API
更新退货单商品信息
更新时间: 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 备注

请求示例

  1. {
  2. "action": "rma.returnGoodsOrder.updateMerchandise",
  3. "app_key": "rebecca",
  4. "client_id": "ODJKMDU1YZCTYJQ5YY00ZWZLLTK5N2QTOWY4MZI5OGMWNDG2",
  5. "client_sign": "0277A3A8C6317C328F3DEE000F67E0D9",
  6. "data": {
  7. "returnGoodsOrderNo" : "RT16000000000684CN",
  8. "originalMerchandiseSerno" : "RM0000000000002634",
  9. "vatNo" : "",
  10. "merchandiseCode" : "auto_sku21",
  11. "specification" : "",
  12. "handleMethod":"DEFECTIVE_SA",
  13. "associateType":"copy",
  14. "newMerchandiseCode": "liao152",
  15. "declareValue" : 10.0,
  16. "remarks" : ""
  17. },
  18. "format": "json",
  19. "language": "zh_CN",
  20. "platform": "sw",
  21. "sign": "1360FE2E76978746F85BE7E574FE1162",
  22. "sign_method": "md5",
  23. "timestamp": "2020-11-04 14:24:56",
  24. "version": "1.0"
  25. }

返回出参

返回参数说明:正确的返回编码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 核实重量

返回示例

  1. {
  2. "code": "0",
  3. "msg": "操作成功",
  4. "data": {
  5. "merchandiesInfo": {
  6. "nameCn": "",
  7. "nameEn": "",
  8. "confirmLength": 30,
  9. "confirmWidth": 22,
  10. "confirmHeight": 20,
  11. "confirmWeight": 100
  12. }
  13. }
  14. }
关键词