Lingxing
切换旧版

查询销售退货单列表

POST/pb/mp/returns/v2/list

接口信息

API Path请求协议请求方式令牌桶容量
/pb/mp/returns/v2/listHTTPSPOST10

请求参数

offsetinteger必填
页码,非偏移量
offset传1,则返回第一页数据
lengthinteger必填
每页记录数
time_typestring
搜索时间类型:updateTime 更新时间【不传默认为创建时间】
start_timestring必填
开始时间,格式:Y-m-d H:i:s
end_timestring必填
结束时间,格式:Y-m-d H:i:s
platform_codearray<any>
平台code
sales_typeinteger
退货类型:1 买家退货,2 物流商退货
statusarray<any>
订单状态:
-1 异常
1 待提交
2 待审批
3 待收货
4 已作废
5 已完成
6 导入中
store_idarray<any>
店铺id
widarray<any>
系统仓库id

请求示例

{
    "offset": 0,
    "length": 20,
    "time_type": "updateTime",
    "start_time": "2023-01-01 00:00:00",
    "end_time": "2024-07-29 20:50:00",
    "sales_type": 1,
    "status": [1,4,5],
    "store_id": ["127190049090011648","127190049090011654"],
    "wid": [1,578,765]
}

返回结果

Json Object

codeinteger必填
状态码,0 成功
示例 0
messagestring必填
操作成功
示例 操作成功
request_idstring必填
请求链路id
示例 052e20647c9c4622adb7576ae335211d.1687946868074
response_timestring必填
响应时间
示例 2023-06-28 18:07:50
dataobject必填
响应数据
隐藏子属性
totalinteger必填
总条数
示例 41
listarray<object>必填
详细列表
隐藏子属性
complete_timestring必填
完成时间
示例 2023-06-05 16:25:08
global_order_nointeger必填
系统单号
示例 103280851812762110
gmt_createstring必填
创建时间
示例 2023-06-05 16:25:08
gmt_modifiedstring必填
更新时间
示例 2023-06-05 16:25:08
has_predictioninteger必填
是否三方仓预报 0 否 1 是
示例 0
logistics_provider_namestring必填
物流商
示例 xx物流
platformstring必填
平台
示例 walmart
pre_arrival_timestring必填
预计到货时间
示例 2023-06-05 16:25:08
reasonstring必填
退货原因
示例 不给换
remarkstring必填
备注
示例 xxxx备注
rma_order_nostring必填
退货单号
示例 RT901320516537774080
sales_typestring必填
退货类型
示例 买家退货
sitestring必填
站点
示例 美国
statusstring必填
订单状态
示例 待收货
store_idinteger必填
多平台店铺id
示例 110000000017008000
sidinteger必填
亚马逊店铺id
示例 17
store_namestring必填
店铺名称
示例 xxx店铺
tracking_nostring必填
跟踪号
示例 212
uid_namestring必填
创建人名称
示例 张三
sys_widinteger必填
退货仓库id
示例 11
w_namestring必填
退货仓库名称
示例 仓库11
relation_order_infoobject必填
关联单据
隐藏子属性
global_order_nointeger必填
系统单号
示例 103296739036561920
storage_in_order_nostring必填
入库单号
示例 IB230520001
itemsarray<object>必填
商品信息
隐藏子属性
available_quantityinteger必填
可用量
示例 1
defective_quantityinteger必填
次品量
示例 1
destroyed_quantityinteger必填
销毁量
示例 1
quantityinteger必填
数量
示例 1
receiving_quantityinteger必填
收货数量
示例 1
return_quantityinteger必填
退货数量
示例 1
handler_typestring必填
处理方式:
默认不处理
重新上架
由WMS决定
暂存区
次品
销毁
示例 默认不处理
pic_infosarray<object>必填
售后图片信息
隐藏子属性
access_urlstring必填
访问地址
示例 https://xxx/xxx
file_namestring必填
图片名
示例 file
remarkstring必填
售后说明
示例 实例xxxx
platform_order_nostring必填
平台单号
示例 ama-test0330-ZEjHkL
mskustring必填
msku
示例 HOLDER001
skustring必填
本地产品sku
示例 danpin2
product_namestring必填
品名
示例 单品2
idinteger必填
id
示例 id
defective_whb_codestring必填
次品仓位编码
available_whb_codestring必填
可用仓位编码

返回成功示例

{
    "code": 0,
    "data": {
        "total": "10",
        "list": [
            {
                "reason": "产品质量问题",
                "status": "已完成",
                "platform": "amazon",
                "site": null,
                "remark": "",
                "sid": "101",
                "items": [
                    {
                        "sku": "mini-blue2",
                        "msku": "",
                        "quantity": 3,
                        "remark": "",
                        "stockDeductId": "0",
                        "platform_order_no": "1258762477858",
                        "product_name": "干花*2",
                        "return_quantity": 3,
                        "receiving_quantity": 3,
                        "handler_type": "默认不处理",
                        "available_quantity": 3,
                        "defective_quantity": null,
                        "destroyed_quantity": 0,
                        "stock_cost": null,
                        "pic_infos": null
                    }
                ],
                "rma_order_no": "RT901406878224720384",
                "sales_type": "买家退货",
                "sys_wid": "1",
                "w_name": "wcn测试仓库测试改名",
                "delivery_w_name": null,
                "delivery_w_nid": null,
                "global_order_no": "103345679826100736",
                "logistics_provider_name": "",
                "tracking_no": "132",
                "uid_name": "陈旭鹏",
                "gmt_create": "2024-02-04 17:11:44",
                "store_name": null,
                "has_prediction": 0,
                "pre_arrival_time": "1970-01-01 08:00:00",
                "complete_time": "2024-02-04 17:12:19",
                "gmt_modified": "2024-02-04 17:12:19",
                "store_id": "127190049090011648",
                "relation_order_info": {
                    "global_order_no": "103345679826100736",
                    "storage_in_order_no": "IB240204014"
                }
            },
            {
                "reason": "包裹损坏",
                "status": "已完成",
                "platform": "amazon",
                "site": null,
                "remark": "",
                "sid": "101",
                "items": [
                    {
                        "sku": "BAN",
                        "msku": "",
                        "quantity": 2,
                        "remark": "",
                        "stockDeductId": "0",
                        "platform_order_no": "test1203-110",
                        "product_name": "BAN",
                        "return_quantity": 1,
                        "receiving_quantity": 1,
                        "handler_type": "默认不处理",
                        "available_quantity": 0,
                        "defective_quantity": null,
                        "destroyed_quantity": 0,
                        "stock_cost": null,
                        "pic_infos": null
                    }
                ],
                "rma_order_no": "RT901261790905177088",
                "sales_type": "买家退货",
                "sys_wid": "1",
                "w_name": "wcn测试仓库测试改名",
                "delivery_w_name": null,
                "delivery_w_nid": null,
                "global_order_no": "103255373488840704",
                "logistics_provider_name": "",
                "tracking_no": "",
                "uid_name": "金巧玲",
                "gmt_create": "2022-12-21 17:49:55",
                "store_name": null,
                "has_prediction": 0,
                "pre_arrival_time": "1970-01-01 08:00:00",
                "complete_time": "2023-11-13 15:01:23",
                "gmt_modified": "2023-11-13 15:01:23",
                "store_id": "127190049090011648",
                "relation_order_info": {
                    "global_order_no": "103255373488840704",
                    "storage_in_order_no": "IB231113004"
                }
            }
        ]
    },
    "response_time": "2024-07-31 16:00:40",
    "message": "操作成功",
    "request_id": "aa4794a7b2c0437483966bed3e7bee75.114.17224128397332303"
}