冰河系统出库通知单推送API_V1.0.md

出库通知单API用于推送除配送和标准类型的出库单据

测试API URL POST http://test.higo-express.cn/wms/api/v1/orderinfo/pushOrderInfo.do
正式API URL POST http://oms.higo-express.cn/wms/api/v1/orderinfo/pushOrderInfo.do

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

输入参数

   json:"快递明细",
   userKey: "MRYX-TEST",
   userValue: "MRYX123456"

json参数示例

{
  "consignerNO": "000001",
  "fromWarehouseNO": "A001",
  "type": 13,
  "remark": "注释信息1",
  "sourceNO": "HG78957944620069",
  "details": [
    {
      "goodsNO": "mryx1000133",
      "outstockqit": 2,
      "remark": "我是注释2",
      "unit": "个"
    },
    {
      "goodsNO": "mryx1000362",
      "outstockqit": 1,
      "remark": "我是注释2",
      "unit": "个"
    },
    {
      "goodsNO": "mryx1000416",
      "outstockqit": 1,
      "remark": "我是注释2",
      "unit": "个"
    },
    {
      "goodsNO": "mryx1000352",
      "outstockqit": 2,
      "remark": "我是注释2",
      "unit": "个"
    }
  ]
}

json参数字段说明

字段	中文描述	类型	长度	是否必填	示例值
consignerNO	发货网点单位编号,具体编号参考:http://www.jianshu.com/p/5fa1d389a3c6	string	11	是	000001
fromWarehouseNO	发货仓库编号,具体编号参考:http://www.jianshu.com/p/5fa1d389a3c6	string	11	是	A001
type	出库类型,完整入库类型参考表:出库类型(type)字段说明	6	int	是	2:采购退货
sourceNO	来源单号	36	string	是	CG2015092511230919752,来源单号,用于两边对账
details	出库商品明细	数组	是

出库类型(type)字段说明

  PanKui(1, "盘亏"), 
  CaiGou(2, "采购退货"), 
  ShengChanLinYong(3, "生产领用"), 
  QuYang(4, "取样"), 
  ZuHe(6, "组合"), 
  DiaoBo(7, "调拨"), 
  TuiHuo(8, "仓库退换货"), 
  NeiLing(9, "内领"), 
  QiTa(10,"其它出库"), 
  TiaoHuo(11, "调货出库"), 
  WeiTuo(12, "委托出库"),
  BaoSun(13, "报损"), 
  HaoYong(14, "耗用"),
  WanGongTuiHuo(15, "完工退货");

出库明细(details)说明

字段	中文描述	类型	长度	是否必填	示例值
goodsNO	商品编号	string	32	是	XYZ10234
outstockqit	入库数量	int	6	是	1
lots	批次号	string	36	是
unit	单位	string	36	是	箱
remark	注释	string	80	否	注释

API返回示例

{
  "data": {
    "sourceNO": "HG07132179431883",
    "orderInfoNO": "CK000000894"
  },
  "list": [
    
  ],
  "code": "failed",
  "msg": "错误提示信息",
  "fail": true
}

返回结果字段说明

字段	中文描述
data	sourceNO:来源单号,orderInfoNO:冰河系统生成的对应出库单单号
list	保留字段,可以忽略
code	成功,失败标志,failed/success
msg	错误说明
fail	注释