渡轮预订 API
面向旅行社和 OTA 的渡轮 API：航次、车辆与船票
渡轮 API 让您的网站展示港口之间的真实航次，并在同一次访问中售出船票。本页介绍渡轮 API 返回什么、渡轮预订为何需要姓名和日期之外的更多信息、船票与值机如何运作，以及 PHPTRAVELS 如何把渡轮对接变成您自己域名上的预订引擎。
- 时刻表与余位
- 车辆、客舱与宠物
- 电子船票与值机
- 跳岛游
概念
渡轮 API 描述的是港口网络，而不是商品列表
航班有机场代码，酒店有地址，渡轮则有港口、港口之间的航线，以及在特定日期运营各条航线的船公司。渡轮 API 先提供这张网络，再提供网络上的航次。
航线示例
- 比雷埃夫斯大陆港口第 1 段 · 多家船公司
- 纳克索斯岛屿枢纽第 2 段 · 季节性航次
- 圣托里尼岛屿
01港口
旅客搜索时选择的出发地和目的地，包含港口名称和国家。有些城市有多个码头，因此 API 会返回确切的港口。
02航线
连接两个港口的线路。搜索表单只提供已接入的船公司实际运营的港口组合，旅客不会搜到不存在的航线。
03航次
每条航线上按日期安排的出发班次，包含船舶、时间和船上剩余位置。这部分每分钟都可能变化。
在后台，渡轮模块把整个网络集中管理：已接入船公司的航线与您自行录入的航线并列，共用港口的航线会衔接成更长的行程。详见 轮渡 页面。
时刻表与余位
两次调用填满出发信息板
渡轮搜索其实是两个问题：这条航线、这个日期有哪些航次，以及这些乘客和这辆车是否还有位置。供应商分别回答这两个问题，您的网站在显示价格前两者都需要。
| 出发 | 目的地 | 船舶 | 航程 | 余位 |
|---|---|---|---|---|
| 07:00 | 纳克索斯 | 高速渡轮 | 3 小时 35 分钟 | 在售仅座位，不可载车 |
| 07:25 | 纳克索斯 | 客滚渡轮 | 5 小时 40 分钟 | 在售座位与车位 |
| 07:30 | 米科诺斯 | 客滚渡轮 | 5 小时 15 分钟 | 余位紧张座位与车位 |
| 13:00 | 帕罗斯 | 双体船 | 3 小时 10 分钟 | 在售仅座位，不可载车 |
| 17:30 | 圣托里尼 | 客滚渡轮 | 7 小时 50 分钟 | 余位紧张客舱所剩无几 |
| 21:00 | 伊拉克利翁 | 邮轮式渡轮 | 9 小时 00 分钟 | 已满下一个可订航次 |
示意数据，已简化
- 时刻表
有哪些航次
输入航线、日期和时间段，返回出发、到达、船舶和航程时间。时刻表随季节变化，因此要实时读取或频繁刷新，绝不手工录入。
- 余位
船上是否还有位置
甲板位、座位、客舱和车道是各自独立的容量。一个航次可能还有座位却没有车位，所以要针对确切的乘客组合和车辆来查询。
- 价格
这组旅客需支付多少
票价取决于乘客类型、所选舱位等级和车辆尺寸。付款前会再次计价，因为最后一间客舱可能已售出。
渡轮有何不同
渡轮预订涉及人员、车辆和住宿的位置
航空公司只需要姓名和日期。渡轮运营商还需要知道按年龄段划分的乘客、开上车辆甲板的是什么车、每个人坐在哪里或睡在哪里，以及是否带有宠物。每一项答案都会影响价格和剩余空间。
01按类型划分的乘客
- 成人2
- 儿童1
- 婴儿0
- 老年人0
运营商对成人、儿童、婴儿和老年人的定价不同，年龄段也各自设定。部分航线还有居民或学生票价。API 会告诉您该航线接受哪些类型。
02车辆
- 长度
- 不超过 5 米
- 高度
- 低于 2 米
车位按类型和尺寸出售。长度决定占用多少车道；高度同样重要，房车、厢式货车等高大车辆可能需要另一层甲板。尺寸填错可能在港口被加收费用。
03船上
- 甲板自由座
- 预留座位带编号
- 客舱铺位，按客舱计
甲板位、预留座位和客舱是容量各自独立的舱位等级。座位按乘客计价，客舱通常按间计价，这在夜间航行中尤为重要。
04宠物
1 只狗，装在笼中同行
规定因运营商和船舶而异：可能要求使用笼具、提供可带宠物的客舱，或完全不允许。宠物是有独立价格和名额限制的附加项，因此随船票一并预订。
示意表单，已简化
预订之后
出票与值机
渡轮销售并非付款就结束。旅客还要登船，计划会变，海况也有话语权。这些环节由渡轮 API 与您的平台共同处理。
电子船票
许多运营商会签发带可扫描二维码的电子船票，旅客可在手机上或打印出示。平台将其与发票一同发送到邮箱，并保存在客户账户中。
港口登船
部分航线仍需在运营商的港口办公室用预订编号换取登船牌。预订确认会告知旅客属于哪种情形以及去哪里办理。
值机截止时间
车辆通常比步行乘客更早值机，国际航线还需要护照。线上销售在航线的值机截止时间停止。
改签
日期、时间、乘客或车辆的变更遵循票价条件，可能产生手续费或票价差额。变更后会重新出票。
天气取消
运营商会因天气和海况取消或推迟航次。请按运营商条款规划如何通知受影响的旅客，并将其改到下一航次或退款。
取消与退款
每种票价都有各自的退款规则。请在付款前展示，让旅客清楚所购内容，并通过原支付方式退款。
运营商会公布各自的条件，平台随每个航次一并展示。关于运营商和旅行社的处理方式，请对比渡轮预订软件。
PHPTRAVELS 已就绪
用您自己的账号即可启用的渡轮连接器
以下渡轮供应商已接入 PHPTRAVELS 渡轮模块。您与供应商签订条款，在后台填入自己的凭据，其航次就会出现在您的搜索结果中。名单实时来自我们的集成目录。
填充信息板的其他方式
- 配额：运营商分配给您的座位、客舱和车位，售完即止。
- 自有航线：您自己运营或签约的航线，使用您自己的时刻表和票价。
- 其他渡轮运营商的 API：任何有文档的 API 都可以接入，源代码归您所有。参见定制API集成。
跳岛游
多段航程，一次行程，一次付款
跳岛游很少只乘一程。旅客飞抵后转乘至港口，先到一座岛，再到下一座。把这些航段组合起来，正是把渡轮 API 放进完整预订平台的价值所在。
- 衔接检查每一段只能在上一段到达后、间隔不短于您设定的最短时间才能开始，因此行程中不会出现无法衔接的情况。
- 一次结账每一段可来自不同的运营商和来源，客户仍只需付款一次，并获得每段的船票。
- 信息自动带入乘客和车辆信息会在各段之间传递，无需重复填写。
通过 机票 API 对接添加航班段，用 机场接送技术 添加前往港口的接送。它们与其他 旅游API 一起运行在同一个平台上。
- 飞往雅典航班段，来自您接入的任一机票供应商。
- 机场至比雷埃夫斯从机场到渡轮码头的接送。
- 比雷埃夫斯 → 纳克索斯第一程航行，携带汽车和两名成人。
- 纳克索斯 3 晚两程航行之间的酒店住宿。
- 纳克索斯 → 圣托里尼第二程航行，可能是另一家运营商。
渡轮 API 是由渡轮运营商或渡轮预订平台提供的一组网络服务，让旅游网站能够读取港口、航线和时刻表，查询乘客与车辆的余位，创建预订并实时获取船票。
渡轮预订增加了按类型和尺寸计价的车辆、甲板位/座位/客舱等船上舱位，以及宠物。各项余位分别计数，步行乘客与车辆的值机截止时间也不同。
可以，前提是运营商在该航次承运车辆。预订会发送车辆类型和尺寸，票价已包含其在车辆甲板上的位置。
可以，只要船上提供客舱。客舱是容量独立的舱位等级，通常按间而不是按乘客计价。
本页展示的渡轮供应商来自我们的实时集成目录。PHPTRAVELS 是 Kikoto Ferries 的官方技术合作伙伴，其他运营商可通过定制集成加入。
不会。您需要与每家渡轮供应商签订条款，并在后台填入自己的凭据。PHPTRAVELS 提供预订平台和现成的连接器。
可以。客户逐段添加航程，每一段都会与上一段的到达时间核对，整个行程一次结账，每段都有船票。
可以。您自己运营或签约的航线、运营商配额和 API 航次会出现在同一次搜索中，各自使用独立的票价和加价。
可以。B2B 代理在您的代理门户中预订，使用各自的加价或佣金，并从钱包余额支付，与您的公开网站在同一套系统上。