入库通知单推送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 | 注释 |
网友评论