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

入库通知单推送API用于接收第三方推送入库通知单,实物到库后，现场根据入库通知单进行入库操作

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

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

输入参数

   json:"快递明细",
   userKey: "申请用户",
   userValue: "申请密码"

json参数示例

{
  "consigneeNO": "000001",
  "toWarehouseNO": "A001",
  "type": 13,
  "accept": 0,
  "sourceNO": "HG44678048401016",
  "receiptNoticeInfoDetailList": [
    {
      "goodsNO": "lxjwgoods_30",
      "lots": "20151234",
      "qit": 1,
      "unit": "件",
      "remark": "我是注释",
      "purchasePrice":2.3
    },
    {
      "goodsNO": "lxjwgoods_53",
      "lots": "20151234",
      "qit": 1,
      "unit": "件",
      "remark": "我是注释",
       "purchasePrice":2.3
    },
    {
      "goodsNO": "lxjwgoods_48",
      "lots": "20151234",
      "qit": 1,
      "unit": "件",
      "remark": "我是注释",
     "purchasePrice":2.3
    },
    {
      "goodsNO": "lxjwgoods_40",
      "lots": "20151234",
      "qit": 0,
      "unit": "件",
      "remark": "我是注释",
     "purchasePrice":2.3"
    }
  ]
}

字段解释

字段	中文描述	类型	长度	是否必填	示例值
consigneeNO	收货网点单位编号,具体编号参考:http://www.jianshu.com/p/5fa1d389a3c6	string	11	是	000001
toWarehouseNO	收货仓库编号,具体编号参考:http://www.jianshu.com/p/5fa1d389a3c6	string	11	是	A001
type	入库类型,完整入库类型参考表:入库类型(type)字段	6	int	是	13:委托入库 统一传入13
accept	是否质检	6	int	是	0:不质检 这里统一传入0
sourceNO	来源单号	36	string	是	CG2015092511230919752,来源单号,用于两边对账
receiptNoticeInfoDetailList	入库商品明细	数组	是	.	.

入库类型(type)字段

 PanYing(1, "盘盈"),
  CaiGou(2, "采购入库"),
  QuYang(3, "取样"), 
  ZuHe(4, "组合"), 
  DiaoBo(5, "调拨"), 
  TuiHuo(6,"仓库退换货"), 
  NeiLing(7, "内领"), 
  QiTa(8, "其它入库"), 
  TiaoHuo(9, "调货入库"), 
  //10,11,12,保留
  WeiTuo(13, "委托入库");

入库明细(receiptNoticeInfoDetailList)字段解释

字段	中文描述	类型	长度	是否必填	示例值
goodsNO	商品编号	string	32	是	XYZ10234
lots	批次号	string	36	是	20150912 使用日期格式 YYYYMMDD,仓库出库是以批次为比较依据，先进先出原则
qit	入库数量	int	6	是	1
unit	单位	string	36	是	箱
remark	注释	string	80	否	注释
purchasePrice	采购单价	BigDecimal	12,2	否	采购单价，不为空的情况下最小值不能低于0.01

API返回示例

{
  "data": {
    "sourceNO": "HG07132179431883",
    "receiptNoticeInfoNO": "RN000002417"
  },
  "list": [
    
  ],
  "code": "failed",
  "msg": "入库商品数量必须大于0,入库商品数量必须大于0,入库商品数量必须大于0,入库商品数量必须大于0,",
  "fail": true
}

返回结果字段说明

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