Qeasy Cloud
Get Started

领星ERP 创建已完成的采购退货单 API

Platform
领星ERP
Type
WebAPI
Effect
EXECUTE
API Version
1.0
Adapter
\Adapter\LingXing\LXExecuteAdapter
Auth Mode
OTHER
Description
采购 · POST · 请求参数 17 个(必填 7) · 响应参数 7 个 · 限流令牌桶容量 1
Updated At
2026-11-21

创建已完成的采购退货单

POST/erp/sc/routing/purchase/purchase_return_order/createPurchaseReturnOrder
Factory
{
  "operation": {
    "method": "POST",
    "path": "/erp/sc/routing/purchase/purchase_return_order/createPurchaseReturnOrder"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": {
    "purchase_order_sn": "PO220513032",
    "return_method": 1,
    "replenish_method": 0,
    "fee_part_type": 0,
    "shipping_currency": "CNY",
    "shipping_price": 1,
    "other_currency": "CNY",
    "other_fee": 1,
    "return_reason": "产品颜色差异大",
    "remark": "DP0001退货",
    "item_list": [
      {
        "purchase_order_item_id": 19302,
        "return_good_num": 5,
        "return_bad_num": 5,
        "expect_arrive_time": "",
        "deduction_amount": 10,
        "remark": "颜色差异"
      }
    ]
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1purchase_order_sn采购单号string—Required采购单号
2return_method退货方式integer—Required退货方式,1:退货扣款 2:退货补货
3replenish_method补货方式integer—Optional补货方式,1:源单补货【退货方式为2时必填】
4fee_part_type分摊方式integer—Required分摊方式,0:不分摊 1:按金额 2:按数量
5shipping_currency退货运费币种string—Required退货运费币种,支持CNY、USD,当源单币种为CNY时,运费币种只能为CNY
6shipping_price退货运费number—Optional退货运费
7other_currency其他费用币种string—Required其他费用币种,支持CNY、USD,当源单币种为CNY时,其他费用币种只能为CNY
8other_fee其他费用number—Optional其他费用
9return_reason退货原因string—Optional退货原因
10remark单据备注string—Optional单据备注
11item_list退货产品array<object>—Required退货产品
11.1purchase_order_item_id采购单子项idinteger—Required采购单子项id
11.2return_good_num良品退货量integer—Optional良品退货量,良品退货量和次品退货量不可同时为空
11.3return_bad_num次品退货量integer—Optional次品退货量,良品退货量和次品退货量不可同时为空
11.4expect_arrive_time预计到货时间string—Optional预计到货时间,退货补货可设置该字段
11.5deduction_amount退货金额number—Optional退货金额,退货方式为退货扣款时必填,填写值不可大于扣款数量*含税单价
11.6remark备注string—Optional备注

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码,0 成功
2message消息提示stringsuccessRequired消息提示
3error_details错误信息string[]Required错误信息
4request_id请求链路idstringC1309FC7-1EC2-9B67-901A-2A0156CC7C25Required请求链路id
5response_time响应时间string2022-05-20 11:48:25Required响应时间
6data响应数据object—Required响应数据
6.1order_sn采购退货单号stringPR220520003Required采购退货单号

The 创建已完成的采购退货单 API (/erp/sc/routing/purchase/purchase_return_order/createPurchaseReturnOrder) 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.