# 查询所在城市的预约时间段

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

事件英文名：waybill_query_expect_time_range

当用户查询所在城市的预约时间段时，推送此事件。

# 1. 消息参数

# 请求体 Request Payload

参数名	类型	说明
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

# 2. 消息返回

# 返回体 Response Payload

参数名	类型	必填	说明
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	objarray	是	可预约时间段
Asap	object	否	是否可下单后2小时内上门，无此参数返回表示不支持

# Res.ValidTimeRange(Array) Object Payload

可预约时间段

参数名	类型	必填	说明
StartTime	number	是	开始时间，小时数（24小时制）
EndTime	number	是	结束时间，小时数（24小时制）
DayDelta	number	否	天数，0-表示今天 1表示明天 2-表示后天，默认是0
Status	number	否	状态 0-可预约 1-约满，默认可预约

# Res.Asap Object Payload

是否可下单后2小时内上门，无此参数返回表示不支持

参数名	类型	必填	说明
StartTime	number	是	开始时间，小时数（24小时制）
EndTime	number	是	结束时间，小时数（24小时制）
DayDelta	number	否	天数，0-表示今天 1表示明天 2-表示后天，默认是0
Status	number	否	状态 0-可预约 1-约满，默认可预约

# 3. 注意事项

本事件无特殊注意事项

# 4. 代码示例

本事件无代码示例