Referensi XML Ketersediaan, Tarif, dan Inventaris (ARI)

Panduan referensi XML ini memberikan konten referensi mendetail dan contoh kode untuk berbagai pesan, elemen, dan atribut yang tersedia untuk feed Ketersediaan, Tarif, dan Inventaris (ARI).

ARI adalah mode pengiriman harga yang mengontrol tarif, ketersediaan, dan inventaris per malam, serta memberikan batasan terkait bagaimana semua opsi tersebut dapat digabungkan. ARI juga memberikan fleksibilitas untuk menyertakan pajak, biaya, dan promosi.

ARI mengikuti protokol standar OpenTravel Alliance (OTA) untuk beberapa jenis pesan utama guna menentukan ketersediaan dan inventaris.

Harga berdasarkan LOS

Harga LOS-based memungkinkan Anda menentukan tarif per tanggal check-in dan lama menginap, bukan per tanggal menginap. Saat Anda menentukan elemen <StatusApplicationControl> untuk harga berdasarkan LOS, atribut @Start dan @End menandakan rentang tanggal check in yang diberlakukan tarif LOS.

Meskipun saat menggunakan harga berbasis LOS, tidak ada lagi tarif per malam, semua fitur ARI lainnya (inventaris, ketersediaan, aturan, promosi, dll.) masih dapat diterapkan pada tarif ini dan ditentukan pada tingkat per malam. Artinya, jika sistem Anda lebih selaras dengan sistem penetapan harga berbasis LOS, Anda masih dapat memanfaatkan set fitur ARI yang lengkap, selain efisiensi bandwidth yang diberikan dengan memanfaatkan ketersediaan setiap malam dan update batasan.

Poin Penting: Setiap properti di akun Anda harus menggunakan tarif berbasis LOS atau tarif per tanggal.

Untuk mengaktifkan harga berdasarkan LOS di akun Anda, hubungi TAM Anda atau hubungi kami.

Poin Penting: Anda harus mengirimkan empat jenis pesan (transaksi, tarif, inventaris, dan ketersediaan) sebelum harga tersedia. Sebaiknya ukuran pesan ARI secara khusus <OTA_HotelRateAmountNotifRQ> hingga 5 MB dengan batas kecepatan upload 400 file per detik.

ARI menggunakan pesan permintaan berikut:

• Transaction (Data Properti). Menentukan jenis dan informasi paket (paket tarif).

• OTA_HotelRateAmountNotifRQ. Menentukan jumlah tarif jumlah tamu per tanggal atau berdasarkan LOS per produk (kombinasi jenis kamar dan paket tarif) untuk rentang tanggal tertentu.

• OTA_HotelAvailNotifRQ. Menentukan ketersediaan dan batasan berdasarkan jenis kamar dan paket tarif. Inventaris juga dapat diperbarui menggunakan pesan ini, tetapi OTA_HotelInvCountNotifRQ lebih disarankan.

• OTA_HotelInvCountNotifRQ. Menentukan inventaris kamar fisik atau jumlah kamar yang tersedia untuk dijual.

• TaxFeeInfo. (Opsional) Menentukan pajak dan biaya per properti. Pesan ini tidak diperlukan jika AmountAfterTax ditentukan dalam pesan OTA_HotelRateAmountNotifRQ.

• Promotions. (Opsional) Menentukan tarif promosi untuk pemesanan, masa inap, dan pengguna tertentu.

• RateModifications. (Opsional) Menentukan aturan modifikasi tarif untuk pemesanan, lama menginap, dan pengguna tertentu.

• ExtraGuestCharges. (Opsional) Menentukan bagaimana tarif harus dikonfigurasi untuk anak-anak dan orang dewasa tambahan.

Setiap pesan berisi subkumpulan informasi yang digunakan Google untuk menghitung harga dan ketersediaan yang ditampilkan kepada pengguna saat mereka menelusuri properti Anda dengan tanggal check-in dan check-out serta jumlah tamu tertentu.

Poin Penting: Fitur ARI terbatas pada pesan dan elemen yang dijelaskan dalam referensi XML Inventaris & Harga (ARI) ini dan panduan ARI. Semua pesan, elemen, atau atribut OTA yang tidak didokumentasikan secara spesifik di sini tidak didukung dalam implementasi ARI kami.

Selain itu, elemen pesan Transaksi lainnya yang tidak tercakup dalam referensi XML Inventaris & Harga (ARI) ini tidak didukung saat menggunakan jenis feed ARI.

Google terus mengupdate dan meningkatkan kualitas API. Jika Anda menggunakan fitur harga tambahan dalam sistem, beri tahu Technology Account Manager(TAM) agar dapat diprioritaskan dengan fitur tersebut atau ia akan memberi tahu Anda jika fitur tersebut direncanakan untuk rilis.

Histori revisi Referensi XML ARI

Tabel berikut mencantumkan pembaruan dokumentasi untuk perubahan fitur saja.

Tanggal	Perubahan
14 Agustus 2020	Rilis awal.
21 Oktober 2020	Menambahkan jenis pesan Promosi.
17 November 2020	Untuk pesan Transaksi (Data Properti), memperbarui endpoint dan menambahkan atribut action ke elemen PropertyDataSet.
24 November 2020	Untuk pesan Transaksi (Data Properti), menambahkan elemen <AllowablePackageIDs> dan <AllowableRoomIDs>.
4 Februari 2021	Pesan respons ditambahkan.
25 Februari 2021	Menambahkan OTA_HotelInvCountNotifRQ.
21 Oktober 2020	Menambahkan jenis pesan Modifikasi Tarif.