Vergi ve Ücret Mesajı

Genel Bakış

TaxFeeInfo mesajı, bir tesisin rezervasyonu sırasında kullanıcıya uygulanan ve web sitesinde belirtilen tesisin vergi düzenlemelerine dayalı vergi ve ücretleri tanımlar. Vergi ve ücret verilerini eklemek için Rate mesajını (OTA_HotelRateAmountNotifRQ) kullanırsınız.

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üncellemelerini göndermeniz önemlidir.

Vergi ve ücret gönderme yöntemleri ile oranlarınızla ilgili fiyatlandırma ayrıntıları hakkında daha fazla bilgi için Vergiler ve Ücretler Politikası'na bakın.

Vergi ve ücret ekleme yöntemleri

Vergi ve ücret eklemenin iki genel yolu vardır:

İlk yöntemde, Rate mesajında AmountAfterTax değerini belirtirsiniz. Taban gecelik fiyatları (tüm vergi ve ücretler hariç) ve toplam gecelik fiyatları (tüm vergi ve ücretler dahil) içeren fiyat mesajları göndererek vergi ve ücretleri eklersiniz. Bu ücretler gecelik olduğundan bu yaklaşım yalnızca gecelik olan ve yüzdeye dayalı vergiler ve ücretler için geçerlidir. Konaklama başına vergiler ve ücretler kullanılamaz.

İkinci (tercih edilen) yöntem ise ücret mesajlarında yalnızca vergi ve ücret hariç taban gecelik ücretleri göndermek ve tesis düzeyinde vergi ve ücretleri iletmek için TaxFeeInfo kullanmaktır. Ayrı ayrı vergiler ve ücretler, belirli tarih aralıklarında geçerli olan belirli oda türleri ve ücret planlarıyla sınırlandırılabilir.

Bu sayfada yalnızca TaxFeeInfo kullanmanın tercih edilen yöntemi açıklanmakta ve bu yönteme atıfta bulunulmaktadır. Bu sayfada, AmountAfterTax değerinin derecelendirme mesajında (OTA_HotelRateAmountNotifRQ) belirtilme yöntemi açıklanmamaktadır.

Vergi belirleme yöntemleri

Vergileri ayarlamak için aşağıdaki seçeneklerden yararlanabilirsiniz:

Basis = [room|person]
Dönem = [stay|night]
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 ve ücret uygular. Vergi ve ücretin yalnızca seyahat planındaki TÜM tarihler konaklama tarihleri aralığıyla çakışıyorsa uygulanacağını belirleyemezsiniz. Birbiriyle çakışan birden fazla konaklama tarihi aralığı için StayDates aralıkları tek bir açık aralıkta belirtilir. TaxFeeInfo örneklerine bakın.

Çeşitli vergiyle ilgili senaryo örnekleri için Nasıl yapılır? bölümüne bakın. Örnekler, aşağıdakilerle ilgili talimatlar da dahil olmak üzere en önemli vergi senaryolarından bazılarını kapsar:

Tesis başına uygulanan sabit vergi ve yüzde vergi
Yüzde cinsinden vergi yalnızca ilk geceden sonraki geceler için uygulanır
Eski vergileri yenileriyle değiştirme yöntemi
Ülkeler için vergileri dahil etme veya hariç tutma
Dilimler halinde vergi belirleme
Vergi ve vergiye tabi ücret belirleme

Aşağıdaki bölümlerde, vergi bilgilerinizi ekleme ve güncelleme konusunda size yardımcı olacak genel yönergeler, temel bir örnek ve nasıl yapılır senaryoları yer almaktadır.

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

XML referansı, zorunlu ve isteğe bağlı öğelerin açıklamalarını içerir. Ö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 kullandığınızdan emin olmak için mesajı oluştururken TaxFeeInfo Söz Dizimi örneğini referans olarak kullanın. Feed'lerinizi Google'a göndermeden önce yayınlanan şemalarla doğrulamak için xmllint gibi bir üçüncü taraf XML aracı kullanabilirsiniz. TaxFeeinfo mesaj şeması için Otel reklamları şemaları konusuna bakın.

Yönergeler

Bu bölümde, vergileri ve ücretleri ayarlamayla ilgili genel kurallar ve özel talimatlar yer almaktadır.

İşlemler

Video içi yer paylaşımlı reklamlar: Bir mülkle ilgili tüm vergileri değiştirmek için overlay işlemini kullanın. overlay işlemi varsayılan ve desteklenen tek işlemdir. Bu güncelleme uygulandıktan sonra bu tesisle ilgili önceki tüm vergi ve ücretler temizlenir.

Genel

Her Tax değerlendirilir ve geçerliyse BaseByGuestAmt içinde belirtilen AmountBeforeTax tutarına göre hesaplanır.
Geçerli tüm vergi 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.
Vergiler ve ücretler aşağıdaki gibi kısıtlamalara tabi olabilir:
- Yalnızca belirli oda türleri ve ü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 tür kısıtlamayı ayarlamanız gerekmez. Tümü için geçerliyse bu alanları boş bırakabilirsiniz.
Vergilerde veya ücretlerde değişiklik olduğunda TaxFeeInfo güncellemesi gönderin.

Örnek

Bu bölümde, zorunlu ve isteğe bağlı öğeler kullanılarak oluşturulan TaxFeeInfo mesajına dair temel bir örnek verilmektedir. Dosyanızı hazırladıktan sonra, bu uç noktaya bir POST mesajı göndererek Google'a göndermeniz gerekir:

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

Mesajı nasıl aktaracağınız/POST edeceğiniz hakkında daha fazla bilgi edinmek için Mesaj aktarma başlıklı makaleyi inceleyin.

hotel_id özelliği için, tesisin tanımlanmasında sisteminizde kullandığınız benzersiz otel kimliğini kullanın. Bu değer, Otel Listesi feed'indeki <listing> öğesinde <id> kullanılarak belirtilen otel kimliğiyle eşleşmelidir. Google'ın verilerinizi doğru şekilde göstermesini sağlamak için sisteminizle tutarlılık çok önemlidir.

Bu örnekte, bir tesis için toplam konaklama süresince (gecelik değil) %10 vergi oranı ve 50 ABD doları ücret tutarı 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 vergileri ekleme ve diğer örnekler için Vergi örnekleri konusuna bakın.

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

Bu bölümde, vergi ve ücretleri ayarlarken karşılaşabileceğiniz senaryolarla ilgili çözümler sunulmaktadır.

Senaryo 1: Sabit vergi ekleme

Bu vergi örneğinde, tesis başına sabit vergi belirleme yöntemi gösterilmektedir.

Açıklama

Oda veya konaklama için yüzde vergi yerine tesis başına sabit vergi uygulamak istiyorsanız.

Çözüm

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

Örnek

Bu örnekte, percentage yerine amount kullanılarak sabit verginin nasıl 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>

Senaryo 2: `ApplicableNights` kullanarak vergileri hedefleme

Açıklama

Sabit ücretli vergiyi yalnızca ilk geceden sonraki gecelere uygulamak istiyorsunuz. Örneğin, konukların ilk gece kullanamayacağı belirli bir olanağın günlük kullanımı için zorunlu bir ücret alınabilir.

Çözüm

Hangi gecelerde vergi uygulanacağını kontrol etmek için <ApplicableNights excluded="1"/> simgesini kullanın.

Örnek

Bu örnekte ApplicableNights işlevinin 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 ücretleri yenileriyle değiştirme

Açıklama

Mevcut vergi ve ücretler değiştiği için yenileriyle değiştirilmesi gerekiyor.

Çözüm

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

Örnek

Aşağıdaki örnekte, bir tesise ait tüm vergi ve ü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 vergiler nasıl dahil edilir veya hariç tutulur?

Açıklama

Bazı ülkelerde vergiyi dahil etmeniz, diğerlerinde ise hariç tutmanız gerekir. Örneğin, AB dışı vergilerin uygulandığı daha küçük bir konfederasyon için vergileri hariç tutmanız, diğer tüm ülkelerde ise vergi uygulamanız gerekir.

Çözüm

UserCountries type için include veya exclude seçeneklerini kullanın. Vergiyi yalnızca listelenen ülkeye uygulamak için include, listelenen ülke hariç tüm ülkelere uygulamak için exclude simgesini 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>

Senaryo 5: Dilimler halinde vergi nasıl ayarlanır?

Açıklama

Gecelik ücretlere göre uygulanan bir kademeli KDV vergisi eklemek istiyorsunuz.

Çözüm

Bu senaryoda, hedef ülkenin GST vergi dilimlerinin aşağıdaki gibi olduğunu varsayalım:

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

Örnek

Aşağıdaki örnekte, dilimler halinde verginin 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 bu vergiye de uygulanan başka bir hizmet ücreti eklemek istiyorsunuz.

Çözüm

Bu senaryoda, vergilendirilebilir ücretlerin iki örnek kullanım alanı ele alınmaktadır:

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

Örnekler

Yüzde olarak vergiye tabi ücret

Bu örnekte AmountBeforeTax 100 ABD doları, GST vergisi %18 ve ek% 5 hizmet ücreti uygulanmaktadır. Bu durumda, toplam vergilendirilebilir ücret yüzdesi %5,9 (5*1,18) ve toplam oran tutarı 123,90 ABD doları [= 118 ABD doları (%18 GST) + 5,9 ABD doları (%5,9 hizmet ücreti)] olur.

Aşağıdaki snippet'te vergi (GST) ve vergilendirilebilir ücret (hizmet ücreti) yüzdeler olarak tanımlanmaktadı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>

Vergiye tabi ücret tutarı

Bu örnekte AmountBeforeTax 100 ABD doları, GST vergisi %18 ve ek 20 ABD doları sabit ücret vardır. Bu durumda, vergiye tabi toplam ücret 23,60 ABD doları (20 ABD doları*1,18) ve toplam ücret tutarı 141,60 ABD doları [= 118 ABD doları (%18 GST) + 23,60 ABD doları (20 ABD doları sabit ücret)] olur.

Aşağıdaki snippet'te vergi (GST) yüzde olarak, vergilendirilebilir ücret (hizmet ücreti) ise sabit oranlı bir tutar olarak tanımlanmaktadı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>amount</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>23.6</Amount>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

Vergi ve Ücret Mesajı Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Genel Bakış

Vergi ve ücret ekleme yöntemleri

Vergi belirleme yöntemleri

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

Söz dizimi ve şemalar

Yönergeler

İşlemler

Genel

Örnek

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

Senaryo 1: Sabit vergi ekleme

Açıklama

Çözüm

Örnek

Senaryo 2: ApplicableNights kullanarak vergileri hedefleme

Açıklama

Çözüm

Örnek

3. senaryo: Eski vergi ve ücretleri yenileriyle değiştirme

Açıklama

Çözüm

Örnek

4. senaryo: Ülkeler için vergiler nasıl dahil edilir veya hariç tutulur?

Açıklama

Çözüm

Örnek

Senaryo 5: Dilimler halinde vergi nasıl ayarlanır?

Açıklama

Çözüm

Örnek

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

Açıklama

Çözüm

Örnekler

Yüzde olarak vergiye tabi ücret

Vergiye tabi ücret tutarı

Vergi ve Ücret Mesajı

Senaryo 2: `ApplicableNights` kullanarak vergileri hedefleme