Pesan Inventaris

Ringkasan

Pesan Inventaris (OTA_HotelInvCountNotifRQ) menentukan jumlah inventaris (jumlah kamar fisik) yang tersedia untuk dipesan untuk jenis kamar tertentu. Saat mengirim pesan Inventaris, Anda menunjukkan jumlah kamar jenis tersebut yang tersedia pada tanggal tertentu. Jika tidak ada kamar dengan jenis tersebut yang tersedia, produk yang melibatkan jenis kamar dan tanggal tersebut tidak akan ditampilkan.

Bagian berikut mencakup panduan umum, contoh dasar, dan skenario cara untuk membantu Anda mulai menambahkan dan memperbarui inventaris serta mengirim pesan Inventaris.

Untuk contoh berbagai skenario terkait inventaris, lihat Cara.

Elemen wajib dan opsional

Referensi XML memberikan deskripsi elemen wajib dan opsional. Untuk mengetahui detail tentang atribut dan elemen turunan, lihat Elemen & atribut inventaris.

Sintaksis dan skema

Gunakan contoh sintaksis Inventaris sebagai referensi saat Anda membuat pesan Inventaris untuk memastikan Anda mengikuti format yang benar.

Anda dapat menggunakan alat XML pihak ketiga seperti xmllint untuk memvalidasi feed dengan skema yang dipublikasikan sebelum mengirimkannya ke Google. Untuk skema pesan Inventaris, lihat Skema Iklan Hotel.

Panduan

Gunakan panduan berikut untuk pesan Inventaris:

  • Inventaris dikelompokkan menurut hotel, tanggal, dan jenis kamar.

  • Jumlah inventaris harus lebih besar dari 0 untuk semua malam menginap agar harga ditampilkan untuk paket tarif dan hunian terkait.

  • Jika jumlah inventaris sama dengan 0, kamar tidak akan tersedia untuk dipesan untuk ID Kamar dan rentang tanggal yang ditentukan.

  • CountType harus selalu memiliki nilai 2 agar valid karena menunjukkan jumlah "ketersediaan pasti".

  • Kirim inventaris yang diperbarui setiap kali terjadi reservasi atau pembatalan kamar di sistem Anda.

Inventaris versus ketersediaan

Inventaris adalah jumlah kamar yang dapat dipesan berdasarkan jumlah fisik dan ketersediaan menunjukkan apakah kombinasi jenis kamar dan paket tarif diizinkan untuk dipesan. Untuk ARI, ketersediaan dan inventaris dapat bervariasi berdasarkan serangkaian tanggal atau jenis akomodasi, dan keduanya memiliki jenis pesan yang sesuai. Inventaris dan ketersediaan dikelompokkan berdasarkan hotel, tanggal, dan jenis kamar, dengan penambahan paket tarif untuk ketersediaan.

Mungkin ada "tidak ada ketersediaan" meskipun ada inventaris karena inventaris dan ketersediaan tidak saling terkait.

Ada dua konsep ketersediaan. Pertama, ada ketersediaan keseluruhan produk untuk masa inap tertentu yang dipengaruhi oleh faktor-faktor seperti apakah setiap malam memiliki tarif yang ditentukan, inventaris untuk jenis kamar terkait, dan pembatasan ketersediaan terbuka. Kedua, ada batasan spesifik untuk produk pada tanggal tertentu, yang diwakili oleh <RestrictionStatus Restriction="Master" Status="Open"/> dalam OTA_HotelAvailNotifRQ, dan penutupan ketersediaan ini dikenal sebagai "penghentian penjualan".

Inventaris harus berupa bilangan bulat yang lebih besar dari 0 untuk kamar dan pembatasan ketersediaan harus terbuka agar harga produk ditampilkan.

Contoh

Bagian ini memberikan contoh dasar pesan Inventaris menggunakan elemen wajib dan opsional. Setelah menyiapkan file, Anda harus mengirimkannya ke Google melalui pesan POST ke endpoint ini:

https://www.google.com/travel/hotels/uploads/ota/hotel_inv_count_notif

Untuk mempelajari lebih lanjut cara mengirim/POSTING pesan, lihat Mengirim pesan.

Untuk HotelCode, gunakan ID Hotel unik yang Anda gunakan dalam sistem untuk mengidentifikasi properti. Nilai ini harus cocok dengan ID Hotel yang ditentukan menggunakan <id> di elemen <listing> di feed Daftar Hotel. Untuk <RoomID>, gunakan ID yang sama dengan yang Anda gunakan dalam sistem untuk tipe kamar. Konsistensi dengan sistem Anda sangat penting untuk memastikan Google menampilkan data Anda dengan benar.

Contoh ini menunjukkan cara menyetel inventaris untuk 13 kamar yang dapat dipesan selama bulan Desember:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="HotelID">
    <Inventory>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"/>
      <InvCounts>
        <InvCount Count="13" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

Untuk contoh lainnya, lihat Contoh inventaris.

Petunjuk

Bagian ini memberikan skenario yang mungkin Anda alami saat mengirim pesan Inventaris.

Skenario: Cara memblokir pemesanan kamar

Deskripsi

Anda harus menunjukkan bahwa tidak ada kamar tersisa yang dapat dipesan untuk jenis kamar ini pada serangkaian tanggal tertentu, biasanya karena kamar sudah habis.

Solusi

Anda menetapkan <InvCount Count> ke nilai 0 dan menambahkan rentang tanggal yang diinginkan.

Contoh

Contoh ini menunjukkan cara menggunakan InvCount untuk menyetel inventaris ke 0 untuk kamar dan tanggal yang ditentukan (misalnya, beberapa minggu pertama di bulan Januari).

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-01-15"
                                InvTypeCode="ROOMID"/>
      <InvCounts>
        <InvCount Count="0" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>