接口说明

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
                   }
          }
     }

关键词