更新退货单商品信息
更新时间: 2021-06-30 20:43:19 访问次数:3249
接口说明
1.用于万邑联-待处理订单-关联商品处理
2.用于给第三方系统(如客户erp)通过API的方式处理退货单关联商品业务
接口名称
rma.returnGoodsOrder.updateMerchandise
请求说明
请求内容 | 说明 |
---|---|
URL | https://openapi.winit.com.cn/openapi/service |
接口测试 | https://sandboxopenapi.winit.com.cn/openapi/service |
验证方法 | Token,md5 |
格式 | json |
字符编码 | UTF-8 |
http请求方式 | http |
请求数限制 | 默认每分钟1000,1000有需要可申请加大。 |
请求入参
名称 | 类型 | 必填 | 说明 | 示例 |
---|---|---|---|---|
returnGoodsOrderNo | String(64) | Y | winit订单号(退货单号) | |
originalMerchandiseSerno | String(64) | Y | 退货商品条码 | M码 |
merchandiseCode | String(255) | O | 关联商品编码 处理方式选择销毁时,无需填写。填写将忽略 处理方式选择良品上架或不良品上架时,必须填写 |
SKU |
specification | String(255) | N | 关联商品规格 | |
handleMethod | String(32) | Y | 处理方式 DE:销毁 GOOD_SA:良品上架 DEFECTIVE_SA:不良品上架 (以下逻辑已弃用:当isGood不传值时必填;当isGood传值时,默认为GOOD_SA) |
GOOD_SA |
associateType | String(32) | Y | 维护方式 directly :“直接‘关联商品’” copy:“复制‘关联商品’” (以下逻辑已弃用:当isGood不传值时必填;当isGood传值时,按ISGood生效) |
copy |
isGood | String(1) | N | 商品状况,已弃用 Y:“良品” N:“不良品” |
|
newMerchandiseCode | String(128) | O | 新SKU编码 当associateType维护方式=directly 时,忽略填写值 当associateType维护方式=copy 时,必填,复制“关联商品”的商品信息新生成的SKU的SKU编码; (以下逻辑已弃用:当isGood传值时,新SKU编码不传参,默认在关联的商品编码后拼接“return”) |
|
vatNo | String(128) | N | VAT Owner DE、UK填写 |
|
declareValue | BigDecimal(16,9) | N | 申报价值 商品状况为“不良品”时必填 |
|
remarks | String(500) | N | 备注 |
请求示例
{
"action": "rma.returnGoodsOrder.updateMerchandise",
"app_key": "rebecca",
"client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
"client_sign": "0277A3A8C6317C328F3DEE000F67E0D9",
"data": {
"returnGoodsOrderNo" : "RT16000000000684CN",
"originalMerchandiseSerno" : "RM0000000000002634",
"vatNo" : "",
"merchandiseCode" : "auto_sku21",
"specification" : "",
"handleMethod":"DEFECTIVE_SA",
"associateType":"copy",
"newMerchandiseCode": "liao152",
"declareValue" : 10.0,
"remarks" : ""
},
"format": "json",
"language": "zh_CN",
"platform": "sw",
"sign": "1360FE2E76978746F85BE7E574FE1162",
"sign_method": "md5",
"timestamp": "2020-11-04 14:24:56",
"version": "1.0"
}
返回出参
返回参数说明:正确的返回编码code:0及结果data,错误的返回错误码及错误信息msg。
名称 | 类型 | 必传 | 说明 | 示例 |
---|---|---|---|---|
merchandiesInfo | Object | Y | 关联商品的信息 | |
–|nameCn | String | N | 中文名称 | |
–|nameEn | String | N | 英文名称 | |
–|confirmLength | Double | Y | 核实长度 | |
–|confirmWidth | Double | Y | 核实宽度 | |
–|confirmHeight | Double | Y | 核实高度 | |
–|confirmWeight | Double | Y | 核实重量 |
返回示例
{
"code": "0",
"msg": "操作成功",
"data": {
"merchandiesInfo": {
"nameCn": "",
"nameEn": "",
"confirmLength": 30,
"confirmWidth": 22,
"confirmHeight": 20,
"confirmWeight": 100
}
}
}