API đặt chỗ phà
API phà cho đại lý và OTA: chuyến phà, phương tiện và vé
API phà cho phép website của bạn hiển thị các chuyến phà thực giữa các cảng và bán vé ngay trong cùng một lượt truy cập. Trang này giải thích API phà trả về những gì, vì sao đặt phà cần nhiều hơn tên và ngày, vé và check-in hoạt động ra sao, và cách PHPTRAVELS biến kết nối phà thành hệ thống đặt chỗ trên tên miền của riêng bạn.
- Lịch chạy và chỗ trống
- Phương tiện, cabin và thú cưng
- Vé điện tử và check-in
- Island hopping
Đó là gì
API phà mô tả một mạng lưới cảng, không phải danh sách sản phẩm
Chuyến bay có mã sân bay, khách sạn có địa chỉ. Phà có cảng, các tuyến nối giữa các cảng và những nhà khai thác chạy từng tuyến vào những ngày nhất định. API phà mở mạng lưới đó ra trước, rồi mới đến các chuyến chạy trên đó.
Tuyến ví dụ
- PiraeusCảng đất liềnChặng 1 · nhiều nhà khai thác
- NaxosĐầu mối các đảoChặng 2 · chuyến theo mùa
- SantoriniĐảo
01Cảng
Các điểm đi và đến mà du khách tìm kiếm, kèm tên và quốc gia của cảng. Một số thành phố có nhiều hơn một bến, nên API trả về đúng cảng.
02Tuyến
Các đường nối hai cảng. Biểu mẫu tìm kiếm của bạn chỉ đưa ra những cặp cảng mà nhà khai thác đã kết nối thực sự chạy, nên du khách không bao giờ tìm một chuyến không tồn tại.
03Chuyến chạy
Các chuyến khởi hành theo ngày trên mỗi tuyến, kèm tàu, giờ và số chỗ còn lại trên tàu. Đây là phần thay đổi từng phút.
Phía sau, mô-đun phà giữ toàn bộ mạng lưới ở một nơi: các tuyến từ nhà khai thác đã kết nối nằm cạnh các tuyến bạn tự nhập, và các chặng chung một cảng sẽ nối thành hành trình dài hơn. Xem cách hoạt động trên trang Phà.
Lịch chạy và chỗ trống
Hai lệnh gọi lấp đầy bảng giờ khởi hành
Một lượt tìm phà thực chất là hai câu hỏi: tuyến và ngày này có những chuyến nào, và còn chỗ cho những hành khách và phương tiện này không. Nhà cung cấp trả lời riêng từng câu, và website của bạn cần cả hai trước khi hiển thị giá.
| Khởi hành | Đến | Tàu | Thời gian chạy | Chỗ trống |
|---|---|---|---|---|
| 07:00 | Naxos | Phà cao tốc | 3 giờ 35 phút | Đang bánChỉ có ghế, không chở xe |
| 07:25 | Naxos | Phà Ro-Pax | 5 giờ 40 phút | Đang bánGhế và chỗ để ô tô |
| 07:30 | Mykonos | Phà Ro-Pax | 5 giờ 15 phút | Sắp hết chỗGhế và chỗ để ô tô |
| 13:00 | Paros | Tàu hai thân | 3 giờ 10 phút | Đang bánChỉ có ghế, không chở xe |
| 17:30 | Santorini | Phà Ro-Pax | 7 giờ 50 phút | Sắp hết chỗNhững cabin cuối cùng |
| 21:00 | Heraklion | Phà du ngoạn | 9 giờ 00 phút | Hết chỗChuyến kế tiếp được đề xuất |
Dữ liệu minh họa, đã đơn giản hóa
- Lịch chạy
Có những chuyến nào
Đầu vào là tuyến, ngày và khung giờ; đầu ra là giờ đi, giờ đến, tàu và thời gian chạy. Lịch thay đổi theo mùa, nên được đọc trực tiếp hoặc làm mới thường xuyên, không bao giờ nhập tay.
- Chỗ trống
Trên tàu còn chỗ không
Chỗ trên boong, ghế, cabin và làn xe là các sức chứa riêng biệt. Một chuyến có thể còn ghế mà hết chỗ cho ô tô, nên việc kiểm tra được thực hiện cho đúng đoàn khách và phương tiện.
- Giá
Đoàn này phải trả bao nhiêu
Giá vé phụ thuộc loại hành khách, hạng chọn trên tàu và kích thước phương tiện. Giá được tính lại ngay trước khi thanh toán, vì cabin cuối cùng có thể đã bán hết.
Điều làm phà khác biệt
Một đơn đặt phà chở người, phương tiện và chỗ ngủ
Hãng bay chỉ cần tên và ngày. Nhà khai thác phà còn cần biết ai đi theo độ tuổi, thứ gì được đưa lên boong xe, mỗi người ngồi hay ngủ ở đâu và có động vật đi cùng không. Mỗi câu trả lời đều thay đổi giá và số chỗ còn lại.
01Hành khách theo loại
- Người lớn2
- Trẻ em1
- Em bé0
- Người cao tuổi0
Nhà khai thác tính giá người lớn, trẻ em, em bé và người cao tuổi khác nhau, và mỗi nơi tự đặt độ tuổi riêng. Một số tuyến có thêm giá cho cư dân hoặc sinh viên. API cho biết một tuyến chấp nhận những loại nào.
02Phương tiện
- Chiều dài
- Đến 5 m
- Chiều cao
- Dưới 2 m
Chỗ để xe được bán theo loại và kích thước. Chiều dài quyết định xe chiếm bao nhiêu làn; chiều cao quan trọng vì xe cao như xe cắm trại và xe van có thể cần boong khác. Khai sai kích thước có thể bị thu thêm phụ phí tại cảng.
03Trên tàu
- BoongChỗ ngồi tự do
- Ghế đặt trướcCó số
- CabinGiường, tính theo cabin
Chỗ trên boong, ghế đặt trước và cabin là các hạng riêng, mỗi hạng có sức chứa riêng. Ghế tính theo hành khách, cabin thường tính theo cabin, điều này quan trọng với các chuyến qua đêm.
04Thú cưng
1 con chó, đi trong lồng vận chuyển
Quy định khác nhau theo nhà khai thác và tàu: lồng vận chuyển, cabin cho phép thú cưng hoặc hoàn toàn không được. Thú cưng là dịch vụ thêm có giá riêng và số chỗ giới hạn, nên được đặt cùng vé.
Biểu mẫu minh họa, đã đơn giản hóa
Sau khi đặt chỗ
Xuất vé và check-in
Một đơn bán phà không kết thúc ở bước thanh toán. Du khách vẫn phải lên tàu, kế hoạch có thể đổi, và biển cũng có tiếng nói của nó. Đây là những phần mà API phà và nền tảng của bạn cùng xử lý.
Vé điện tử
Nhiều nhà khai thác phát hành vé điện tử kèm mã quét, du khách xuất trình trên điện thoại hoặc bản in. Nền tảng gửi vé qua email cùng hóa đơn và lưu trong tài khoản khách hàng.
Lên tàu tại cảng
Một số tuyến vẫn đổi mã đặt chỗ lấy thẻ lên tàu tại văn phòng nhà khai thác ở cảng. Xác nhận đặt chỗ cho du khách biết trường hợp nào áp dụng và đến đâu.
Hạn check-in
Phương tiện thường check-in sớm hơn hành khách đi bộ, và các tuyến quốc tế cần hộ chiếu. Bán online dừng ở hạn check-in của tuyến.
Thay đổi
Việc đổi ngày, giờ, hành khách hoặc phương tiện tuân theo điều kiện của loại giá vé và có thể mất phí hoặc chênh lệch giá. Vé được phát hành lại sau khi thay đổi.
Hủy chuyến do thời tiết
Nhà khai thác hủy hoặc hoãn chuyến vì thời tiết và tình trạng biển. Hãy lên kế hoạch thông báo cho du khách bị ảnh hưởng, chuyển sang chuyến kế tiếp hoặc hoàn tiền, theo điều khoản của nhà khai thác.
Hủy vé và hoàn tiền
Mỗi loại giá vé có quy tắc hoàn tiền riêng. Hãy hiển thị trước khi thanh toán để du khách biết mình mua gì, và hoàn tiền về phương thức thanh toán ban đầu.
Nhà khai thác công bố điều kiện riêng; nền tảng hiển thị chúng kèm từng chuyến. Hãy so sánh cách Phần mềm đặt vé phà xử lý việc này cho nhà khai thác và đại lý.
Có sẵn trong PHPTRAVELS
Connector phà bạn bật bằng tài khoản của chính mình
Các nhà cung cấp phà này đã được kết nối với mô-đun phà của PHPTRAVELS. Bạn thỏa thuận điều khoản với nhà cung cấp, nhập thông tin xác thực trong admin và các chuyến của họ xuất hiện trong kết quả tìm kiếm của bạn. Danh sách lấy trực tiếp từ thư mục tích hợp của chúng tôi.
Những cách khác để lấp đầy bảng
- Allotment: ghế, cabin và chỗ để xe mà nhà khai thác phân bổ cho bạn, ngừng bán khi hết.
- Tuyến của riêng bạn: các chuyến bạn tự khai thác hoặc ký hợp đồng, với lịch chạy và giá vé của bạn.
- API của một nhà khai thác phà khác: có thể thêm bất kỳ API nào có tài liệu, và mã nguồn thuộc về bạn. Xem Tích hợp API tùy chỉnh.
Island hopping
Nhiều chặng, một hành trình, một lần thanh toán
Chuyến đi giữa các đảo hiếm khi chỉ là một chặng. Du khách bay đến, di chuyển ra cảng, đi tàu đến một đảo rồi sang đảo tiếp theo. Kết hợp các chặng đó là nơi API phà trong một nền tảng đặt chỗ đầy đủ phát huy giá trị.
- Kiểm tra kết nốiMỗi chặng chỉ có thể bắt đầu sau khi chặng trước đến nơi, với khoảng cách tối thiểu do bạn đặt, nên không hành trình nào chứa kết nối bất khả thi.
- Một lần thanh toánMỗi chặng có thể đến từ nhà khai thác và nguồn khác nhau, nhưng khách chỉ thanh toán một lần và nhận một vé cho từng chặng.
- Thông tin được giữ nguyênHành khách và phương tiện chuyển từ chặng này sang chặng khác, nên không ai phải nhập lại cùng một thông tin.
Thêm chặng bay qua kết nối API vé máy bay và chặng ra cảng bằng Công nghệ đưa đón sân bay. Tất cả nằm cạnh các API du lịch khác trên cùng một nền tảng.
- Bay đến AthensChặng bay, từ bất kỳ nhà cung cấp chuyến bay nào bạn kết nối.
- Sân bay đến PiraeusĐưa đón từ sân bay đến bến phà.
- Piraeus → NaxosChặng biển đầu tiên, có ô tô và hai người lớn trên tàu.
- 3 đêm ở NaxosLưu trú khách sạn giữa hai chặng biển.
- Naxos → SantoriniChặng biển thứ hai, có thể với nhà khai thác khác.
Đưa API phà vào hoạt động trên website của bạn
Tìm chuyến và đặt phà trên bản demo trực tiếp, rồi cho chúng tôi biết bạn định bán những tuyến và nhà khai thác nào.
Bạn đang xây ứng dụng riêng? REST API và webhook đi kèm gói Enterprise. So sánh Bảng giá hoặc đọc tài liệu dành cho nhà phát triển.
API phà là một bộ dịch vụ web của nhà khai thác phà hoặc nền tảng đặt phà, cho phép website du lịch đọc thông tin cảng, tuyến và lịch chạy, kiểm tra chỗ trống cho hành khách và phương tiện, tạo đơn đặt chỗ và nhận vé theo thời gian thực.
Đặt phà có thêm phương tiện tính giá theo loại và kích thước, các hạng trên tàu như chỗ boong, ghế và cabin, cùng thú cưng. Chỗ trống được tính riêng cho từng loại, và hạn check-in khác nhau giữa hành khách đi bộ và phương tiện.
Có, khi nhà khai thác chở phương tiện trên chuyến đó. Đơn đặt gửi loại và kích thước phương tiện, và giá vé đã gồm chỗ của xe trên boong xe.
Có, khi tàu có cabin. Cabin là một hạng riêng với sức chứa riêng và thường tính giá theo cabin thay vì theo hành khách.
Các nhà cung cấp phà hiển thị trên trang này lấy từ thư mục tích hợp trực tiếp của chúng tôi. PHPTRAVELS là đối tác công nghệ chính thức của Kikoto Ferries, và các nhà khai thác khác có thể được thêm qua tích hợp tùy chỉnh.
Không. Bạn thỏa thuận điều khoản với từng nhà cung cấp phà và nhập thông tin xác thực của chính mình trong admin. PHPTRAVELS cung cấp nền tảng đặt chỗ và các connector có sẵn.
Có. Khách thêm từng chặng một, mỗi chặng được kiểm tra với giờ đến của chặng trước, và cả hành trình được thanh toán trong một lần với một vé cho mỗi chặng.
Có. Tuyến bạn tự khai thác hoặc ký hợp đồng, allotment của nhà khai thác và các chuyến từ API xuất hiện trong cùng một kết quả tìm kiếm, mỗi loại có giá vé và markup riêng.
Có. Đại lý B2B đặt chỗ trong cổng đại lý của bạn với markup hoặc hoa hồng riêng và thanh toán từ số dư ví, trên cùng một bản cài đặt với website công khai của bạn.
Khám phá thêm
Thêm về nền tảng
- PhàTuyến đường biển
- Phần mềm đặt vé phàBán vé phà với tư cách hãng tàu hoặc đại lý
- Hợp tác Kikoto FerriesĐối tác công nghệ chính thức của Kikoto Ferries
- API du lịchAPI GDS, khách sạn, tour, xe và thanh toán
- API vé máy bayAPI vé máy bay từ GDS, NDC và nhà gom vé trên một nền tảng
- Công nghệ đưa đón sân bayBán dịch vụ đưa đón sân bay và khách sạn với Kiwitaxi