文档中心 > 酒店客栈-线上预订

酒店商品发布

更新时间:2017/03/07 访问次数:28916

数据推送总览图

 

 

 接口说明:

 

1. 酒店、房型、RP数据,必须有全局唯一的外部ID

2. 房型库存需要用外部房型ID,房价库存和价格需要使用外部房型ID+外部RPcode

3. 这里未提及的接口,以及标注为“废弃”的接口,“废弃”的字段,都不要需要关注

4.taobao.xhotel.rate.update,taobao.xhotel.rates.update,taobao.xhotel.rates.increment这三个接口可以同时更新报价和库存,也可以单独更新报价或者单独更新库存。

 

接口列表:

 

静态信息

1.酒店信息接口

taobao.xhotel.add

该接口支持酒店信息的新增和修改,其中入参outer_id必须全局唯一。具体入参介绍请点击上面接口链接查看。

 

2.房型接口

taobao.xhotel.roomtype.add

该接口支持房型信息的新增和修改,其中入参outer_id必须全局唯一。具体入参介绍请点击上面接口链接查看。

 

3.房价接口

taobao.xhotel.rateplan.add

该接口支持房价信息的新增和修改,其中入参rateplan_code必须全局唯一。对接该接口的时候务必注意payment_type,cancel_policy,guarantee_type三个字段的约束关系,具体约束参见下面核心字段介绍。具体入参介绍请点击上面接口链接查看。

核心字段介绍:
name:在淘宝搜索页面展示的房价名称。请注意名称里不要维护早餐信息,如果想设置早餐信息,请设置breakfast_count字段即可。
payment_type:支付类型,只支持:1:预付 5:现付 6: 信用住 7:在线预约。其中5,6,7三种类型需要向阿里申请权限,否则房价不能上架售卖。
breakfast_count:早餐数量。-1:状态早餐,和具体几人价有关系,几人价是几份早餐;0:不含早1:含单早2:含双早N:含N早(-1-99可选)。房价中的早餐信息均以改字段为准。
cancel_policy:退订政策。目前共有1,2,4,5,6五种类型。注意事项:支付类型为预付,那么可以使用所有的退订类型,但是担保属性必须是非担保;支付类型为面付或者信任住并且担保属性是无担保,那么只能使用1类型的退订;支付类型为面付或者信任住并且担保属性为担保,那么只能使用2,5类型的退订;支付类型为在线预约,那么只能使用1,2,5类型的退改。
guarantee_type:担保类型。类型种类: 0 无担保 1 峰时首晚担保 2峰时全额担保 3全天首晚担保 4全天全额担保。
guarantee_start_time: 分时担保每日开始担保时间。 (如果设置了峰时担保类型即guarantee_type等于1或者2,那么峰时担保时间不能为空,并且必须大于等于8点)。
breakfast_cal:早餐日历。date:具体日期。breakfast_count:这一天早餐的数量,范围为-1到99之间。其中-1为状态早餐。如果date为空,那么会去读取startDate和endDate(格式都为"yyyy-MM-dd"),即该早时间段内的早餐都是breakfast_count这个值。另外日历中缺失的日期的早餐数量由上面第三个核心字段即breakfast_count决定。
cancel_policy_cal:日历退订政策。该字段注意事项和上面的第四个核心字段cancel_policy一致。
guarantee_cal:日历担保。该字段的注意事项和上面第五个核心字段即guarantee_type一致。
effective_time:房价生效开始时间,用来控制此rateplan生效的开始时间,配合字段deadline_time一起限定rp的有效期。只有当前时间在房价的有效期范围内,该房价才能正常售卖。
deadline_time:房价生效截止时间,用来控制此rateplan生效的截止时间,配合字段effective_time一起限定rp的有效期。只有当前时间在房价的有效期范围内,该房价才能正常售卖。

 

库存信息

1.单个房型全量库存更新接口(房价共享库存)

taobao.xhotel.room.update (单个房型全量库存更新)

该接口是更新某一个房型的全部库存信息,全部覆盖的形式,比如第一次更新某个房型库存信息为两天:日期2016-01-01,库存10;日期2016-01-02,库存15。第二次更新这个房型的库存信息为1天:日期2016-01-02,库存5,那么这个房型的最终库存信息为:日期2016-01-02,库存5。该接口支持使用商家的房型code即out_rid来更新库存信息,也支持使用淘宝的房型id即rid来更新库存,推荐使用out_rid来更新库存信息。其中日历开关参数请谨慎使用,如果没有开关房需求,那么可以忽略日历开关字段room_switch_cal。具体参数使用请参照上面接口链接。

 

2.多个房型全量库存更新接口(房价共享库存)

taobao.xhotel.rooms.update (多个房型全量库存更新)

该接口是全量更新多个房型的库存信息,细分到每一个房型来说,也是全部覆盖的形式。比如第一次更新的房型为A,B,C三个房型,那么这次会全量覆盖这三个房型,覆盖方式和单个房型全量库存更新接口中举例一样。如果第二次更新的房型为B,C那么这次只会覆盖B,C两个房型,A房型保持第一次更新时候的值不变。该接口支持使用商家的房型code即out_rid来更新库存信息,也支持使用淘宝的房型id即rid来更新库存,推荐使用out_rid来更新库存信息。具体参数使用请参照上面接口链接。

3.多个房型增量库存更新接口(房价共享库存)

taobao.xhotel.rooms.increment(多个房型曾量库存更新)

该接口是增量更新多个房型的库存信息,细分到每一个房型来说,是以请求参数中的数据来覆盖已有数据的形式。比如第一次更新某个房型库存信息为两天:日期2016-01-01,库存10;日期2016-01-02,库存15。第二次更新这个房型的库存信息为1天:日期2016-01-02,库存5,那么这个房型的最终库存信息为:日期2016-01-01,库存10;日期2016-01-02,库存5。该接口支持使用商家的房型code即out_rid来更新库存信息,也支持使用淘宝的房型id即rid来更新库存,推荐使用out_rid来更新库存信息。具体参数使用请参照上面接口链接。

4.单个房型和房价库存更新接口(房价专有库存)

taobao.xhotel.rate.update (单个(房型+价格计划)更新全量库存)

taobao.xhotel.multiplerate.update (复杂价格推送接口(全量更新)) 复杂价格即支持(多人价,连住价等)

该接口是更新某一个房型和房价的全部库存信息,全部覆盖的形式,比如第一次更新某个房型123和房价abc库存信息为两天:日期2016-01-01,库存10;日期2016-01-02,库存15。第二次更新这个房型123和房价abc的库存信息为1天:日期2016-01-02,库存5,那么这个房型123和房价abc的最终库存信息为:日期2016-01-02,库存5。该接口支持使用商家的房型code即out_rid和房价code即rateplan_code来更新库存信息,也支持使用淘宝的房型id即rid和房价id即rpid来更新库存,推荐使用out_rid和rateplan_code来更新库存信息。具体参数使用请参照上面接口链接。

5.多个房型和房价库存更新接口(批量房价专有库存)

taobao.xhotel.rates.update (多个(房型+价格计划)全量库存更新)

taobao.xhotel.multiplerates.update (复杂价格推送接口(批量全量)) 复杂价格即支持(多人价,连住价等)

该接口是更新多个房型和房价的全部库存信息,全部覆盖的形式。和taobao.xhotel.rate.update的主要区别是该接口一次支持更新多个房型和房价的库存。比如第一次更新某房型123和房价abc库存信息为两天:日期2016-01-01,库存10;日期2016-01-02,库存15。第二次更新这个房型123和房价abc的库存信息为1天:日期2016-01-02,库存5。那么这个房型123和房价abc的最终库存信息为:日期2016-01-02,库存5。该接口支持使用商家的房型code即out_rid和房价code即rateplan_code来更新库存信息,也支持使用淘宝的房型id即rid和房价id即rpid来更新库存,推荐使用out_rid和rateplan_code来更新库存信息。其中日历开关参数请谨慎使用。具体参数使用请参照上面接口链接。

6.多个房型和房价库存增量更新接口(批量增量房价专有库存)

taobao.xhotel.rates.increment(多个(房型+价格计划)曾量库存价格,传哪天更新哪天)

taobao.xhotel.multiplerates.increment (复杂房价推送接口(批量增量))   复杂价格即支持(多人价,连住价等)

该接口是增量更新多个房型和房价的库存信息,全部覆盖的形式。和taobao.xhotel.rates.update的主要区别是该接口是增量更新。比如第一次更新某个房型123和房价abc库存信息为两天:日期2016-01-01,库存10;日期 2016-01-02,库存15。第二次更新这个房型123和房价abc的库存信息为1天:日期2016-01-02,库存5,那么这个房型123和房价abc的最终库存信息为:日期2016-01-01,库存10;日期2016-01-02,库存5。该接口支持使用商家的房型code即out_rid和房价code即rateplan_code来更新库存信息,也支持使用淘宝的房型id即rid和房价 id即rpid来更新库存,推荐使用out_rid和rateplan_code来更新库存信息。具体参数使用请参照上面接口链接。

 

价格信息

1.单个房型和房价的全量价格更新接口

taobao.xhotel.rate.update (单个(房型+价格计划)更新全量价格)

taobao.xhotel.multiplerate.update (复杂价格推送接口(全量更新)) 复杂价格即支持(多人价,连住价等)

该接口是更新某一个房型和房价的全部价格信息,全部覆盖的形式,比如第一次更新某个房型123和房价abc价格信息为两天:日期2016-01-01,价格1000;日期2016-01-02,价格1500。第二次更新这个房型123和房价abc的价格信息为1天:日期2016-01-02,价格5000,那么这个房型123和房价abc的最终价格信息为:日期2016-01-02,价格5000。该接口支持使用商家的房型code即out_rid和房价code即rateplan_code来更新价格信息,也支持使用淘宝的房型id即rid和房价 id即rpid来更新价格,推荐使用out_rid和rateplan_code来更新价格信息。具体参数使用请参照上面接口链接。

2.多个房型和房价的全量价格更新接口

taobao.xhotel.rates.update (多个(房型+价格计划)更新全量价格)

taobao.xhotel.multiplerates.update (复杂价格推送接口(批量全量)) 复杂价格即支持(多人价,连住价等)

该 接口是更新多个房型和房价的全部价格信息,全部覆盖的形式。和taobao.xhotel.rate.update的主要区别是该接口一次支持更新多个房型和房价的价格。比如第一次更新某个房型123和房价abc价格信息为两天:日期2016-01-01,价格1000;日期 2016-01-02,价格1500。第二次更新这个房型123和房价abc的价格信息为1天:日期2016-01-02,价格5000,那么这个房型123和房价abc的最终价格信息为:日期2016-01-02,价格5000。该接口支持使用商家的房型code即out_rid和房价code即rateplan_code来更新价格信息,也支持使用淘宝的房型id即rid和房价id即rpid来更新价格,推荐使用out_rid和rateplan_code来更新价格信息。其中价格字符串中的status请谨慎使用,该字段是开关房状态,1为开,0为关,如果没有开关房需求,那么请忽略该字段。具体参数使用请参照上面接口链接。

3.多个房型和房价的增量价格更新接口

taobao.xhotel.rates.increment(多个(房型+价格计划)更新增量价格,传哪天更新哪天)

taobao.xhotel.multiplerates.increment (复杂房价推送接口(批量增量))  

该接口是增量更新多个房型和房价的价格信息,全部覆盖的形式。和taobao.xhotel.rates.update的主要区别是改接口是增量更新。比如第一次更新某个房型123和房价abc价格信息为两天:日期2016-01-01,价格1000;日期 2016-01-02,价格1500。第二次更新这个房型123和房价abc的价格信息为1天:日期2016-01-02,价格5000,那么这个房型123和房价abc的最终库存信息为:日期2016-01-01,价格1000;日期2016-01-02,价格5000。该接口支持使用商家的房型code即out_rid和房价code即rateplan_code来更新价格信息,也支持使用淘宝的房型id即rid和房价id即rpid来更新价格,推荐使用out_rid和rateplan_code来更新价格信息。其中价格字符串中的status请谨慎使用,该字段是开关房状态,1为开,0为关,如果没有开关房需求,那么请忽略该字段。具体参数使用请参照上面接口链接。

删除接口(慎重使用) 

1.酒店产品库rateplan 销售政策删除,同时删除关联的rate 房态报价

taobao.xhotel.rateplan.delete (价格计划rateplan删除)

2.酒店产品库rate 房态报价删除

taobao.xhotel.rate.delete (rate删除接口)

 更多API说明:酒店API列表

 

FAQ

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