Pesan Inventaris

Ringkasan

Pesan Inventaris (OTA_HotelInvCountNotifRQ) menentukan jumlah inventaris (jumlah kamar fisik) yang tersedia untuk dipesan untuk ruang tertentu jenis datanya. Saat Anda mengirim pesan Inventaris, Anda menunjukkan jumlah ruangan 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 pedoman umum, contoh dasar, dan petunjuk skenario untuk membantu Anda mulai menambahkan dan memperbarui inventaris dan 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 atribut dan elemen turunan, lihat Elemen & atribut inventaris.

Sintaksis dan skema

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

Anda dapat menggunakan alat XML pihak ketiga seperti xmllint untuk memvalidasi feed Anda dengan skema yang dipublikasikan sebelum mengirimkannya ke Google. Untuk Inventaris skema pesan, 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 dalam pesanan guna menampilkan harga untuk paket tarif dan jumlah tamu terkait.

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

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

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

Inventaris versus ketersediaan

Inventaris adalah jumlah ruang yang dapat dipesan berdasarkan jumlah fisik dan {i>availability<i} menunjukkan apakah kombinasi jenis kamar dan paket tarif diizinkan untuk dipesan. Untuk ARI, ketersediaan dan inventaris dapat bervariasi berdasarkan pada satu set tanggal atau jenis akomodasi, dan keduanya memiliki jenis pesan. Inventaris dan ketersediaan ditentukan berdasarkan hotel, tanggal, dan kamar khusus, dengan tambahan paket tarif untuk ketersediaan.

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

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

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

Contoh

Bagian ini memberikan contoh dasar pesan Inventaris yang menggunakan atribut dan elemen opsional. Setelah Anda 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 mendorong/MENGPOSTING pesan, lihat Mendorong pesan.

Untuk HotelCode, gunakan ID Hotel unik yang Anda gunakan dalam sistem untuk yang mengidentifikasi properti. Nilai ini harus cocok dengan ID Hotel yang ditentukan menggunakan <id> di <listing> elemen 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 bahwa Google menampilkan data Anda dengan benar.

Contoh ini menunjukkan cara menetapkan inventaris untuk 13 ruang yang dapat dipesan untuk 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 Inventaris contoh.

Petunjuk

Bagian ini menguraikan skenario yang mungkin Anda temui saat mengirim sebuah Pesan inventaris.

Skenario: Cara memblokir pemesanan ruang

Deskripsi

Anda perlu menunjukkan bahwa tidak ada ruang tersisa yang dapat dipesan tipe kamar ini pada serangkaian tanggal tertentu, paling sering karena kamar itu 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 ruangan 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>