轻易云
注册体验

领星ERP查询售后工单列表接口

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

查询售后工单列表

POST/pb/mp/returns/workOrder/list
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/pb/mp/returns/workOrder/list"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 10,
    "text": ""
  },
  "requestExample": {
    "date_type": "create_time",
    "start_time": "2023-06-15 00:00:00",
    "end_time": "2023-06-16 23:59:59",
    "offset": 0,
    "length": 20
  },
  "responseExample": {
    "code": 0,
    "message": "操作成功",
    "request_id": "895f2f0493414a4184d28cffaff87a09.1686797615263",
    "response_time": "2023-06-15 10:53:36",
    "data": {
      "total": 101,
      "list": [
        {
          "status": "处理中/待收货",
          "rma_id": 202306050003,
          "rma_type": 2,
          "order_number": 103280851812762110,
          "platform_code": "10008",
          "country": "美国",
          "store_name": "test-walmart",
          "rma_from": 2,
          "rma_reason": "不给换",
          "return_warehouse_code": 11,
          "return_warehouse_name": "仓库11",
          "return_type_code": 1,
          "return_logistice_type_code": 1,
          "return_logistics": "",
          "tracking_number": "",
          "estimate_arrive_date": 0,
          "order_amount": null,
          "refund_method": 1,
          "refund_status": "",
          "comment": "",
          "create_time": "2023-06-09 11:23:44",
          "update_time": "2023-06-09 11:25:01",
          "complete_time": "2023-06-09 11:25:01",
          "tag_list": [
            {
              "tag_id": "907225000920047630",
              "tag_name": "RMA标签1"
            }
          ],
          "refund": [],
          "rma_info": [
            {
              "sku": "SKUPIC",
              "msku": "walm_test2_sku6kGpZ",
              "product_name": "pic",
              "product_image": "https://xxx/47889efe3d00df67cb39.jpg",
              "product_amount": 5,
              "product_rma_amount": 1,
              "product_comment": "",
              "product_rma_image": null,
              "platform_order_no": "NINE00002"
            }
          ],
          "related_info": [
            {
              "return_order_id": "RT901280870700859904",
              "return_order_status_code": 5,
              "issue_order_number": null
            },
            {
              "return_order_id": "RT901294602998157824",
              "return_order_status_code": 3,
              "issue_order_number": null
            },
            {
              "return_order_id": "RT901294603713667072",
              "return_order_status_code": 3,
              "issue_order_number": null
            },
            {
              "return_order_id": "RT901320516537774080",
              "return_order_status_code": 3,
              "issue_order_number": null
            }
          ]
        }
      ]
    }
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1date_type时间类型string—必填时间类型: create_time 创建时间 complete_time 完成时间
2start_time开始时间string—必填开始时间,闭区间,格式:Y-m-d H:i:s
3end_time结束时间string—必填结束时间,闭区间,格式:Y-m-d H:i:s
4offset分页偏移量integer—必填分页偏移量
5length分页长度integer—必填分页长度,上限500

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0 成功
2message提示信息string操作成功必填提示信息
3request_id请求链路idstringeb2bdeed-4842-42b0-8b5e-81345dda5078.1679967282563必填请求链路id
4response_time响应时间string2023-03-28 09:34:45必填响应时间
5data响应数据object—必填响应数据
5.1total总数integer46必填总数
5.2list列表信息array<object>—必填列表信息
5.2.1rma_id售后单号string202306050003必填售后单号
5.2.2rma_type售后类型integer1必填售后类型: 1 退货退款 2 仅退货 3 仅退款 4 退货补发 5 补发
5.2.3status状态【售后单状态/订单状态】string处理中/待收货必填状态【售后单状态/订单状态】
5.2.4order_number系统单号string103290951812762112必填系统单号
5.2.5platform_code平台codestring10002必填平台code
5.2.6country国家string美国必填国家
5.2.7store_name店铺名称stringtest-walmart必填店铺名称
5.2.8rma_from单据来源integer2必填单据来源:1 手工创建,2 线上同步
5.2.9rma_reason售后原因string不给换必填售后原因
5.2.10return_warehouse_code退货仓库idstring11必填退货仓库id
5.2.11return_warehouse_name退货仓库名称string仓库11必填退货仓库名称
5.2.12return_type_code退货类型integer1必填退货类型:1 买家退货,2 卖家退货
5.2.13return_logistice_type_code物流类型integer1必填物流类型:1 自选物流,2 三方物流
5.2.14return_logistics物流商string物流商xx必填物流商
5.2.15tracking_number跟踪号string123必填跟踪号
5.2.16estimate_arrive_date预计到货时间string168658600000必填预计到货时间
5.2.17order_amount订单金额string338.0必填订单金额
5.2.18returen_method退款方式integer1必填退款方式:0 无选择,1 手动退款
5.2.19refund_status退款状态string退款完成必填退款状态: 待退款 退款中 退款失败 退款完成
5.2.20comment备注string备注xx必填备注
5.2.21create_time创建时间string2023-06-09 11:23:44必填创建时间
5.2.22update_time更新时间string2023-06-09 11:25:01必填更新时间
5.2.23complete_time完成时间string2023-06-09 11:25:01必填完成时间
5.2.24tag_list标签信息array<object>—必填标签信息
5.2.24.1tag_id标签idstring907225000920047630必填标签id
5.2.24.2tag_name标签名称stringRMA标签1必填标签名称
5.2.25refund退款信息array<object>—必填退款信息
5.2.25.1platform_order_number退款平台单号stringama-test0330-mnkg8a必填退款平台单号
5.2.25.2refund_amount退款金额number2必填退款金额
5.2.26rma_info售后信息array<object>—必填售后信息
5.2.26.1skuskustringdanpin2必填SKU
5.2.26.2mskumskustringsHOLDER001必填MSKU
5.2.26.3product_name品名string单品2必填品名
5.2.26.4product_image商品图片stringhttps//xxxx.jpg必填商品图片
5.2.26.5product_amount商品订购数量integer1必填商品订购数量
5.2.26.6product_rma_amount商品售后数量integer1必填商品售后数量
5.2.26.7product_comment商品售后说明string暂无说明必填商品售后说明
5.2.26.8product_rma_image商品售后图片stringhttps://xxxx-xxxxx.com/xxxxxxxxxx.jpg必填商品售后图片
5.2.26.9platform_order_no平台单号string—必填平台单号
5.2.27related_info关联单据array<object>—必填关联单据
5.2.27.1return_order_id销售退货单单据号stringRT901305646307553280必填销售退货单单据号
5.2.27.2return_order_status_code销售退货单状态integer3必填销售退货单状态: -1 异常 1 待提交 2 待审批 3 待收货 4 已作废 5 已完成 6 导入中
5.2.27.3issue_order_number补发订单系统单号string103295742586946048必填补发订单系统单号

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

需要对接这个接口?

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