Stok Durumu, Fiyatlar ve Envanter (ARI) XML Referansı

Bu XML referans kılavuzu; Müsaitlik Durumu, Fiyatlar ve Envanter (ARI) feed'lerinde kullanılabilen farklı mesajlar, öğeler ve özellikler için ayrıntılı referans içerik ve kod örnekleri sağlar.

ARI; gecelik fiyatları, müsaitlik durumunu ve envanteri kontrol eden ve bunların nasıl birleştirilebileceğiyle ilgili kısıtlamalar sağlayan bir fiyatlandırma iletim modudur. ARI, vergileri, ücretleri ve promosyonları ekleme esnekliği de sunar.

ARI, kullanılabilirliği ve envanteri tanımlamak için kullanılan ana mesaj türlerinden bazıları için OpenTravel Alliance'ın (OTA) standart protokollerini uygular.

KS tabanlı fiyatlandırma

LOS-based fiyatlandırması, konaklama tarihi yerine check-in tarihi ve konaklama süresi başına fiyatları belirtmenize olanak tanır. KS tabanlı fiyatlandırma için bir <StatusApplicationControl> öğesi belirlediğinizde @Start ve @End özellikleri, KS ücretlerinin geçerli olduğu bir giriş tarihi aralığını ifade eder.

KS tabanlı fiyatlandırma kullanılırken artık gecelik fiyat sunulmasa da diğer tüm ARI özellikleri (envanter, müsaitlik durumu, kurallar, promosyonlar vb.) bu fiyatlara uygulanmaya devam edebilir ve gecelik olarak belirtilir. Bu, sistemleriniz LOS tabanlı bir fiyatlandırma sistemiyle daha uyumluysa gecelik müsaitlik durumu ve kısıtlama güncellemelerinden yararlanarak sağlanan bant genişliği verimliliğinin yanı sıra zengin ARI özellik grubundan yararlanmaya devam edebileceğiniz anlamına gelir.

Önemli Nokta: Hesabınızdaki her mülk, KS tabanlı fiyatları veya güncel fiyatları kullanmalıdır.

Hesabınızda KS tabanlı fiyatlandırmayı etkinleştirmek için THY ile iletişime geçin veya bize ulaşın.

Önemli Bilgi: Fiyatlandırma kullanıma sunulmadan önce dört mesaj türünü (işlem, ücret, envanter ve stok durumu) göndermeniz gerekir. ARI mesajlarının boyutunu özellikle <OTA_HotelRateAmountNotifRQ> ila 5 MB olarak ve saniyede 400 dosya yükleme hızıyla sınırlamanız önerilir.

ARI aşağıdaki istek mesajlarını kullanır:

• Transaction (Tesis Verileri). Tür ve paket (ücret planı) bilgilerini tanımlar.

• OTA_HotelRateAmountNotifRQ Belirli tarih aralıkları için ürün başına tarihe göre veya KS tabanlı doluluk oranı tutarlarını (oda türü ve ücret planı kombinasyonu) tanımlar.

• OTA_HotelAvailNotifRQ. Oda türüne ve ücret planlarına göre müsaitlik durumunu ve kısıtlamaları tanımlar. Envanter bu mesaj kullanılarak da güncellenebilir ancak OTA_HotelInvCountNotifRQ tercih edilir.

• OTA_HotelInvCountNotifRQ. Fiziksel oda envanterini veya satılabilecek oda sayısını tanımlar.

• TaxFeeInfo. (İsteğe bağlı) Tesis başına vergileri ve ücretleri tanımlar. OTA_HotelRateAmountNotifRQ mesajında AmountAfterTax belirtilmişse bu mesaj gerekli değildir.

• Promotions. (İsteğe bağlı) Belirli rezervasyonlar, konaklamalar ve kullanıcılar için promosyon ücretlerini tanımlar.

• RateModifications. (İsteğe bağlı) Belirli rezervasyonlar, konaklamalar ve kullanıcılar için ücret değiştirme kurallarını tanımlar.

• ExtraGuestCharges. (İsteğe bağlı) Fiyatlar'ın çocuklar ve ek yetişkinler için nasıl yapılandırılması gerektiğini tanımlar.

Her mesaj, Google'ın belirli check-in/çıkış tarihleri ve doluluk oranına sahip tesislerinizi arayan kullanıcılara gösterilen fiyatları ve müsaitlik durumunu hesaplamak için kullandığı bilgi alt kümesini içerir.

Önemli Bilgi: ARI özellikleri, bu Envanter ve Fiyatlandırma (ARI) XML referansında ve ARI kılavuzunda açıklanan mesajlar ve öğelerle sınırlıdır. Özel olarak burada belirtilmeyen herhangi bir OTA mesajı, öğesi veya özelliği ARI uygulamamızda desteklenmez.

ARI feed türü kullanılırken bu Envanter ve Fiyatlandırma (ARI) XML referansında yer almayan diğer Transaction mesajı öğeleri de desteklenmez.

Google, API'yi güncellemeye ve iyileştirmeye devam etmektedir. Sisteminizde ek fiyatlandırma özellikleri kullanıyorsanız Technology Account Manager(TAM) ile iletişim kurarak bu özelliklere öncelik verilmesini sağlayın veya söz konusu özelliklerin kullanıma sunulması planlanıp tamamlanmadığını size bildirin.

ARI XML Referansı düzeltme geçmişi

Aşağıdaki tabloda yalnızca özellik değişiklikleriyle ilgili doküman güncellemeleri listelenmektedir.

Tarih	Değişiklikler
14 Ağustos 2020	İlk sürüm.
21 Ekim 2020	Promosyonlar mesaj türü eklendi.
17 Kasım 2020	Transaction (Tesis Verileri) mesajları için uç nokta güncellendi ve PropertyDataSet öğelerine action özelliği eklendi.
24 Kasım 2020	Transaction (Tesis Verileri) mesajları için <AllowablePackageIDs> ve <AllowableRoomIDs> öğeleri eklendi.
4 Şubat 2021	Yanıt mesajları eklendi.
25 Şubat 2021	OTA_HotelInvCountNotifRQ eklendi.
21 Ekim 2020	Ücret Değişiklikleri mesaj türü eklendi.