您可以通过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 物流详情节点类型。
    • WAIT：待接单。
    • ACCEPT：已接单。
    • GOT：已揽收。
    • MODIFY_WEIGHT：更新重量。
    • TRANSPORT：运输中。
    • DELIVERING：派送中。
    • 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次后仍失败，不再重试。