Bu sayfa, Cloud Translation API ile çevrilmiştir.

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, Fiyat mesajında AmountAfterTax değerini belirtirsiniz; hem taban gecelik fiyatları (tüm vergiler ve ücretler hariç) hem de toplam gecelik fiyatları (tüm vergiler ve ücretler dahil) içeren fiyat mesajları göndererek vergileri ve ücretleri eklersiniz. Bu ücretler gecelik olduğundan bu yaklaşım yalnızca yüzdeye dayalı vergiler ve ücretler veya gecelik sabit tutarlar için işe yarar. Konaklama başına vergiler 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, Derecelendirme 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:

Basis = [room|person]
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 konaklamanın tamamı için vergi ve ücret uygular. Vergi ve ücretin yalnızca seyahat planındaki TÜM tarihlerin konaklama tarihleri aralığıyla çakışması durumunda uygulanacağını belirtemezsiniz. Birbiriyle örtüşen birden fazla konaklama tarihi aralığı için StayDates aralıkları tek bir açık aralıkta belirtilir. TaxFeeInfo örneklerine bakın.

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:

Tesis başına uygulanan sabit vergi ve yüzdelik 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
Klasör vergisini parantezlerle ayarlama
Vergi ve vergiye tabi ücreti ayarlama

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.

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 belirlemeyle 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.
Vergilerde 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. Google'ın verilerinizi doğru şekilde göstermesini sağlamak için sisteminizle tutarlı olmanız ç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 ayarlarken karşılaşabileceğiniz senaryolara yönelik çö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 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>

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, parantez içinde bir katmanlı 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>

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 100 ABD doları, GST vergisi %18 ve ek% 5 hizmet ücreti vardır. Bu durumda, vergiye tabi ücret yüzdesi toplam %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'te vergi (GST) ve vergiye tabi ücret (hizmet ücreti) yüzde 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>

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'te vergi (GST) yüzde olarak, vergiye tabi ücret (hizmet ücreti) ise sabit ücret 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

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

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

Açıklama

Çözüm

Örnek

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

Açıklama

Çözüm

Örnek

Senaryo 5: Vergi dilimini parantezlerle ayarlama

Açıklama

Çözüm

Örnek

Senaryo 6: Vergi ve vergiye tabi ücreti ayarlama

Açıklama

Çözüm

Örnekler

Yüzde olarak vergiye tabi ücret

Tutar olarak vergiye tabi ücret

Vergi ve Ücret Mesajı

Senaryo 2: `ApplicableNights` kullanarak vergileri hedefleme