Halaman ini diterjemahkan oleh Cloud Translation API.

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).

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.

Untuk mengetahui informasi selengkapnya tentang cara mengirimkan pajak dan biaya, serta detail harga spesifik untuk tarif Anda, lihat Kebijakan Pajak dan Biaya.

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 per malam dasar (tidak termasuk semua pajak dan biaya) dan tarif per malam total (termasuk semua pajak dan biaya). Karena tarif ini adalah tarif per malam, pendekatan ini hanya berfungsi untuk pajak dan biaya berbasis persentase atau jumlah tetap per malam, dan pajak serta biaya per menginap tidak dapat digunakan.

Metode kedua (yang lebih disarankan) adalah hanya mengirimkan tarif dasar harian yang tidak termasuk pajak dan biaya dalam pesan tarif, serta menggunakan TaxFeeInfo untuk menyampaikan pajak dan biaya di tingkat properti. Pajak dan biaya individual masih dapat dicakup ke jenis kamar dan paket tarif tertentu, yang berlaku untuk rentang tanggal tertentu.

Halaman ini hanya menjelaskan dan merujuk pada metode pilihan untuk menggunakan TaxFeeInfo, bukan metode untuk menentukan AmountAfterTax dalam pesan Tarif (OTA_HotelRateAmountNotifRQ).

Metode untuk menetapkan pajak

Anda memiliki opsi berikut untuk menyetel pajak:

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

Jika Periode adalah stay dan Jenis adalah percent, Google 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 dalam itinerari tumpang-tindih dengan rentang tanggal menginap. Untuk beberapa rentang tanggal menginap yang tumpang-tindih satu sama lain, rentang StayDates ditentukan dalam satu rentang terbuka. Lihat contoh TaxFeeInfo.

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

Pajak tetap dan pajak persentase 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
Menetapkan pajak slab dengan rentang
Menetapkan pajak dan biaya yang dikenai pajak

Bagian berikut mencakup panduan umum, contoh dasar, dan skenario cara memulai penambahan dan pembaruan informasi pajak Anda.

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 Anda 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 pedoman 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. Pajak dan biaya sebelumnya untuk properti ini akan dihapus setelah update ini diterapkan.

Umum

Setiap Tax dievaluasi dan, jika berlaku, dihitung berdasarkan jumlah AmountBeforeTax yang ditentukan dalam BaseByGuestAmt.
Setelah semua pajak dan biaya yang berlaku dihitung, pajak dan biaya tersebut ditambahkan ke harga dasar untuk membentuk total harga.
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 harus menetapkan setiap jenis batasan; Anda dapat mengosongkannya jika berlaku untuk semua.
Kirim update 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/MEMPOSTING pesan, lihat Mengirim pesan.

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 Anda sangat penting untuk memastikan Google menampilkan data Anda dengan benar.

Contoh ini menunjukkan cara menetapkan persentase pajak 10% dan jumlah biaya $50 untuk properti selama total masa menginap (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>

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

Petunjuk

Bagian ini memberikan solusi untuk skenario yang mungkin Anda alami saat menyetel 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 menginap 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 fasilitas tertentu yang dikecualikan dari malam pertama, di mana tamu tidak akan memiliki kesempatan untuk menggunakan fasilitas tertentu tersebut.

Solusi

Gunakan <ApplicableNights excluded="1"/> untuk mengontrol malam saat pajak diterapkan.

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 yang baru.

Solusi

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

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 perlu 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 untuk 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 negara 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 rentang

Deskripsi

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

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.
Dikenai pajak sebesar 18% jika tarif per malam lebih besar dari 7.500.

Contoh

Contoh berikut menunjukkan cara menetapkan pajak slab dengan rentang:

<?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 kena pajak ditentukan sebagai biaya persentase.
Pajak adalah biaya persentase, sedangkan biaya kena pajak adalah jumlah tetap per masa inap.

Contoh

Biaya kena pajak sebagai persentase

Contoh ini memiliki AmountBeforeTax sebesar $100, pajak GST sebesar 18%, dan biaya layanan tambahan sebesar 5%, sehingga total persentase biaya kena pajak adalah 5,9% (5*1,18), dan total jumlah tarif adalah $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 (GST 18%) + $23,60 (tarif tetap $20)].

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>

Pesan Pajak dan Biaya Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Ringkasan

Metode untuk menambahkan pajak dan biaya

Metode untuk menetapkan pajak

Elemen wajib dan opsional

Sintaksis dan skema

Panduan

Tindakan

Umum

Contoh

Petunjuk

Skenario 1: Cara menambahkan pajak tetap

Deskripsi

Solusi

Contoh

Skenario 2: Cara menargetkan pajak menggunakan ApplicableNights

Deskripsi

Solusi

Contoh

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

Deskripsi

Solusi

Contoh

Skenario 4: Cara menyertakan atau mengecualikan pajak untuk negara

Deskripsi

Solusi

Contoh

Skenario 5: Cara menetapkan pajak slab dengan rentang

Deskripsi

Solusi

Contoh

Skenario 6: Cara menetapkan pajak dan biaya kena pajak

Deskripsi

Solusi

Contoh

Biaya kena pajak sebagai persentase

Biaya kena pajak sebagai jumlah

Pesan Pajak dan Biaya

Skenario 2: Cara menargetkan pajak menggunakan `ApplicableNights`