Vergi ve Ücret Mesajı

Genel Bakış

TaxFeeInfo mesajı, bir tesis için rezervasyon yapan kullanıcının ödemesi gereken vergileri 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.

Bu mesaj için desteklenen tek işlem, her mülkün 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 ekleme yöntemleri

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

İlk yöntemde, Ücret mesajında AmountAfterTax değerini belirtirsiniz. Vergi ve ücretleri, hem taban gecelik ücretleri (tüm vergiler ve ücretler hariç) hem de toplam gecelik ücretleri (tüm vergi ve ücretler dahil) içeren ücret mesajları göndererek eklersiniz. Bu fiyatlar gecelik olarak oluşturulduğundan, bu yaklaşım yalnızca yüzdeye dayalı vergi ve ücretler ya da gecelik sabit tutarlar için geçerlidir. Konaklama başına vergi ve ücretler kullanılamaz.

İkinci (tercih edilen) yöntem, ücret mesajlarında yalnızca vergi ve ücret hariç taban gecelik ücretleri göndermek ve vergileri ile ücretleri tesis düzeyinde iletmek için TaxFeeInfo özelliğini kullanmaktır. Vergi ve ücretler, belirli tarih aralıkları için geçerli olan belirli oda türleri ve ücret planlarıyla sınırlı olabilir.

Bu sayfada, ücret mesajında (OTA_HotelRateAmountNotifRQ) AmountAfterTax değerini belirtme yöntemi değil, yalnızca TaxFeeInfo değerini kullanmanın tercih edilen yöntemi açıklanmakta ve bu yöntemden bahsedilmektedir.

Vergileri ayarlama yöntemleri

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

  • Temel = [oda|kişi]
  • Dönem = [konaklama|gece]
  • Tür = [percent|amount]

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

Vergiyle ilgili çeşitli senaryo örnekleri için Nasıl yapılır? bölümüne bakın. Örnekler, aşağıdakiler gibi en yaygın vergi senaryolarından bazılarını kapsar:

  • Yüzdelik vergi
  • Tesis başına uygulanan sabit vergi
  • Yüzdelik vergi yalnızca ilk geceden sonraki gecelere uygulanır
  • Eski vergileri yeni vergilerle 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 ayarlama

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

Zorunlu 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 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 xmllint gibi bir üçüncü taraf XML aracı kullanarak yayınlanan şemalarla doğrulayabilirsiniz. TaxFeeinfo mesaj şeması için Otel reklamları şemaları başlıklı makaleyi inceleyin.

Yönergeler

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

İşlemler

Video içi yer paylaşımlı reklamlar
Bir mülkün tüm vergilerini 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 vergi ve ücretler silinir.

Genel

  • Her Tax değerlendirilir ve varsa BaseByGuestAmt içinde belirtilen AmountBeforeTax tutarına göre 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.

  • Vergi ve ücretlerde aşağıdaki gibi kısıtlamalar 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. Hepsi için geçerliyse bunları boş bırakabilirsiniz.

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

Örnek

Bu bölümde, zorunlu ve isteğe bağlı öğeleri kullanan bir TaxFeeInfo mesajına dair temel bir örnek verilmiştir. Dosyanızı hazırladıktan sonra şu uç noktaya bir POST mesajı göndererek Google'a göndermeniz gerekir:

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

Mesajın nasıl gönderileceği/POST edileceği hakkında daha fazla bilgi edinmek için Mesajları gönderme bölümüne bakın.

hotel_id özelliği için tesisi tanımlamak amacıyla 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. Sisteminizle tutarlılık, Google'ın verilerinizi doğru bir şekilde görüntülemesi için çok önemlidir.

Bu örnekte, bir tesis için toplam konaklama (gecelik değil) için %10 vergi yüzdesi 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şa bağlı vergi ekleme örnekleri ve diğer örnekler için Vergi örnekleri bölümüne bakın.

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

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

Senaryo 1: Sabit vergi ekleme

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

Açıklama

Yüzdelik vergi yerine tesis başına oda veya konaklama için sabit bir 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 ücret vergisini yalnızca ilk geceden sonraki gecelere uygulamak istiyorsunuz. Örneğin, konukların ilk gece bu imkanı kullanamayacakları belirli bir imkanı günlük olarak kullanmak için zorunlu bir ücret vardır.

Çözüm

Vergilerin hangi gecelere uygulanacağını kontrol etmek için <ApplicableNights excluded="1"/> simgesini 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>

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

Açıklama

Mevcut vergi ve ü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 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 vergileri dahil etme veya hariç tutma

Açıklama

Belirli ülkeler için vergiyi dahil ederken başka bir ülke için vergiyi hariç tutmanız gerekir. Örneğin, diğer tüm ülkelere vergi uygularken AB dışındaki vergilere sahip küçük bir konfederasyon 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'ü, listelenen ülke hariç tüm ülkelere uygulamak için exclude'ü kullanın.

Örnek

Aşağıdaki örnekte, otelin bulunduğu ülkenin (İ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: Vergi dilimini parantezlerle ayarlama

Açıklama

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

Çözüm

Bu senaryoda, hedef ülkenin GST vergi dilimleri şöyle olsun:

  • 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, parantezlerle bir basamak 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>

Senaryo 6: Vergi ve vergiye tabi ücreti ayarlama

Açıklama

KDV gibi bir vergi ve bu vergiye de uygulanan başka bir hizmet ücreti eklemek istiyorsunuz.

Çözüm

Bu senaryoda, vergiye tabi ücretlerin iki örnek kullanım alanı ele alınmıştır:

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

Örnekler

Yüzde olarak vergiye tabi ücret

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

Aşağıdaki snippet, vergiyi (GST) ve vergiye tabi ücreti (hizmet ücreti) yüzde 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>percent</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>5.9</Amount>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

Tutar olarak vergiye tabi ücret

Bu örnekte AmountBeforeTax değeri 100 TL, GST vergisi %18 ve ek ücret 20 TL'dir. Bu durumda, vergiye tabi toplam ücret 23,60 TL ("20*1,18") ve toplam ücret 141,60 TL ("118 (%18 GST) + 23,60 (20 sabit ücret)") olur.

Aşağıdaki snippet, vergiyi (GST) yüzde olarak ve vergilendirilebilir ücreti (hizmet ücreti) sabit bir 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>