创建退货单

POST

/openApi/order/createReturn

最后修改时间：2024-12-30 09:09:17

责任人：未设置

请求参数

Body 参数multipart/form-data

appid

string

必需

open_appid_api，由服务端分配唯一标示appid

timestamp

integer

当前时间戳

必需

示例值:

sign

string

签名参数(32位)

必需

示例值:

notice

string

可选

site_id

string

站点

可选

commodity_string

string

必需

订单商品数据， JSON字符串，如：{"order_no":"订单号","remark":"退货单备注","commodity_list":[{"apply_amount":"申请退货数量","commodity_id":"商品id","remark":"商品备注","apply_price":"申请退货单价"}]

从15.7.0版本后支持使用商品编码+单位代替id来使用，即结构如下
{"order_no":"订单号","remark":"退货单备注","commodity_list":[{"apply_amount":"申请退货数量", "commodity_code": "商品编码", "unit": "商品单位","remark":"商品备注","apply_price":"申请退货单价"}]}

不关联原单结构如下：
{"return_type":"user","user_id": "客户id","return_date": "售后日期","remark":"退货单备注","commodity_list":[{"apply_amount":"申请退货数量", "commodity_id": "商品id","remark":"商品备注","apply_price":"申请退货单价"}]}

idempotent_key

string

可选

系统版本>=15.7.0支持，传随机数，用于做幂等校验。如果不传此字段或为空则不校验

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://scm.sdongpo.com/cc_thirdparty/openApi/order/createReturn' \
--form 'appid=""' \
--form 'timestamp=""' \
--form 'sign=""' \
--form 'notice=""' \
--form 'site_id=""' \
--form 'commodity_string=""' \
--form 'idempotent_key=""'

返回响应

🟢200成功

application/json

Body

status

integer

必需

data

object

必需

return_no

string

必需

return_id

integer

必需

message

string

必需

示例

{
  "status": 1,
  "data": {
    "return_no": "RT2334434343",
    "return_id": 1
  },
  "message": "更新成功"
}

修改于 2024-12-30 09:09:17

退货单详情

审核拒绝退货单