Tài liệu tham khảo XML về tình trạng phòng, giá và quỹ phòng (ARI)
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Hướng dẫn tham khảo XML này cung cấp nội dung tham chiếu chi tiết và ví dụ về mã cho các thông báo, phần tử và thuộc tính hiện có của nguồn cấp dữ liệu Tình trạng 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 những quy tắc ràng buộc về cách kết hợp những giá trị này. ARI cũng giúp bạn linh hoạt 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) đối với một số loại thông báo chính để xác định tình trạng còn hàng và khoảng không quảng cáo.
Giá dựa trên LOS
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 giá dựa trên LOS, các thuộc tính @Start và @End biểu thị phạm vi ngày nhận phòng mà giá LOS sẽ được áp dụng.
Mặc dù khi sử dụng giá dựa trên LOS, giá theo đêm sẽ không còn nữa, nhưng tất cả các tính năng ARI khác (kho hà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 những mức giá này và được chỉ định ở mức mỗi đêm. Điều này có nghĩa là nếu các hệ thống của bạn phù hợp hơn với hệ thống định giá dựa trên LOS, thì bạn vẫn có thể tận dụng bộ tính năng ARI phong phú, ngoài hiệu suất băng thông được cấp bằng cách sử dụng thông tin cập nhật về tình trạng phòng mỗi đêm và quy định hạn chế.
Để bật giá dựa trên LOS cho tài khoản của bạn, hãy liên hệ với TAM của bạn hoặc
liên hệ với chúng tôi.
OTA_HotelRateAmountNotifRQ. Xác định giá theo ngày hoặc theo thời gian lưu trú dựa trên thời gian lưu trú cho mỗi sản phẩm (tổ hợp loại phòng và gói giá) trong phạm vi ngày cụ thể.
OTA_HotelAvailNotifRQ. Xác định tình trạng phòng và quy định hạn chế dựa trên loại phòng và gói giá. Quỹ phòng cũng có thể được cập nhật bằng thông báo này, nhưng OTA_HotelInvCountNotifRQ sẽ được ưu tiên.
TaxFeeInfo. (Không bắt buộc) Xác định thuế và phí cho mỗi cơ sở lưu trú. Bạn không bắt buộc phải sử dụng thông báo này nếu AmountAfterTax được chỉ định trong thông báo OTA_HotelRateAmountNotifRQ.
Promotions. (Không bắt buộc) Xác định giá khuyến mãi cho một số lượt đặt phòng, thời gian lưu trú và người dùng nhất định.
RateModifications. (Không bắt buộc) Xác định các quy tắc sửa đổi giá đối với 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 thiết lập giá phòng 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 sử dụng để tính giá và tình trạng phòng mà người dùng nhìn thấy khi họ tìm cơ sở lưu trú của bạn có ngày nhận phòng và trả phòng cũng như số người lưu trú cụ thể.
Nhật ký sửa đổi Tài liệu tham khảo XML của ARI
Bảng sau đây chỉ liệt kê 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
Thêm 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 PropertiesDataSet.
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 nội dung 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
Đã thêm loại thông báo Sửa đổi giá.
Mọi quyền được bảo lưu. Java là một nhãn hiệu đã đăng ký của Oracle và/hoặc chi nhánh của Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[[["\u003cp\u003eThis XML reference guide details the messages, elements, and attributes for managing hotel availability, rates, and inventory using Availability, Rates, and Inventory (ARI) feeds.\u003c/p\u003e\n"],["\u003cp\u003eARI allows for LOS-based or per-date pricing, enabling flexible control over nightly rates, availability, inventory, taxes, fees, and promotions.\u003c/p\u003e\n"],["\u003cp\u003eKey ARI messages include: Transaction (Property Data), OTA_HotelRateAmountNotifRQ (Rates), OTA_HotelAvailNotifRQ (Availability), OTA_HotelInvCountNotifRQ (Inventory), and optional messages for taxes/fees, promotions, rate modifications, and extra guest charges.\u003c/p\u003e\n"],["\u003cp\u003eEach property should utilize either LOS-based or per-date rates, and all four primary message types (transaction, rate, inventory, and availability) are required for pricing to be available.\u003c/p\u003e\n"],["\u003cp\u003eOnly messages, elements, and attributes specifically documented in this ARI XML reference and the ARI guide are supported; for any additional pricing features used in your system, contact your Technology Account Manager (TAM).\u003c/p\u003e\n"]]],[],null,["# Availability, Rates, and Inventory (ARI) XML Reference\n\nThis XML reference guide provides detailed reference content and code\nexamples for the different messages, elements, and attributes available for\nAvailability, Rates, and Inventory (ARI) feeds.\n\nARI is a pricing delivery mode that controls nightly rates, availability,\nand inventory, and provides constraints on how these can be combined. ARI also\nprovides flexibility to include taxes, fees, and promotions.\n\nARI follows the standard protocols of OpenTravel Alliance (OTA) for some of\nthe main message types for defining availability and inventory.\n\n### LOS-based pricing\n\n`LOS-based` pricing lets you to specify rates per check-in date and length of\nstay, rather than per stay date. When you specify a\n`\u003cStatusApplicationControl\u003e` element for LOS-based pricing, the `@Start` and\n`@End` attributes signifies a range of check-in dates for which the LOS rates\napply.\n\nAlthough when using LOS-based pricing there are no longer nightly rates, all\nother ARI features (inventory, availability, rules, promotions, etc.) can still\nbe applied to these rates and are specified at a nightly level. This means if\nyour systems more closely align with an LOS-based pricing system, you can still\ntake advantage of the rich ARI feature set, in addition to the bandwidth\nefficiency that is granted by making use of the nightly availability and\nrestriction updates.\n| **Key Point:** Each property in your account should use either LOS-based rates or per-date rates.\n\nTo enable LOS-based pricing on your account, contact your TAM or\n[contact us](https://support.google.com/hotelprices/gethelp).\n| **Key Point:** You must send the four message types (transaction, rate, inventory, and availability) before pricing is available. It is recommended that you the size of ARI messages specifically `\u003cOTA_HotelRateAmountNotifRQ\u003e` to 5MB with a limit of 400 files per second upload rate.\n\nARI uses the following request messages:\n\n- [`Transaction` (Property Data)](/hotels/hotel-prices/xml-reference/ari-property). Defines the type and package\n (rate plan) information.\n\n- [`OTA_HotelRateAmountNotifRQ`](/hotels/hotel-prices/xml-reference/ari-rate). Defines the per-date or LOS-based\n occupancy rate amounts per product (room type and rate plan combination) for\n specific date ranges.\n\n- [`OTA_HotelAvailNotifRQ`](/hotels/hotel-prices/xml-reference/ari-avail). Defines availability and restrictions\n based on room type and rate plans. Inventory can also be updated using this\n message, but `OTA_HotelInvCountNotifRQ` is preferred.\n\n- [`OTA_HotelInvCountNotifRQ`](/hotels/hotel-prices/xml-reference/ari-inv). Defines the physical room inventory or\n number of rooms available to be sold.\n\n- [`TaxFeeInfo`](/hotels/hotel-prices/xml-reference/ari-tax). (Optional) Defines per-property taxes and fees. This\n message isn't required if `AmountAfterTax` is specified in the\n `OTA_HotelRateAmountNotifRQ` message.\n\n- [`Promotions`](/hotels/hotel-prices/xml-reference/ari-promotions). (Optional) Defines promotional rates for\n certain bookings, stays, and users.\n\n- [`RateModifications`](/hotels/hotel-prices/xml-reference/ari-rate-modifications). (Optional) Defines rate\n modification rules for certain bookings, stays, and users.\n\n- [`ExtraGuestCharges`](/hotels/hotel-prices/xml-reference/ari-extra-guest-charges). (Optional) Defines how rates\n should be configured for children and additional adults.\n\nEach message contains a subset of information that Google uses to compute the\nprices and availability displayed to users when they search for your\nproperties with specific check-in and check-out dates and occupancy.\n| **Key Point:** ARI features is limited to the messages and elements described within this Inventory \\& Pricing (ARI) XML reference and the ARI guide. Any OTA message, element, or attribute not specifically documented here is not supported in our ARI implementation.\n|\n|\n| Also, other [Transaction message](/hotels/hotel-prices/xml-reference/transaction-messages) elements not covered in\n| this Inventory \\& Pricing (ARI) XML reference are not supported when\n| using the ARI feed type.\n| Google continues to update and improve the API. If you use additional pricing features in your system, notify your `Technology Account Manager(TAM)` so that it can be prioritized with those features or they will let you know if those features are planned for a release.\n\nARI XML Reference revision history\n----------------------------------\n\nThe following table lists documentation updates for feature changes only.\n\n| Date | Changes |\n|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| August 14, 2020 | Initial release. |\n| October 21, 2020 | Added the Promotions message type. |\n| November 17, 2020 | For Transaction (Property Data) messages, updated the [endpoint](../dev-guide/ari-overview#pushing-messages) and added the `action` attribute to PropertyDataSet elements. |\n| November 24, 2020 | For Transaction (Property Data) messages, added the `\u003cAllowablePackageIDs\u003e` and `\u003cAllowableRoomIDs\u003e` elements. |\n| February 4, 2021 | Added response messages. |\n| February 25, 2021 | Added `OTA_HotelInvCountNotifRQ`. |\n| October 21, 2020 | Added the Rate Modifications message type. |"]]
