Demo trực tiếp

API lưu trú

API lưu trú cho khách sạn, căn hộ và nhà nghỉ dưỡng cho thuê

API lưu trú đưa mọi loại hình lưu trú lên website đặt chỗ của bạn: phòng khách sạn, căn hộ dịch vụ, nhà nghỉ dưỡng, hostel và nhà nghỉ gia đình. Trang này giải thích dữ liệu đằng sau một chỗ lưu trú, những quy tắc khiến nhà cho thuê khác khách sạn, và cách PHPTRAVELS bán cơ sở của chính bạn cùng nguồn phòng nhà cung cấp trong một lần tìm kiếm.

  • Cơ sở, đơn vị, giá, lịch
  • Số đêm tối thiểu và phí
  • Khung hủy phòng
  • Nguồn riêng cộng nguồn API

Mô hình dữ liệu

Bốn lớp trong mỗi chỗ lưu trú

Dù là khách sạn 300 phòng hay một căn nhà ven biển, API lưu trú đều mô tả nó theo cùng bốn lớp lồng nhau. Mỗi lớp trả lời một câu hỏi khác nhau mà khách đặt ra trước khi đặt chỗ.

01Cơ sở lưu trú

Chính địa điểm đó: tên, loại hình, địa chỉ và vị trí trên bản đồ, ảnh, tiện nghi, hạng sao hoặc chất lượng, nội quy và giờ nhận phòng.

property_id · type · address · geo · photos · amenities · check_in_from

02Phòng hoặc đơn vị

Thứ thực sự được đặt: một hạng phòng, cả căn hộ hoặc một giường trong phòng tập thể, kèm diện tích, giường và sức chứa tối đa.

unit_id · beds · size_m2 · max_adults · max_children

03Gói giá

Cách đơn vị đó được bán: suất ăn, chính sách hủy, điều khoản thanh toán và ai được đặt, chẳng hạn công khai hay chỉ dành cho đại lý.

rate_plan_id · board · cancel_policy · payment · channel

04Tình trạng phòng trống

Một dòng cho mỗi đêm: giá, số đơn vị còn lại, số đêm tối thiểu và việc có cho phép nhận hay trả phòng vào ngày đó hay không.

date · price · units_left · min_stay · closed_to_arrival

Một tòa nhà, một căn phòng, một thẻ giá và một cuốn lịch được vẽ thành các lớp xếp chồng của một tin đăng lưu trú

PHPTRAVELS gọi module lưu trú của mình là Stays vì cùng một mô hình bao phủ nhiều hơn khách sạn rất nhiều. Một cơ sở chứa các đơn vị, một đơn vị được bán qua một hoặc nhiều gói giá, và mỗi gói giá có lịch từng đêm với giá và số chỗ trống. Làm đúng bốn lớp này thì một giường hostel, một phòng suite khách sạn và một biệt thự ba phòng ngủ đều nằm vừa trong cùng một lần tìm kiếm và thanh toán.

Mỗi nhà cung cấp gọi tên các lớp khác nhau, có nơi gộp hai lớp làm một, nhưng cấu trúc luôn tồn tại. Khách sạn ánh xạ mọi nguồn về cấu trúc đó, nên khách thấy một trang nhất quán.

Từng đêm một

Lịch phòng trống quyết định bán được hay không

Mọi API lưu trú đều kết thúc ở một cuốn lịch. Tìm kiếm chỉ trả về cơ sở khi mọi đêm trong kỳ lưu trú được yêu cầu đều còn trống, có giá và được quy tắc lưu trú cho phép.

Căn hộ hai phòng ngủ · Giá tiêu chuẩnTháng 11 2026 · Giá mỗi đêm
  1. 26
  2. 27
  3. 28
  4. 29
  5. 30
  6. 31
  7. 1120
  8. 2120
  9. 3
  10. 4
  11. 5
  12. 6165
  13. 7140
  14. 8120
  15. 9
  16. 10
  17. 11
  18. 123+165
  19. 13165
  20. 14140
  21. 15120
  22. 16120
  23. 17120
  24. 18
  25. 19
  26. 20165
  27. 21140
  28. 22120
  29. 23120
  30. 24120
  31. 25120
  32. 263+165
  33. 27165
  34. 28140
  35. 29120
  36. 30120
  37. 1
  38. 2
  39. 3
  40. 4
  41. 5
  42. 6
  • Còn trống, có giá mỗi đêm
  • Đã được đặt
  • Chủ nhà đóng
  • Số đêm tối thiểu từ ngày nhận phòng này
  • Không nhận phòng vào ngày này

Dữ liệu minh họa, đã đơn giản hóa

  • Giá tính theo đêmTổng tiền là tổng của từng đêm, nên thứ Sáu và thứ Bảy theo giá cuối tuần đắt hơn hai ngày thường. Giá theo ngày và theo mùa nằm trên lịch, không nằm ở cơ sở.
  • Quy tắc số đêm tối thiểuTối thiểu ba đêm cho lượt nhận phòng thứ Sáu sẽ ẩn đơn vị khỏi kết quả tìm hai đêm. Nhà cho thuê dùng quy tắc này nhiều hơn khách sạn rất nhiều, thường chặt hơn vào cuối tuần và mùa cao điểm.
  • Đóng nhận phòng hoặc trả phòngMột đêm có thể đặt được trong kỳ lưu trú dài hơn nhưng không được làm đêm đầu hoặc đêm cuối. Ngày đổi khách của nhà nghỉ dưỡng hoạt động theo cách này.
  • Đêm bị đóng và stop-sellChủ nhà khóa ngày để tự dùng hoặc bảo trì, còn stop-sell ngừng bán đơn vị ngay lập tức. Bất kỳ đêm nào bị đóng trong khoảng ngày yêu cầu đều loại đơn vị khỏi kết quả.

Không phải chỗ lưu trú nào cũng là khách sạn

Khách sạn, căn hộ và nhà nghỉ dưỡng cho thuê

Mô hình dữ liệu dùng chung, nhưng mỗi loại hình lưu trú điền vào đó theo cách riêng. Đây là những điểm khác biệt mà quy trình đặt chỗ của bạn phải xử lý khi bán nhiều hơn phòng khách sạn.

Khách sạn

Gồm cả hostel và nhà nghỉ

Thứ được đặt
Một hạng phòng có nhiều phòng giống hệt nhau, hoặc một giường trong phòng tập thể.
Giá
Giá mỗi đêm theo phòng và suất ăn; thêm người lớn hoặc trẻ em có thể làm giá thay đổi.
Quy tắc lưu trú
Chỉ yêu cầu số đêm tối thiểu vào ngày cao điểm; phần lớn các đêm có thể đặt riêng lẻ.
Phí và tiền cọc
Thuế thành phố hoặc du lịch, đôi khi có phí resort trả tại cơ sở.
Nhận phòng
Lễ tân 24 giờ hoặc có nhân viên trực; giờ nhận phòng ghi trên voucher là đủ.
Nguồn thường gặp
Bedbank và nhà bán buôn, hợp đồng trực tiếp, channel manager.

Căn hộ dịch vụ

Aparthotel và căn hộ trong thành phố

Thứ được đặt
Một loại căn hộ, thường có bếp và phòng ngủ riêng.
Giá
Giá mỗi đêm theo căn, kèm giá theo tuần hoặc tháng cho kỳ lưu trú dài.
Quy tắc lưu trú
Số đêm tối thiểu khá phổ biến, và lưu trú dài ngày chiếm phần lớn nhu cầu.
Phí và tiền cọc
Phí dọn dẹp mỗi kỳ lưu trú và tiền cọc hoàn lại là chuyện thường gặp.
Nhận phòng
Giờ lễ tân khác nhau; đến muộn cần hộp khóa hoặc mã số.
Nguồn thường gặp
Channel manager, hợp đồng trực tiếp và một số nhà bán buôn.

Nhà nghỉ dưỡng cho thuê

Nhà nghỉ dưỡng, biệt thự và cabin

Thứ được đặt
Một ngôi nhà cụ thể. Thường chỉ có một căn như vậy.
Giá
Giá mỗi đêm cho cả ngôi nhà, cộng phí cho mỗi khách thêm vượt quá số khách cơ bản.
Quy tắc lưu trú
Số đêm tối thiểu, ngày đổi khách cố định và ngày không nhận phòng là chuyện thường.
Phí và tiền cọc
Phí dọn dẹp, tiền cọc thiệt hại hoàn lại và thuế địa phương, mỗi khoản đều hiển thị trước khi thanh toán.
Nhận phòng
Hướng dẫn nhận phòng, địa chỉ và liên hệ được gửi trước ngày đến, không bao giờ đăng trên trang công khai.
Nguồn thường gặp
Chủ nhà và đơn vị quản lý bất động sản, trực tiếp hoặc qua channel manager.

Bán nhà của nhiều chủ nhà thay vì hợp đồng của riêng bạn? Đó là mô hình sàn giao dịch, được nói đến ở trang Cổng BnB.

Các khung chính sách hủy phòng

Một đặt chỗ, ba khung hủy phòng

Chính sách hủy là một dòng thời gian tính ngược từ ngày nhận phòng. Mỗi khung cho biết khách được hoàn lại bao nhiêu nếu hủy trong khung đó.

Đặt chỗNhận phòng
  1. 01 · Đến 14 ngày trước ngày đếnHủy miễn phíKhách hủy và được hoàn tiền đầy đủ. Đây là hạn chót mà du khách tìm đầu tiên, nên hãy hiển thị bằng một ngày cụ thể chứ không phải một quy tắc.
  2. 02 · Từ 14 đến 3 ngày trướcPhạt một phầnÁp dụng khoản phạt, thường là đêm đầu tiên hoặc một phần trăm của kỳ lưu trú. Nhà cho thuê có thể giữ lại tiền cọc trong khung này.
  3. 03 · 3 ngày cuối và không đếnKhông hoàn tiềnGiữ lại toàn bộ số tiền. Các mức giá bán theo dạng không hoàn tiền nằm trong khung này ngay từ lúc đặt.
Các khung mang tính ví dụ; mỗi gói giá có khung riêng.
  • Theo từng gói giá, không theo cơ sởCùng một căn hộ có thể có giá linh hoạt và giá không hoàn tiền rẻ hơn, nên chính sách thuộc lớp gói giá.
  • Ngày tính theo múi giờ của cơ sở"14 ngày trước" được tính từ ngày đến tại nơi cơ sở tọa lạc. Hãy quy đổi thành ngày và giờ rõ ràng trên trang và trên voucher.
  • Chính sách của nhà cung cấp được ưu tiênVới nguồn phòng qua API, bạn không thể đưa ra điều kiện nới hơn nhà cung cấp. Với hợp đồng của riêng bạn, bạn tự đặt các khung.

Nguồn riêng và nguồn API

Cơ sở bạn ký hợp đồng và API nhà cung cấp trong một lần tìm kiếm

Hầu hết đơn vị bán lưu trú làm cả hai: nhập các nơi họ tự ký hợp đồng và thêm API nhà cung cấp cho phần còn lại. Du khách không bao giờ nên nhận ra chỗ lưu trú đến từ đâu.

Cơ sở của chính bạn

  • Tự nhập cơ sở, đơn vị và gói giá trong trang quản trị
  • Cấp cho chủ nhà và khách sạn tài khoản extranet để quản lý lịch của họ
  • Đặt giá, số đêm tối thiểu, ngày đóng và khung hủy phòng
  • Allotment với ngày nhả phòng và stop-sell
  • Hoặc nhận giá và phòng trống từ channel manager

Nguồn phòng nhà cung cấp qua API

  • Danh mục lớn ở những điểm đến bạn không thể tự ký hợp đồng
  • Giá và phòng trống trực tiếp tại thời điểm tìm kiếm
  • Suất ăn, chính sách và phí của nhà cung cấp trên mọi mức giá
  • Bật bằng hợp đồng và thông tin xác thực nhà cung cấp của chính bạn
  • Đặt chỗ và hủy được gửi thẳng đến nhà cung cấp

Khách nhận được gì

  • Một danh sách kết quả với một trang cơ sở cho mỗi nơi
  • Cùng một phòng từ nhiều nguồn chỉ hiển thị một lần, theo giá của bạn
  • Mức tăng giá của bạn theo nhà cung cấp, điểm đến hoặc kênh, cùng giá cho đại lý B2B
  • Một định dạng voucher, bất kể nguồn nào xác nhận

Việc kết nối channel manager được nói ở Tích hợp channel manager. Với các phòng bạn giữ theo hợp đồng, xem Hệ thống tồn kho đặt chỗ.

Có sẵn trong PHPTRAVELS

Nhà cung cấp lưu trú đã được kết nối

Các nhà cung cấp lưu trú này hiện đã kết nối với module Stays. Bạn ký hợp đồng với nhà cung cấp, nhập thông tin xác thực của chính bạn vào trang quản trị, thử trong sandbox của họ rồi đưa vào hoạt động. Danh sách được lấy trực tiếp từ thư mục tích hợp của chúng tôi.

Cần một nhà cung cấp chưa có trong danh sách, chẳng hạn mạng lưới nhà cho thuê theo khu vực? Mọi API lưu trú có tài liệu đều có thể được thêm vào, xem Tích hợp API tùy chỉnh. Về các loại nhà cung cấp khách sạn và cách ánh xạ nội dung, hãy đọc trang API khách sạn, cùng hai hướng dẫn bedbank lớn nhất: Tích hợp API RateHawk và Tích hợp Hotelbeds API.

Đặt chỗ lưu trú như cách khách của bạn sẽ làm

Tìm kiếm, so sánh giá và đặt chỗ trong bản demo trực tiếp, rồi cho chúng tôi biết bạn định bán những cơ sở và nhà cung cấp nào.

Dùng thử demo trực tiếpHỏi về nhà cung cấp của bạn

Đang xây ứng dụng riêng hoặc nguồn dữ liệu cho đối tác? REST API của PHPTRAVELS phục vụ mọi nguồn lưu trú đã kết nối trong một định dạng, kèm webhook cho các sự kiện đặt chỗ. API đi kèm gói Enterprise, xem Bảng giá và tài liệu dành cho nhà phát triển. Bức tranh rộng hơn có ở API du lịch.

Câu hỏi thường gặp

API lưu trú: những câu hỏi của lập trình viên và đại lý

Liên hệ kinh doanh

API lưu trú là một bộ dịch vụ web cho phép website đặt chỗ tìm kiếm chỗ lưu trú, đọc giá và phòng trống theo ngày và số khách cho trước, cũng như tạo, xem và hủy đặt chỗ. API bao phủ khách sạn và mọi loại hình lưu trú khác: căn hộ, nhà nghỉ dưỡng cho thuê, hostel và nhà nghỉ gia đình.

Các lệnh gọi cốt lõi giống nhau. API lưu trú còn phải xử lý những gì các chỗ lưu trú ngoài khách sạn cần: đặt nguyên một căn, số đêm tối thiểu và ngày đổi khách, phụ phí khách thêm, phí dọn dẹp, tiền cọc hoàn lại và hướng dẫn nhận phòng gửi trước ngày đến.

Có. Trong PHPTRAVELS, module Stays dùng một mô hình cơ sở, đơn vị, gói giá và phòng trống cho mọi loại hình lưu trú, nên khách sạn, căn hộ và nhà nghỉ dưỡng xuất hiện trong cùng một lần tìm kiếm với quy tắc riêng của từng loại.

Mỗi đêm trên lịch có thể mang một độ dài lưu trú tối thiểu, thường gắn với ngày nhận phòng. Nếu khách tìm ít đêm hơn mức tối thiểu, đơn vị sẽ không được trả về. Cờ đóng nhận phòng và đóng trả phòng hoạt động tương tự cho các ngày đổi khách.

Có. Bạn có thể tự thêm cơ sở, đơn vị, gói giá và lịch, cấp cho chủ nhà tài khoản extranet hoặc nhận giá từ channel manager, rồi bán chúng cạnh nguồn phòng nhà cung cấp trong cùng một danh sách kết quả.

Từ gói giá. Nguồn phòng nhà cung cấp mang theo chính sách của nhà cung cấp, còn cơ sở của riêng bạn dùng các khung do bạn đặt. Hạn chót được hiển thị cho khách trước khi thanh toán và in trên voucher.

Không. Bạn ký hợp đồng với từng nhà cung cấp lưu trú và nhập thông tin xác thực của chính bạn vào trang quản trị. PHPTRAVELS cung cấp nền tảng đặt chỗ, module Stays và các trình kết nối dựng sẵn.

Có. Với gói Enterprise, REST API của PHPTRAVELS mở tìm kiếm và đặt chỗ trên mọi nguồn đã kết nối trong một định dạng, kèm webhook cho các sự kiện đặt chỗ và toàn bộ mã nguồn để mở rộng.

Một giấy phép PHPTRAVELS, tên miền riêng của bạn và ít nhất một nguồn phòng: cơ sở bạn tự ký hợp đồng, một channel manager hoặc hợp đồng nhà cung cấp với nhà bán buôn lưu trú. Bản demo trực tiếp cho xem trước toàn bộ quy trình.

Khám phá thêm

Thêm về nền tảng