# 通过收发件地址查询标准运费
本文档描述服务器端接收的消息或事件,详细说明参见消息推送。
事件英文名:query_single_waybill_fee
用户在下单页面选择收发货地址时进行查询
# 1. 消息参数
# 请求体 Request Payload
| 参数名 | 类型 | 说明 |
|---|---|---|
| ToUserName | string | 快递公司小程序 UserName |
| FromUserName | string | 微信团队的 OpenID (固定值) |
| CreateTime | number | 事件时间,Unix时间戳 |
| MsgType | string | 消息类型,固定为 event |
| Event | string | 事件类型,固定为 query_single_waybill_fee,不区分大小写 |
| Sender | object | 发件人信息 |
| Receiver | object | 收件人信息 |
| GoodDetail | object | 物品详情 |
| Scene | number | 1 C端散单, 2 B端退货, 3 B端发货 |
# Body.Sender Object Payload
发件人信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| Name | string | 收件人姓名 |
| Tel | string | 收件人座机号码 |
| Mobile | string | 收件人手机号码 |
| Province | string | 省份,比如"广东省" |
| City | string | 地区/市,比如"广州市" |
| Area | string | 区/县,比如"海珠区" |
| Street | string | 街道,比如新港中路 |
| Address | string | 详细地址,比如"XX路XX号XX大厦XX" |
# Body.Receiver Object Payload
收件人信息
| 参数名 | 类型 | 说明 |
|---|---|---|
| Name | string | 收件人姓名 |
| Tel | string | 收件人座机号码 |
| Mobile | string | 收件人手机号码 |
| Province | string | 省份,比如"广东省" |
| City | string | 地区/市,比如"广州市" |
| Area | string | 区/县,比如"海珠区" |
| Street | string | 街道,比如新港中路 |
| Address | string | 详细地址,比如"XX路XX号XX大厦XX" |
# Body.GoodDetail Object Payload
物品详情
| 参数名 | 类型 | 说明 | 枚举 |
|---|---|---|---|
| Weight | number | 货物总重量,比如1.2,单位是千克(kg) | - |
| Special | number | 物品类型,见物品类型说明 | 枚举值 |
# 2. 消息返回
# 返回体 Response Payload
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 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-线下支付完成 |
# 3. 枚举信息
# Body.GoodDetail.Special Enum
物品类型,见物品类型说明
| 枚举值 | 描述 |
|---|---|
| 0 | 文件类 |
| 1 | 电子产品类(包括家用电器) |
| 2 | 办公用品类,服装鞋帽,箱包类 |
| 3 | 化妆品,美容产品类 |
| 4 | 珠宝,手表,眼镜,贵重饰品类 |
| 5 | 食品,保健药品类 |
| 6 | 工艺品类(包括瓷器,茶具,烹饪用品) |
| 7 | 玩具乐器类 |
| 8 | 其他类 |
# 4. 注意事项
本事件无特殊注意事项
# 5. 代码示例
本事件无代码示例