SmartLogisticsReport

您可以通过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****
}]

字段说明

参数名参数类型是否必选示例描述
cpCodeStringYTO物流公司编号。
logisticsStatusStringSIGN物流详情节点类型。
  • WAIT:待接单。
  • ACCEPT:已接单。
  • GOT:已揽收。
  • MODIFY_WEIGHT:更新重量。
  • TRANSPORT:运输中。
  • DELIVERING:派送中。
  • SIGN:已签收。
mailNoStringYTO3243643****快递单号。
logisticsStatusDescString已签收包裹状态描述。
lastLogisticDetailString包裹已签收最后一条物流详情信息。
logisticsGmtModifiedString2021-12-10 10:00:00最后一条物流详情的变更时间。
packageDynString{}扩展字段JSON。当logisticsStatus为已揽收时,重量信息将会出现在此字段中,单位g,{"weight": 1223.3}。
aliyunpriceString6阿里云计费价格,单位:元。按照从揽收开始T+3之内价格有效,支持更新。
cityString成都当前物流所在城市。
bizKeyString3243643****日志key。
outerOrderCodeStringLP2891241****物流订单下单时传入的订单号。

响应说明

响应样例

{
  "code" : 0,
  "msg" : "接收成功"
}

字段说明

名称

类型

是否必选

示例值

描述

code

Number

0

应答编码。

msg

String

接收成功

描述信息。

说明
  • 系统仅校验返回值的code是否为数字,不校验内容。若HTTP状态码为200,请求成功。HTTP状态码非200或响应超时情况下,系统会进行重试推送。

  • 若出现系统异常、消费失败等情况,建议HTTP响应码返回50X。

重新推送

第一次推送失败后,间隔1分钟、5分钟、10分钟后会进行重推,直至推送成功为止。如果推送3次后仍失败,不再重试。