Qeasy Cloud
Get Started

领星ERP 查询销售退货单列表 API

Platform
领星ERP
Type
WebAPI
Effect
QUERY
API Version
1.0
Adapter
\Adapter\LingXing\LXQueryAdapter
Auth Mode
OTHER
Description
仓库 / 收货质检 · POST · 请求参数 10 个(必填 4) · 响应参数 50 个 · 限流令牌桶容量 10
Updated At
2026-11-21

查询销售退货单列表

POST/pb/mp/returns/v2/list
Factory
{
  "operation": {
    "method": "POST",
    "path": "/pb/mp/returns/v2/list"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 10,
    "text": ""
  },
  "requestExample": {
    "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
    ]
  },
  "responseExample": {
    "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"
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1offset页码integer—Required页码,非偏移量 offset传1,则返回第一页数据
2length每页记录数integer—Required每页记录数
3time_type搜索时间类型string—Optional搜索时间类型:updateTime 更新时间【不传默认为创建时间】
4start_time开始时间string—Required开始时间,格式:Y-m-d H:i:s
5end_time结束时间string—Required结束时间,格式:Y-m-d H:i:s
6platform_code平台codearray<any>—Optional平台code
7sales_type退货类型integer—Optional退货类型:1 买家退货,2 物流商退货
8status订单状态array<any>—Optional订单状态: -1 异常 1 待提交 2 待审批 3 待收货 4 已作废 5 已完成 6 导入中
9store_id店铺idarray<any>—Optional店铺id
10wid系统仓库idarray<any>—Optional系统仓库id

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码,0 成功
2message操作成功string操作成功Required操作成功
3request_id请求链路idstring052e20647c9c4622adb7576ae335211d.1687946868074Required请求链路id
4response_time响应时间string2023-06-28 18:07:50Required响应时间
5data响应数据object—Required响应数据
5.1total总条数integer41Required总条数
5.2list详细列表array<object>—Required详细列表
5.2.1complete_time完成时间string2023-06-05 16:25:08Required完成时间
5.2.2global_order_no系统单号integer103280851812762110Required系统单号
5.2.3gmt_create创建时间string2023-06-05 16:25:08Required创建时间
5.2.4gmt_modified更新时间string2023-06-05 16:25:08Required更新时间
5.2.5has_prediction是否三方仓预报 0 否 1 是integer0Required是否三方仓预报 0 否 1 是
5.2.6logistics_provider_name物流商stringxx物流Required物流商
5.2.7platform平台stringwalmartRequired平台
5.2.8pre_arrival_time预计到货时间string2023-06-05 16:25:08Required预计到货时间
5.2.9reason退货原因string不给换Required退货原因
5.2.10remark备注stringxxxx备注Required备注
5.2.11rma_order_no退货单号stringRT901320516537774080Required退货单号
5.2.12sales_type退货类型string买家退货Required退货类型
5.2.13site站点string美国Required站点
5.2.14status订单状态string待收货Required订单状态
5.2.15store_id多平台店铺idinteger110000000017008000Required多平台店铺id
5.2.16sid亚马逊店铺idinteger17Required亚马逊店铺id
5.2.17store_name店铺名称stringxxx店铺Required店铺名称
5.2.18tracking_no跟踪号string212Required跟踪号
5.2.19uid_name创建人名称string张三Required创建人名称
5.2.20sys_wid退货仓库idinteger11Required退货仓库id
5.2.21w_name退货仓库名称string仓库11Required退货仓库名称
5.2.22relation_order_info关联单据object—Required关联单据
5.2.22.1global_order_no系统单号integer103296739036561920Required系统单号
5.2.22.2storage_in_order_no入库单号stringIB230520001Required入库单号
5.2.23items商品信息array<object>—Required商品信息
5.2.23.1available_quantity可用量integer1Required可用量
5.2.23.2defective_quantity次品量integer1Required次品量
5.2.23.3destroyed_quantity销毁量integer1Required销毁量
5.2.23.4quantity数量integer1Required数量
5.2.23.5receiving_quantity收货数量integer1Required收货数量
5.2.23.6return_quantity退货数量integer1Required退货数量
5.2.23.7handler_type处理方式string默认不处理Required处理方式: 默认不处理 重新上架 由WMS决定 暂存区 次品 销毁
5.2.23.8pic_infos售后图片信息array<object>—Required售后图片信息
5.2.23.8.1access_url访问地址stringhttps://xxx/xxxRequired访问地址
5.2.23.8.2file_name图片名stringfileRequired图片名
5.2.23.9remark售后说明string实例xxxxRequired售后说明
5.2.23.10platform_order_no平台单号stringama-test0330-ZEjHkLRequired平台单号
5.2.23.11mskumskustringHOLDER001Requiredmsku
5.2.23.12sku本地产品skustringdanpin2Required本地产品sku
5.2.23.13product_name品名string单品2Required品名
5.2.23.14ididintegeridRequiredid
5.2.23.15defective_whb_code次品仓位编码string—Required次品仓位编码
5.2.23.16available_whb_code可用仓位编码string—Required可用仓位编码

The 查询销售退货单列表 API (/pb/mp/returns/v2/list) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.