taobao.xhotel.order.distribution.validate
下单前的数据验证接口。基础职责是获取实时数据,提高下单接口的成功率,实时查询接口可适当调整RT时长(5s)。
字段 |
类型 |
可为空 |
示例值 |
描述 |
rate_plan_id |
Number |
N |
32213123434 |
售卖政策id,不落库场景可不填 |
rate_key |
String |
N |
32213123434 |
不落库场景必填 |
number_of_rooms |
Number |
N |
2 |
房间数 |
distributor |
String |
N |
hello |
分销渠道 |
number_of_adults_per_room |
Number |
N |
2 |
每间房的成人数,默认写2人,国际场景不填 |
item_id |
Number |
N |
433233252 |
商品id |
search_promotion_amount |
Number |
Y |
1000 |
报价接口的优惠金额(单位分) |
search_after_promotion_amount |
Number |
Y |
800 |
报价接口的优惠后房价(单位分) |
check_in |
Date |
N |
2022-11-15 15:00:00 |
入住日期 |
check_out |
Date |
N |
2022-11-16 14:00:00 |
离店日期 |
search_room_price |
Number |
Y |
10000 |
报价接口的优惠前价格(单位分) |
occupancies |
Object |
Y |
{"roomNo":1,"adultNum":1,"childrenNum":1,"childrenAges":[7]} |
房间信息,国际场景必填 |
字段 |
类型 |
可为空 |
示例值 |
描述 |
result |
Object |
Y |
结果体,范型对象 |
|
is_success |
Boolean |
N |
true |
请求是否成功 |
error_msg |
String |
Y |
系统异常,请稍后重试 |
错误信息 |
error_resp_code |
Number |
Y |
105 |
错误码 |
msg_for_dev |
String |
Y |
奥创解析错误 |
开发查看的错误信息 |
字段 |
类型 |
可为空 |
示例值 |
描述 |
create_key |
String |
N |
1668515755548_210451ea16685157543063960e2d5f_109eca19d39e4caa8464d2792e7d0cb8 |
创单需要传入的参数 |
rate_plan_id |
Number |
N |
32213123434 |
售卖政策ID |
seller_id |
Number |
N |
2204103009000 |
卖家ID |
hid |
Number |
N |
306424009000 |
酒店ID |
rate_plan_info |
Object |
N |
售卖政策具体信息 |
|
hotel_promotion_do(废弃) |
Object |
Y |
优惠具体信息 |
|
invoice_config_do |
Object |
Y |
发票规则 |
字段 |
类型 |
可为空 |
示例值 |
描述 |
display_name |
String |
N |
无早-任意退【测试测试】 |
rp展示名称 |
total_room_price |
Number |
N |
10000 |
总房价(单位:分) |
after_promotion_price |
Number |
N |
8000 |
优惠后房价(单位:分) |
rate_units |
Object |
N |
每间房rate信息 |
|
max_booking_num |
Number |
N |
2 |
最大可预订房间数 |
max_occupancy_num |
Number |
N |
2 |
每间房最大可入住人数 |
max_inventory |
Number |
15 |
最大库存量 |
|
earliest_check_in_time |
String |
N |
12:00 |
最早可以办理入住时间 |
latest_check_out_time |
String |
N |
14:00 |
最晚离店时间 |
cancel_policy_do |
Object |
N |
取消政策 |
|
bed_desc |
String |
N |
双床 |
床型描述 |
字段 |
类型 |
可为空 |
示例值 |
描述 |
rate_key |
String |
N |
dfer34234234232 |
最小售卖单元唯一key |
daily_price_info_list |
List<Object> |
N |
每日价格信息 |
数组,其中对象定义如下:
字段 |
类型 |
可为空 |
示例值 |
描述 |
date |
String |
N |
2022-11-15 |
入住日期 |
cny_price |
Number |
N |
10000 |
房间价格(单位:分) |
board_do |
Object |
Y |
餐食信息 |
字段 |
类型 |
可为空 |
示例值 |
描述 |
board_type |
Number |
Y |
1 |
早餐种类:0 无早;1 早餐;2 三餐 |
board_num |
Number |
Y |
2 |
餐食数量 |
字段 |
类型 |
可为空 |
示例值 |
描述 |
cancel_policy_type |
Number |
N |
1 |
取消政策类型:1.免费取消; 2.不可取消; 4.从入住时间前推小时前百分比扣款;5.限时免费取消(从入住时间前推); 6.提前多少小时退款扣取几晚房费; 9.阶梯收费取消(从入住时间前推小时前退订扣款金额) |
policy_info |
Object[] |
Y |
取消政策规则 |
数组,其中对象定义如下:
字段 |
类型 |
可为空 |
示例值 |
描述 |
hour |
Number |
Y |
48 |
提前x小时 |
value |
Number |
Y |
1 |
规则对应的值,可能是百分比、数值等 |
字段 |
类型 |
可为空 |
示例值 |
描述 |
promotion_existed |
Boolean |
Y |
true |
是否存在优惠 |
promotion_total_price |
Number |
Y |
1000 |
优惠总金额 |
promotion_detail_do_list |
List<Object> |
Y |
优惠明细 |
数组,其中对象的定义如下:
字段 |
类型 |
可为空 |
示例值 |
描述 |
promotion_name |
String |
Y |
百亿补贴 |
优惠名称 |
promotion_price |
Number |
Y |
1000 |
优惠金额 |
promotion_type |
Number |
Y |
1 |
优惠类型, 1=百亿补贴, 2=贵必赔 |
promotion_id |
String |
Y |
1 |
优惠唯一标识 |
字段 |
类型 |
可为空 |
示例值 |
描述 |
can_invoice |
Number |
Y |
1 |
能否开发票,1:能、0:不能 |
invoice_provider |
Number |
Y |
1 |
发票提供方,1:酒店前台,2:卖家 |
support_invoice_type |
List |
Y |
[0,2] |
支持的开票类型,0:纸质普票,1:纸质专票,2:电子普票,21:电子普票,23:全电普票,24:全电专票 |
postage_provider |
Number |
Y |
0 |
邮费提供方,0:未设置 1:卖家承担,2:买家承担(邮费到付),3:卖家承担(邮费¥XX) |
invoice_type |
String |
Y |
旅游费 |
开票用途分类,中间用逗号分隔,代订房费,旅游费,差旅费,其他 |
invoice_other_desc |
String |
Y |
其他类型 |
发票描述,可开票类型选择"其他"时填写的内容 |
memo |
String |
Y |
需发票的客户请联系客服告之开票信息。发票由杭州诗遥开具的代订房费增值税发票 |
发票规则的补充说明 |
错误码 |
解释 |
解决方案 |
101 |
请求参数有误 |
检查请求参数是否符合要求 |
102 |
未知错误 |
联系飞猪开发同学排查 |
105 |
奥创解析错误 |
联系飞猪开发同学排查 |
106 |
请求被限流 |
减少QPS,或联系飞猪开发同学放大限流阈值 |
202 |
buy2查询失败 |
联系飞猪开发同学排查 |
207 |
商品已经失效,可能是ratePlan失效,或库存不足、满房 |
商家库存是实时更新的,报价结果与实时请求验价之间存在时间差,该问题不能完全被避免 |
209 |
该商品不支持售卖 |
命中商品管控规则,联系飞猪业务同学 |