冰河系统(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);

  }