数据推送总览图

 接口说明：

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