邮轮公司
合作邮轮公司
合作邮轮 · 7 晚
- 登船
- 2027-05-15
- 返回
- 2027-05-22
行程
- D1南安普敦--:-- · 17:00
- D2海上航行
- D3布鲁日（泽布吕赫）08:00 · 18:00
- D4阿姆斯特丹09:00 · 19:00
- D5海上航行
- D6哥本哈根07:00 · 17:00
- D7奥斯陆09:00 · 16:00
- D8南安普敦07:00 · --:--
仅为示意记录，并非任何一家邮轮公司的格式。
邮轮预订 API
面向旅行社的邮轮 API：航次、舱房与付款计划
借助邮轮 API，您的网站可以展示实时航次、为各舱房类别报价，并向邮轮公司创建邮轮订单。本页说明数据长什么样、舱房与付款如何运作，以及把邮轮库存放到自己的 PHPTRAVELS 网站上的两种方式。
- 航次与行程
- 舱房类别与甲板平面图
- 订金与尾款
- 定制邮轮对接
邮轮 API 返回什么
用数据描述一个航次
邮轮以航次为单位销售：一艘船、一条行程、一个出发日期。无论格式如何，所有邮轮 API 都围绕这一单位构建。
搜索时会发送地区、月份或日期范围、行程天数和入住人数。返回结果是航次列表，每个航次包含船名、邮轮公司、登船和返回日期、各挂靠港及时间、海上航行天数，以及仍有空位的每个舱房类别的每人起价。
之后，后续调用会按真实乘客为所选类别计价、列出可选舱房、创建订单，并针对订单收款。各邮轮公司的名称和格式各不相同，因此平台会在展示给乘客之前，把所有来源映射到同一套航次、舱房和订单模型。
可订
舱房类别
船上的四个层级：内舱、海景、阳台、套房
邮轮 API 会在每个航次下列出舱房类别。舱房类别是价格的主要驱动因素，每一类都会同时改变多个条件。
- 01内舱无窗
航次的入门价格。邮轮公司常按甲板和位置把它拆分为多个类别，每个类别有各自的代码。
价格水平 - 02海景窗户或舷窗
更进一步，可以享受自然光。部分类别视野受阻，API 会在类别描述中标明。
价格水平 - 03阳台私人阳台
带私人户外空间，类别会因甲板高度以及位于船中部还是船尾而不同。
价格水平 - 04套房阳台与起居区
价目表的最高一档，票价中常附带额外权益，也是最常按指定舱房出售的类别。
价格水平
类别代码与票价代码
每个类别都有代码，每个航次也可以按多个票价代码销售：标准票价、促销票价，以及团体或代理价。同一间舱房，票价代码不同，价格和条件也不同。
保证舱房还是指定舱房
保证预订是乘客购买一个类别，由邮轮公司稍后分配该类别或更高类别的舱房；指定舱房预订则在订票时就锁定舱房号。许多邮轮公司对两者的定价不同。
选择舱房
在甲板平面图上选舱房
当邮轮公司允许指定舱房预订时，API 会返回所选类别中仍可订的舱房，并附上甲板、位置和每间可住人数。
9 层甲板
请选择舱房
船头船尾
0814
242636
29
011119
- 内舱
- 海景
- 阳台
- 套房
- 不可订
舱房 9110
内舱
内侧舱房，是这层甲板上价格最低的一档。可按指定舱房或保证预订出售。
海景
位于船头、船体收窄处的带窗舱房。API 会随类别一并返回景观说明。
阳台
船中部的阳台舱房。在甲板上的位置往往是另一个独立类别，有自己的价格。
套房
朝向船尾、阳台更大的套房。通常按指定舱房预订，而非保证预订。
- 1.列出舱房乘客选好类别后，平台向邮轮公司查询该类别的空闲舱房，并画在甲板上。
- 2.保留舱房许多邮轮 API 允许在乘客填写姓名和付款期间，短时间保留所选舱房。
- 3.确认预订订单确认舱房号、乘客和票价代码，邮轮公司返回其订单编号。
在 PHPTRAVELS 的邮轮中，每艘船都带有甲板和舱房类别，无论舱房是您自己的还是来自已连接的邮轮公司，乘客都能在了解实际情况后再做选择。
付款计划
先付订金，余款在启航前付清
邮轮通常提前数月预订，并分阶段付款。每个航次和票价的日期与金额由邮轮公司设定，API 会随订单一并返回。
- 01
订票与订金
乘客按邮轮公司设定的金额支付订金（按人或按订单），以确认舱房。
- 02
尾款到期
余款须在出发前邮轮公司规定的日期之前付清。逾期未付的订单，邮轮公司可在该日期后取消。
- 03
证件文件
全额付清后，邮轮公司发放邮轮文件，乘客填写登船所需信息。
- 04
启航日
乘客登船。此后的变更在船上或按邮轮公司规则处理。
各时间段的取消罚金
订金阶段罚金上升最高罚金
距离启航越近，取消时扣留的票款比例越高。时间段和比例由各邮轮公司和票价决定，因此邮轮 API 会随订单返回，平台在付款前展示给乘客。
销售您自己签约的航次时，邮轮的运作方式相同：您为每个航次设置订金和尾款到期日，未结余额会在后台持续跟踪，直至付清。
邮轮定价
邮轮价格是怎么构成的
邮轮价格与酒店或机票不同。邮轮 API 会把各个组成部分分开返回，您的预订引擎需要按邮轮公司的方式把它们合并起来。
在邮轮公司价格之上，PHPTRAVELS 可按船只、航次或渠道应用您的加价和佣金，B2B 旅游门户中的代理商看到的是自己的净价。
按人计价，而非按舱房
邮轮票价按每位乘客报价。双人舱的价格是人均票价的两倍，API 会按年龄和在舱房中的位置为每位乘客计价。
以两人同住为基础
起价按两位乘客同住计算。第三、第四位乘客通常票价更低，单人入住的乘客需要支付单人附加费。
税费、手续费与港口费用
政府税费、手续费和港口费用在邮轮票价之外按人加收。请把它们作为单独的行展示，让总价没有意外。
船上消费额度与附加项目
部分票价包含船上消费额度、饮品套餐或小费。API 会把这些作为票价包含项返回，这也是同一间舱房出现两种票价的原因之一。
如何获得邮轮库存
自有合同，或邮轮公司 API
把邮轮放到您的网站上有两条路径。许多旅行社先从第一种开始，业务量上来后再加入第二种。
邮轮模块已就绪
录入您自己的邮轮合同
在后台录入您签约的航次：船只、甲板、舱房类别、逐港行程、出发日期、人均票价、季节、订金和尾款日期。还可以给邮轮合作伙伴分配供应商账号，让他们自行维护自己的航次。
- 您持有的团体舱位和配额
- 按邮轮公司设置佣金
- 面向 B2B 代理商的净价
- 安装当天即可上线
定制对接
连接邮轮公司或邮轮批发商 API
PHPTRAVELS 的对接列表中没有现成的邮轮连接器。由于每个套餐都包含完整源代码，邮轮公司或邮轮批发商的 API 会作为定制API集成接入，并映射到模块已经展示的航次、舱房和订单上。
- 您与邮轮公司或批发商签约
- 您自行获取并保管 API 凭证
- 连接器映射航次、类别和舱房
- 订单、付款和取消遵循邮轮公司的规则
在找供应商？旅游 XML API 供应商名录列出了通过 API 分销的邮轮公司，什么是 API 集成则说明这类对接是如何搭建的。
邮轮 API 是邮轮公司或邮轮批发商向旅游销售方开放的一组网络服务。您的系统可以用它搜索航次、读取行程、为舱房类别报价、列出可订舱房、创建订单，并收取订金和尾款。
不包含。邮轮模块围绕您自己管理的库存构建：您签约的船只、舱房类别和航次。与特定邮轮公司或批发商的连接，会基于随附的源代码作为定制对接来开发。
以旅游销售方的身份向邮轮公司或邮轮批发商申请。各邮轮公司和市场的准入条件不同。协议由您自己签署，凭证也由您自己接收；PHPTRAVELS 不提供供应商凭证。
保证预订以固定价格锁定一个舱房类别，由邮轮公司稍后分配实际舱房，类别相同或更高。指定舱房预订则在订票时就锁定舱房号。
由邮轮公司按航次和票价设定，其 API 会随订单一并返回。对于您自行录入的航次，则在后台为每个航次设置订金和尾款到期日。
邮轮票价按每位乘客报价，通常以两人同住一间舱房为基础。第三、第四位乘客各付各自的票价，单人入住需付单人附加费，税费、手续费和港口费用按人加收。
可以。代理商在 B2B 门户中使用自己的净价和佣金下单，并从代理商钱包付款，与您的公开网站运行在同一套安装上。
企业版套餐包含带文档的 PHPTRAVELS REST API 和 Webhook，且每个套餐都包含完整源代码，因此开发人员可以扩展邮轮预订引擎，或将其接入其他系统。
先把您已签约的航次录入邮轮模块，看看销售情况。当与某家邮轮公司的合作或业务量值得投入时，再通过定制对接加入该公司的 API。