回调说明
-
所有方法 回调参数包含在请求体(requestBody)中, 所有参数按照json格式发送，编码格式为UTF-8
-
回调API授权目前支持accessToken和username/password方式,使用其中之一方式即可
-
所有回调会尝试3次,第三次失败会发生告警邮件, 务必将负责人的email录入到冰河系统
-
回调后必须返回如下json结构数据:
{ "status": "success", "mark": "说明" }
字段说明:
status取值范围 success/fail
mark:处理失败,使用该参数说明 -
回调url格式: pushURL/(方法名)
-
推送是以快递纬度推送路由跟踪信息，黑狗后台已自动判断箱子是否全部送达，暂不支持以箱子纬度推送路由跟踪信息
单据状态回传(针对库内部分，快递部分不需要对接这个接口)
Push URL:/API/V1/updateReceiptStatus
回调参数
{
"messageID":1234,
"operateDatetime": "2015-09-15 10:43:22",
"sourceNO": "DX123456789",
"statusDesc": "入库成功",
"statusCode": 0,
"accessToken": "123457",
"accessUserName": "accessUserName",
"accessPassword": "123456",
"remark": "备注",
"detailList": [
{
"goodsNO": "LJ13234",
"qit": 234,
"unit": "盒"
}
],
"recepitNO": "SN1234355"
}
参数说明
| 参数名 | 是否必须 | 描述 | 示例 |
|---|---|---|---|
| messageID | 是 | 消息唯一标识,防止重复推送 | 1234 |
| operateDatetime | 是 | 发生时间 | 2015-09-14 18:02:58 |
| operationUser | 是 | 操作人 | 张三 |
| accessToken | 否 | 授权token,token,accessUserName,accessPassword参数只能取一种 | 123457 |
| accessUserName | 否 | 授权用户名 | accessUserName |
| accessPassword | 否 | 授权密码 | 123456 |
| sourceNO | 否 | 传入黑狗的原始单号，如果有 | DX123456789 |
| detailList | 是 | 单据确认明细 ,注意,一个入库通知单,会有多条入库确认通知,调用方，需要根据入库通知单总量进行比较,判断消息推送是否合法,冰河保证总量一致,不保证一次推送当前入库通知单所有确认信息 | |
| detailList.goodsNO | 否 | 商品编号 | SA12345678 |
| detailList.qit | 否 | 数量 | 123 |
| detailList.unit | 否 | 商品规格 | 盒 |
| statusDesc | 否 | 状态描述 | 成功,失败 |
| statusCode | 是 | 状态对应的数字 取值范围，0:成功,1:失败 | 1 |
| remark | 否 | 备注信息 | 备注 |
| recepitNO | 是 | 单据入库后,冰河系统生成的唯一单据号 | SN1234 |
| receiptType | 否 | 入库类型 | 1 |
| receiptTypeDesc | 否 | 入库类型描述 | 盘盈 |
入库类型 参数为数字
PanYing(1, "盘盈"),
CaiGou(2, "采购入库"),
QuYang(3, "取样"),
ZuHe(4, "组合"),
DiaoBo(5, "调拨"),
TuiHuo(6,"仓库退换货"),
NeiLing(7, "内领"),
QiTa(8, "其他入库"),
TiaoHuo(9, "调货入库"),
//10,11,12,保留
WeiTuo(13, "委托入库");
网友评论