API tour và hoạt động
API tour cho tour, hoạt động và vé tham quan
API tour đưa tour có hướng dẫn viên, tour trong ngày, trải nghiệm và vé tham quan từ các nhà cung cấp hoạt động lên chính website của bạn. Trang này cho thấy nội dung đó trông thế nào qua API: khung giờ và sức chứa, giá theo loại khách, những câu hỏi nhà cung cấp đặt ra khi đặt chỗ và voucher khách xuất trình vào ngày đi.
- Ngày, khung giờ và sức chứa
- Giá người lớn, trẻ em, em bé và người cao tuổi
- Voucher và vé trên điện thoại
- Tour của riêng bạn cạnh nguồn API
Bán những gì
API tour bán những gì
Nhà cung cấp hoạt động gộp những sản phẩm rất khác nhau vào một API. Chúng cùng theo một mô hình đặt chỗ (một ngày, thường là một giờ, và số khách theo từng nhóm tuổi), nhưng mỗi loại có chi tiết riêng mà website của bạn phải hiển thị.
Tour có hướng dẫn viên
Đi bộ khám phá thành phố, tham quan bảo tàng và tour ẩm thực có hướng dẫn viên, điểm hẹn, giờ bắt đầu và ngôn ngữ của hướng dẫn viên.
Tour trong ngày
Chuyến đi cả ngày từ một thành phố, thường có đón tại khách sạn, di chuyển và bữa trưa được ghi rõ là đã bao gồm hay không.
Vé tham quan
Bảo tàng, danh thắng, công viên giải trí và sở thú: vào cổng theo ngày mở hoặc theo giờ cố định, thường kèm tùy chọn không phải xếp hàng.
Trải nghiệm
Lớp học nấu ăn, du thuyền, buổi biểu diễn và hoạt động ngoài trời, mỗi loại có thời lượng và quy mô nhóm riêng.
Tour nhiều ngày
Tour kéo dài nhiều ngày với lịch trình từng ngày, chỗ ở và ngày khởi hành cố định.
Tour kèm đưa đón
Hoạt động bán kèm đưa đón hai chiều từ khách sạn hoặc cảng, khi thông tin đón khách trở thành một phần của đặt chỗ.

Đa số đại lý kết hợp những sản phẩm này với vé máy bay và khách sạn trên cùng một website. Xem cách các API du lịch khớp với nhau.
Giờ bắt đầu
- 09:30Hết chỗ
- 14:00Hết chỗ
- 14:00Hết chỗ
Dữ liệu minh họa
Tình trạng còn chỗ
Ngày, khung giờ và số chỗ còn lại
Trước khi khách thanh toán, API cho website của bạn biết những ngày nào còn mở, ngày đó có những giờ khởi hành nào và mỗi giờ còn bao nhiêu chỗ.
- Tình trạng còn chỗ theo thời gian thực
- Nhà cung cấp giữ một sức chứa cho từng khung giờ và API trả về số chỗ còn lại. Website của bạn kiểm tra lại ngay trước khi thanh toán, vì một đơn vị bán khác có thể đã lấy mất những chỗ cuối cùng.
- Freesale
- Một số sản phẩm không có số chỗ cấp cố định: nhà cung cấp cho đối tác bán tự do và xác nhận từng đặt chỗ, cho đến khi đóng một ngày hay một khung giờ.
- Theo yêu cầu
- Một số sản phẩm cần nhà cung cấp chấp nhận thủ công từng đặt chỗ. Đặt chỗ ở trạng thái chờ cho đến khi được xác nhận hoặc từ chối, nên phải báo cho khách biết trước khi thanh toán.
- Giờ chốt bán
- Việc bán thường đóng trước giờ bắt đầu một số giờ nhất định. Một khung giờ buổi sáng còn mở có thể đã hết vào buổi chiều.
Giá
Một mức giá cho mỗi loại khách, không phải một mức giá cho cả đặt chỗ
Hoạt động được tính giá theo nhóm tuổi. Nhà cung cấp quy định các nhóm cho từng sản phẩm, và tổng tiền là tổng của mọi khách trong đặt chỗ.
| Loại khách | Nhóm tuổi | Giá mỗi người | Số khách | Tạm tính |
|---|---|---|---|---|
| Người lớn | 18 đến 64 | – | 2 | – |
| Trẻ em | 4 đến 17 | – | 1 | – |
| Em bé | 0 đến 3 | Miễn phí | 1 | – |
| Người cao tuổi | 65 trở lên | – | 0 | – |
| Tổng cho 4 kháchPhần markup của bạn được cộng thêm vào giá của nhà cung cấp | – | |||
- 01
Nhóm tuổi khác nhau theo sản phẩm
Trẻ em có thể là 3 đến 12 tuổi ở tour này và 4 đến 17 tuổi ở tour khác. Website của bạn phải đọc nhóm tuổi từ từng sản phẩm, không dùng một quy tắc chung cho tất cả.
- 02
Số khách tối thiểu và tối đa
Mỗi sản phẩm quy định một đặt chỗ được chứa bao nhiêu người, và một số yêu cầu có ít nhất một người lớn mỗi khi có trẻ em hoặc em bé đi cùng.
- 03
Theo người hoặc theo đơn vị
Tour riêng, thuyền và xe thường tính giá theo nhóm hoặc theo xe tới một sức chứa nhất định, thay vì theo từng khách.
- 04
Miễn phí không có nghĩa là không đếm
Em bé không mất phí vẫn được tính vào số người, nên được gửi cùng đặt chỗ và xuất hiện trên voucher.
Câu hỏi đặt chỗ
Những câu hỏi nhà cung cấp cần được trả lời trước khi nhận đặt chỗ
Nhiều hoạt động không thể diễn ra chỉ với tên và email. Mỗi sản phẩm có thể có câu hỏi bắt buộc riêng, và đặt chỗ sẽ bị từ chối nếu thiếu.
- Theo đặt chỗHỏi một lần: khách sạn đón, chuyến bay đến, số điện thoại di động cho ngày đi.
- Theo từng kháchHỏi cho từng người: họ tên đầy đủ, tuổi, và với một số hoạt động là chiều cao, cân nặng hoặc số hộ chiếu.
- Lựa chọn với đáp án cố địnhNgôn ngữ hướng dẫn viên hay địa điểm đón là danh sách do nhà cung cấp cung cấp, nên khách chọn thay vì gõ.
Một quy trình đặt chỗ tốt hỏi những câu này ngay khi thanh toán, bằng ngôn ngữ của khách, và chuyển câu trả lời cho nhà cung cấp cùng đặt chỗ, để hướng dẫn viên nhận được trước ngày đi.
- Điểm đónBắt buộc
- Sảnh khách sạn, trung tâm thành phố
- Ngôn ngữ tourBắt buộc
- Tiếng Tây Ban Nha
- Yêu cầu về ăn uốngTùy chọn
- Một người ăn chay, không dùng hạt
- Điện thoại của khách chínhBắt buộc
- +00 000 000 000
Vào ngày đi
Voucher là sản phẩm khách thực sự cầm trên tay
Khi nhà cung cấp xác nhận, API trả về những gì khách xuất trình tại cổng vào hoặc điểm hẹn: một mã, mã tham chiếu của nhà cung cấp và các thông tin thực tế.
Voucher đặt chỗ
Tour đi bộ khu phố cổ cùng hướng dẫn viên địa phương
- Ngày
- Thứ Bảy, 14 tháng 11 năm 2026
- Bắt đầu
- 09:30
- Khách
- 2 người lớn, 1 trẻ em, 1 em bé
- Điểm hẹn
- Quảng trường chính, cạnh tháp đồng hồ
- Mã tham chiếu NCC
- TR-48210-KQ
- Đã xác nhận
- Đã xác nhận
- Trên điện thoại hoặc bản in
Nhiều sản phẩm chấp nhận mã trên điện thoại; một số vẫn yêu cầu voucher in. Sản phẩm sẽ nêu rõ, và email xác nhận của bạn nên nhắc lại điều đó.
- Xác nhận tức thì
Đa số sản phẩm API xác nhận trong vài giây và voucher có ngay, nên có thể gửi kèm email đặt chỗ của bạn.
- Xác nhận theo yêu cầu
Sản phẩm theo yêu cầu chỉ gửi voucher sau khi nhà cung cấp chấp nhận, vì vậy phải theo dõi trạng thái đặt chỗ sau khi thanh toán.
- Chính sách hủy
Mỗi sản phẩm có quy định hoàn tiền riêng, thường là hủy miễn phí đến một thời điểm nhất định trước giờ bắt đầu. Hãy hiển thị trước khi thanh toán và trên voucher.
Có sẵn trong PHPTRAVELS
Connector API tour bạn bật bằng tài khoản của chính mình
Các nhà cung cấp hoạt động này đã được kết nối với module tour của PHPTRAVELS. Bạn ký hợp đồng với nhà cung cấp, nhập thông tin xác thực trong admin và kiểm thử trước khi vận hành. Danh sách là bản cập nhật trực tiếp từ thư mục tích hợp của chúng tôi.
TiqetsConnector có sẵnĐọc hướng dẫn tích hợp
Tours BMSConnector có sẵn
ViatorConnector có sẵnĐọc hướng dẫn tích hợp- Tất cả tích hợp
Mỗi connector đi được đến đâu, từ tìm kiếm và chi tiết cho tới đơn hàng và vé điện tử, phụ thuộc vào nhà cung cấp và loại tài khoản họ cấp cho bạn, nên mỗi hướng dẫn giải thích quy trình riêng. Với nhà cung cấp chưa có trong danh sách, xem Tích hợp API tùy chỉnh.
Đọc thêm dành cho đại lý: kiếm tiền từ chương trình affiliate của Viator và bán tour online không cần vốn đầu tư.
Sản phẩm của riêng bạn
Cả tour của riêng bạn nữa, cạnh nguồn API
API tour lấp đầy website của bạn bằng nội dung của các công ty khác. Những tour bạn tự vận hành, và tour của các đơn vị địa phương bạn hợp tác, nên nằm trong cùng một kết quả tìm kiếm.
Trong Tour & hoạt động của PHPTRAVELS, bạn tạo một tour với lịch trình, các chuyến khởi hành hoặc khung giờ, số chỗ và giá theo loại khách. Tour xuất hiện trong cùng kết quả với hoạt động của nhà cung cấp, với quy tắc markup riêng, và khách đặt nó trong cùng một quy trình thanh toán.
Các đơn vị tự tổ chức khởi hành thêm hướng dẫn viên, danh sách khách và tiền cọc bằng Phần mềm điều hành tour, còn Back office lữ hành lo phần đặt chỗ, thanh toán và báo cáo phía sau.
- Tour bạn vận hànhTour của bạnCác chuyến khởi hành, số chỗ và giá của bạn, quản lý trong admin của bạn. Toàn bộ biên lợi nhuận thuộc về bạn.
- Đơn vị đối tácĐơn vị địa phươngCác đơn vị địa phương đăng nhập để tự quản lý tour, tình trạng còn chỗ và giá; bạn cộng thêm markup của mình.
- Nhà cung cấp hoạt độngAPI nhà cung cấpTour và vé từ các nhà cung cấp đã kết nối, với tình trạng còn chỗ trực tiếp và markup của bạn.
Đại lý đặt cả ba trong cổng B2B với mức giá riêng của họ, thanh toán từ số dư ví.
Xem tour và hoạt động trong một hệ thống đặt chỗ đang chạy
Tìm tour, chọn ngày và số khách rồi đi hết bước thanh toán trong bản demo trực tiếp, sau đó trao đổi với chúng tôi về các nhà cung cấp hoạt động bạn dự định ký hợp đồng.
API tour là bộ dịch vụ web của nhà cung cấp hoạt động, cho phép website du lịch tìm tour, hoạt động và vé tham quan, kiểm tra ngày và khung giờ, lấy giá theo loại khách, tạo đặt chỗ và nhận voucher.
Các thuật ngữ này dùng để chỉ cùng một thứ. Nhà cung cấp gọi là API tours, activities, experiences hoặc things to do, và đa số bao gồm tour có hướng dẫn viên, tour trong ngày, trải nghiệm và vé tham quan trong một danh mục.
Có. Các nhà cung cấp vé tham quan như Tiqets cung cấp vé theo giờ và vé mở ngày với các loại người lớn, trẻ em và khác, và vé điện tử được trả về sau khi đặt đơn.
Có. Bạn đăng ký với từng nhà cung cấp và nhận khóa API riêng. Nhà cung cấp quyết định tài khoản của bạn được truy cập sản phẩm, giá và quyền đặt chỗ nào. PHPTRAVELS không cung cấp thông tin xác thực của nhà cung cấp.
Với tình trạng còn chỗ theo thời gian thực, nhà cung cấp giữ sức chứa cho từng ngày hoặc khung giờ và API trả về số chỗ còn lại. Với freesale, nhà cung cấp cho đối tác bán mà không có số chỗ cấp cố định và xác nhận từng đặt chỗ cho đến khi đóng ngày đó.
Thường theo loại khách, với các nhóm tuổi do nhà cung cấp quy định cho từng sản phẩm, như người lớn, trẻ em, em bé và người cao tuổi. Tour riêng và xe thường tính giá theo nhóm hoặc theo đơn vị. Markup của bạn được cộng thêm lên trên.
Module tour có connector sẵn cho các nhà cung cấp hoạt động như Viator, Tiqets và Tours BMS. Danh sách hiện tại nằm trong thư mục tích hợp, và mọi nhà cung cấp có tài liệu API đều có thể được thêm dưới dạng tích hợp tùy chỉnh.
Có. Tour bạn tạo trong module tour của PHPTRAVELS, với chuyến khởi hành và giá riêng, xuất hiện trong cùng kết quả tìm kiếm với hoạt động của nhà cung cấp, mỗi tour có markup riêng.
Có, ở gói Enterprise. REST API và webhook của PHPTRAVELS, kèm tài liệu, cung cấp tìm kiếm và đặt chỗ từ các nhà cung cấp đã kết nối trong một định dạng duy nhất.
Khám phá thêm
Thêm về nền tảng
- Tour & hoạt độngGói tour và tham quan
- Tích hợp API ViatorTour và hoạt động Viator trên trang đặt chỗ của bạn
- Tích hợp API TiqetsVé điểm tham quan Tiqets trong hệ thống đặt chỗ của bạn
- Phần mềm điều hành tourLịch khởi hành, lịch trình, số khách tối thiểu và bán qua đại lý
- Đại lý du lịch ViatorCổng đại lý, hoa hồng và quy trình tour kết nối
- API du lịchAPI GDS, khách sạn, tour, xe và thanh toán
