接口说明

卖家或第三方平台通过该接口可对下单环节未提供退货跟踪号的非Return Label的有RMA退货单，并返回是否操作成功。

使用场景

只允许订单状态为已下单状态的有RMA退货入库单；
只允许非Return Label服务的有RMA退货入库单；
只允许是下单未提供跟踪号的有RMA退货单；

接口名称

rma.returnGoodsOrder.updateReturnOrderExpressNo

请求说明

请求内容	说明
URL	https://openapi.winit.com.cn/openapi/service
接口测试	https://sandboxopenapi.winit.com.cn/openapi/service
验证方法	Token,md5
格式	json
字符编码	UTF-8
http请求方式	http
请求数限制	默认每分钟1000，1000有需要可申请加大。

请求入参

参数	类型	是否必填	备注
returnOrderNo	String	Y	退货单号
expressNo	String	Y	退货跟踪号允许输入数字、字母和符号，长度限制6-60个字符
supplierName	String	N	供应商入参值查询下表非必填，提供则会提升向供应商获取到跟踪号派送轨迹的可能，方便查询包裹运输派送情况。

supplierName可支持提供的供应商：

供应商	国家
AU Post	AU
AU TOLL
Direct Freight
TNT
B2C Europe Parcel	BE
DHL
DPD
UPS
CA POST EXPEDITED	CA
Uni- Domestic Delivery
UPS
DE Post	DE
DHL
DPD
GLS
UPS
DPD	UK
Hermes
Royal Mail
UPS
XDP
Yodel
DHL	US
Fedex
UPS
USPS

请求示例

{
    "action": "rma.returnGoodsOrder.updateReturnOrderExpressNo",
    "app_key": "rebecca",
    "data": {
        "returnOrderNo" : "RT000001929941213",
        "expressNo" : "ZA9192939940012",
        "supplierName" : "Fedex"
    },
    "format": "json",
    "language": "zh_CN",
    "platform": "sw",
    "sign": "00000000000000000000000000000000",
    "sign_method": "md5",
    "timestamp": "2023-07-21 17:17:11",
    "version": "1.0"
}

返回出参

返回参数说明：正确的返回编码code：0及结果data，错误的返回错误码及错误信息msg。

返回示例

--失败
{
    "code": "02050240210",
    "msg": "RT单【{0}】使用Return Label服务会自动获取面单，无需补充跟踪号。",
    "data": ""
}
--失败
{
    "code": "02020500160",
    "msg": "退货跟踪号允许输入数字、字母和符号，长度限制6-60个字符，请填写正确的退货跟踪号！",
    "data": ""
}
--失败
{
    "code": "02050240294",
    "msg": "退货单【RT16000000000223CN】已有跟踪号，不支持补充",
    "data": ""
}
--成功
{
    "code": "0",
    "msg": "操作成功",
    "data": ""
}

关键词