酒店API对接
Hotelbeds API对接：实时房价、预订与确认单
将您的Hotelbeds账户接入PHPTRAVELS，与自有酒店一起销售：实时房价与房态、付款前价格复核、即时确认、PDF确认单、修改与取消。
- 实时房价与房态
- 付款前价格复核
- 确认单与取消
- 映射与缓存
工作原理
把Hotelbeds接入您的酒店预订引擎
Hotelbeds是一家独立的B2B床位批发商，通过API向旅游企业分销其签约酒店库存。PHPTRAVELS使用您自己的凭据调用该API，并运行完整流程：从搜索、价格复核到确认、确认单和取消，同时配备日志、重试和幂等键，确保超时不会产生重复预订。
- 获取Hotelbeds的API key、密钥以及允许的市场和币种
- 在后台填写密钥，并按市场或渠道设置加价
- 映射目的地、酒店以及房型和餐食代码，并缓存内容
- 在测试环境中测试搜索、价格复核、预订、确认单和取消
- 如合同要求则完成认证，然后切换到正式环境
- 环境
- 测试
- 接口地址
- api.test.hotelbeds.com
- 凭据
- API key：•••• · 密钥：••••
- 加价
- 净价加价12%
- 市场与币种
- ES, AE · EUR
搜索与预订
Hotelbeds客房，含餐食、价格类型和取消条款
每条Hotelbeds结果都带有客人和代理商比较所需的信息，以及预订流程所需的规则。
- 4★Rambla Garden Hotel双人房 · 含早餐US$486整个住宿
- 5★Port Vell Suites小套房 · 半膳US$742整个住宿
- Eixample Apartments一居室公寓 · 不含餐US$395整个住宿
映射与缓存
目的地、酒店和房型映射，配合定时内容缓存，预订确认时自动清除。
价格复核
需要复核的价格会在付款前重新计价，客人支付的就是Hotelbeds确认的金额。
备注与政策
价格备注、取消期限和费用在预订前显示，并打印在确认单上。
重试与幂等
指数退避、熔断机制和幂等键，防止超时产生重复预订。
供应商日志
请求与响应日志、错误追踪和调用频率限制处理，可导出作为审计记录。
多币种显示
按您的汇率和取整规则，以客人所用币种显示Hotelbeds净价。
预订流程
从Hotelbeds搜索到确认单和取消
PHPTRAVELS为每笔Hotelbeds预订执行的步骤，公共网站和代理商使用同一流程。
搜索
按目的地、日期和入住人数查询房态，并与自有酒店合并显示。
价格复核
标记为需复核的价格会重新计价，并刷新相关政策。
付款
填写客人信息并付款，Hotelbeds确认后才扣取银行卡款项。
确认
使用幂等键提交预订，并保存Hotelbeds预订编号。
确认单
将含供应商编号和备注的PDF确认单通过邮件发送给客人。
修改或取消
按价格政策处理修改和取消，并在后台办理退款。
库存
Hotelbeds与您的其他酒店来源并列
Hotelbeds是酒店模块中的一个供应商，其客房与您的签约酒店和其他床位批发商出现在同一搜索中。
Hotelbeds酒店
来自您Hotelbeds账户的酒店内容、客房、餐食、价格和政策。
接送与活动
如您的合同开通相应API，可加入Hotelbeds的接送和活动产品。
其他供应商与合同
您的签约酒店和其他酒店API，各自拥有独立的加价规则。
可对接的酒店供应商：
Agoda
Amadeus
Booking.com
Hotelbeds
Hotelston
RateHawk
Stuba
TBO Holidays
Travelport
Wanderbeds
后台管理
在一个后台管理Hotelbeds销售
Hotelbeds预订的利润、代理商、付款和供应商记录，与其他所有产品在同一后台中管理。
加价与佣金
按市场、城市、酒店或渠道，对Hotelbeds净价设置固定金额或百分比加价。
代理商与下级代理
B2B门户提供信用额度、佣金和Hotelbeds预订审批规则。
付款
银行卡、已保存令牌或线下付款，确认时扣款，取消时退款。
供应商编号
按Hotelbeds编号查找任意预订、重发确认单并跟踪修改记录。
提醒
预订失败、复核时价格变动及供应商错误都会发出通知。
报表
Hotelbeds的预订、利润和应付供应商款项，随时可导出。
对比
自建Hotelbeds对接与PHPTRAVELS对比
许多团队一开始自行开发Hotelbeds API对接。以下是自建通常涉及的工作，以及现成集成的做法。
| 方面 | 自行开发 | PHPTRAVELS |
|---|---|---|
| 预订流程 | 自行开发搜索、复核、预订和取消接口由您的开发人员编写和测试 | PHPTRAVELS搜索、价格复核、确认、确认单和取消已内置在酒店模块中 |
| 内容映射 | 自行开发房型和餐食代码需针对项目手工映射 | PHPTRAVELS目的地、酒店和房型映射，并缓存内容 |
| 超时与错误 | 自行开发若未设计重试机制，可能出现重复预订 | PHPTRAVELS每笔预订都有重试、退避和幂等键 |
| 网站与代理商 | 自行开发仍需另行开发预订网站和代理商门户 | PHPTRAVELS同一套系统包含B2C网站和B2B代理商门户 |
| 运维 | 自行开发日志和提醒往往事后才补上 | PHPTRAVELS供应商日志、提醒和可导出的审计记录 |
| 更多供应商 | 自行开发每接一个新供应商都是一个新项目 | PHPTRAVELS在同一后台添加其他酒店、机票和租车API |
适用场景
谁在用PHPTRAVELS销售Hotelbeds
在线旅行社
以自有品牌提供大型酒店目录，Hotelbeds客房与您的直签特惠并列。
B2B旅行社
下级代理以自己的价格预订Hotelbeds酒店，并用信用额度或钱包付款。
DMC与旅游运营商
将Hotelbeds的酒店、接送和活动组合成套餐和行程。
为什么选择PHPTRAVELS
您的合同、您的平台、您的代码
包含源代码
在商业授权下自行托管，开发人员可以扩展Hotelbeds流程。
您自己的Hotelbeds账户
合同、净价和密钥都归您所有，保存在您自己的系统中。
24种语言
以目标市场的语言和币种销售Hotelbeds酒店，包括从右到左的语言。
B2C与B2B
一套系统同时支撑公共网站和代理商门户。
它将您的Hotelbeds账户接入PHPTRAVELS酒店模块，客人和代理商可以搜索Hotelbeds的实时房价和房态，PHPTRAVELS负责价格复核、预订、确认单、修改和取消。
需要。您与Hotelbeds签订合同，获得自己的API key、密钥以及允许的市场和币种。部分市场需要先完成认证，Hotelbeds才会开通正式访问。
不属于。Hotelbeds是独立的B2B床位批发商。PHPTRAVELS分别对接Hotelbeds和Expedia，两者可在同一套系统中运行。
Bedsonline是Hotelbeds集团旗下面向旅行社的品牌。PHPTRAVELS通过Hotelbeds API对接，并在酒店模块中映射内容。
支持，前提是您的Hotelbeds合同开通了相应API。它们可以单独销售，也可以与酒店一起销售。
取决于您的套餐，以及您启用的Hotelbeds产品和付款流程。套餐起价为Startup，一次性授权$2499；请查看价格页面或联系销售获取报价。