文档中心 > 酒店通用分销

数据验证

更新时间:2024/06/11 访问次数:1433

方法名称

taobao.xhotel.order.distribution.validate

使用说明

概述

下单前的数据验证接口。基础职责是获取实时数据,提高下单接口的成功率,实时查询接口可适当调整RT时长(5s)。

注意事项

  • 请不要强依赖返回结果可为空的参数

API入参

字段

类型

可为空

示例值

描述

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]}

房间信息,国际场景必填


API出参


字段

类型

可为空

示例值

描述

result

Object

Y

结果体,范型对象

is_success

Boolean

N

true

请求是否成功

error_msg

String

Y

系统异常,请稍后重试

错误信息

error_resp_code

Number

Y

105

错误码

msg_for_dev

String

Y

奥创解析错误

开发查看的错误信息


result节点


字段

类型

可为空

示例值

描述

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


发票规则


rate_plan_info节点


字段

类型

可为空

示例值

描述

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_units节点


字段

类型

可为空

示例值

描述

rate_key

String

N

dfer34234234232

最小售卖单元唯一key

daily_price_info_list

List<Object>

N

每日价格信息


daily_price_info_list节点

数组,其中对象定义如下:


字段

类型

可为空

示例值

描述

date

String

N

2022-11-15

入住日期

cny_price

Number

N

10000

房间价格(单位:分)

board_do

Object

Y


餐食信息


board_do节点


字段

类型

可为空

示例值

描述

board_type

Number

Y

1

早餐种类:0 无早;1 早餐;2 三餐

board_num

Number

Y

2

餐食数量


cancel_policy_do节点


字段

类型

可为空

示例值

描述

cancel_policy_type

Number

N

1

取消政策类型:1.免费取消; 2.不可取消; 4.从入住时间前推小时前百分比扣款;5.限时免费取消(从入住时间前推); 6.提前多少小时退款扣取几晚房费; 9.阶梯收费取消(从入住时间前推小时前退订扣款金额)

policy_info

Object[]

Y

取消政策规则


policy_info节点

数组,其中对象定义如下:


字段

类型

可为空

示例值

描述

hour

Number

Y

48

提前x小时

value

Number

Y

1

规则对应的值,可能是百分比、数值等


hotel_promotion_do节点


字段

类型

可为空

示例值

描述

promotion_existed

Boolean

Y

true

是否存在优惠

promotion_total_price

Number

Y

1000

优惠总金额

promotion_detail_do_list

List<Object>

Y

优惠明细


promotion_detail_do_list节点

数组,其中对象的定义如下:


字段

类型

可为空

示例值

描述

promotion_name

String

Y

百亿补贴

优惠名称

promotion_price

Number

Y

1000

优惠金额

promotion_type

Number

Y

1

优惠类型, 1=百亿补贴, 2=贵必赔

promotion_id

String

Y

1

优惠唯一标识


invoice_config_do节点


字段

类型

可为空

示例值

描述

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

该商品不支持售卖

命中商品管控规则,联系飞猪业务同学


FAQ

关于此文档暂时还没有FAQ
返回
顶部