采购退货单-新建/编辑

POST/v1/invoices/purchaseReturn/push

异常码	异常消息	异常解决方案
404	‘xxx’ cannot be empty	查看字段说明为“如果传入不能为空”，是否有字段传入了并且是空值

请求参数

serial_id

string

采购退货单编号

必需

值来自/v1/invoices/purchaseReturn/list

warehouse_return_invoice_id

integer

采购退货单id 编辑时需要传递

可选

值来自/v1/invoices/purchaseReturn/list

user_id

integer

操作人

可选

值来自/v1/user/list

currency

string

币种，参考传入值来自/v1/invoices/order/orderEnums返回值中currency_list的code

必需

exchange_rate

number

兑人民币汇率

可选

exchange_rate_usd

number

兑美元汇率

可选

warehouse_invoice_time

string

退货日期

必需

supplier_id

integer

供应商ID，可以从供应商接口中获取

必需

值来自/v1/supplier/list

remark

string

退货备注

必需

invoice_warehouse_id

integer

仓库ID，可以从库存-仓库查询中获取

必需

值来自/v1/warehouse/list

record_list

array [object {6}]

退货明细

可选

return_price

integer

退货单价

必需

return_count

integer

退货数量

必需

product_id

integer

产品id

必需

值来自于/v1/product/list

sku_id

integer

产品sku_id

必需

值来自于/v1/product/list

inbound_record_id

integer

入库明细id

可选

inbound_invoice_id

integer

入库单id

可选

inbound_invoice_id和inbound_record_id要么都传，要么都不传

product_total_count

integer

产品总数量

必需

attachment

array[string]

附件，完整可以下载URL

必需

discount_rate

integer

整单折扣额

必需

handler

array[integer]

处理人ID

必需

值来自/v1/user/list

{
  "serial_id": "",
  "currency": "USD",
  "exchange_rate": "731.86",
  "exchange_rate_usd": "100.00000",
  "warehouse_invoice_time": "2025-01-09",
  "supplier_id": 5137995577,
  "remark": "退货备注",
  "warehouse_id": 3485846285,
  "record_list": [
    {
      "return_price": 2,
      "return_count": 2,
      "product_id": 5158306884,
      "sku_id": 5158306885,
      "inbound_record_id": 5158307130,
      "inbound_invoice_id": 5158307129
    }
  ],
  "product_total_count": 2,
  "attachment": [],
  "discount_rate": 10,
  "handler": [
    11858713
  ]
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

code

integer

必需

message

string

必需

now

string

必需

data

object

必需

warehouse_return_invoice_id

integer

必需

serial_id

string

必需

{
  "code": 200,
  "message": "success",
  "now": "2025-03-14 16:01:00",
  "data": {
    "warehouse_return_invoice_id": 5210034659,
    "serial_id": "CGTH2503140011"
  }
}

最后修改时间： 2 个月前