Pesan Ketersediaan

Ringkasan

Pesan Ketersediaan (OTA_HotelAvailNotifRQ) menentukan apakah produk (jenis kamar yang digabungkan dengan paket tarif) untuk itinerari tertentu dapat dijual untuk tanggal yang berlaku. Saat mengirim pesan Ketersediaan, Anda menunjukkan apakah ketersediaan atau batasan untuk suatu produk telah berubah.

Poin Penting: Inventaris juga dapat diperbarui menggunakan jenis pesan Ketersediaan, tetapi jenis pesan Inventaris (OTA_HotelInvCountNotifRQ) adalah metode yang lebih disarankan.

Bagian berikut mencakup panduan umum, contoh dasar, dan skenario cara untuk membantu Anda mulai menambahkan dan memperbarui ketersediaan menggunakan Pesan ketersediaan.

Batasan ketersediaan malam hari

Pesan Ketersediaan memungkinkan Anda menentukan batasan yang mengontrol ketersediaan keseluruhan pemesanan. Salah satu jenis pembatasan yang penting adalah "ketersediaan setiap malam": apakah produk dapat dijual pada tanggal tertentu. Agar dapat dipesan, masa inap (dari check-in hingga check-out) harus memiliki ketersediaan per malam pada semua tanggal, dan semua batasan pemesanan dan masa inap lainnya harus dipenuhi.

Catatan: Untuk mengetahui informasi selengkapnya tentang konsep Ketersediaan dan perbedaan antara Inventaris dan Ketersediaan, lihat Inventaris versus ketersediaan.

Setelan pembatasan

Secara default, RestrictionStatus untuk Restriction="Master" ditutup. Dengan kata lain, secara default, ada "penghentian penjualan" setiap malam.

Agar dapat dijual, produk harus memiliki <RestrictionStatus Restriction="Master" Status="Open"> untuk semua kombinasi produk pada semua malam menginap. Anda harus mengirimkan Open eksplisit ke Google untuk setiap produk atau mengubah setelan default di Pusat Pengelolaan Hotel. Hal ini dapat dilakukan dengan membuka halaman Harga > Setelan di Pusat Pengelolaan Hotel dan mengedit kolom "ketersediaan default".

Pembatasan lain

Kedatangan/Keberangkatan

Mencegah penjualan itinerari yang tiba atau berangkat pada tanggal yang ditentukan. Nilainya adalah Open secara default.

Selisih pemesanan minimum dan maksimum

Mewajibkan itinerari dibeli setidaknya atau paling banyak dalam jumlah hari tertentu sebelum kedatangan.

Lama menginap minimum dan maksimum

Membatasi durasi menginap untuk itinerari yang memiliki tanggal kedatangan ini.

Lama menginap di masa mendatang minimum dan maksimum (atau "lama menginap")

Membatasi lama menginap untuk itinerari yang berisi tanggal menginap ini.

Pola lama menginap

Memberikan kontrol yang tepat atas durasi menginap yang diizinkan untuk tanggal kedatangan ini.

Panduan umum

• Batasan ketersediaan dikelompokkan berdasarkan hotel, tanggal, jenis kamar, dan paket tarif.

• Produk hanya dapat dipesan jika tidak ada batasan yang diberlakukan yang berlaku pada masa inap (dari check-in hingga check-out) atau saat pengguna dapat memesan masa inap.

• Kirim pembaruan pesan Ketersediaan ke Google setiap kali ada perubahan pada batasan ketersediaan produk pada tanggal tertentu.

Contoh

Bagian ini memberikan contoh dasar pesan Ketersediaan 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_avail_notif

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

Poin Penting: Kirim pesan yang diperbarui kepada Google setiap kali ketersediaan berubah.

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. Konsistensi dengan sistem Anda sangat penting untuk memastikan Google menampilkan data Anda dengan benar.

Contoh ini menunjukkan cara menetapkan batasan ketersediaan:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <AvailStatusMessages HotelCode="HOTELID">
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="202X-03-20"
                                End="202X-03-25"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay MinMaxMessageType="SetMinLOS" Time="2" TimeUnit="Day" />
      </LengthsOfStay>
      <RestrictionStatus Restriction="Master" Status="Open" />
    </AvailStatusMessage>
</OTA_HotelAvailNotifRQ>

Untuk contoh lainnya, lihat Contoh ketersediaan.

Petunjuk

Bagian ini memberikan solusi untuk skenario yang mungkin Anda alami saat mengirim pesan Ketersediaan, khususnya detail tentang pembatasan ketersediaan malam hari (juga dikenal sebagai "berhenti jual").

Skenario 1: Cara menjual produk pada tanggal tertentu

Deskripsi

Anda ingin membuat kombinasi jenis kamar dan paket tarif (produk) tersedia pada tanggal tertentu.

Catatan: Secara default, Google memperlakukan produk seolah-olah "berhenti dijual" (ketersediaan setiap malam ditutup), tetapi Anda dapat mengonfigurasi apakah pembatasan ketersediaan setiap malam terbuka atau tertutup secara default. Anda harus mengirimkan Open eksplisit untuk setiap produk kepada Google atau mengubah setelan default di Pusat Pengelolaan Hotel.

Solusi

Tetapkan batasan Master ke Open dan tentukan tanggalnya.

Contoh

Contoh ini menunjukkan cara membuka ketersediaan malam untuk produk selama beberapa minggu pada bulan Maret.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2022-03-20"
                                End="2022-03-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

Catatan: Pembatasan ketersediaan per malam harus Open (dan inventaris harus berupa bilangan bulat yang lebih besar dari 0 untuk kamar) agar harga produk dapat ditampilkan.

Untuk mengetahui informasi selengkapnya tentang cara menetapkan harga, lihat Memecahkan masalah harga yang tidak ada atau tidak lengkap.

Skenario 2: Cara berhenti menjual produk pada tanggal tertentu

Deskripsi

Anda secara eksplisit ingin menghentikan penjualan produk (bukan karena kehabisan stok) pada tanggal tertentu.

Catatan: Jika produk dinonaktifkan sepenuhnya karena jenis kamar, paket tarif, atau kombinasinya dinonaktifkan, sebaiknya gunakan pesan Transaksi (Data Properti) untuk membatalkan pemetaan produk karena tidak bergantung pada tanggal.

Solusi

Tetapkan batasan Master ke Close dan tentukan tanggalnya.

Contoh

Contoh ini menunjukkan cara "menghentikan penjualan" atau menutup ketersediaan malam untuk produk pada tanggal tertentu.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2022-04-20"
                                End="2022-04-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>