视频号
取消
中文
中文
EN
取消
  • 介绍

    • # 物流轨迹推送通知

    # 接口说明

    当电子面单对应的物流轨迹发生变化时，视频号小店会通过该接口将消息通知给商家。

    # 注意事项

    • 回调url设置和消息推送规则需参考消息推送文档 ，如果设置的回调url无法访问，商户将无法收视频号小店发送的通知；

    # 请求参数说明

    参数 类型 描述
    ToUserName string UserName
    FromUserName string OpenID
    CreateTime number 事件时间,Unix时间戳
    MsgType string 消息类型,固定为 event
    Event string 事件类型,本接口固定为 ewaybill_push_path
    waybill_info object WaybillInfo 事件主体，结构体详情请参考WaybillInfo

    # 请求参数示例（解密后的明文JSON）

    {
    "ToUserName": "gh_*",
    "FromUserName": "OpenID",
    "CreateTime": 1662480000,
    "MsgType": "event",
    "Event": "ewaybill_push_path",
    "waybill_info": {
       "ewaybill_order_id":123123123123123,
       "waybill_id":"xxxx",
       "update_time":1231231,
       "status":1,
       "desc":"您的快件已签收"
     }
}

    # 返回参数示例

    {
  "ToUserName": "oABCD",
  "FromUserName": "gh_abcdefg",
  "CreateTime": 1533042556,
  "MsgType": "event",
  "Event": "ewaybill_push_path",
  "ResultCode": 0,
  "ResultMsg": "success"
}

    # 结构体

    # WaybillInfo

    事件主体

    参数 类型 是否必填 描述
    ewaybill_order_id UINT64 是 电子面单订单id
    waybill_id String 是 运单号
    update_time UINT32 是 更新时间，单位秒
    status UINT32 是 轨迹节点状态，枚举值详情请参考status
    desc String 是 轨迹节点描述

    # 枚举值

    # status

    轨迹节点状态状态

    枚举值 描述
    0 待揽件
    1 揽收
    2 运输中
    3 派件
    4 入柜
    5 签收
    6 退回
    7 转寄
    8 异常
    9 出柜
    99 其他未知