新增退货单

POST

/api/customer/operation/addReturn

请求参数

Header 参数

apiKey

string

API授权码

必需

默认值:

5ff6e6a70376ba11a42e277086598d4a

signature

string

签名

必需

默认值:

4590A48221F34CE299EA2D74036246F5

timestamp

string

请求时间戳

必需

默认值:

1717381423

sourceFrom

enum<string>

必需

平台标识，传拼音。（例如：领星：lingxing、易仓：yicang、店小秘：dianxiaomi、旺店通：wangdiantong、积加：jijia、千易：qianyi、赛狐：saihu、自研ERP：ziyan 等等...）

枚举值:

lingxingyicangdianxiaomiwangdiantongjijiaqianyisaihuziyan

默认值:

lingxing

Body 参数application/json

warehouseCode

string

仓库编码

必需

参考枚举描述-仓库名称

frtTrackNumber

string

物流追踪号

必需

carrier

string

承运商

必需

参考枚举描述-承运商

customerOrderNo

string

客户参考号

可选

estiTime

string

预计到达时间

可选

customerRemark

string

备注

可选

returnSkuEntityList

array [object {2}]

退货商品信息

必需

skuCode

string

SKU编码

必需

quantity

integer

SKU数量

必需

示例

{
    "warehouseCode": "sz_wh",
    "frtTrackNumber": "wc042105",
    "carrier": "FEDEX",
    "customerOrderNo": "c042105",
    "estiTime": "2025-04-21 16:02:32",
    "customerRemark": "备注",
    "returnSkuEntityList": [
        {
            "skuCode": "SKU20240530",
            "quantity": 2
        },
        {
            "skuCode": "SKU20240531",
            "quantity": 3
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://192.168.8.18:3080/api/customer/operation/addReturn' \
--header 'apiKey;' \
--header 'signature;' \
--header 'timestamp;' \
--header 'sourceFrom;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "warehouseCode": "sz_wh",
    "frtTrackNumber": "wc042105",
    "carrier": "FEDEX",
    "customerOrderNo": "c042105",
    "estiTime": "2025-04-21 16:02:32",
    "customerRemark": "备注",
    "returnSkuEntityList": [
        {
            "skuCode": "SKU20240530",
            "quantity": 2
        },
        {
            "skuCode": "SKU20240531",
            "quantity": 3
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

返回代码

必需

message

string

返回处理消息

必需

result

object

返回数据对象

必需

data

object

实际数据对象

必需

success

boolean

成功标志

必需

timestamp

integer

时间戳

必需

示例

{
    "code": 200,
    "message": "新增退货单成功",
    "result": {
        "data": {
            "returnNo": "RO2504210005"
        }
    },
    "success": true,
    "timestamp": 1745228662581
}

修改于 2025-04-22 09:12:44

商品库存

取消退货单