微信小店
取消
中文
中文
EN
取消
  • 微信小店

    • # 物流轨迹推送通知

    本文档描述服务器端接收的消息或事件，详细说明参见消息推送。

    事件英文名：ewaybill_push_path

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

    相关 API 接口：ewaybill_getorder

    # 1. 消息参数

    # 请求体 Request Payload

    参数名类型说明
    ToUserNamestringUserName
    FromUserNamestringOpenID
    CreateTimenumber事件时间,Unix时间戳
    MsgTypestring消息类型,固定为event
    Eventstring事件类型,本接口固定为ewaybill_push_path
    waybill_infoobject事件主体

    # Body.waybill_info Object Payload

    事件主体

    参数名类型说明枚举
    ewaybill_order_idUINT64电子面单订单id-
    waybill_idString运单号-
    update_timeUINT32更新时间，单位秒-
    statusUINT32轨迹节点状态枚举值
    descString轨迹节点描述-

    # 2. 消息返回

    # 返回体 Response Payload

    回复 success 或空字符串（无需加密）

    # 3. 枚举信息

    # Body.waybill_info.status Enum

    轨迹节点状态

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

    # 4. 注意事项

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

    # 5. 代码示例

    请求示例

    {
    "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"
}