Halaman ini diterjemahkan oleh Cloud Translation API.

Pesan Tarif

Ringkasan

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

Bagian berikut membahas panduan umum, contoh dasar, dan skenario petunjuk untuk mulai menambahkan dan memperbarui tarif serta mengirim pesan Tarif.

Perilaku tarif yang cocok

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

Prinsip utama

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

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 kurang dari atau sama dengan nilai yang Anda tetapkan.

Contoh: Tarif untuk jenis kamar dan paket tarif sama untuk jumlah tamu satu sampai empat. Gunakan pesan Tarif untuk menetapkan satu tarif bagi jumlah tamu maksimal 4 orang. Pengguna yang menelusuri jumlah tamu satu, dua, dan tiga akan melihat tarif yang sama. Pengguna yang menelusuri angka 5 ke atas tidak akan melihat tarif.

Mengontrol

Tarif yang berbeda untuk jumlah tamu alternatif dapat diberikan secara eksplisit. Kirimkan tarif yang berbeda untuk setiap nilai jumlah tamu jika Anda ingin lebih mengontrol cara Google mencocokkan permintaan dengan tarif jumlah tamu.

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

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

Elemen wajib dan opsional

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

Sintaksis dan skema

Gunakan contoh Sintaksis Tarif sebagai referensi saat membuat pesan Tarif untuk memastikan Anda mengikuti format yang benar.

Anda dapat menggunakan alat XML pihak ketiga seperti xmllint untuk memvalidasi feed dengan skema yang dipublikasikan sebelum mengirimkannya ke Google. Untuk skema pesan Tarif, lihat Skema Iklan Hotel.

Model penetapan harga

Harga per tanggal

Model ini adalah model penetapan harga standar yang digunakan untuk sebagian besar properti. Model harga per-date didasarkan pada penetapan tarif yang dijumlahkan dari seluruh tanggal menginap untuk tiba dengan harga total. Dalam model ini, semua tarif pada elemen Rate diinterpretasikan sebagai berlaku untuk rentang tanggal menginap yang ditentukan dalam <StatusApplicationControl>.

Harga berdasarkan LOS

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

Anda dapat menggunakan model penetapan harga berbasis LOS dengan menetapkan RatePlanType="26" pada elemen StatusApplicationControl. Anda juga harus menetapkan atribut RateTimeUnit dan UnitMultiplier pada elemen Rate dalam XML. Hal ini menyebabkan semua tarif dalam elemen Rate tertentu diterapkan ke tetap yang ditentukan oleh tanggal kedatangan yang ditentukan di <StatusApplicationControl> dan nilai LOS yang ditentukan untuk UnitMultiplier.

Anda dapat menggunakan model penetapan harga per tanggal dan berbasis LOS dalam satu akun, tetapi setiap properti hanya boleh menggunakan satu model penetapan harga. Perhatikan hal-hal berikut saat menerapkan harga berdasarkan LOS:

Tarif untuk lama menginap yang berbeda tidak digabungkan saat menggunakan harga berdasarkan LOS. Misalnya, tarif LOS 3 tidak digabungkan dengan LOS 1 untuk menetapkan harga tarif LOS 4. Rasio LOS 4 harus ditentukan secara eksplisit.
Tarif 1 malam pada harga berbasis LOS tidak digunakan sebagai tarif per malam individual pada harga per tanggal.
Setiap properti hanya boleh menggunakan harga berbasis LOS atau harga per tanggal, tergantung cara tarif ditampilkan di 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 kombinasi jenis kamar, paket tarif, dan tanggal menginap yang ditentukan di <StatusApplicationControl>.

Pembaruan tarif menggunakan tindakan Delta secara default.
Update Delta tidak mengubah tarif yang disimpan sebelumnya untuk jumlah tamu lainnya. Misalnya, jika Anda telah menentukan tarif untuk kamar dengan jumlah tamu satu dan dua orang, serta mengirim pembaruan tarif Delta untuk kamar dengan jumlah tamu satu orang, tarif untuk jumlah tamu dua orang tetap tidak berubah.

Overlay: Menghapus semua tarif per jumlah tamu yang ada untuk jenis kamar, paket tarif, dan tanggal yang ditentukan di <StatusApplicationControl>, lalu menggantinya dengan tarif baru. Misalnya, jika Anda telah menentukan tarif untuk kamar dengan jumlah tamu satu dan dua orang, lalu Anda mengirim pembaruan Overlay untuk kamar dengan jumlah tamu satu orang, Google akan menghapus semua tarif sebelumnya (baik untuk jumlah tamu tunggal maupun ganda), dan hanya tarif untuk jumlah tamu tunggal yang akan tetap ada setelah pembaruan dilakukan.

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

Harga berdasarkan LOS

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

Pembaruan tarif menggunakan tindakan Delta secara default.
Update Delta tidak mengubah tarif yang disimpan sebelumnya untuk lama menginap lainnya. Misalnya, jika Anda telah menentukan tarif untuk LOS 1 dan 2, serta mengirim pembaruan tarif Delta untuk LOS 1, tarif per jumlah tamu LOS 2 tidak akan berubah.
Update Delta akan menimpa semua tarif per tamu yang disimpan sebelumnya untuk lama menginap yang ditentukan. Misalnya, jika Anda telah menentukan tarif jumlah tamu tunggal dan dua untuk LOS 1, dan mengirim pembaruan tarif Delta untuk LOS 1 hanya dengan satu tarif jumlah tamu satu, tarif jumlah tamu dua orang akan dihapus.

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

Remove: Menghapus semua tarif per jumlah tamu yang ada untuk semua LOSS jenis 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 kunjungan (bukan per malam) tidak dapat ditampilkan di AmountAfterTax.

Secara umum, Google merekomendasikan penggunaan TaxFeeInfo, bukan AmountAfterTax.

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

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

Contoh

Bagian ini memberikan contoh dasar pesan Tarif yang menggunakan elemen wajib dan 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/Memposting pesan, lihat Mengirim pesan.

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. Untuk <PackageID> dan <RoomID>, gunakan ID yang sama dengan yang Anda gunakan dalam sistem untuk paket tarif dan jenis kamar. Konsistensi dengan sistem sangat penting untuk memastikan Google menampilkan harga dan data Anda dengan benar.

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 alami saat mengirim Memberi rating pesan.

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

Skenario 1: Cara mengubah harga per jumlah tamu

Deskripsi

Tarif per malam sebelumnya ditentukan hanya 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 baru menggunakan pembaruan cakupan Delta default. Nilai baru ini tidak memengaruhi tarif jumlah tamu 2.

Skenario 2: Cara mengganti tarif per jumlah tamu untuk properti

Deskripsi

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

Solusi

Gunakan NotifType="Overlay" untuk mengganti semua tarif jumlah tamu untuk properti, jenis kamar, paket tarif, dan tanggal tertentu. Dalam skenario ini, tindakan Overlay akan menampilkan 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 ke grup dengan lebih sedikit orang. Dalam skenario ini, 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 menggunakan nilai tersebut untuk jumlah tamu yang lebih rendah. Artinya, tidak perlu mengulangi tarif per malam yang sama untuk jumlah tamu 1-6 jika semuanya sama; cukup tetapkan untuk 6.