轻易云
注册体验

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

所属平台
领星ERP
类型
WebAPI
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
仓库 / 收货质检 · POST · 请求参数 10 个(必填 4) · 响应参数 50 个 · 限流令牌桶容量 10
更新日期
2026-11-21

查询销售退货单列表

POST/pb/mp/returns/v2/list
加工厂
{
  "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"
  }
}

接口请求参数

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

接口响应参数

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

领星ERP的接口:查询销售退货单列表(/pb/mp/returns/v2/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。