Vergi ve Ücret Mesajı

Genel bakış

TaxFeeInfo mesajı, tesis rezervasyonu yapan kullanıcılara uygulanan vergi ve ücretleri tesisin web sitesinde belirtilen vergi düzenlemelerine göre tanımlar. Vergi ve ücret verilerini eklemek için Ücret mesajını (OTA_HotelRateAmountNotifRQ) kullanırsınız.

Not: Ücret mesajında AmountAfterTax belirtilmişse TaxFeeinfo mesaj türü önerilir ve gerekli değildir.

Bu mesaj için desteklenen tek işlem, her tesisin vergi ve ücret verilerini değiştirmek için kullanılan overlay işlemidir. Değişiklik olduğunda vergi ve ücret güncellemelerinin gönderilmesi önemlidir.

Önemli Nokta: Rezervasyon sırasında ödenmese veya doğrudan tesise ödenmese bile kullanıcının ödemesi gereken tüm vergi ve ücretleri (KDV, konaklama vergisi, şehir vergisi vb.) eklemeniz gerekir.

Vergi ve ücret ekleme yöntemleri

Vergi ve ücret eklemenin iki genel yolu vardır: İlk yöntemde Ücret mesajında AmountAfterTax değerini belirtirsiniz; vergileri/ücretleri hem taban gecelik ücretleri (tüm vergiler/ücretler hariç) hem de toplam gecelik ücretleri (tüm vergiler/ücretler dahil) içeren fiyat mesajları göndererek eklersiniz. Bu ücretler gecelik olduğundan bu yaklaşım yalnızca yüzdeye dayalı vergiler/ücretler veya gecelik sabit tutarlar için işe yarar ve konaklama başına vergiler/ücretler kullanılamaz.

İkinci (tercih edilen) yöntem, ücret mesajlarında yalnızca vergi/ücret hariç taban gecelik ücretleri göndermek ve vergileri/ücretleri tesis düzeyinde iletmek için TaxFeeInfo özelliğini kullanmaktır. Vergiler/ücretler, yine belirli oda türleri ve ücret planlarının kapsamına alınabilir ve/veya belirli tarih aralıkları için geçerli olabilir.

Not: Bu sayfada, ücret mesajında (OTA_HotelRateAmountNotifRQ) AmountAfterTax belirtme yöntemi değil, yalnızca tercih edilen TaxFeeInfo kullanma yöntemi açıklanmaktadır.

Vergi ayarlama yöntemleri

Vergileri ayarlamak için aşağıdaki seçenekleri kullanabilirsiniz:

• Temel = [oda|kişi]
• Dönem = [konaklama|gece]
• Tür = [yüzde|tutar]

Dönem stay ve Tür percent olduğunda, seyahat planındaki tek bir tarih StayDates aralığıyla çakışsa bile Google, konaklamanın tamamı için vergi/ücret uygular. Yalnızca seyahat planındaki TÜM tarihler konaklama tarihleri tarih aralığıyla çakışıyorsa vergi/ücret uygulanacağını belirtemezsiniz.

Vergiyle ilgili çeşitli senaryolara dair örnekler için Nasıl yapılır? sayfasına göz atın. Örnekler, aşağıdakilerin nasıl yapılır bilgileri dahil olmak üzere en iyi vergi senaryolarından bazılarını kapsar:

• Vergi yüzdesi
• Mülk başına sabit vergi uygulanır
• Yalnızca ilk geceden sonraki gecelere uygulanan vergi yüzdesi
• Eski vergileri yeni vergilerle değiştirme yöntemi
• Ülkeler için vergileri dahil etme veya hariç tutma
• Kademeli vergiyi köşeli parantezlerle ayarlama
• Vergi ve vergiye tabi ücret belirleyin

Aşağıdaki bölümlerde, vergi bilgilerinizi eklemeye ve güncellemeye başlamanıza yardımcı olacak genel kurallar, temel bir örnek ve nasıl yapılır senaryoları ele alınmaktadır.

Gerekli ve isteğe bağlı öğeler

XML referansı, gerekli ve isteğe bağlı öğelerin açıklamalarını sağlar. Özellikler ve alt öğelerle ilgili ayrıntılar için TaxFeeInfo Öğeler ve Özellikler bölümüne bakın.

Söz dizimi ve şemalar

Doğru biçimi uyguladığınızdan emin olmak için mesajı oluştururken referans olarak TaxFeeInfo Söz Dizimi örneğini kullanın. Google'a göndermeden önce feed'lerinizi yayınlanan şemalarla doğrulamak için xmllint gibi üçüncü taraf bir XML aracı kullanabilirsiniz. TaxFeeinfo mesaj şeması için Otel reklamları şemaları konusuna bakın.

Yönergeler

Bu bölümde, vergi ve ücretlerin belirlenmesiyle ilgili genel kurallar ve özel talimatlar ele alınmaktadır.

İşlemler

Video içi yer paylaşımlı reklamlar

Bir tesise ait tüm vergileri değiştirmek için overlay işlemini kullanın. overlay işlemi varsayılandır ve desteklenen tek işlemdir. Bu tesisin önceki vergi ve ücretleri, güncelleme uygulandıktan sonra düşülecek.

Genel

• Her Tax değerlendirilir ve varsa BaseByGuestAmt öğesinde belirtilen AmountBeforeTax tutarı temel alınarak hesaplanır.

• Geçerli tüm vergiler ve ücretler hesaplandıktan sonra, toplam fiyatı oluşturmak için taban fiyata eklenir.

• <Tax> ve <Fee> için söz dizimi aynıdır.

• Vergilerde/ücretlerde aşağıdakiler gibi kısıtlamalar olabilir:

  • Yalnızca belirli oda türleri ve/veya ücret planları için geçerlidir.
  • Yalnızca belirli konaklama tarihleri için geçerlidir.

  Bu kısıtlamalar isteğe bağlıdır ve her kısıtlama türünü ayarlamanız gerekmez. Tümü için geçerliyse bunları boş bırakabilirsiniz.

• Vergiler veya ücretlerde değişiklik olduğunda TaxFeeInfo güncellemesi gönderin.

Örnek

Bu bölümde, zorunlu ve isteğe bağlı öğelerin kullanıldığı bir TaxFeeInfo mesajının temel bir örneği verilmiştir. Dosyanızı hazırladıktan sonra bu uç noktaya POST mesajıyla Google'a göndermeniz gerekir:

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

Mesajları aktarma/gönderme hakkında daha fazla bilgi edinmek için Mesaj aktarma başlıklı makaleyi inceleyin.

Önemli Bilgi: Vergi ve ücretleriniz her değiştiğinde Google'a güncel bir TaxFeeInfo mesajı gönderin.

hotel_id özelliğinde, tesisi tanımlamak amacıyla sisteminizde kullandığınız benzersiz Otel Kimliği'ni kullanın. Bu değer, Otel Listesi feed'indeki <listing> öğesinde <id> kullanılarak belirtilen Otel Kimliği ile eşleşmelidir. Sisteminizle tutarlılık, Google'ın verilerinizi doğru bir şekilde görüntülemesini sağlamak için çok önemlidir.

Bu örnekte, bir mülk için gecelik değil toplam konaklama için% 10 vergi yüzdesinin ve 50 ABD doları ücret tutarının nasıl ayarlanacağı gösterilmektedir:

<?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>

Yaşla ilgili vergi ekleme örnekleri ve diğer örnekler için Vergi örnekleri bölümüne göz atın.

"Nasıl yapılır" kılavuzları

Bu bölümde, vergi ve ücretleri belirlerken karşılaşabileceğiniz senaryolara yönelik çözümler sunulmaktadır.

1. Senaryo: Sabit vergi nasıl eklenir?

Bu vergi örneğinde, mülk başına nasıl sabit vergi belirleneceği gösterilmektedir.

Açıklama

Tesis başına oda/konaklama için yüzde vergisi yerine sabit bir vergi uygulamak istersiniz.

Çözüm

Sabit vergi seçeneğini eklemek için percentage yerine amount kullanın.

Örnek

Bu örnekte, percentage yerine amount kullanılarak nasıl sabit vergi ekleneceği gösterilmektedir:

<?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>

2. senaryo: ApplicableNights ile vergi hedefleme

Açıklama

Yalnızca ilk geceden sonraki gecelere sabit ücretli vergi uygulamak istiyorsunuz. Örneğin, belirli bir imkanın günlük kullanımı için ilk gece hariç tutulan zorunlu bir ücret alınır. Konukların bu olanaktan yararlanma fırsatı bulamazlar.

Çözüm

Hangi gecelere vergi uygulandığını kontrol etmek için <ApplicableNights excluded="1"/> özelliğini kullanın.

Örnek

Bu örnekte, ApplicableNights özelliğinin nasıl kullanılacağı gösterilmektedir:

<?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>

3. Senaryo: Eski vergi ve ücretler nasıl değiştirilir?

Açıklama

Mevcut vergiler/ücretler değiştirildi ve yenileriyle değiştirilmesi gerekiyor.

Çözüm

Mevcut tüm vergi ve ücretleri kaldırmak için overlay işlemini kullanın.

Not: overlay işlemi, belirtilmemişse varsayılan işlemdir. Bu işlem, her bir tesis için yalnızca tüm vergilerin/ücretlerin değiştirilebileceği anlamına gelir ve yeni vergileri/ücretleri aşamalı olarak ekleyemezsiniz.

Örnek

Aşağıdaki örnekte, bir tesise ait tüm vergilerin/ücretlerin nasıl kaldırılacağı gösterilmektedir:

    <?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>

4. Senaryo: Ülkeler için vergileri dahil etme veya hariç tutma

Açıklama

Belirli ülkeler için vergileri dahil ederken diğer ülkeler için vergileri hariç tutmanız gerekir. Örneğin, AB dışı vergilere sahip daha küçük bir konfederasyonda vergileri hariç tutarken, diğer tüm ülkeler için vergileri hariç tutmanız gerekir.

Çözüm

UserCountries type için include veya exclude seçeneklerini kullanın. Vergiyi yalnızca listelenen ülkeye uygulamak için include kodunu, listelenen ülke dışındaki tüm ülkelerde vergiyi uygulamak için exclude özelliğini kullanın.

Örnek

Aşağıdaki örnekte, otelin bulunduğu ülke (İsrail) dışındaki kullanıcılar için vergilerin nasıl ayarlanacağı gösterilmektedir:

<?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>

5. Senaryo: Kademeli vergileri köşeli parantezlerle ayarlama

Açıklama

Gecelik ücretlere göre uygulanan bir GST toplu vergisi eklemek istiyorsunuz.

Not: Bu senaryoda, bu seçeneği belirlemek için Brackets (örtüşmeyen vergi dilimleri) kullanın.

Çözüm

Bu senaryoda, hedef ülkenin GST vergi dilimlerinin şöyle olduğunu varsayalım:

• Gecelik ücret 1.000 veya daha azsa vergi uygulanmaz.
• Gecelik ücret 1.000'den fazla ve 7.500'den az veya 7.500'e eşitse% 12 vergi uygulanır.
• Gecelik ücret 7.500'den fazlaysa% 18 vergi uygulanır.

Örnek

Aşağıdaki örnekte, parantezli slab vergisinin nasıl ayarlanacağı gösterilmektedir:

<?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>

6. Senaryo: Vergi ve vergiye tabi ücret nasıl ayarlanır?

Açıklama

KDV gibi bir vergi ve söz konusu vergiye tabi olan başka bir hizmet ücreti eklemeniz gerekir.

Çözüm

Bu senaryoda, vergiye tabi ücretlerin iki kullanım alanı örnek olarak verilmiştir:

• Hem vergi hem de vergiye tabi ücret, yüzde olarak ücret olarak tanımlanır.
• Vergi, yüzde olarak alınan ücrettir. Vergiye tabi ücret ise konaklama başına sabit bir tutardır.

Örnekler

Yüzde olarak vergiye tabi ücret

Bu örnekte, 100 ABD doları AmountBeforeTax, %18 GST vergisi ve %5 ek hizmet ödemesi vardır. Bu durumda,

Aşağıdaki snippet'te vergi (GST) ve vergiye tabi ücret (hizmet ücreti) yüzde olarak tanımlanır:

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

Tutar olarak vergiye tabi ücret

Bu örnekte, AmountBeforeTax 100 ABD doları, %18 GST ve %18 oranında GST vardır. Ayrıca, toplam vergiye tabi 23,60 ABD doları (20 ABD doları*1,18 ABD doları) ücret, toplam vergi tutarı 141,60 ABD doları [= 118 ABD doları (%18 GST) + 23,60 ABD doları (20 ABD doları)] sabit ücrettir.

Aşağıdaki snippet'te vergiyi (GST) yüzde olarak, vergiye tabi ücreti (hizmet ücreti) ise sabit ücret tutarı olarak tanımlar:

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