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 dari jenis tersebut yang tersedia pada tanggal tertentu. Jika jenis kamar tersebut tidak tersedia, produk yang melibatkan jenis dan tanggal kamar tersebut tidak akan ditampilkan.

Bagian berikut membahas pedoman umum, contoh dasar, dan skenario cara untuk mulai menambahkan dan memperbarui inventaris serta mengirim pesan Inventaris.

Untuk contoh berbagai skenario terkait inventaris, lihat Petunjuk.

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 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 dikunci berdasarkan hotel, tanggal, dan jenis kamar.

  • Jumlah inventaris harus lebih besar dari 0 untuk semua malam menginap agar dapat menampilkan harga untuk paket tarif dan jumlah tamu yang terkait.

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

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

  • Mengirim inventaris yang diperbarui setiap kali reservasi atau pembatalan kamar terjadi 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 dikunci berdasarkan hotel, tanggal, dan jenis kamar, dengan penambahan paket tarif untuk ketersediaan.

Mungkin "tidak ada ketersediaan" meskipun inventaris tersedia karena inventaris dan ketersediaan tidak saling bergantung.

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

Inventaris harus berupa bilangan bulat yang lebih besar dari 0 untuk kamar dan batasan ketersediaan harus dibuka agar dapat menampilkan harga produk.

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> dalam feed Daftar Hotel. Untuk <RoomID>, gunakan ID yang sama dengan yang Anda gunakan dalam sistem untuk jenis kamar. Konsistensi dengan sistem Anda sangat penting untuk memastikan bahwa Google menampilkan data Anda dengan benar.

Contoh ini menunjukkan cara menetapkan 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 Inventory.

Skenario: Cara memblokir ruang agar tidak dipesan

Deskripsi

Anda perlu menunjukkan bahwa tidak ada kamar tersisa yang dapat dipesan untuk jenis kamar ini pada kumpulan tanggal tertentu, biasanya karena ruang telah terjual habis.

Solusi

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

Contoh

Contoh ini menunjukkan cara menggunakan InvCount untuk menetapkan inventaris ke 0 untuk kamar dan tanggal yang ditentukan (misalnya, beberapa minggu pertama pada 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>