冰河系统(OMS)商品信息推送API.md

商品信息推送,重复推送,可以实现商品信息更新
注意 温区,规格,单位不允许修改

测试API URL POST http://qa.higo-express.cn/saveOrUpdateExternalGoods.action
正式API URL POST http://oms.higo-express.cn/saveOrUpdateExternalGoods.action

调用方式:模拟表单提交,json,userKey,userValue参数,其中 json参数的值为标准JSON格式的字符串,注意转义json相关字符,具体字段含义参考字段要求

输入参数

   json:"明细信息",
   userKey: "MRYX-TEST",
   userValue: "MRYX123456"

json参数示例

{
"goodsNO": "40041234", 
"goodsName": "黄香蕉苹果", 
"unit": "KG", 
"model": "", 
"temperatureType": 1
}

json参数字段说明

字段 中文描述 类型 长度 是否必填 示例值
goodsNO 商品编码 String 64 Y
goodsName 商品名称 String 80 Y 黄香蕉苹果
unit 单位 String 8 Y
model 规格 String N 不必填字段 500个/箱
temperatureType 温区 int 1 Y 1
periodDate 保质期 天 int N 如果不需要保质期,可以不用传此字段 365

温区类型(temperatureType )字段说明

  CW(1, "常温"),

  /** 冷冻类型 **/
  LD(2, "冷冻"),

  /** 冷藏类型 **/
  LC(3, "冷藏"),

API返回示例

{
  "code": "success",
  "data": {
    "createDate": "2016-04-20 16:13:11",
    "goodsNO": "urfresh_1110001472",
    "goodsName": "2016041901",
    "model": "KG",
    "state": 1,
    "temperatureType": 1,
    "unit": "千克"
  },
  "msg": "保存成功"
}

返回结果字段说明

字段 中文描述
data 商品信息
list 保留字段,可以忽略
code 成功,失败标志,failed/success
msg 错误说明
fail 标识成功失败

代码请求示例

  @Test
  public void testPushGoods() throws IllegalAccessException, InvocationTargetException {

    String json = "{" + "\"goodsNO\":\"urfresh_urfresh_1110001551\"," + "\"goodsName\":\"黑狗测试商品13\"," + "\"unit\":\"千克\"," + "\"model\":\"1\","
        + "\"temperatureType\":\"3\"" + "}";
    HigoLogUtils.logInfo(json);
    String url = "http://qa.higo-express.cn/saveOrUpdateExternalGoods.action";
    List postParams = new ArrayList();
    postParams.add(new BasicNameValuePair("json", json));
    postParams.add(new BasicNameValuePair("userKey", "xxx"));
    postParams.add(new BasicNameValuePair("userValue", "xxx"));
    postParams.add(new BasicNameValuePair("datatime", DateUtils.formatDate2Str(new Date(), "yyyyMMhhHHmmss")));

    BingHeHttpPostRequest bingHeHttpPostRequest = new BingHeHttpPostRequest();
    bingHeHttpPostRequest.setRequestUrl(url);
    bingHeHttpPostRequest.setPostParams(postParams);
    bingHeHttpPostRequest.setContenttype(MediaType.APPLICATION_FORM_URLENCODED_VALUE);
    String re = BingHeHttpClientWrapper.sendHttpPost(bingHeHttpPostRequest);
    HigoLogUtils.debug(re);

  }

你可能感兴趣的:(冰河系统(OMS)商品信息推送API.md)