API đặt du thuyền
API du thuyền cho phép website của bạn hiển thị các chuyến đi theo thời gian thực, tính giá từng hạng cabin và tạo đặt chỗ với hãng tàu. Trang này giải thích dữ liệu trông như thế nào, cabin và thanh toán vận hành ra sao, cùng hai cách đưa nguồn hàng du thuyền lên website PHPTRAVELS của riêng bạn.
API du thuyền trả về gì
Du thuyền được bán theo từng chuyến: một con tàu, một hành trình, một ngày khởi hành. Mọi API du thuyền, dù định dạng nào, đều xây dựng quanh đơn vị này.
Một lần tìm kiếm gửi đi khu vực, tháng hoặc khoảng ngày, thời lượng và số khách. Kết quả là danh sách chuyến đi, mỗi chuyến có tàu, hãng tàu, ngày lên tàu và ngày về, các cảng ghé kèm giờ, số ngày trên biển và giá khởi điểm mỗi người cho từng hạng cabin còn chỗ.
Từ đó, các lệnh gọi tiếp theo tính giá hạng đã chọn cho khách thực tế, liệt kê các cabin có thể chọn, tạo đặt chỗ và nhận thanh toán. Tên gọi và định dạng khác nhau giữa các hãng, nên nền tảng chuyển mọi nguồn về cùng một mô hình chuyến đi, cabin và đặt chỗ trước khi khách nhìn thấy.
Hãng tàu
Hãng tàu đối tác của bạn
Tàu đối tác · 7 đêm
Hành trình
Bản ghi minh họa, không phải định dạng của riêng hãng tàu nào.
Hạng cabin
Dưới mỗi chuyến đi, API du thuyền liệt kê các hạng cabin. Đây là yếu tố chính quyết định giá, và mỗi hạng thay đổi nhiều thứ cùng lúc.
Mức giá đầu vào của chuyến đi. Các hãng thường chia thành nhiều hạng theo boong và vị trí, mỗi hạng có mã riêng.
Cao hơn một bậc nhờ có ánh sáng tự nhiên. Một số hạng bị che tầm nhìn, và API ghi chú điều này trong mô tả hạng.
Không gian ngoài trời riêng, với các hạng thay đổi theo độ cao boong và vị trí giữa tàu hay đuôi tàu.
Đỉnh của bảng giá, thường kèm tiện ích đã gồm trong giá vé, và là các hạng hay được bán dưới dạng cabin cụ thể nhất.
Mỗi hạng có một mã, và mỗi chuyến đi có thể bán theo nhiều mã giá vé: giá tiêu chuẩn, giá khuyến mãi và giá đoàn hoặc đại lý. Cùng một cabin có thể có giá và điều kiện khác nhau tùy mã giá vé.
Với đặt chỗ đảm bảo hạng, khách mua một hạng cabin và hãng tàu chỉ định cabin sau, trong hạng đó hoặc cao hơn. Đặt cabin cụ thể cố định số cabin ngay khi đặt. Nhiều hãng tính giá hai loại này khác nhau.
Chọn cabin
Khi hãng tàu cho phép đặt cabin cụ thể, API trả về các cabin còn trống trong hạng đã chọn, kèm boong, vị trí và số khách mỗi cabin chứa được.
Boong 9
Chọn một cabin
Cabin 9110
Cabin trong
Cabin bên trong, giá thấp nhất trên boong này. Bán dưới dạng cabin cụ thể hoặc đảm bảo hạng.
Nhìn ra biển
Cabin có cửa sổ ở mũi tàu, nơi thân tàu thu hẹp. API trả về ghi chú về tầm nhìn cùng với hạng.
Ban công
Cabin ban công giữa tàu. Vị trí trên boong thường là một hạng riêng với giá riêng.
Suite
Suite hướng về đuôi tàu với ban công rộng hơn. Thường đặt dưới dạng cabin cụ thể, không phải đảm bảo hạng.
Trong Du thuyền của PHPTRAVELS, tàu có boong và hạng cabin riêng để khách chọn khi đã nắm đủ thông tin, dù cabin là của bạn hay đến từ hãng tàu được kết nối.
Lịch thanh toán
Du thuyền được đặt trước nhiều tháng và thanh toán theo từng đợt. Hãng tàu quy định ngày và số tiền cho từng chuyến đi và giá vé, và API trả về cùng với đặt chỗ.
Khách trả khoản đặt cọc do hãng tàu quy định, tính theo người hoặc theo đặt chỗ, để xác nhận cabin.
Số dư đến hạn vào ngày hãng tàu quy định trước khi khởi hành. Đặt chỗ chưa thanh toán có thể bị hãng hủy sau thời điểm đó.
Khi đã thanh toán đủ, hãng tàu phát hành giấy tờ du thuyền và khách hoàn tất thông tin check-in.
Khách lên tàu. Các thay đổi sau thời điểm này được xử lý trên tàu hoặc theo quy định của hãng.
Càng gần ngày khởi hành, phần giá vé bị giữ lại khi hủy càng lớn. Các mốc thời gian và tỷ lệ phần trăm thuộc về từng hãng và giá vé, nên API du thuyền gửi chúng cùng đặt chỗ và nền tảng của bạn hiển thị cho khách trước khi thanh toán.
Khi bạn bán các chuyến đi tự ký hợp đồng, Du thuyền hoạt động theo cách tương tự: bạn đặt tiền cọc và hạn thanh toán số dư cho từng chuyến, và các khoản còn nợ được theo dõi trong trang quản trị cho đến khi thanh toán xong.
Giá trong du thuyền
Giá du thuyền được đọc khác với giá khách sạn hay vé máy bay. API du thuyền trả về từng phần riêng biệt, và công cụ đặt chỗ của bạn phải ghép chúng lại giống như hãng tàu.
Trên giá của hãng tàu, PHPTRAVELS áp dụng mức tăng giá và hoa hồng của bạn theo tàu, chuyến đi hoặc kênh bán, và các đại lý trong Cổng du lịch B2B thấy giá net riêng của họ.
Giá vé du thuyền được báo theo từng khách. Cabin cho hai người có giá gấp đôi giá mỗi người, và API tính giá từng khách theo độ tuổi và vị trí trong cabin.
Giá khởi điểm giả định hai khách ở chung. Khách thứ ba và thứ tư thường trả giá thấp hơn, còn khách đi một mình phải trả phụ thu phòng đơn.
Thuế nhà nước, phí và phí cảng được cộng theo từng người vào giá vé du thuyền. Hãy hiển thị chúng thành các dòng riêng để tổng tiền không có bất ngờ.
Một số giá vé đã gồm tín dụng chi tiêu trên tàu, gói đồ uống hoặc tiền thưởng phục vụ. API trả về chúng dưới dạng quyền lợi đi kèm, và đó là một lý do khiến hai giá vé cho cùng một cabin khác nhau.
Cách có nguồn hàng du thuyền
Có hai cách để đưa du thuyền lên website của bạn. Nhiều đại lý bắt đầu từ cách thứ nhất và bổ sung cách thứ hai khi sản lượng đủ lớn.
Nhập vào trang quản trị các chuyến đi bạn ký hợp đồng: tàu, boong, hạng cabin, hành trình từng cảng, ngày khởi hành, giá mỗi người, mùa, tiền cọc và ngày thanh toán số dư. Đối tác du thuyền có thể được cấp tài khoản nhà cung cấp để tự cập nhật các chuyến đi của họ.
Danh sách tích hợp của PHPTRAVELS chưa có trình kết nối du thuyền dựng sẵn. Vì mọi gói đều gồm toàn bộ mã nguồn, API của một hãng tàu hoặc đơn vị tổng hợp du thuyền được kết nối dưới dạng Tích hợp API tùy chỉnh, ánh xạ vào cùng các chuyến đi, cabin và đặt chỗ mà module đã hiển thị.
Đang tìm nhà cung cấp? Danh sách nhà cung cấp XML API du lịch liệt kê các hãng tàu phân phối qua API, và Tích hợp API là gì giải thích cách xây dựng một kết nối như vậy.
Mở bản demo trực tiếp để tìm chuyến đi, so sánh hạng cabin và đặt chỗ kèm tiền cọc, rồi so sánh các gói tại Bảng giá.
API du thuyền là tập hợp dịch vụ web mà hãng tàu hoặc đơn vị tổng hợp du thuyền mở cho người bán du lịch. Hệ thống của bạn dùng nó để tìm chuyến đi, đọc hành trình, tính giá hạng cabin, liệt kê cabin còn trống, tạo đặt chỗ và nhận tiền cọc cùng thanh toán cuối.
Không. Module Du thuyền được xây dựng quanh nguồn hàng do bạn tự quản lý: tàu, hạng cabin và các chuyến đi bạn ký hợp đồng. Kết nối với một hãng tàu hoặc đơn vị tổng hợp cụ thể được phát triển như một tích hợp tùy chỉnh trên mã nguồn đi kèm.
Bạn đăng ký với hãng tàu hoặc đơn vị tổng hợp du thuyền với tư cách người bán du lịch. Điều kiện truy cập khác nhau tùy hãng và thị trường. Bạn tự ký thỏa thuận và nhận thông tin xác thực; PHPTRAVELS không bao giờ cung cấp thông tin xác thực của nhà cung cấp.
Đặt chỗ đảm bảo hạng giữ một hạng cabin với mức giá đã định, và hãng tàu chỉ định cabin thực tế sau, trong hạng đó hoặc cao hơn. Đặt cabin cụ thể cố định số cabin ngay khi đặt.
Hãng tàu quy định theo từng chuyến đi và giá vé, và API của họ trả về cùng với đặt chỗ. Với các chuyến đi bạn tự nhập, bạn đặt tiền cọc và hạn thanh toán số dư cho từng chuyến trong trang quản trị.
Giá vé du thuyền được báo theo từng khách, thường dựa trên hai khách ở chung một cabin. Khách thứ ba và thứ tư trả giá riêng, khách đi một mình trả phụ thu phòng đơn, còn thuế, phí và phí cảng được cộng theo từng người.
Có. Đại lý đặt chỗ trong cổng B2B với giá net và hoa hồng riêng, thanh toán từ ví đại lý, trên cùng một bản cài đặt với website công khai của bạn.
Gói Enterprise gồm REST API và webhook của PHPTRAVELS kèm tài liệu, và mọi gói đều gồm toàn bộ mã nguồn, nên lập trình viên của bạn có thể mở rộng công cụ đặt du thuyền hoặc kết nối nó với các hệ thống khác.
Hãy bắt đầu với các chuyến đi bạn đã ký hợp đồng, nhập vào module Du thuyền, và xem chúng bán ra sao. Khi quan hệ đối tác với một hãng tàu hoặc sản lượng đủ xứng đáng, hãy bổ sung API của hãng đó qua tích hợp tùy chỉnh.
Khám phá thêm
Cookie để đo lường quảng cáo
Chúng tôi sử dụng cookie của Google để đo lường quảng cáo nào mang lại lượt truy cập và yêu cầu liên hệ, đồng thời hiển thị quảng cáo phù hợp với bạn. Chọn Chấp nhận để cho phép, hoặc Từ chối để chỉ giữ lại các cookie cần thiết cho hoạt động của trang web. Tuyên bố về quyền riêng tư
