快递地址匹配信息推送API_V1.10.md

用于快递订单第一次推送时,未返回地址匹配结果的场景;人工匹配地址后,推送对应的目的站点给供方/调用方,调用方将对应的目的站点打印在面单上

回调说明

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

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

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

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

  5. 回调url格式: pushURL/方法名

状态回调流程如下:

快递订单地址匹配结果回传

返回快递订单在人工匹配目的站点后的结果

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

回调参数

{
  "messageID": 8247475167384569344,
  "sourceNO": "JB00000095472",
   "waybillID":"3000577684",
  "statusCode": 0,
  "beginStop":"大兴RDC/黄村分站"
  "destStop": "大兴RDC/黄村分站",
  "accessToken": "123457",
  "accessUserName": "accessUserName",
  "accessPassword": "123456"

}

参数说明

字段名 是否必须 描述 示例
messageID 消息标识 8247475167384569344
beginStop 匹配成功的始发站点 大兴RDC/黄村分站
destStop 匹配成功的目的站点 大兴RDC/黄村分站
accessToken 授权token,token,accessUserName,accessPassword参数只能取一种 123457
accessUserName 授权用户名 accessUserName
accessPassword 授权密码 123456
sourceNO 来源单号,传入黑狗的原始单号 DX123456789
waybillID 运单号,面单上打印的运单号 SA12345678
statusCode 暂时不用 4

黑狗面单格式如下

黑狗面单格式

你可能感兴趣的:(快递地址匹配信息推送API_V1.10.md)