用于(OMS---WMS)销售订单状态,快递(Express)状态回传，不适用出入库通知单状态回传

回调说明

1. 所有方法 回调参数包含在请求体(requestBody)中, 所有参数按照json格式发送，编码格式为UTF-8

2. 回调API授权目前支持accessToken和username/password方式,使用其中之一方式即可

3. 所有回调会尝试3次,第三次失败会发生告警邮件, 务必将负责人的email录入到冰河系统

4. 回调后必须返回如下json结构数据:
   { "status": "success", "mark": "说明" }
   字段说明:
   status取值范围 success/fail
mark:处理失败,使用该参数说明

5. 回调url格式: pushURL/(方法名)
   解释说明:
   pushURL：调用方接收地址 （例如： http://xxxxx/xxx/xxx/xxx）
方法名:黑狗对应的回调方法名 （例如 ：/API/V1/updateOrderStatus）
实际回调地址为 : http://xxxxx/xxx/xxx/xxx/API/V1/updateOrderStatus

6. 推送是以快递纬度推送路由跟踪信息，黑狗后台已自动判断箱子是否全部送达，暂不支持以箱子纬度推送路由跟踪信息

Push URL:/API/V1/updateOrderStatus (没有.do后缀)

状态回调流程如下:

快递订单状态回传

返回订单在冰河系统产生的快递跟踪信息,电商网站可以直接使用返回的信息轨迹,显示给用户查看。黑狗快递查询官方地址:[http://higo-express.com/traking.html?waybillID=4000226100],类似下图:

![快递流转信息][3]

回调参数

{
  "messageID":1234,
  "operateDatetime": "2015-09-14 18:02:58",
  "operationUser": "张三",
  "accessToken": "123457",
  "accessUserName": "accessUserName",
  "accessPassword": "123456",
  "sourceNO": "DX123456789",
  "waybillID": "SA12345678",
  "statusDesc": "订单打包中",
  "statusCode": 4,
  "remark":"备注信息",
  "courier": "申玉龙",
  "courierPhone":"13301070965",
  "reason": "xxxxxxxx"
}

参数说明

statusCode取值范围

订单对应状态能否调用取消订单,拦截订单API

单据状态回传(针对库内部分，快递部分不需要对接这个接口)

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"
}

参数说明