您可以通过HTTP批量推送方式订阅电商物流详细报告消息(SmartLogisticsReport),获取电商物流节点详情。
前提条件
开通电商物流详细报告消息功能,详情请咨询您的商务经理。
协议说明
参数 | 说明 |
协议 | HTTP + JSON |
编码 | UTF-8 |
请求说明
请求内容为JSON Array格式,单次请求可能会包含多个记录。
请求样例
[{
"cpCode": "YTO",
"mailNo": "YTO3243643****",
"logisticsGmtModified": "2021-12-10 10:00:00",
"city": "成都",
"bizKey": "3243643****",
"logisticsStatusDesc": "已签收",
"lastLogisticDetail": "包裹已签收",
"aliyunprice": "6",
"logisticsStatus": "SIGN",
"outerOrderCode": LP2891241****
}]
字段说明
参数名 | 参数类型 | 是否必选 | 示例 | 描述 |
cpCode | String | 是 | YTO | 物流公司编号。 |
logisticsStatus | String | 是 | SIGN | 物流详情节点类型。
|
mailNo | String | 是 | YTO3243643**** | 快递单号。 |
logisticsStatusDesc | String | 是 | 已签收 | 包裹状态描述。 |
lastLogisticDetail | String | 是 | 包裹已签收 | 最后一条物流详情信息。 |
logisticsGmtModified | String | 是 | 2021-12-10 10:00:00 | 最后一条物流详情的变更时间。 |
packageDyn | String | 否 | {} | 扩展字段JSON。当logisticsStatus为已揽收时,重量信息将会出现在此字段中,单位g,{"weight": 1223.3}。 |
aliyunprice | String | 否 | 6 | 阿里云计费价格,单位:元。按照从揽收开始T+3之内价格有效,支持更新。 |
city | String | 是 | 成都 | 当前物流所在城市。 |
bizKey | String | 是 | 3243643**** | 日志key。 |
outerOrderCode | String | 是 | LP2891241**** | 物流订单下单时传入的订单号。 |
响应说明
响应样例
{
"code" : 0,
"msg" : "接收成功"
}
字段说明
名称 | 类型 | 是否必选 | 示例值 | 描述 |
code | Number | 是 | 0 | 应答编码。 |
msg | String | 否 | 接收成功 | 描述信息。 |
说明
系统仅校验返回值的code是否为数字,不校验内容。若HTTP状态码为200,请求成功。HTTP状态码非200或响应超时情况下,系统会进行重试推送。
若出现系统异常、消费失败等情况,建议HTTP响应码返回50X。
重新推送
第一次推送失败后,间隔1分钟、5分钟、10分钟后会进行重推,直至推送成功为止。如果推送3次后仍失败,不再重试。
文档内容是否对您有帮助?