Pesan Pajak dan Biaya

Ringkasan

Pesan TaxFeeInfo menentukan pajak dan biaya yang berlaku untuk pengguna saat memesan properti dan berdasarkan peraturan pajak properti yang diuraikan di situs. Untuk menambahkan data pajak dan biaya, Anda menggunakan pesan Tarif (OTA_HotelRateAmountNotifRQ).

Catatan: Jenis pesan TaxFeeinfo direkomendasikan, dan tidak diperlukan jika AmountAfterTax ditentukan di pesan Tarif.

Satu-satunya tindakan yang didukung untuk pesan ini adalah overlay yang digunakan untuk mengganti data pajak dan biaya untuk setiap properti. Anda harus mengirimkan pembaruan pajak dan biaya setiap kali ada perubahan.

Poin Penting: Anda harus menyertakan semua pajak dan biaya yang harus dibayar pengguna (PPN, pajak menginap, pajak kota, dll.), meskipun tidak dibayar pada waktu pemesanan, atau tidak dibayar langsung ke properti.

Metode untuk menambahkan pajak dan biaya

Ada dua cara umum untuk menambahkan pajak dan biaya:

Pada metode pertama, Anda menentukan AmountAfterTax dalam pesan Tarif; Anda menambahkan pajak dan biaya dengan mengirimkan pesan tarif yang berisi tarif dasar per malam (tidak termasuk semua pajak dan biaya) dan total tarif per malam (termasuk semua pajak dan biaya). Karena tarif ini per malam, pendekatan ini hanya berfungsi untuk pajak dan biaya berbasis persentase atau jumlah tetap yang per malam, dan pajak dan biaya per masa inap tidak dapat digunakan.

Metode kedua (lebih disukai) adalah hanya mengirim tarif dasar per malam eksklusif pajak dan biaya dalam pesan tarif, dan menggunakan TaxFeeInfo untuk menyampaikan pajak dan biaya di tingkat properti. Masing-masing pajak dan biaya masih dapat dicakup untuk jenis kamar dan paket tarif tertentu, yang berlaku untuk rentang tanggal tertentu.

Poin Penting: Ada batas 300 pajak dan biaya per properti. Anda dapat menggunakan pesan TaxFeeInfo untuk menghapus pajak dan biaya dari properti.

Halaman ini menjelaskan dan hanya merujuk pada metode yang lebih disukai untuk menggunakan TaxFeeInfo, bukan metode untuk menentukan AmountAfterTax dalam pesan Rating (OTA_HotelRateAmountNotifRQ).

Metode untuk menetapkan pajak

Anda memiliki opsi berikut untuk menetapkan pajak:

• Basis = [room|person]
• Periode = [stay|night]
• Jenis = [percent|amount]

Jika Periode adalah stay dan Jenis adalah percent, Google akan menerapkan pajak dan biaya untuk seluruh masa inap meskipun satu tanggal dalam itinerari tumpang-tindih dengan rentang StayDates. Anda tidak dapat menentukan penerapan pajak dan biaya hanya jika SEMUA tanggal di itinerari tumpang-tindih dengan rentang tanggal tanggal menginap.

Untuk mengetahui contoh berbagai skenario terkait pajak, lihat Petunjuk. Contoh ini mencakup beberapa skenario pajak teratas, termasuk Cara untuk:

• Persentase pajak
• Pajak tetap yang diterapkan per properti
• Pajak persentase hanya berlaku untuk malam setelah malam pertama
• Metode untuk mengganti pajak lama dengan pajak baru
• Menyertakan atau mengecualikan pajak untuk negara
• Tetapkan pajak slab dengan tanda kurung
• Menetapkan pajak dan biaya kena pajak

Bagian berikut mencakup panduan umum, contoh dasar, dan skenario petunjuk untuk membantu Anda mulai menambahkan dan memperbarui informasi pajak.

Elemen wajib dan opsional

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

Sintaksis dan skema

Gunakan contoh Sintaksis TaxFeeInfo sebagai referensi saat membuat pesan 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 TaxFeeinfo, lihat skema iklan Hotel.

Panduan

Bagian ini membahas panduan umum dan petunjuk khusus untuk menetapkan pajak dan biaya.

Tindakan

Overlay

Gunakan tindakan overlay untuk mengganti semua pajak untuk properti. Tindakan overlay adalah tindakan default dan satu-satunya tindakan yang didukung. Semua pajak dan biaya sebelumnya untuk properti ini akan dihapus setelah pembaruan ini diterapkan.

Umum

• Setiap Tax dievaluasi dan, jika berlaku, dihitung berdasarkan jumlah AmountBeforeTax yang ditentukan di BaseByGuestAmt.

• Setelah semua pajak dan biaya yang berlaku dihitung, pajak dan biaya tersebut ditambahkan ke harga dasar untuk membentuk harga total.

• Sintaksis untuk <Tax> dan <Fee> sama.

• Pajak dan biaya dapat memiliki batasan, seperti:

  • Hanya berlaku untuk jenis kamar dan paket tarif tertentu.
  • Hanya berlaku untuk tanggal menginap tertentu.

  Batasan ini bersifat opsional dan Anda tidak perlu menetapkan setiap jenis batasan; Anda dapat mengosongkannya jika berlaku untuk semua.

• Kirim pembaruan TaxFeeInfo setiap kali ada perubahan pada pajak atau biaya.

Contoh

Bagian ini memberikan contoh dasar pesan TaxFeeInfo menggunakan elemen wajib dan opsional. Setelah menyiapkan file, Anda harus mengirimkannya ke Google menggunakan pesan POST ke endpoint ini:

https://www.google.com/travel/hotels/uploads/taxes

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

Poin Penting: Kirim pesan TaxFeeInfo yang diperbarui ke Google setiap kali pajak dan biaya Anda berubah.

Untuk atribut hotel_id, 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 sangat penting untuk memastikan bahwa Google menampilkan data Anda dengan benar.

Contoh ini menunjukkan cara menetapkan persentase pajak 10% dan jumlah biaya $50 untuk properti untuk total masa inap (bukan per malam):

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-20T16:20:00-04:00"
            partner="partner_key"
            id="12345678">
  <Property>
    <ID>HOTELID</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>10</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>50</Amount>
        <Currency>USD</Currency>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

Catatan: Jika <Currency> tidak ditentukan, tetapi <Amount> ditentukan, nilai <Currency> akan ditetapkan secara default ke mata uang tarif dasar.

Untuk contoh penambahan pajak terkait usia dan contoh lainnya, lihat Contoh pajak.

Petunjuk

Bagian ini memberikan solusi untuk skenario yang mungkin Anda alami saat menetapkan pajak dan biaya.

Skenario 1: Cara menambahkan pajak tetap

Contoh pajak ini menunjukkan cara menetapkan pajak tetap per properti.

Deskripsi

Anda ingin menerapkan pajak tetap untuk kamar atau masa inap per properti, bukan pajak persentase.

Solusi

Gunakan amount, bukan percentage, untuk menambahkan opsi pajak tetap.

Contoh

Contoh ini menunjukkan cara menambahkan pajak tetap menggunakan amount, bukan percentage:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>30</Amount>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

Skenario 2: Cara menargetkan pajak menggunakan ApplicableNights

Deskripsi

Anda ingin menerapkan pajak biaya tetap hanya untuk malam setelah malam pertama. Misalnya, ada biaya wajib untuk penggunaan harian atas fasilitas tertentu yang dikecualikan sejak malam pertama, saat tamu tidak akan memiliki kesempatan untuk menggunakan fasilitas tersebut.

Solusi

Gunakan <ApplicableNights excluded="1"/> untuk mengontrol malam mana yang dikenai pajak.

Contoh

Contoh ini menunjukkan cara menggunakan ApplicableNights:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>night</Period>
        <Amount>50</Amount>
        <ApplicableNights excluded="1"/>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

Skenario 3: Cara mengganti pajak dan biaya lama dengan yang baru

Deskripsi

Pajak dan biaya saat ini telah berubah dan perlu diganti dengan pajak dan biaya baru.

Solusi

Gunakan tindakan overlay untuk menghapus semua pajak dan biaya yang ada.

Catatan: Tindakan overlay adalah tindakan default jika tidak ditentukan, yang berarti Anda hanya dapat mengganti semua pajak dan biaya untuk setiap properti dan Anda tidak dapat menambahkan pajak/biaya baru secara bertahap.

Contoh

Contoh berikut menunjukkan cara menghapus semua pajak dan biaya untuk suatu properti:

    <?xml version="1.0" encoding="UTF-8"?>
    <TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
                id="12345678"
                partner="partner_key">
      <Property action="overlay">
        <ID>Property_1</ID>
      </Property>
    </TaxFeeInfo>

Skenario 4: Cara menyertakan atau mengecualikan pajak untuk negara

Deskripsi

Anda harus menyertakan pajak untuk negara tertentu sekaligus mengecualikan pajak dari negara lain. Misalnya, Anda perlu mengecualikan pajak untuk konfederasi yang lebih kecil dengan pajak non-Uni Eropa sekaligus mengenakan pajak pada semua negara lainnya.

Solusi

Gunakan opsi include atau exclude untuk UserCountries type. Gunakan include untuk menerapkan pajak hanya ke negara yang tercantum atau gunakan exclude untuk menerapkan pajak ke semua negara kecuali yang tercantum.

Contoh

Contoh berikut menunjukkan cara menetapkan pajak untuk pengguna di luar negara hotel (Israel):

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>night</Period>
        <UserCountries type="exclude">
          <Country code="IL"/>
        </UserCountries>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

Skenario 5: Cara menetapkan pajak slab dengan tanda kurung

Deskripsi

Anda ingin menambahkan pajak slab GST yang diterapkan berdasarkan tarif per malam.

Catatan: Untuk skenario ini, gunakan Brackets (kumpulan tanda kurung pajak yang tidak tumpang-tindih) untuk menetapkan opsi ini.

Solusi

Untuk skenario ini, misalkan rentang pajak GST negara target adalah:

• Tidak ada pajak jika tarif per malam kurang dari atau sama dengan 1.000.
• Dikenai pajak sebesar 12% jika tarif per malam lebih besar dari 1.000 dan kurang dari atau sama dengan 7.500.
• Pajak sebesar 18% jika tarif per malam lebih besar dari 7.500.

Contoh

Contoh berikut menunjukkan cara menetapkan pajak slab dengan tanda kurung:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-28T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>night</Period>
        <Brackets base_amount="0">
          <Bracket starts_at="1000.01" amount="12"/>
          <Bracket starts_at="7500.01" amount="18"/>
        </Brackets>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

Skenario 6: Cara menetapkan pajak dan biaya kena pajak

Deskripsi

Anda ingin menambahkan pajak seperti PPN, dan biaya layanan lain yang juga berlaku untuk pajak tersebut.

Solusi

Skenario ini mempertimbangkan dua contoh kasus penggunaan biaya kena pajak:

• Pajak dan biaya yang dapat dikenakan pajak ditentukan sebagai tagihan persentase.
• Pajak berupa persentase, sedangkan biaya kena pajak adalah jumlah tetap per kunjungan.

Contoh

Biaya kena pajak dalam persen

Contoh ini memiliki AmountBeforeTax sebesar $100, pajak GST sebesar 18%, dan biaya layanan tambahan sebesar 5% sehingga total persentase biaya kena pajak sebesar 5,9% (5*1,18), dan jumlah total tarif sebesar $123,90 [= $118 (GST 18%) + $5,9 (biaya layanan 5,9%)].

Cuplikan berikut menentukan pajak (GST) dan biaya kena pajak (biaya layanan) sebagai persentase:

<TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
  id="12345678"
  partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>18</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>5.9</Amount>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

Biaya kena pajak sebagai jumlah

Contoh ini memiliki AmountBeforeTax sebesar $100, pajak GST sebesar 18%, dan biaya tarif tetap tambahan sebesar $20, sehingga total biaya kena pajak sebesar $23,60 ($20*1,18), dan total jumlah tarif sebesar $141,60 [= $118 (18% GST) + $23,60 ($20 tarif tetap)].

Cuplikan berikut menentukan pajak (GST) dalam persentase dan biaya kena pajak (biaya layanan) sebagai jumlah tarif tetap:

<TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
  id="12345678"
  partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>18</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>23.6</Amount>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>