酒店客栈-线上预订
酒店商品发布
更新时间：2021/03/18
访问次数：46788
商品推送步骤
新增库存可分为room共享库存和rate专有库存，rate接口参数use_room_inventory，传true表示使用room共享库存，传false表示使用rate专有库存
接口说明
接口限流
接口限流是指API接口，每个appkey以及每个卖家超过限流都会拦截，严重影响及时更新，建议商家合理控制调用频率。接口限流优化建议
| API接口名称 | API限流 | appkey限流 | 卖家动态QPS限流 |
|---|---|---|---|
| taobao.xhotel.rateplan.update | 700QPS | 60QPS以下 | 按天自动计算卖家QPS |
| taobao.xhotel.room.update | 300QPS | 50QPS | 按天自动计算卖家QPS |
| taobao.xhotel.rate.update | 500QPS | 60QPS | 按天自动计算卖家QPS |
| taobao.xhotel.rates.increment | 750QPS | 60QPS | 按天自动计算卖家QPS |
| taobao.xhotel.rates.update | 1000QPS | 110QPS | 按天自动计算卖家QPS |
- 特别说明，API对每个appkey限流是为了防止个别appkey恶意调用影响其他appkey的调用，因API底层整体限流保护，因此不保证每个appkey在以上限流阀值内全部调用成功，当API整体限流时，对所有appkey机会均等。当单个appkey给多个卖家使用时，需考虑appkey调用量、API限流对业务影响，必要时需申请多个appkey。
维护酒店
| API接口 | 接口说明 |
|---|---|
| taobao.xhotel.update | 该接口支持酒店信息的新增和修改，其中入参outer_id必须卖家唯一。 |
维护房型
| API接口 | 接口说明 |
|---|---|
| taobao.xhotel.roomtype.update | 该接口支持房型信息的新增和修改，其中入参outer_id必须卖家唯一。 |
维护Rateplan价格计划
| API接口 | 接口说明 |
|---|---|
| taobao.xhotel.rateplan.update | 该接口支持房价信息的新增和修改，对接该接口的时候务必注意payment_type,cancel_policy,guarantee_type三个字段的约束关系 |
| taobao.xhotel.rateplan.add | 该接口支持房价信息的新增和修改，对接该接口的时候务必注意payment_type,cancel_policy,guarantee_type三个字段的约束关系 |
- 以上两个接口可二选一进行对接，新增加online_booking_binding_info 可进行在线预约关联关系新增
维护房型共享库存
| API接口 | 接口说明 |
|---|---|
| taobao.xhotel.rooms.update | 房型库存推送接口（批量全量），此接口用于全量更新多个房型的房型库存、房态 |
| taobao.xhotel.rooms.increment | 房型库存推送接口（批量增量），此接口用于增量更新多个房型的房型库存、房态即传哪天的库存、房态就更新哪天的 |
- 商家可同时对接room库存接口以及rate库存接口，room接口是房型共享库存，rates接口是专有库存。rates接口中的参数use_room_inventory为true时表示使用的是room接口推送的库存，为false时表示用rate推送的库存。
- 提高用户试单体验，房型上若有长期的固定的多个房价绑定且使用同样的库存来源时，建议使用room库存；临时的阶段性的个性化的促销活动，用rate库存。建议批量全量、批量增量接口兼顾使用。
- rate接口中的库存，价格，开关都是独立更新的，更新库存为0或者关房，不必一定要更新价格，如果必须要默认价格，需卖家默认price为-1
维护价格以及专有库存
| API接口 | 接口说明 |
|---|---|
| taobao.xhotel.rates.update | 多个（房型+价格计划）全量价格更新，此接口用于全量更新多个房型和房价维度的全部库存价格信息 |
| taobao.xhotel.rates.increment | 多个（房型+价格计划）增量库存价格，此接口用于增量更新多个房型和房价维度的库存信息即传哪天的价格库存就更新哪天的 |
| taobao.xhotel.rate.add | 单个（房型+价格计划）库存价格新增更新接口,新增online_booking_binding_info参数,可进行在线预约关联关系新增 |
| taobao.xhotel.rate.update | 单个（房型+价格计划）库存价格新增更新接口，新增online_booking_binding_info参数,可进行在线预约关联关系新增 |
-
rate接口中的库存，价格，开关都是独立更新的，更新库存为0或者关房，不必一定要更新价格，如果必须要默认价格，需卖家默认price为-1
-
特别说明，若商家不用room库存接口，使用rate接口同时推送库存和价格，即第四步推库存和第五步推价格就一起实现了。虽然日历库存为0、日历关房，都实现了当天不可售，建议推送能反映实际场景（即库存为0是酒店设置的0，日历关房是酒店设置的日历关），方便卖家管理可售情况。
更多接口
| API接口 | 接口说明 |
|---|---|
| taobao.xhotel.multiplerates.update | 复杂价格全量更新接口，可支持多人价、连住价、税费,如需要对接，请联系对应BD申请复杂价格标签 |
| taobao.xhotel.multiplerates.increment | 复杂价格增量更新接口，支持多人价、连住价、税费,如需对接，请联系对应BD申请复杂价格标签 |
| taobao.xhotel.multiplerate.update | 复杂价格全量更新接口，可支持多人价、连住价、税费,如需要对接，请联系对应BD申请复杂价格标签,该接口新增online_booking_binding_info参数,可进行在线预约关联关系新增 |
| taobao.xhotel.delete | 酒店删除接口，用于删除酒店以及该酒店下的房型 |
| taobao.xhotel.roomtype.delete.public | 房型删除接口，用户删除房型 |
| taobao.xhotel.house.add | 非标准民宿房源添加或更新接口，其中入参outer_id必须卖家唯一。 |
| taobao.xhotel.house.roomtype.add | 该接口支持非标民宿房型信息的新增和修改，其中入参outer_id必须卖家唯一。 |
- 对接复杂价格库存，需联系BD运营申请复杂价格的标签，申请通过后才能正常推送复杂价格
