酒店
包括青年旅舍和民宿
- 预订对象
- 有许多相同客房的房型,或共享宿舍里的一张床。
- 定价
- 按客房和餐食安排的每晚价格,加人或加儿童可能改变价格。
- 入住规则
- 仅在高峰日期要求最少入住晚数,大多数夜晚可单晚预订。
- 费用与押金
- 城市税或旅游税,有时还有在酒店支付的度假村费。
- 到达
- 24小时或有人值守的前台,凭证上的入住时间就够了。
- 典型来源
- 床库(Bedbank)和批发商、直签合同、渠道管理系统。
住宿API
住宿API把各类住宿送到您的预订网站:酒店客房、服务式公寓、度假屋、青年旅舍和民宿。本页讲解一次住宿背后的数据、租赁与酒店不同的规则,以及PHPTRAVELS如何在一次搜索中同时销售您自己的房源和供应商库存。
数据模型
无论是300间客房的酒店,还是一栋海边小屋,住宿API都用同样的四个嵌套层级来描述。每一层回答客人订房前会问的不同问题。
01房源
住宿地点本身:名称、类型、地址与地图位置、照片、设施、星级或品质评分、入住规则和入住时间。
property_id · type · address · geo · photos · amenities · check_in_from
02客房或单元
实际被预订的对象:一种房型、一整套公寓或宿舍里的一张床,包含面积、床位和最多入住人数。
unit_id · beds · size_m2 · max_adults · max_children
03价格方案
该单元的销售方式:餐食安排、取消政策、付款条件,以及谁可以预订,例如公开或仅限代理。
rate_plan_id · board · cancel_policy · payment · channel
04可订状态
每晚一行:价格、剩余单元数、最少入住晚数,以及当天是否允许入住或退房。
date · price · units_left · min_stay · closed_to_arrival

PHPTRAVELS把住宿模块命名为Stays,因为同一个模型涵盖的远不止酒店。一个房源包含多个单元,一个单元通过一个或多个价格方案销售,每个价格方案都有逐晚的价格与可订日历。把这四层理清,青旅的一张床、酒店的套房、三卧室的别墅,都能适配同一套搜索和结账流程。
各供应商对这些层级的叫法不同,有的还把其中两层合并,但这个结构始终存在。酒店把每个来源都映射到这一结构,客人看到的是统一的页面。
逐晚管理
每个住宿API最终都落到日历上。只有所请求住宿期间的每一晚都可订、有定价且符合入住规则时,搜索才会返回该房源。
示意数据,已简化
住宿不只是酒店
数据模型是共通的,但不同类型的住宿填充方式不同。当您销售的不只是酒店客房时,预订流程需要处理这些差异。
包括青年旅舍和民宿
公寓式酒店和城市公寓
度假屋、别墅和木屋
销售的是众多房东的房子,而不是自己签约的房源?那属于平台模式,详见BnB 门户页面。
取消政策期限
取消政策是从入住日倒推的时间线。每个期限规定了客人在该期限内取消时能拿回多少。
自有库存与API库存
大多数住宿销售商两者兼顾:自己签约的房源自行录入,其余通过供应商API补充。旅客不应察觉某个住宿来自哪里。
PHPTRAVELS已就绪
以下住宿供应商目前已对接Stays模块。您与供应商签约,在后台填入自己的凭证,在其沙盒环境测试后即可上线。名单实时来自我们的集成目录。
需要名单之外的供应商,比如区域性的租赁网络?只要有文档的住宿API都可以添加,详见定制API集成。酒店供应商类型与内容映射请阅读酒店API页面,两个最大床库的指南是RateHawk API对接和Hotelbeds API 集成。
住宿API是一组网络服务,让预订网站可以搜索住宿、读取指定日期和人数的价格与可订状态,并创建、查询和取消预订。它涵盖酒店以及其他所有类型的住宿:公寓、度假租赁、青年旅舍和民宿。
核心调用是一样的。住宿API还要处理非酒店住宿所需的内容:整套预订、最少入住晚数与换客日、加人收费、清洁费、可退还押金,以及到达前发送的入住说明。
可以。在PHPTRAVELS中,Stays模块对所有住宿类型使用同一个由房源、单元、价格方案和可订状态组成的模型,因此酒店、公寓和度假屋会带着各自的规则出现在同一次搜索中。
日历中的每一晚都可以设置最少入住时长,通常与入住日绑定。如果客人搜索的晚数少于最少要求,该单元就不会返回。不可入住和不可退房的标记对换客日也是同样的原理。
可以。您可以自行添加房源、单元、价格方案和日历,给房东提供Extranet登录,或从渠道管理系统获取价格,并与供应商库存一起在同一份结果列表中销售。
来自价格方案。供应商库存带有供应商的政策,您自己的房源则使用您设置的期限。截止时间会在付款前展示给客人,并印在凭证上。
不会。您需要与每个住宿供应商签约,并在后台填入自己的凭证。PHPTRAVELS提供预订平台、Stays模块和现成的连接器。
可以。在Enterprise套餐中,PHPTRAVELS REST API以统一格式开放所有已对接来源的搜索和预订,并提供预订事件Webhook和可供扩展的完整源代码。
一份PHPTRAVELS许可证、您自己的域名,以及至少一个库存来源:您自己签约的房源、渠道管理系统,或与住宿批发商的供应商合同。可以先通过在线演示了解完整流程。
用于广告效果衡量的 Cookie
我们使用 Google Cookie 来衡量哪些广告带来了访问和咨询,并向您展示相关广告。点击“接受”即可允许,或点击“拒绝”,仅保留网站正常运行所需的 Cookie。 隐私声明