轻易云
注册体验

领星ERP查询采购退货单列表接口

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

查询采购退货单列表

POST/erp/sc/routing/purchase/purchase_return_order/getPurchaseReturnOrderList
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/erp/sc/routing/purchase/purchase_return_order/getPurchaseReturnOrderList"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": {
    "offset": 0,
    "length": 20,
    "start_date": "2024-08-02",
    "end_date": "2024-08-02",
    "status": [
      10,
      20
    ]
  },
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "0CDB0A84-AE71-A25C-7432-041C78192C34",
    "response_time": "2024-08-02 17:46:27",
    "data": {
      "total": 2,
      "list": [
        {
          "order_sn": "PR240802002",
          "create_realname": "何承伟",
          "create_uid": 10548111,
          "buyer_realname": "甄新晴",
          "buyer_uid": 10401445,
          "create_time": "2024-08-02 10:56:57",
          "last_time": "2024-08-02 10:56:57",
          "purchase_order_sn": "PO240104006",
          "wid": 44,
          "supplier_name": "深圳市健爱户外运动用品有限公司(已删除)",
          "supplier_id": 1583,
          "return_method": 2,
          "replenish_method": 1,
          "receipt_funds_order_sn": "",
          "status": 10,
          "purchase_currency": "CNY",
          "purchase_currency_icon": "¥",
          "fee_part_type": null,
          "shipping_currency": "CNY",
          "shipping_price": "0.00",
          "other_currency": "CNY",
          "other_fee": "0.00",
          "return_amount_total": "0.00",
          "return_reason": "",
          "remark": "",
          "item_list": [
            {
              "item_id": 2414,
              "spu_name": "",
              "spu": "",
              "product_name": "服装1111",
              "sku": "fuzhuang1111",
              "fnsku": "B0BBB14W7B",
              "msku": [],
              "attribute": [],
              "seller_id": "109",
              "price": "100.0000",
              "quantity_real": 80,
              "return_good_num": 0,
              "return_bad_num": 5,
              "replenish_num": 5,
              "deduction_amount": "0.00",
              "expect_arrive_time": "",
              "remark": ""
            }
          ]
        }
      ]
    },
    "total": 0
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1search_field_time时间搜索维度string—可选时间搜索维度: create_time 创建时间【默认值】 last_time 更新时间
2start_date开始时间string—可选开始时间,格式:Y-m-d,双闭区间 当筛选更新时间时,支持Y-m-d或Y-m-d H:i:s
3end_date结束时间string—可选结束时间,格式:Y-m-d,双闭区间 当筛选更新时间时,支持Y-m-d或Y-m-d H:i:s
4status状态array<any>—可选状态: 121 待审批 122 已驳回 124 已作废(审批作废) 10 已处理 20 已作废(单据作废) 5 待退货
5offset分页偏移量integer—必填分页偏移量
6length分页长度integer—必填分页长度,上限500

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0 成功
2message消息提示stringsuccess必填消息提示
3error_details错误信息array<any>[]必填错误信息
4request_id请求链路idstring929A1D7D-D656-0EA0-C78A-A686790C7090必填请求链路id
5response_time响应时间string2022-05-20 16:57:03必填响应时间
6data响应数据object—必填响应数据
6.1total总数integer1000必填总数
6.2list列表array<object>—必填列表
6.2.1wid仓库idinteger1必填仓库id
6.2.2order_sn退货单号stringPR220520004必填退货单号
6.2.3create_uid创建人idinteger125必填创建人id
6.2.4create_realname创建人名称stringJSTAPI必填创建人名称
6.2.5create_time创建时间string2022-05-20 11:48:23必填创建时间
6.2.6last_time更新时间string2022-05-20 11:48:23必填更新时间
6.2.7buyer_uid采购员idinteger175必填采购员id
6.2.8buyer_realname采购员名称stringAPI必填采购员名称
6.2.9purchase_order_sn采购单号stringPO220513032必填采购单号
6.2.10supplier_id供应商idinteger12必填供应商id
6.2.11supplier_name供应商名称string供应商3必填供应商名称
6.2.12return_method退货方式integer1必填退货方式:1 退货扣款,2 退货补货
6.2.13replenish_method补货方式integer—必填补货方式:1 源单补货
6.2.14receipt_funds_order_sn收款单号string—必填收款单号
6.2.15status状态integer10必填状态: 121 待审批 122 已驳回 124 已作废(审批作废) 10 已处理 20 已作废(单据作废)
6.2.16purchase_currency采购币种stringCNY必填采购币种
6.2.17purchase_currency_icon采购币种符号string¥必填采购币种符号
6.2.18fee_part_type费用分配方式integer—必填费用分配方式: 0 不分配 1 按金额 2 按数量
6.2.19shipping_currency运费币种stringCNY必填运费币种
6.2.20shipping_price退货运费number0必填退货运费
6.2.21other_currency其他费用币种stringCNY必填其他费用币种
6.2.22other_fee其他费用number0必填其他费用
6.2.23return_reason退货原因string单品0001破损必填退货原因
6.2.24return_amount_total退货总金额string—必填退货总金额
6.2.25remark单据备注string破损需要退货必填单据备注
6.2.26item_list子项列表array<object>—必填子项列表
6.2.26.1item_id子项idinteger313必填子项id
6.2.26.2spu_name款名stringSPU NAME必填款名
6.2.26.3spuspustringSPU1必填SPU
6.2.26.4product_name品名string单品0001必填品名
6.2.26.5skuskustringDP0001必填SKU
6.2.26.6fnskufnskustring—必填FNSKU
6.2.26.7mskumskuarray<any>—必填MSKU
6.2.26.8attribute属性array<object>—必填属性
6.2.26.8.1attr_id属性idstring1必填属性id
6.2.26.8.2attr_name属性名string颜色必填属性名
6.2.26.8.3attr_value属性值string白必填属性值
6.2.26.9price含税单价number1必填含税单价
6.2.26.10quantity_real采购数量integer20必填采购数量
6.2.26.11return_good_num良品退货量integer5必填良品退货量
6.2.26.12return_bad_num次品退货量integer—必填次品退货量
6.2.26.13replenish_num扣款数量integer5必填扣款数量
6.2.26.14deduction_amount退货金额number5必填退货金额
6.2.26.15expect_arrive_time预计到货时间string&nbsp;必填预计到货时间
6.2.26.16remark备注string破损必填备注

领星ERP的接口:查询采购退货单列表(/erp/sc/routing/purchase/purchase_return_order/getPurchaseReturnOrderList),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

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