小程序
取消
开发
中文
EN
取消
  • 平台能力

    • # 散单寄件

    「散单寄件功能」开放快递公司接入，应用在“微信快递服务”寄快递、发货组件发货、退货组件退货等场景，用户无需快递公司结算账号，即可直接在微信移动端完成下单至快递公司，实现快递员上门取件、支付运费。

    # 产品优势

    1. 承接微信生态内散单场景寄快递需求；
    2. 无需申请快递公司结算账号，一键下单，在线支付；
    3. 提升用户回访：关键物流状态会通过微信服务通知发送给用户，用户点击后可回访快递公司小程序查看该运单的物流状态或进行后续操作。

    # 接入流程

    # 1.邮件申请

    发送申请邮件至wxwuliu@tencent.com

    【邮件标题】 快递公司名称 - 散单寄件接入申请

    【邮件内容】 快递公司名称、快递公司logo、小程序appid（小程序需要完成微信认证）、对接人微信号/手机号

    【邮件附件】《营业执照》、《快递业务经营许可证》扫描件

    我们会在收到邮件后的1个工作日内进行反馈。

    # 2.协议签署

    符合接入要求的快递公司，会收到邮件回复，包含接入指引和《合作协议》。

    # 3.开发调试

    1. 按照下方接口文档设计和开发，其中部分信息需要由微信协助配置
    2. 以邮件和微信群形式沟通

    # 4.审核发布

    接口开发完成，微信侧确认，通过性能和安全审核后发布。 发布后微信生态内用户可以向快递公司下散单。

    # 接入前准备

    # 1.小程序

    用户收到轨迹更新消息后，可以间接跳转到快递小程序的轨迹详情页。至少需要提供两个页面：

    1. 快递轨迹详情页，路径可以参考 pages/info/info?from=wx&no=12345678901234 。微信做跳转时，会传入运单号。
    2. 快递投诉页面

    # 2.小程序事件服务

    事件服务用于接收微信的推送，目前有下单、取消运单等事件。

    # 3.接入运力公司配置信息

    配置信息 释义
    快递编码，英文大写字母 如：BEST、JDL、YUNDA、ZTO
    快递公司中文名称 如：百世、京东、韵达、中通
    小程序appid 用于接受事件推送消息的小程序appid
    客服电话 用于接收用户反馈的官方客服电话
    logo 公司logo
    默认揽件规则 用于兜底的揽件规则 格式见下方默认揽件规则数据格式
    支持的支付方式 0@寄付
    支持的货物重量 min
    是否支持保价 0-不支持 1-策略支持
    最大保价价值 如： 30000（单位元）
    最小保价价值 如：1（单位元）
    默认的保价策略 格式 value@type@fee/rate
    支持等级 取值0-3 表示支持的接口优先级类型 表示P0-P3

    默认揽件规则数据格式： 提供time与tips两列数据，案例如下

    time tips 含义
    9 今天11:00前上门 0:00-8:59下单展示"今天11:00前上门"
    17 两小时上门 9:00-16:59下单时展示"两小时上门"
    24 明天11:00前上门 17:00-23:59下单展示"明天11:00前上门"

    # 相关接口

    1.接口概览
    2.运力接口

    # 1.接口概览

    【微信快递服务散单接入】在线支付-微信支付普通支付

    【微信快递服务散单接入】在线支付-微信支付分后付

    【微信快递服务散单接入】线下支付

    # 2.运力接口

    # 2.1 基础功能

    callback接口需要在mp页面里设置服务器地址。

    https://developers.weixin.qq.com/miniprogram/dev/framework/server-ability/message-push.html

    # 2.1.1 通过收发件地址查询标准运费(callback3)

    用户在下单页面选择收发货地址时进行查询

    • 请求参数
    属性 类型 说明 是否必填
    ToUserName string 快递公司小程序 UserName 是
    FromUserName string 微信团队的 OpenID （固定值） 是
    CreateTime number 事件时间，Unix时间戳 是
    MsgType string 消息类型，固定为 event 是
    Event string 事件类型，固定为 query_single_waybill_fee，不区分大小写 是
    Sender Object<Addr> 发件人信息 是
    Receiver Object<Addr> 收件人信息 是
    GoodDetail Object<GoodDetail> 物品详情 是
    Scene number 1 C端散单, 2 B端退货, 3 B端发货 是
    • 返回参数
    属性 类型 说明 是否必填
    ToUserName string 原样返回请求中的 FromUserName 是
    FromUserName string 快递公司小程序 UserName 是
    CreateTime number 事件时间，Unix 时间戳 是
    MsgType string 消息类型，固定为 event 是
    Event string 事件类型，固定为 query_single_waybill_fee，不区分大小写 是
    ResultCode number 处理结果错误码 是
    ResultMsg string 处理结果的详细信息 否
    Fee number 预估运费，单位元（折后价） 是
    OriginalFee number 预估运费，单位元（原价） 否
    # 2.1.2 下单(callback1)
    • 请求参数
    属性 类型 说明 是否必填
    ToUserName string 快递公司小程序UserName 是
    FromUserName string 微信团队的OpenID（固定值） 是
    CreateTime number 事件时间，Unix时间戳 是
    MsgType string 消息类型，固定为event 是
    Event string 事件类型，固定为add_single_waybill，不区分大小写 是
    Token string 订单Token。请保存该Token，更新运单轨迹时需要传入，长度需预留256个字符 是
    WXAppId string 商户微信小程序的appid 是
    OrderID string 商户订单ID，可以使用token而不用这个字段 是
    Sender Object<Addr> 发件人信息 是
    Receiver Object<Addr> 收件人信息 是
    GoodDetail Object<GoodDetail> 物品详情 是
    Insured Object<Insured> 保价信息 否
    ExpectStartTime number 期望上门取件起始时间 否
    ExpectEndTime number 期望上门取件结束时间 否
    Settingment number 结算方式默认0现结，1到付,2月结,3支付分 否
    CompanyID string 中通大客户CompanyID，结算方式为2，且选中通时需填 否
    Account string 月结账号，结算方式为2时需填 否
    AccountPwd string 月结账号密码结算方式为2时需填 否
    Remark string 备注信息 否
    PickUpStartTime number 上门时间段（开始时间） 否
    PickUpEndTime number 上门时间段（结束时间） 否
    Scene number 1 C端散单, 2 B端退货, 3 B端发货 是
    • Addr结构
    属性 类型 说明 是否必填
    Name string 收件人姓名 是
    Tel string 收件人座机号码 Tel和Mobile至少填一项
    Mobile string 收件人手机号码 Tel和Mobile至少填一项
    Province string 省份，比如"广东省" 是
    City string 地区/市，比如"广州市" 是
    Area string 区/县，比如"海珠区" 是
    Street string 街道，比如新港中路 是
    Address string 详细地址，比如"XX路XX号XX大厦XX" 是
    Id string 地址id 是
    • GoodDetail结构
    属性 类型 说明 是否必填
    Weight number 货物总重量，比如1.2，单位是千克(kg) 否，默认1
    Special number 物品类型，见物品类型说明 否，默认0
    • 物品类型Special字段说明
    类型 说明
    0 文件类
    1 电子产品类(包括家用电器)
    2 办公用品类,服装鞋帽，箱包类
    3 化妆品，美容产品类
    4 珠宝，手表，眼镜，贵重饰品类
    5 食品，保健药品类
    6 工艺品类(包括瓷器，茶具，烹饪用品)
    7 玩具乐器类
    8 其他类
    • Insured结构
    属性 类型 说明
    UseInsured number 是否保价，0表示不保价，1表示保价，默认0
    InsuredValue number 保价金额，单位是分，比如:10000表示100元
    • 返回参数
    属性 类型 说明 是否必填
    ToUserName string 原样返回请求中的FromUserName 是
    FromUserName string 快递公司小程序UserName 是
    CreateTime number 事件时间，Unix时间戳 是
    MsgType string 消息类型，固定为event 是
    Event string 事件类型，固定为add_single_waybill，不区分大小写 是
    ResultCode number 处理结果错误码 是
    ResultMsg string 处理结果的详细信息 否
    WayBillID string 运单ID，如果不能立即返回，可以在打印面单时候回调通知微信端 否
    EstimatedDeliveryTime string 预计送达时间，格式：yyyy-mm-dd 否
    JumpPath string 下单成功后跳转的地址（appid需要联系微信进行登记配置） 否
    PickCode string 取件码 否
    # 2.1.3 取消订单(callback2)
    • 请求参数
    属性 类型 说明 是否必填
    ToUserName string 快递公司小程序 UserName 是
    FromUserName string 微信团队的 OpenID （固定值） 是
    CreateTime number 事件时间，Unix时间戳 是
    MsgType string 消息类型，固定为 event 是
    Event string 事件类型，固定为 cancel_single_waybill，不区分大小写 是
    Token string 下单接口传的Token 是
    WXAppId string 商户在微信端的appid 是
    OrderID string 商户订单 ID，可以使用token而不用这个字段 是
    WayBillID string 运单 ID，不一定有 否
    CancelID number 取消原因Id 是
    CancelReason string 取消原因说明 否
    • CancelID定义
    值 说明
    1 不想寄了
    2 下错单
    3 重复下单
    4 运费太贵
    5 无人联系
    6 取件太慢
    7 态度差
    8 其它原因
    • 返回参数
    属性 类型 说明 是否必填
    ToUserName string 原样返回请求中的 FromUserName 是
    FromUserName string 快递公司小程序 UserName 是
    CreateTime number 事件时间，Unix 时间戳 是
    MsgType string 消息类型，固定为 event 是
    Event string 事件类型，固定为 cancel_single_waybill，不区分大小写 是
    ResultCode number 处理结果错误码 是
    ResultMsg string 处理结果的详细信息 否
    # 2.1.4 查单(callback10)
    • 请求参数
    属性 类型 说明 是否必填
    ToUserName string 快递公司小程序UserName 是
    FromUserName string 微信团队的OpenID（固定值） 是
    CreateTime number 事件时间，Unix时间戳 是
    MsgType string 消息类型，固定为event 是
    Event string 事件类型，固定为query_single_waybill，不区分大小写 是
    Token string 订单Token，下单时传入的值 是
    WXAppId string 下单的小程序的appid 是
    WaybillId string 运单号，运力方如有更新会同步带上 否
    OrderID string 订单ID，可以使用token而不用这个字段 是
    • 返回参数
    属性 类型 说明 是否必填
    ToUserName string 原样返回请求中的FromUserName 是
    FromUserName string 快递公司小程序UserName 是
    CreateTime number 事件时间，Unix时间戳 是
    MsgType string 消息类型，固定为event 是
    Event string 事件类型，固定为query_single_waybill，不区分大小写 是
    ResultCode number 处理结果错误码 是
    ResultMsg string 处理结果的详细信息 否
    WayBillID string 运单ID，已生成时必填 否
    Sender Object<Addr> 发件人信息 否
    Receiver Object<Addr> 收件人信息 否
    GoodDetail Object<GoodDetail> 物品详情 否
    Insured Object<Insured> 保价信息 否
    PathInfo object<Path> 轨迹信息 否
    Fee number 运单所需要支付的费用，单位分，费用确定时必填 否
    OriginalFee number 原价，单位分 否
    OnlinePay number 是否支持在线支付，0-不支持，1-支持在线支付 是
    PayResult number 支付结果 0-未支付 1-线上支付完成 2-线下支付完成 是
    • Addr结构
    属性 类型 说明 是否必填
    Name string 收件人姓名 是
    Tel string 收件人座机号码 Tel和Mobile至少填一项
    Mobile string 收件人手机号码 Tel和Mobile至少填一项
    Province string 省份，比如"广东省" 是
    City string 地区/市，比如"广州市" 是
    Area string 区/县，比如"海珠区" 是
    Street string 街道，比如新港中路 否
    Address string 详细地址，比如"XX路XX号XX大厦XX" 是
    • GoodDetail结构
    属性 类型 说明 是否必填
    Weight number 货物总重量，比如1.2，单位是千克(kg) 否，默认1
    Special number 物品类型，见物品类型说明 否，默认0
    • 物品类型Special字段说明
    类型 说明
    0 文件类
    1 电子产品类(包括家用电器)
    2 办公用品类,服装鞋帽，箱包类
    3 化妆品，美容产品类
    4 珠宝，手表，眼镜，贵重饰品类
    5 食品，保健药品类
    6 工艺品类(包括瓷器，茶具，烹饪用品)
    7 玩具乐器类
    8 其他类
    • Insured结构
    属性 类型 说明
    UseInsured number 是否保价，0表示不保价，1表示保价，默认0
    InsuredValue number 保价金额，单位是分，比如:10000表示100元
    • Path结构
    属性 类型 说明 是否必填
    path_info array<PathInfo> 轨迹内容 是
    • PathInfo结构（每一项结构相同）
    属性 类型 说明 是否必填
    action_time number 轨迹变化Unix时间戳 是
    action_type number 轨迹变化类型，与普通单保持一致，参见附录action_type定义 是
    action_msg string 轨迹变化具体信息说明，展示在快递轨迹详情页中。若有手机号码，则直接写11位手机号码。使用UTF-8编码。 是
    pickup_courier_name string 取件员姓名,当分配取件员成功时返回 否
    pickup_courier_phone string 取件员电话,当分配取件员成功时返回 否
    delivery_courier_name string 派件员姓名,当分配派件员成功时返回 否
    delivery_courier_phone string 派件员电话,当分配派件员成功时返回 否
    # 2.1.5 运力更新订单状态(api1)

    • 请求地址

      POST https://api.weixin.qq.com/cgi-bin/express/delivery/single_waybill/update?access_token=ACCESS_TOKEN

    • 请求参数

    属性 类型 说明 是否必填
    access_token string 接口调用凭证 是
    token string 商户侧下单事件中推送的Token字段 是
    waybill_id string 运单ID 否
    action_time number 轨迹变化Unix时间戳 是
    action_type number 轨迹变化类型，与普通单保持一致，参见附录action_type定义 是
    action_msg string 轨迹变化具体信息说明，展示在快递轨迹详情页中。若有手机号码，则直接写11位手机号码。使用UTF-8编码。 是
    pickup_courier_name string 取件员姓名 当分配取件员成功时返回
    pickup_courier_phone string 取件员电话 当分配取件员成功时返回
    delivery_courier_name string 派件员姓名 当分配派件员成功时返回
    delivery_courier_phone string 派件员电话 当分配派件员成功时返回
    • 返回参数
    属性 类型 说明 是否必填
    errcode number 错误码 是
    errmsg string 错误信息 是
    # 2.1.6 运力更新需支付的运费(api2)

    支付分订单更新运费接口，须保证该订单状态不是待揽件状态。正常流程是：用户下支付分订单，运力公司调用更新订单状态接口，然后再调用更新运费接口。

    • 请求地址：https://api.weixin.qq.com/cgi-bin/express/delivery/single_waybill/fee?access_token=ACCESS_TOKEN

    • 请求方法： POST application/json

      • 请求参数
    属性 类型 说明 是否必填
    access_token string 接口调用凭证 是
    token string 商户侧下单事件中推送的 Token 字段 是
    waybill_id string 运单 ID 否(waybill_id在调用此接口时必须存在，如果本接口不传，那么就需要下单时返回或者运力更新订单状态接口更新waybill_id)
    need_pay number 是否需要用户在线支付， 0不需要，1需要，2需要(支付分) 是
    fee number 需要支付的金额（一般等于original_fee，如有优惠则填最终需要支付的金额），单位分 是
    original_fee number 原价（base_fee+insured_fee+other_fee），单位分 是
    base_fee number 运费，单位分 是
    insured_fee number 保价费，单位分 否
    other_fee number 其他费用，单位分 否
    remark number 其他费用备注 否
    pay_goods_name string 商品名称（对应微信支付商品详情页上的商品名称） 否
    • 返回参数
    属性 类型 说明 是否必填
    errcode number 错误码 是
    errmsg string 错误信息 是
    # 2.1.7 运力取消订单(api5)

    运力公司取消订单

    • 请求地址：https://api.weixin.qq.com/cgi-bin/express/delivery/single_waybill/cancel_order?access_token=ACCESS_TOKEN

    • 请求方法： POST application/json

      • 请求参数
    属性 类型 说明 是否必填
    access_token string 接口调用凭证 是
    token string 商户侧下单事件中推送的 Token 字段 是
    reason string 取消的原因 是
    • 返回参数
    属性 类型 说明 是否必填
    errcode number 错误码 是
    errmsg string 错误信息 是
    # 2.2 催单功能
    # 2.2.1 查询所在城市的预约时间段(callback9)
    • 请求参数
    属性 类型 说明 是否必填
    ToUserName string 快递公司小程序 UserName 是
    FromUserName string 微信团队的 OpenID （固定值） 是
    CreateTime number 事件时间，Unix时间戳 是
    MsgType string 消息类型，固定为 event 是
    Event string 事件类型，固定为 waybill_query_expect_time_range，不区分大小写 是
    WXAppId string 商户在微信端的appid 是
    Province string 省份，比如"广东省" 是
    City string 地区/市，比如"广州市" 是
    Area string 区/县，比如"海珠区" 是
    Street string 街道 是
    Address string 详细地址 是
    Id string 地址id 是
    • 返回参数
    属性 类型 说明 是否必填
    ToUserName string 原样返回请求中的 FromUserName 是
    FromUserName string 快递公司小程序 UserName 是
    CreateTime number 事件时间，Unix 时间戳 是
    MsgType string 消息类型，固定为 event 是
    Event string 事件类型，固定为waybill_query_expect_time_range，不区分大小写 是
    ResultCode number 处理结果错误码 是
    ResultMsg string 处理结果的详细信息 否
    ExpectTimeRange number 预约时间段，比如1或者2，单位小时（此字段废弃不再使用） 是
    ValidTimeRange Array<TimeRange> 可预约时间段 是
    Asap Object<TimeRange> 是否可下单后2小时内上门，无此参数返回表示不支持 否

    TimeRange

    属性 类型 说明 是否必填
    StartTime number 开始时间，小时数（24小时制） 是
    EndTime number 结束时间，小时数（24小时制） 是
    DayDelta number 天数，0-表示今天 1表示明天 2-表示后天，默认是0 否
    Status number 状态 0-可预约 1-约满，默认可预约 否
    # 2.2.2 催单接口(callback11)
    • 请求参数
    属性 类型 说明 是否必填
    ToUserName string 快递公司小程序UserName 是
    FromUserName string 微信团队的OpenID（固定值） 是
    CreateTime number 事件时间，Unix时间戳 是
    MsgType string 消息类型，固定为event 是
    Event string 事件类型，固定为remind_waybill，不区分大小写 是
    Token string 订单Token。请保存该Token，更新运单轨迹时需要传入，长度需预留256个字符 是
    WXAppId string 商户微信小程序的appid 是
    OrderID string 商户订单ID，可以使用token而不用这个字段 是
    • 返回参数
    属性 类型 说明 是否必填
    ToUserName string 原样返回请求中的FromUserName 是
    FromUserName string 快递公司小程序UserName 是
    CreateTime number 事件时间，Unix时间戳 是
    MsgType string 消息类型，固定为event 是
    Event string 事件类型，固定为remind_waybill，不区分大小写 是
    ResultCode number 处理结果错误码 是
    ResultMsg string 处理结果的详细信息 否
    WayBillID string 运单ID，如果不能立即返回，可以在打印面单时候回调通知微信端 否
    EstimatedDeliveryTime string 预计寄送时间，格式：yyyy-mm-dd 否
    # 2.3 在线支付
    # 2.3.1 通知用户支付完成情况(callback5)

    当用户在线支付完成后通知

    • 请求参数
    属性 类型 说明 是否必填
    ToUserName string 快递公司小程序 UserName 是
    FromUserName string 微信团队的 OpenID （固定值） 是
    CreateTime number 事件时间，Unix时间戳 是
    MsgType string 消息类型，固定为 event 是
    Event string 事件类型，固定为 notify_single_waybill_pay，不区分大小写 是
    Token string 下单接口传的Token 是
    WXAppId string 商户在微信端的appid 是
    OrderID string 商户订单 ID，可以使用token而不用这个字段 是
    WayBillID string 运单 ID 是
    Fee number 支付金额，单位分 是
    OriginalFee number 原价，单位分 否
    PayOrderId string 支付订单号 否
    PayFinishTime number 支付成功时间，10位时间戳 否
    • 返回参数
    属性 类型 说明 是否必填
    ToUserName string 原样返回请求中的 FromUserName 是
    FromUserName string 快递公司小程序 UserName 是
    CreateTime number 事件时间，Unix 时间戳 是
    MsgType string 消息类型，固定为 event 是
    Event string 事件类型，固定为 query_single_waybill_pay，不区分大小写 是
    ResultCode number 处理结果错误码 是
    ResultMsg string 处理结果的详细信息 否
    # 2.3.2 运力更新需支付的运费(api2)

    支付分订单更新运费接口，须保证该订单状态不是待揽件状态。正常流程是：用户下支付分订单，运力公司调用更新订单状态接口，然后再调用更新运费接口。

    • 请求地址：https://api.weixin.qq.com/cgi-bin/express/delivery/single_waybill/fee?access_token=ACCESS_TOKEN

    • 请求方法： POST application/json

      • 请求参数
    属性 类型 说明 是否必填
    access_token string 接口调用凭证 是
    token string 商户侧下单事件中推送的 Token 字段 是
    waybill_id string 运单 ID 否(waybill_id在调用此接口时必须存在，如果本接口不传，那么就需要下单时返回或者运力更新订单状态接口更新waybill_id)
    need_pay number 是否需要用户在线支付， 0不需要，1需要，2需要(支付分) 是
    fee number 需要支付的金额（一般等于original_fee，如有优惠则填最终需要支付的金额），单位分 是
    original_fee number 原价（base_fee+insured_fee+other_fee），单位分 是
    base_fee number 运费，单位分 是
    insured_fee number 保价费，单位分 否
    other_fee number 其他费用，单位分 否
    remark number 其他费用备注 否
    pay_goods_name string 商品名称（对应微信支付商品详情页上的商品名称） 否
    • 返回参数
    属性 类型 说明 是否必填
    errcode number 错误码 是
    errmsg string 错误信息 是
    # 2.3.3 运力公司退款(api6)
    • 描述：运力公司退款(可部分退款)
    • 请求地址：https://api.weixin.qq.com/cgi-bin/express/delivery/single_waybill/refund_order?access_token=ACCESS_TOKEN
    • 请求方式：POST application/json
    • 请求参数
    属性 类型 说明 是否必填
    token string 下单时的Token字段 是
    fee int 退款金额，单位分 是
    • 返回参数
    属性 类型 说明 是否必填
    errcode int 返回码 是
    errmsg string 返回信息 是
    # 2.3.4 对账单下载(api7)
    • 描述：运力公司下载对账单
    • 请求地址：https://api.weixin.qq.com/cgi-bin/express/delivery/single_waybill/get_bill?access_token=ACCESS_TOKEN
    • 请求方式：POST application/json
    • 请求参数
    属性 类型 说明 是否必填
    date string 下载对账单的时间，格式为YYYYMMDD 是
    type string 下载对账单的类型 ALL-所以账单 SUCCESS-成功支付账单 REFUND-退款账单 是
    • 返回参数 成功时返回对账文件内容，失败时返回json数据结构
    属性 类型 说明 是否必填
    errcode int 返回码 是
    errmsg string 返回信息 是
    # 2.4 反馈功能
    # 2.4.1 给小哥评价(callback4)
    • 请求参数
    属性 类型 说明 是否必填
    ToUserName string 快递公司小程序 UserName 是
    FromUserName string 微信团队的 OpenID （固定值） 是
    CreateTime number 事件时间，Unix时间戳 是
    MsgType string 消息类型，固定为 event 是
    Event string 事件类型，固定为 waybill_evaluate_agent，不区分大小写 是
    Token string 下单接口传的Token 是
    WXAppId string 商户在微信端的appid 是
    OrderID string 商户订单ID，可以使用token而不用这个字段 是
    WayBillID string 运单 ID 是
    CourierType number 0, 取件员，1.派件员 是
    Score number 1-5分，最低1分，最高5分 是
    • 返回参数
    属性 类型 说明 是否必填
    ToUserName string 原样返回请求中的 FromUserName 是
    FromUserName string 快递公司小程序 UserName 是
    CreateTime number 事件时间，Unix 时间戳 是
    MsgType string 消息类型，固定为 event 是
    Event string 事件类型，固定为 waybill_evaluate_agent，不区分大小写 是
    ResultCode number 处理结果错误码 是
    ResultMsg string 处理结果的详细信息 否
    # 2.4.2 用户投诉(callback7)
    • 请求参数
    属性 类型 说明 是否必填
    ToUserName string 快递公司小程序 UserName 是
    FromUserName string 微信团队的 OpenID （固定值） 是
    CreateTime number 事件时间，Unix时间戳 是
    MsgType string 消息类型，固定为 event 是
    Event string 事件类型，固定为 waybill_complaint，不区分大小写 是
    Token string 下单接口传的Token 是
    WXAppId string 商户在微信端的appid 是
    OrderID string 商户订单 ID，可以使用token而不用这个字段 是
    WayBillID string 运单 ID 是
    ComplainType number 投诉类型 是
    Content string 投诉内容 是
    Pic string 多张投诉材料图片链接，竖线分割，比如: url1 url2
    Name string 联系人姓名 是
    Phone string 联系人电话 是
    • ComplainType定义
    投诉类型 投诉类型描述
    1004 快件延误
    1005 快件丢失
    1006 快件破损短少
    1007 服务态度
    1008 其它
    • 返回参数
    属性 类型 说明 是否必填
    ToUserName string 原样返回请求中的 FromUserName 是
    FromUserName string 快递公司小程序 UserName 是
    CreateTime number 事件时间，Unix 时间戳 是
    MsgType string 消息类型，固定为 event 是
    Event string 事件类型，固定为 waybill_complaint，不区分大小写 是
    ResultCode number 处理结果错误码 是
    ResultMsg string 处理结果的详细信息 否
    # 2.4.3 运力返回用户投诉处理结果(api3)
    • 请求地址：https://api.weixin.qq.com/cgi-bin/express/delivery/single_waybill/evaluate_feedback?access_token=ACCESS_TOKEN
    • 请求方法：POST application/json
    • 请求参数
    属性 类型 说明 是否必填
    access_token string 接口调用凭证 是
    token string 商户侧下单事件中推送的 Token 字段 是
    waybill_id string 运单 ID 是
    result string 处理结果 是
    desc string 处理结果说明 是
    • 返回参数
    属性 类型 说明 是否必填
    errcode number 错误码 是
    errmsg string 错误信息 是

    # 附录

    # action_type定义

    值 说明
    90001 揽件前阶段-网点接单
    90002 揽件前阶段-分配业务员
    90003 揽件前阶段-重新分配业务员
    90010 揽件前阶段-待支付
    90011 揽件前阶段-已支付
    100001 揽件阶段-揽件成功
    100002 揽件阶段-揽件失败
    200001 运输阶段-更新运输轨迹
    300002 派送阶段-派送中
    300003 派送阶段-签收成功
    300004 派送阶段-签收失败
    300005 派送阶段-第三方代收入库
    300006 派送阶段-第三方代收快递员取出
    300007 派送阶段-代签收
    400001 异常阶段-订单取消
    400002 异常阶段-订单滞留
    400003 异常阶段-订单退回
    400004 异常阶段-订单拒收
    400005 异常阶段-问题件
    500001 兜底状态-其他未分类状态纳入本action_type

    # 订单状态定义

    值 说明
    0 已下单待揽件
    1 已揽件
    2 运输中
    3 派件中
    4 已签收
    5 异常
    6 代签收
    7 揽收失败
    8 签收失败（拒收，超区）
    11 已取消
    13 退件中
    14 已退件

    # 物品类型

    值 说明
    0 文件类
    1 电子产品类（包括家用电器）
    2 办公用品类、服装鞋帽，箱包类
    3 化妆品、美容产品类
    4 珠宝、手表、眼镜、贵重饰品类
    5 食品、保健药品类
    6 工艺品类（包括瓷器、茶具、烹饪用品）
    7 玩具乐器类
    8 其他类