Pesan Ketersediaan

Ringkasan

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

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

Bagian berikut membahas panduan umum, contoh dasar, dan skenario petunjuk untuk membantu Anda mulai menambahkan dan memperbarui ketersediaan menggunakan pesan Ketersediaan.

Batasan ketersediaan per malam

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

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

Setelan pembatasan

Secara default, RestrictionStatus untuk Restriction="Master" ditutup. Dengan kata lain, secara default, ada "berhenti menjual" di 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 kepada 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 kedatangan atau keberangkatan pada tanggal yang ditentukan. Nilainya adalah Open secara default.

Offset pemesanan minimum dan maksimum

Mewajibkan itinerari dibeli setidaknya atau maksimum sejumlah hari tertentu sebelum kedatangan.

Lama menginap minimum dan maksimum

Membatasi lama menginap untuk itinerari yang memiliki tanggal kedatangan ini.

Masa inap maju minimum dan maksimum (atau "stay-through")

Membatasi lama menginap untuk itinerari yang berisi tanggal menginap ini.

Pola lama menginap

Memberikan kontrol yang tepat terkait lama menginap yang diizinkan untuk tanggal kedatangan ini.

Pedoman umum

• Batasan ketersediaan dipengaruhi oleh hotel, tanggal, jenis kamar, dan paket tarif.

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

• Kirimi Google pembaruan pesan Ketersediaan kepada Google setiap kali ada perubahan batasan ketersediaan untuk 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 baru ke 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 bahwa 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 setiap malam (juga dikenal sebagai "berhenti menjual").

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 sebagai mengaktifkan "hentikan penjualan" (ketersediaan per malam ditutup), tetapi Anda dapat mengonfigurasi apakah pembatasan ketersediaan per malam dibuka atau ditutup 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 tanggal.

Contoh

Contoh ini menunjukkan cara membuka ketersediaan setiap malam untuk suatu 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: Batasan ketersediaan per malam harus Open (dan inventaris harus berupa bilangan bulat yang lebih besar dari 0 untuk kamar) agar dapat menampilkan harga produk.

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

Skenario 2: Cara berhenti menjual produk pada tanggal tertentu

Deskripsi

Anda secara eksplisit ingin menghentikan penjualan produk (alih-alih kehabisan inventaris) pada tanggal tertentu.

Catatan: Jika produk sepenuhnya dinonaktifkan, 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 tanggal.

Contoh

Sampel ini menunjukkan cara "menghentikan penjualan" atau menutup ketersediaan per malam untuk produk pada tanggal yang ditentukan.

<?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>