Halaman ini diterjemahkan oleh Cloud Translation API.

Pesan Tarif

Ringkasan

Pesan Tarif (OTA_HotelRateAmountNotifRQ) menentukan tarif per malam tingkat keterisian untuk setiap jenis kamar dan kombinasi paket tarif untuk tanggal tertentu rentang. Sebagai bagian dari pesan Tarif, Google mendukung penetapan harga berdasarkan jumlah tamu, memungkinkan tarif per malam yang berbeda ditentukan berdasarkan jumlah maksimum penghuni yang dituju.

Bagian berikut mencakup pedoman umum, contoh dasar, dan petunjuk skenario untuk membantu Anda mulai menambah dan memperbarui tingkat dan mengirimkan Beri rating pesan.

Perilaku rasio kecocokan

Saat pengguna meminta jumlah tamu tertentu, tarif yang mereka lihat bergantung pada cara Anda menentukan harga dalam pesan Tarif. Bagian ini membahas bagaimana permintaan pengguna dicocokkan dengan tarif Anda bergantung pada jumlah tamu dan tarif yang Anda tentukan.

Prinsip utama

Tarif yang ditentukan untuk jumlah tamu tertentu berlaku untuk semua jumlah tamu yang lebih rendah, kecuali jika dinyatakan lain.
Permintaan jumlah tamu di atas yang ditentukan dianggap tidak dapat dilakukan.
Harga berdasarkan jumlah tamu berlaku untuk harga per tanggal dan berdasarkan jumlah tamu model harga yang dijelaskan di bawah ini. Artinya, Anda dapat menentukan tarif untuk jumlah tamu. Jika tarif untuk jumlah tamu tertentu tidak ada, tarif untuk jumlah tamu tertinggi berikutnya akan digunakan. Anda juga dapat menentukan biaya untuk tamu dan anak tambahan menggunakan AdditionalGuestAmounts atau ExtraGuestCharges yang diterapkan hingga kapasitas yang ditentukan untuk kamar.

Poin Penting: Ada batas 100 biaya tamu tambahan per properti. Anda dapat Gunakan pesan ExtraGuestCharge untuk menghapus biaya tamu tambahan.

Manfaat dan contoh

Efisiensi

Untuk beberapa jumlah tamu dengan jumlah tarif yang sama, Anda tidak perlu menetapkan tarif untuk setiap jumlah tamu. Anda dapat menyederhanakan pesan dengan hanya menetapkan nilai jumlah tamu tertinggi yang didukung oleh jenis kamar dan paket tarif. Pengguna akan melihat tarif tersebut untuk setiap jumlah tamu yang kurang dari atau sama dengan yang Anda tetapkan dengan sejumlah nilai.

Contoh: Tarif untuk jenis kamar dan paket tarif sama untuk jumlah hunian satu hingga empat. Gunakan pesan Tarif untuk menetapkan satu tarif untuk maks jumlah tamu 4 orang. Pengguna yang menelusuri jumlah tamu satu, dua, dan tiga orang akan melihat rasio yang sama. Pengguna yang menelusuri 5 tahun ke atas tidak akan melihat tarif.

Kontrol

Tarif berbeda untuk jumlah tamu alternatif dapat diberikan secara eksplisit. Kirim tarif yang berbeda untuk setiap nilai jumlah tamu. Jika Anda ingin kontrol yang lebih besar Google mencocokkan permintaan dengan tingkat keterisian.

Contoh: Jika tarif ditentukan untuk jumlah tamu 3 dan 1, jumlah tamu satu orang penelusuran akan menampilkan tarif single, penelusuran jumlah tamu untuk dua orang akan ditampilkan tingkat keterisian tiga orang, dan pengguna yang menelusuri jumlah tamu 4 orang ke atas tidak akan melihat tarif.

Untuk contoh lainnya dari berbagai skenario terkait tarif, lihat Petunjuk.

Elemen wajib dan opsional

Referensi XML memberikan deskripsi elemen wajib dan opsional. Untuk mengetahui detail tentang dan elemen turunan, lihat Elemen Tarif & Atribut.

Sintaksis dan skema

Gunakan Sintaksis Tarif sebagai referensi saat Anda membuat pesan Tarif 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 skema pesan Rating, lihat Skema Iklan Hotel.

Model penetapan harga

Harga per tanggal

Ini adalah model penetapan harga standar yang digunakan untuk sebagian besar properti. per-date model harga didasarkan pada penetapan tarif yang diringkas di seluruh tanggal menginap untuk mendapatkan harga total. Dalam model ini, semua tarif di bawah elemen Rate ditafsirkan sebagai diterapkan ke rentang tanggal menginap yang ditentukan dalam <StatusApplicationControl>.

Harga berdasarkan LOS

Model penetapan harga berbasis LOS (panjang masa inap) didasarkan pada tarif yang ditetapkan untuk kombinasi tanggal kedatangan dan panjang masa inap. Tarif yang ditentukan dalam Model penetapan harga berbasis LOS adalah per hari. Misalnya, jika Anda mengirim tarif sebesar $100 untuk lama menginap 3 orang, harga totalnya dihitung sebagai 3 x$100=$300.

Anda dapat menggunakan model penetapan harga berbasis LOS dengan menentukan RatePlanType="26" pada elemen StatusApplicationControl. Anda juga perlu menetapkan atribut RateTimeUnit dan UnitMultiplier pada elemen Rate di XML. Ini menyebabkan semua tarif di bawah elemen Rate yang diberikan diterapkan ke tetap ditentukan oleh tanggal kedatangan yang ditentukan dalam <StatusApplicationControl> dan Nilai LOS ditentukan untuk UnitMultiplier.

Anda dapat menggunakan model penetapan harga per tanggal dan berbasis LOS di bawah satu Namun, setiap properti sebaiknya hanya menggunakan satu model penetapan harga. Perhatikan hal-hal berikut saat menerapkan harga berbasis LOS:

Tarif untuk panjang masa inap yang berbeda tidak digabungkan saat menggunakan berbasis LOS penetapan harga. Misalnya, rasio LOS 3 tidak dikombinasikan dengan LOS dari 1 untuk menetapkan harga rasio LOS 4. Rasio LOS 4 harus secara eksplisit yang ditentukan.
Tarif 1 malam di harga berbasis LOS tidak digunakan sebagai tarif malam individual dengan harga per tanggal.
Setiap properti hanya boleh menggunakan harga berdasarkan LOS atau per tanggal harga, tergantung pada cara tarif ditampilkan dalam sistem Anda.

Untuk mengaktifkan harga berdasarkan LOS di akun Anda, buat permintaan melalui TAM atau hubungi kami.

Pedoman atau Tindakan

Harga per tanggal

Delta: Menambahkan atau memperbarui tarif per jumlah tamu hanya untuk orang yang ditentukan kombinasi jenis kamar, paket tarif, dan tanggal menginap yang ditentukan di <StatusApplicationControl>.

Pembaruan tarif menggunakan tindakan Delta secara default.
Pembaruan Delta tidak mengubah tarif yang disimpan sebelumnya untuk jumlah tamu. Misalnya, jika Anda telah menentukan tarif untuk satu kali dan kamar berkapasitas dua orang, dan kirimkan pembaruan tarif Delta untuk kamar single jumlah tamu, tarif jumlah tamu dua orang tetap tidak berubah.

Overlay: Menghapus semua tarif per jumlah tamu yang ada untuk jenis kamar tersebut, paket tarif, dan tanggal yang ditentukan di <StatusApplicationControl> lalu ganti dengan tarif baru. Misalnya, jika Anda telah menentukan tarif untuk satu kali dan kamar berkapasitas dua orang, dan Anda mengirimkan pembaruan Overlay untuk jumlah tamu satu orang kamar, Google akan menghapus semua tarif sebelumnya (baik single maupun double jumlah tamu) dan hanya tingkat keterisian satu yang akan tetap ada setelah pembaruan.

Remove: Menghapus semua tarif per jumlah tamu yang ada untuk jenis kamar tersebut, paket tarif, dan tanggal yang ditentukan dalam <StatusApplicationControl>.

Harga berdasarkan LOS

Delta: Menambahkan atau memperbarui tarif per nilai LOS hanya untuk nilai yang ditentukan kombinasi jenis kamar, paket tarif, dan tanggal check-in yang ditentukan di <StatusApplicationControl>. Mengganti semua tarif per jumlah tamu yang terkait dengan nilai LOS yang diperbarui.

Pembaruan tarif menggunakan tindakan Delta secara default.
Pembaruan Delta tidak mengubah tarif yang disimpan sebelumnya untuk dan panjang masa inap. Misalnya, jika Anda telah menentukan tarif untuk LOS 1 dan 2, dan mengirim pembaruan tarif Delta untuk LOS 1, tarif per jumlah tamu LOS 2 tetap tidak berubah.
Pembaruan Delta akan menimpa semua tarif per jumlah tamu yang disimpan sebelumnya untuk panjang masa inap yang ditentukan. Misalnya, jika Anda telah menentukan tarif jumlah tamu dua orang untuk LOS 1, dan kirimkan pembaruan tarif Delta untuk LOS 1 yang hanya memiliki satu jumlah tamu, tarif tersebut akan dihapus.

Overlay: Menghapus semua tarif per jumlah tamu yang ada untuk kamar yang menginap di LOS jenis, paket tarif, dan tanggal check-in yang ditentukan di <StatusApplicationControl> dan menggantinya dengan tarif baru. Misalnya, jika Anda telah menentukan tarif untuk LOS 1 dan 2, dan Anda mengirimkan info terbaru Overlay untuk LOS 1, Google akan menghapus semua tingkat sebelumnya (baik LOS 1 dan 2) dan hanya rasio LOS 1 yang akan tetap setelah update.

Remove: Menghapus semua tarif per jumlah tamu yang ada untuk semua LOS tipe kamar, paket tarif, dan tanggal check-in yang ditentukan di <StatusApplicationControl>.

Terkait pajak

Jika pajak dan biaya sederhana, jumlah total dapat ditentukan menggunakan AmountAfterTax. Pajak kompleks, seperti pajak dan biaya yang berlaku per masa inap (bukan per malam) tidak dapat ditampilkan dalam AmountAfterTax.

Secara umum, Google merekomendasikan penggunaan TaxFeeInfo, bukan AmountAfterTax.

Jika memungkinkan, Anda harus menyertakan AmountBeforeTax (meskipun Anda telah menentukan AmountAfterTax) karena lokalitas tertentu (misalnya, US) menampilkan harga sebelum pajak secara default.

Semua pajak dan biaya yang harus dibayar pengguna (PPN, pajak tetap, biaya pembersihan, kota pajak, dll.) harus disertakan, meskipun tidak dibayar pada saat pemesanan, atau tidak dibayarkan langsung ke properti.

Contoh

Bagian ini memberikan contoh dasar dari pesan Tarif menggunakan wajib dan elemen opsional. Setelah menyiapkan file, Anda harus mengirimkannya ke Google menggunakan pesan POST ke endpoint berikut: https://www.google.com/travel/hotels/uploads/property_data

Untuk mempelajari lebih lanjut cara mengirim/POST pesan, lihat Mengirim 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 elemen <listing> dalam Feed Daftar Hotel. Untuk <PackageID> dan <RoomID>, gunakan ID yang sama dengan yang Anda digunakan di dalam sistem Anda untuk paket tarif dan jenis kamar (masing-masing). {i>Consistency <i}(konsistensi) dengan sistem Anda sangatlah penting untuk memastikan bahwa Google menampilkan harga dan data Anda.

Contoh ini menunjukkan cara menetapkan tarif menggunakan tindakan Delta:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2022-02-25T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <RateAmountMessages HotelCode="HotelID">
    <RateAmountMessage>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID" />
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt NumberOfGuests="1" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="2" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="3" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="4" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
</OTA_HotelRateAmountNotifRQ>

Petunjuk

Bagian ini memberikan solusi untuk skenario yang mungkin Anda hadapi saat mengirim Beri rating pesan.

Untuk contoh cara menambahkan, menghapus, dan memperbarui tarif, lihat Tarif Contoh.

Skenario 1: Cara mengubah harga per jumlah tamu

Deskripsi

Tarif per malam sebelumnya hanya ditetapkan untuk jumlah tamu dua orang (yang juga berlaku untuk jumlah tamu satu orang), tetapi sekarang ada tarif yang lebih murah untuk jumlah tamu satu orang.

Solusi

Kirim tarif jumlah tamu 1 yang baru menggunakan pembaruan cakupan Delta default. Fitur baru ini ini tidak memengaruhi tarif jumlah tamu 2.

Skenario 2: Cara mengganti tarif per jumlah tamu untuk sebuah properti

Deskripsi

Anda sebelumnya menentukan tarif untuk jumlah tamu 1 hingga 4, tetapi sekarang hanya jumlah hunian 1 dan 2 valid.

Solusi

Gunakan NotifType="Overlay" untuk mengganti semua tarif jumlah tamu di properti tertentu, jenis kamar, paket tarif, dan tanggal. Dalam skenario ini, tindakan Overlay akan mencantumkan tarif untuk jumlah tamu 1 dan 2.

Skenario 3: Cara menetapkan tarif yang sama untuk beberapa jumlah tamu

Deskripsi

Tarif untuk jumlah tamu tertentu dapat dijual kepada grup yang berisi lebih sedikit orang. Di sini Anda dapat menyederhanakan pesan dengan hanya mengirimkan pembaruan tarif untuk jumlah tamu maksimum yang berlaku.

Solusi

Jika Anda memiliki harga yang sama untuk beberapa jumlah tamu, tetapkan nilai jumlah tamu tertinggi yang didukung oleh jenis kamar dan paket tarif, dan nilai tersebut akan otomatis digunakan untuk jumlah tamu yang lebih rendah. Artinya, tidak perlu mengulangi hal yang sama tarif per malam untuk jumlah tamu 1-6 jika semuanya sama; setel untuk 6.