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 · 请求参数 6 个(必填 2) · 响应参数 53 个 · 限流令牌桶容量 1
Updated At
2026-11-21

查询采购退货单列表

POST/erp/sc/routing/purchase/purchase_return_order/getPurchaseReturnOrderList
Factory
{
  "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
  }
}

Request Parameters

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

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码,0 成功
2message消息提示stringsuccessRequired消息提示
3error_details错误信息array<any>[]Required错误信息
4request_id请求链路idstring929A1D7D-D656-0EA0-C78A-A686790C7090Required请求链路id
5response_time响应时间string2022-05-20 16:57:03Required响应时间
6data响应数据object—Required响应数据
6.1total总数integer1000Required总数
6.2list列表array<object>—Required列表
6.2.1wid仓库idinteger1Required仓库id
6.2.2order_sn退货单号stringPR220520004Required退货单号
6.2.3create_uid创建人idinteger125Required创建人id
6.2.4create_realname创建人名称stringJSTAPIRequired创建人名称
6.2.5create_time创建时间string2022-05-20 11:48:23Required创建时间
6.2.6last_time更新时间string2022-05-20 11:48:23Required更新时间
6.2.7buyer_uid采购员idinteger175Required采购员id
6.2.8buyer_realname采购员名称stringAPIRequired采购员名称
6.2.9purchase_order_sn采购单号stringPO220513032Required采购单号
6.2.10supplier_id供应商idinteger12Required供应商id
6.2.11supplier_name供应商名称string供应商3Required供应商名称
6.2.12return_method退货方式integer1Required退货方式:1 退货扣款,2 退货补货
6.2.13replenish_method补货方式integer—Required补货方式:1 源单补货
6.2.14receipt_funds_order_sn收款单号string—Required收款单号
6.2.15status状态integer10Required状态: 121 待审批 122 已驳回 124 已作废(审批作废) 10 已处理 20 已作废(单据作废)
6.2.16purchase_currency采购币种stringCNYRequired采购币种
6.2.17purchase_currency_icon采购币种符号string¥Required采购币种符号
6.2.18fee_part_type费用分配方式integer—Required费用分配方式: 0 不分配 1 按金额 2 按数量
6.2.19shipping_currency运费币种stringCNYRequired运费币种
6.2.20shipping_price退货运费number0Required退货运费
6.2.21other_currency其他费用币种stringCNYRequired其他费用币种
6.2.22other_fee其他费用number0Required其他费用
6.2.23return_reason退货原因string单品0001破损Required退货原因
6.2.24return_amount_total退货总金额string—Required退货总金额
6.2.25remark单据备注string破损需要退货Required单据备注
6.2.26item_list子项列表array<object>—Required子项列表
6.2.26.1item_id子项idinteger313Required子项id
6.2.26.2spu_name款名stringSPU NAMERequired款名
6.2.26.3spuspustringSPU1RequiredSPU
6.2.26.4product_name品名string单品0001Required品名
6.2.26.5skuskustringDP0001RequiredSKU
6.2.26.6fnskufnskustring—RequiredFNSKU
6.2.26.7mskumskuarray<any>—RequiredMSKU
6.2.26.8attribute属性array<object>—Required属性
6.2.26.8.1attr_id属性idstring1Required属性id
6.2.26.8.2attr_name属性名string颜色Required属性名
6.2.26.8.3attr_value属性值string白Required属性值
6.2.26.9price含税单价number1Required含税单价
6.2.26.10quantity_real采购数量integer20Required采购数量
6.2.26.11return_good_num良品退货量integer5Required良品退货量
6.2.26.12return_bad_num次品退货量integer—Required次品退货量
6.2.26.13replenish_num扣款数量integer5Required扣款数量
6.2.26.14deduction_amount退货金额number5Required退货金额
6.2.26.15expect_arrive_time预计到货时间string&nbsp;Required预计到货时间
6.2.26.16remark备注string破损Required备注

The 查询采购退货单列表 API (/erp/sc/routing/purchase/purchase_return_order/getPurchaseReturnOrderList) 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.