Pesan Ketersediaan

Ringkasan

Pesan Ketersediaan (OTA_HotelAvailNotifRQ) menentukan apakah suatu produk (jenis kamar dikombinasikan dengan paket tarif) untuk itinerari tertentu dapat dijual dengan harga tanggal yang berlaku. Saat mengirim pesan Ketersediaan, Anda harus 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 lebih disukai.

Bagian berikut mencakup pedoman umum, contoh dasar, dan petunjuk skenario untuk membantu Anda mulai menambah dan memperbarui ketersediaan menggunakan Pesan ketersediaan.

Batasan ketersediaan per malam

Pesan Ketersediaan memungkinkan Anda menentukan batasan yang mengontrol ketersediaan pemesanan. Salah satu jenis batasan yang penting adalah "ketersediaan malam hari": apakah produk dapat dijual pada tanggal tertentu. Agar masa inap (dari check-in hingga check-out) dapat dipesan, harus ada properti setiap malam ketersediaan pada semua tanggal, dan semua batasan pemesanan serta masa inap lainnya harus jika kondisi tertentu terpenuhi.

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

Setelan pembatasan

Secara default, RestrictionStatus untuk Restriction="Master" ditutup. Di kata, secara default, ada "stop jual" 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 secara default di Pusat Pengelolaan Hotel. Hal ini dapat dilakukan dengan menavigasi ke Harga > Setelan di Pusat Pengelolaan Hotel dan mengedit kolom "default ketersediaan" kolom tersebut.

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

Mengharuskan itinerari dibeli minimal atau maksimal dalam jumlah tertentu hari sebelum kedatangan.

Panjang masa inap minimum dan maksimum

Membatasi lama menginap untuk itinerari yang memiliki tanggal kedatangan ini.

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

Membatasi lama menginap untuk itinerari yang berisi tanggal menginap ini.

Pola lama menginap

Memberikan kontrol yang tepat tentang lama masa inap yang diizinkan untuk tanggal kedatangan ini.

Panduan umum

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

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

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

Contoh

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

Untuk mempelajari lebih lanjut cara mendorong/MENGPOSTING pesan, lihat Mendorong pesan.

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

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 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 Ketersediaan contoh.

Petunjuk

Bagian ini memberikan solusi untuk skenario yang mungkin Anda hadapi saat mengirim Pesan ketersediaan, khususnya detail ketersediaan per malam pembatasan (disebut juga "stop jual").

Skenario 1: Cara menjual produk pada tanggal tertentu

Deskripsi

Anda ingin menyediakan kombinasi jenis kamar dan paket tarif (produk) di tanggal tertentu.

Catatan: Secara default, Google memperlakukan produk sebagai "menghentikan penjualan" yang diaktifkan (ketersediaan setiap malam ditutup), tetapi Anda dapat mengonfigurasi apakah batasan ketersediaan setiap malam terbuka atau tertutup secara default. Anda harus mengirimkan permintaan Open eksplisit untuk setiap produk atau ubah default di Pusat Pengelolaan Hotel.

Solusi

Tetapkan batasan Master ke Open dan tentukan tanggalnya.

Contoh

Contoh ini menunjukkan cara membuka ketersediaan malam untuk suatu produk selama beberapa minggu di 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 bilangan bulat yang lebih besar dari 0 untuk kamar) agar dapat menampilkan harga produk.

Untuk informasi selengkapnya tentang cara menyetel harga, lihat Pemecahan masalah untuk masalah yang tidak ada atau harga tidak lengkap.

Skenario 2: Cara berhenti menjual produk pada tanggal tertentu

Deskripsi

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

Catatan: Jika produk benar-benar dinonaktifkan, karena jenis kamar, tarif tertentu, atau kombinasinya dinonaktifkan, maka lebih disarankan untuk menggunakan Transaksi (Data Properti) pesan ke batalkan pemetaan produk karena tidak bergantung pada tanggal.

Solusi

Tetapkan batasan Master ke Close dan tentukan tanggalnya.

Contoh

Sampel ini menunjukkan cara "menghentikan penjualan" atau menutup ketersediaan per malam untuk 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>