轻易云
注册体验

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

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

创建已完成的采购退货单

POST/erp/sc/routing/purchase/purchase_return_order/createPurchaseReturnOrder
加工厂
{
  "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": "颜色差异"
      }
    ]
  }
}

接口请求参数

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

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0 成功
2message消息提示stringsuccess必填消息提示
3error_details错误信息string[]必填错误信息
4request_id请求链路idstringC1309FC7-1EC2-9B67-901A-2A0156CC7C25必填请求链路id
5response_time响应时间string2022-05-20 11:48:25必填响应时间
6data响应数据object—必填响应数据
6.1order_sn采购退货单号stringPR220520003必填采购退货单号

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

需要对接这个接口?

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