回调说明
-
所有方法 回调参数包含在请求体(requestBody)中, 所有参数按照json格式发送，编码格式为UTF-8
-
回调API授权目前支持accessToken和username/password方式,使用其中之一方式即可
-
所有回调会尝试3次,第三次失败会发生告警邮件, 务必将负责人的email录入到冰河系统
-
回调后必须返回如下json结构数据:
{ "status": "success", "mark": "说明" }
字段说明:
status取值范围 success/fail
mark:处理失败,使用该参数说明 -
回调url格式: pushURL/(方法名)
-
推送是以快递纬度推送路由跟踪信息，黑狗后台已自动判断箱子是否全部送达，暂不支持以箱子纬度推送路由跟踪信息
单据状态回传(针对库内部分，快递部分不需要对接这个接口)
Push URL:/API/V1/updateOrderInfoUpdate
回调参数
{
"operateDatetime":"2016-11-03 17:25:35",
"messageID":1,
"sourceNO":"22463",
"statusCode":0,
"operationUser":"300001",
"accessToken":"53922c8e67b3cb7159a086bb0ca45f6f",
"detailList":[
{
"goodsno":"yhdx636",
"goodsname":"月饼",
"qit":4,
"lots":"201609181",
"locationno":"A01JHZA006"
}
],
"orderinfono":"CKN000396948"
}
参数说明
| 参数名 | 是否必须 | 描述 | 示例 |
|---|---|---|---|
| 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 | 是 | 商品编号 | yhdx636 |
| detailList.goodsname | 是 | 商品名称 | 月饼 |
| detailList.qit | 否 | 数量 | 123 |
| detailList.unit | 否 | 商品规格 | 盒 |
| statusCode | 是 | 状态对应的数字 取值范围，0:成功,1:失败 | 1 |
| orderinfono | 是 | 单据入库后,冰河系统生成的唯一单据号 | SN1234 |
| orderType | 否 | 出库类型 | 1 |
| orderTypeDesc | 否 | 出库类型描述 | 盘亏 |
出库类型 类型使用数字
PanYing(1, "盘亏"),
CaiGou(2, "采购退货"),
ShengChanLinYong(3,"生产领用"),
QuYang(4,"取样"),
PeiSong(5, "配送"),
ZuHe(6, "组合"),
DiaoBo(7,"调拨"),
TuiHuo(8, "仓库退换货"),
NeiLing(9, "内领"),
QiTa(10, "其他出库"),
TiaoHuo(11, "调货出库"),
WeiTuo(12,"委托出库"),
BaoSun(13,"报损"),
HaoYong(14,"耗用"),
WanGongTuiHuo(15,"完工退货"),
//16-30保留
BiaoZhun(30,"标准"),
QueHuo(99, "全部缺货");
网友评论