Tài liệu tham khảo XML về tình trạng phòng, giá và quỹ phòng (ARI)

Tài liệu hướng dẫn về XML này cung cấp nội dung tham chiếu và đoạn mã ví dụ cụ thể cho các thông báo, phần tử và thuộc tính của nguồn cấp dữ liệu Quỹ phòng, giá và khoảng không quảng cáo (ARI).

ARI là một chế độ phân phối giá kiểm soát giá mỗi đêm, tình trạng phòng và quỹ phòng, đồng thời đưa ra các quy tắc hạn chế về cách kết hợp những yếu tố này. ARI cũng mang đến sự linh hoạt khi bạn có thể thêm thuế, phí và chương trình khuyến mãi.

ARI tuân theo các giao thức tiêu chuẩn của OpenTravel Alliance (OTA) cho một số loại thông báo chính để xác định tình trạng phòng và khoảng không quảng cáo.

Giá dựa trên thời gian lưu trú

Giá LOS-based cho phép bạn chỉ định giá theo ngày nhận phòng và thời gian lưu trú, thay vì theo ngày lưu trú. Khi bạn chỉ định một phần tử <StatusApplicationControl> cho mức giá dựa trên thời gian lưu trú, các thuộc tính @Start và @End biểu thị một khoảng ngày nhận phòng mà mức giá theo thời gian lưu trú áp dụng.

Mặc dù khi sử dụng mức giá dựa trên thời gian lưu trú, bạn sẽ không còn mức giá theo đêm nữa, nhưng tất cả các tính năng ARI khác (quỹ phòng, tình trạng phòng, quy tắc, chương trình khuyến mãi, v.v.) vẫn có thể được áp dụng cho các mức giá này và được chỉ định ở cấp độ theo đêm. Điều này có nghĩa là nếu hệ thống của bạn phù hợp hơn với hệ thống định giá dựa trên LOS, bạn vẫn có thể tận dụng bộ tính năng ARI phong phú, ngoài hiệu quả về băng thông khi sử dụng các bản cập nhật hằng đêm về tình trạng phòng và hạn chế.

Để bật tính năng định giá dựa trên LOS trong tài khoản của bạn, hãy liên hệ với TAM hoặc liên hệ với chúng tôi.

ARI sử dụng các thông báo yêu cầu sau:

  • Transaction (Dữ liệu cơ sở lưu trú). Xác định loại và thông tin về gói (gói giá).

  • OTA_HotelRateAmountNotifRQ. Xác định số tiền giá theo ngày hoặc theo thời gian lưu trú cho mỗi sản phẩm (kiểu kết hợp loại phòng và gói giá) trong các phạm vi ngày cụ thể.

  • OTA_HotelAvailNotifRQ. Xác định tình trạng phòng và các quy định hạn chế dựa trên loại phòng và gói giá. Bạn cũng có thể dùng thông báo này để cập nhật quỹ phòng, nhưng OTA_HotelInvCountNotifRQ sẽ được ưu tiên.

  • OTA_HotelInvCountNotifRQ. Xác định khoảng không quảng cáo phòng thực tế hoặc số lượng phòng có thể bán.

  • TaxFeeInfo. (Không bắt buộc) Xác định thuế và phí cho mỗi cơ sở lưu trú. Thông báo này là không bắt buộc nếu bạn chỉ định AmountAfterTax trong thông báo OTA_HotelRateAmountNotifRQ.

  • Promotions. (Không bắt buộc) Xác định mức giá khuyến mãi dành cho một số lượt đặt phòng, thời gian lưu trú và người dùng.

  • RateModifications. (Không bắt buộc) Xác định các quy tắc sửa đổi giá cho một số lượt đặt phòng, thời gian lưu trú và người dùng.

  • ExtraGuestCharges. (Không bắt buộc) Xác định cách bạn nên định cấu hình giá cho trẻ em và người lớn bổ sung.

Mỗi thông báo chứa một tập hợp con thông tin mà Google dùng để tính giá và tình trạng phòng để cung cấp cho người dùng khi họ tìm kiếm cơ sở lưu trú của bạn bằng thông tin về ngày nhận phòng, trả phòng và sức chứa cụ thể.

Lịch sử sửa đổi tài liệu tham khảo XML về ARI

Dưới đây là bảng cung cấp riêng những nội dung cập nhật trong tài liệu liên quan đến các thay đổi về tính năng.

Ngày Các thay đổi
Ngày 14 tháng 8 năm 2020 Bản phát hành đầu tiên.
Ngày 21 tháng 10 năm 2020 Bổ sung loại thông báo Khuyến mãi.
Ngày 17 tháng 11 năm 2020 Đối với các thông báo Giao dịch (Dữ liệu của cơ sở lưu trú), đã cập nhật điểm cuối và thêm thuộc tính action vào các phần tử của PropertyDataSet.
Ngày 24 tháng 11 năm 2020 Đối với các thông báo Giao dịch (Dữ liệu của cơ sở lưu trú), đã thêm các phần tử <AllowablePackageIDs> và <AllowableRoomIDs>.
Ngày 4 tháng 2 năm 2021 Đã thêm tin thông báo phản hồi.
Ngày 25 tháng 2 năm 2021 Thêm OTA_HotelInvCountNotifRQ.
Ngày 21 tháng 10 năm 2020 Bổ sung loại thông báo Nội dung sửa đổi giá.