Referensi XML Ketersediaan, Tarif, dan Inventaris (ARI)

Panduan referensi XML ini menyediakan 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 per malam, ketersediaan, dan inventaris, serta memberikan batasan tentang cara menggabungkannya. ARI juga memberikan fleksibilitas untuk menyertakan pajak, biaya, dan promosi.

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

Harga berbasis 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 berbasis LOS, atribut @Start dan @End menandakan rentang tanggal check-in yang menerapkan 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 di tingkat per malam. Artinya, jika sistem Anda lebih selaras dengan sistem penetapan harga berbasis LOS, Anda tetap dapat memanfaatkan serangkaian fitur ARI yang lengkap, selain efisiensi bandwidth yang diberikan dengan memanfaatkan ketersediaan dan pembaruan batasan harian.

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

Untuk mengaktifkan harga berbasis 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 batasi ukuran pesan ARI secara khusus <OTA_HotelRateAmountNotifRQ> hingga 5 MB dengan batas kecepatan upload 400 file per detik. Hindari mengirimkan beberapa informasi itinerari spesifik per tanggal yang tumpang-tindih dalam interval 3 detik dari pesan terakhir.

ARI menggunakan pesan permintaan berikut:

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

• OTA_HotelRateAmountNotifRQ. Menentukan jumlah tarif hunian per tanggal atau berbasis 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, menginap, dan pengguna tertentu.

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

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

Setiap pesan berisi subkumpulan informasi yang digunakan Google untuk menghitung harga serta 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 jika menggunakan jenis feed ARI.

Google terus memperbarui dan meningkatkan kualitas API. Jika Anda menggunakan fitur penetapan harga tambahan pada sistem, beri tahu Technology Account Manager(TAM) agar fitur tersebut dapat diprioritaskan dengan fitur tersebut atau mereka akan memberi tahu Anda jika fitur tersebut direncanakan untuk dirilis.

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	Menambahkan pesan respons.
25 Februari 2021	OTA_HotelInvCountNotifRQ ditambahkan.
21 Oktober 2020	Menambahkan jenis pesan Perubahan Tarif.