Vergi ve Ücret Mesajı

Genel Bakış

TaxFeeInfo mesajı, kullanıcı tesis rezervasyonu yaparken ve tesisin vergi düzenlemelerine göre web sitesinde ana hatlarıyla belirten Vergi ve ücret verilerini eklemek için Mesajı değerlendirin (OTA_HotelRateAmountNotifRQ).

Bu mesaj için desteklenen tek işlem, değiştirmek için kullanılacak olan overlay işlemidir her tesisin vergi ve ücret verilerini içerir. Vergi ve ücret göndermeniz önemlidir bir güncelleme bildirimi de alırsınız.

Vergi ve ücret ekleme yöntemleri

Vergi ve ücret eklemenin iki genel yolu vardır: İlk yöntemde Ücret mesajında AmountAfterTax değerini belirtin; vergileri/ücretleri ekleyin Her iki taban fiyatı da içeren ücret mesajları (gecelik) göndererek ücretlerin (tüm vergiler/ücretler hariç) ve toplam gecelik ücretlerin (şunun dahil: (tüm vergiler/ücretler). Bu ücretler gecelik olarak oluşturulduğundan, bu yaklaşım yalnızca gecelik ve konaklama başına yüzdeye göre vergiler/ücretler veya sabit tutarlar vergiler veya ücretler kullanılamaz.

İkinci (tercih edilen) yöntem, vergi/ücret hariç tabanları yalnızca gecelik göndermektir bedelleri belirtmeli ve belirli bir fiyat aralığındaki vergileri/ücretleri aktarmak için TaxFeeInfo mülk düzeyinde ayarlayabilirsiniz. Bununla birlikte, her bir vergi veya ücret, belirli bir oda için ayarlanabilir. ve/veya belirli tarih aralıkları için geçerlidir.

Bu sayfada yalnızca tercih edilen TaxFeeInfo geçerlidir (örneğin,AmountAfterTax Mesajı değerlendirin (OTA_HotelRateAmountNotifRQ).

Vergileri ayarlama yöntemleri

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

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

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

Vergiyle ilgili çeşitli senaryo örnekleri için Nasıl yapılır? başlıklı makaleyi inceleyin. Aşağıdakiler için "Nasıl yapılır?" bilgileri de dahil olmak üzere en önemli vergi senaryolarından bazıları örneklerde ele alınmaktadır:

• Yüzdelik vergi
• Tesis başına uygulanan sabit vergi
• Yalnızca ilk geceden sonraki gecelere uygulanan vergi yüzdesi
• Eski vergileri yenileriyle değiştirme yöntemi
• Ülkeler için vergileri dahil etme veya hariç tutma
• Kademeli vergiyi parantez içinde belirleme
• Vergi ve vergiye tabi ücreti belirleyin

Aşağıdaki bölümlerde genel yönergeler, temel bir örnek ve nasıl yapılır? vergi bilgilerinizi ekleyip güncellemenize yardımcı olacak birkaç senaryoya göz atın.

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

XML referansı zorunlu ve isteğe bağlı öğelerin açıklamalarını içerir. Ayrıntılı bilgi özelliklere ve alt öğelere ilişkin TaxFeeInfo Öğe ve Özellikler.

Söz dizimi ve şemalar

TaxFeeInfo söz dizimini kullanın. örnek olarak kullanabilirsiniz. Böylece, gerekir. Şunun gibi bir üçüncü taraf XML aracı kullanabilirsiniz: xmllint'i kullanarak göndermeden önce feed'lerinizi yayınlanan şemalarla doğrulayın Google'a gönderebilirsiniz. TaxFeeinfo mesaj şeması için bkz. Otel reklamları şemaları.

Yönergeler

Bu bölümde, vergi ve ücretler.

İşlemler

Video içi yer paylaşımlı reklamlar

Bir tesisin tüm vergilerini değiştirmek için overlay işlemini kullanın. İlgili içeriği oluşturmak için kullanılan overlay işlemi varsayılan olarak ve desteklenen tek işlemdir. Herhangi biri bu tesisin önceki vergiler ve ücretler bu güncellemeden sonra silinecektir emin olun.

Genel

• Her Tax değerlendirilir ve varsa BaseByGuestAmt olarak belirtilen AmountBeforeTax tutarı için.

• Geçerli tüm vergiler ve ücretler hesaplandıktan sonra toplam fiyatı oluşturun.

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

• Vergiler/ü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 etiket türünü ayarlamanız gerekmez. kısıtlama; Bunları boş bırakabilirsiniz (herkes için geçerliyse).

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

Örnek

Bu bölümde, gerekli kullanımı kullanan TaxFeeInfo mesajıyla ilgili temel bir örnek verilmiştir. ve isteğe bağlı öğeler için de geçerli. Dosyanızı hazırladıktan sonra şu adrese göndermeniz gerekir: Google, bir POST mesajıyla şu uç noktaya:

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

Mesajın nasıl aktarılacağı/yayınlanacağı hakkında daha fazla bilgi edinmek için Mesaj aktarma bölümüne bakın.

hotel_id özelliği için benzersiz Otel Kimliği'ni kullanın sisteminizde mülkü tanımlamak için kullandığınız yöntemdir. Bu değer eşleşmelidir <listing> içinde <id> kullanılarak belirtilen Otel Kimliği öğesini seçebilirsiniz. Sisteminizle tutarlılık, verilerinizi doğru şekilde gösterdiğinden emin olun.

Bu örnekte, bir kampanya için% 10 vergi yüzdesi ve 50 TL ücret tutarının nasıl toplam konaklama süresi için tesis (gecelik değil):

<?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 vergilerin eklenmesine dair örnekler ve diğer örnekler: Vergi örnekleri bölümüne bakın.

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

Bu bölümde, projeyi ayarlarken karşılaşabileceğiniz senaryolara vergi ve ücretler.

1. Senaryo: Sabit vergi ekleme

Bu vergi örneğinde, tesis başına sabit verginin nasıl ayarlanacağı gösterilmektedir.

Açıklama

Bunun yerine, oda/konaklama için tesis başına sabit bir vergi uygulamak istiyorsunuz. yüzdelik vergiden daha düşük.

Çözüm

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

Örnek

Bu örnekte, yerine amount kullanılarak sabit verginin nasıl ekleneceği gösterilmektedir 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>

2. Senaryo: ApplicableNights kullanarak vergileri hedefleme

Açıklama

Yalnızca ilk geceden sonraki gecelere sabit ücretli vergi uygulamak istiyorsunuz. Örneğin, Örneğin, belirli bir imkanın günlük kullanımı için konaklama imkanı bulamadığı ilk geceden, kullanmaya başladı.

Çözüm

Hangi gecelerde vergi alınacağını kontrol etmek için <ApplicableNights excluded="1"/> kullanın geçerlidir.

Ö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: Eskileri yeni vergiler ve ücretlerle değiştirme

Açıklama

Mevcut vergiler/ücretler değişti ve 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 tesisin tüm vergileri veya ücretlerinin 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

Belirli ülkelerde, vergiler hariç tutulduğunda başka bir tane. Örneğin, daha küçük bir konfederasyon için vergileri hariç tutmanız gerekiyor AB dışındaki tüm ülkelerde vergilendirilirken geçerli olacaktır.

Çözüm

UserCountries type için include veya exclude seçeneklerini kullanın. Vergiyi yalnızca listelenen ülkeye uygulamak için include veya exclude kullanın. vergiyi listelenen ülke dışındaki tüm ülkelere uygular.

Örnek

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

<?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: Parantez içinde aşamalı vergi nasıl belirlenir?

Açıklama

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

Çözüm

Bu senaryoda hedef ülkenin GST vergi dilimlerinin şu şekilde olduğunu varsayalım:

• Gecelik ücret 1.000'den az veya 1.000'e eşitse 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, parantez içinde aşamalı 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 ücreti ayarlama

Açıklama

KDV gibi bir vergi ve aynı zamanda başka bir hizmet ücreti de eklemek istiyorsunuz. bu vergi için geçerli değildir.

Çözüm

Bu senaryoda, vergiye tabi ücretlerin iki kullanım örneği ele alınmaktadır:

• Hem vergi hem de vergiye tabi ücret, yüzdelik ücretler olarak tanımlanır.
• Vergi yüzdelik olarak, vergiye tabi ücret ise kalır.

Örnekler

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

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