接口说明

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	O	关联商品的信息退货单处理方式为良品上架或不良品上架才会返回销毁暂不返回关联商品
– nameCn	String	N	中文名称
– nameEn	String	N	英文名称
– confirmLength	Double	N	核实长度
– confirmWidth	Double	N	核实宽度
– confirmHeight	Double	N	核实高度
– confirmWeight	Double	N	核实重量

返回示例

{
        "code": "0",
        "msg": "操作成功",
        "data": {
                  "merchandiesInfo": {
                         "nameCn": "",
                         "nameEn": "",
                         "confirmLength": 30,
                         "confirmWidth": 22,
                         "confirmHeight": 20,
                         "confirmWeight": 100
                   }
          }
     }

关键词