VergiÜcretiBilgisi

İstekler

Söz dizimi

TaxFeeInfo mesajında şu söz dizimi kullanılır:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="timestamp"
            id="message_ID"
            partner="partner_key">
  <Property action="[overlay]">
    <ID>HotelID</ID>
    <Taxes>
      <Tax>
        <RoomTypes>
          <RoomType id="RoomID_1"/>
          <RoomType id="RoomID_2"/>
        </RoomTypes>
        <RatePlans>
          <RatePlan id="PackageID_1"/>
          <RatePlan id="PackageID_2"/>
        </RatePlans>
        <BookingDates>
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </BookingDates>
        <CheckinDates>
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </CheckinDates>
        <CheckoutDates>
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </CheckoutDates>
        <StayDates application="[all|any|overlap]">
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </StayDates>
        <Type>[percent|amount|cumulative_percent]</Type>
        <Basis>[room|person]</Basis>
        <Period>[stay|night]</Period>
        <Currency>currency_code</Currency>
        <Amount>tax_amount</Amount>
        <ApplicableNights max="integer" excluded="integer"/>
        <LengthOfStay min="integer" max="integer"/>
        <!-- Use either <Amount> or <Brackets> -->
        <Brackets base_amount="tax_amount"/>
          <Bracket starts_at="nightly_rate" amount="tax_amount"/>
        </Brackets>
        <AgeBrackets>
          <AdultCharge amount="tax_amount"/>
          <ChildAgeBrackets>
            <ChildAgeBracket max_age="max_age" amount="tax_amount"/>
          </ChildAgeBrackets>
        </AgeBrackets>
        <UserCountries type="[include|exclude]">
          <Country code="country_code1"/>
          <Country code="country_code2"/>
        </UserCountries>
        <!--"exclusive" parameter is optional -->
        <Rank exclusive="[true|false]">integer</Rank>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <RoomTypes>
          <RoomType id="RoomID_1"/>
          <RoomType id="RoomID_2"/>
        </RoomTypes>
        <RatePlans>
          <RatePlan id="PackageID_1"/>
          <RatePlan id="PackageID_2"/>
        </RatePlans>
        <BookingDates>
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </BookingDates>
        <CheckinDates>
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </CheckinDates>
        <CheckoutDates>
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </CheckoutDates>
        <StayDates application="[all|any|overlap]">
          <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/>
        </StayDates>
        <Type>[percent|amount|cumulative_percent]</Type>
        <Basis>[room|person]</Basis>
        <Period>[stay|night]</Period>
        <Currency>currency_code</Currency>
        <Amount>fee_amount</Amount>
        <ApplicableNights max="integer" excluded="integer"/>
        <LengthOfStay min="integer" max="integer"/>
        <!-- Use either <Amount> or <Brackets> -->
        <Brackets base_amount="tax_amount"/>
          <Bracket starts_at="nightly_rate" amount="tax_amount"/>
        </Brackets>
        <AgeBrackets>
          <AdultCharge amount="tax_amount"/>
          <ChildAgeBrackets>
            <ChildAgeBracket max_age="max_age" amount="tax_amount"/>
          </ChildAgeBrackets>
        </AgeBrackets>
        <UserCountries type="[include|exclude]">
          <Country code="country_code1"/>
          <Country code="country_code2"/>
        </UserCountries>
        <!--"exclusive" parameter is optional -->
        <Rank exclusive="[true|false]">integer</Rank>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

Öğeler ve özellikler

TaxFeeInfo mesajında aşağıdaki öğeler ve özellikler bulunur:

Öğe / @Özellik Yineleme sayısı Tür Açıklama
TaxFeeInfo 1 Complex element Tek bir tesise ait vergileri ve ücretleri tanımlayan mesajın kök öğesidir.
TaxFeeInfo / @timestamp 1 DateTime Bu mesajın oluşturulma tarihi ve saatidir.
TaxFeeInfo / @id 1 string Bu istek mesajının benzersiz tanımlayıcısıdır. Bu değer, yanıt mesajında döndürülür. İzin verilen karakterler a-z, A-Z, 0-9, _ (alt çizgi) ve - (kısa çizgi) şeklindedir.
TaxFeeInfo / @partner 1 string Bu mesajın iş ortağı hesabı. Bu dize değeri, Hotel Center'ın Hesap ayarları sayfasında listelenen "İş ortağı anahtarı" değeridir.

Not: Birden fazla hesap için feed sağlayan bir arka ucunuz varsa bu değerin aynı hesap genelinde <OTA_HotelRateAmountNotifRQ> ve <OTA_HotelAvailNotifRQ> mesajlarınızın <RequestorID> öğesinde belirtilen ID özellik değeriyle eşleşmesi gerekir.
TaxFeeInfo / Property 1..n Property Tek bir tesise ait vergilerin ve ücretlerin tanımlandığı kapsayıcıdır.
TaxFeeInfo / Property / @action 0..1 string Güncellemenin nasıl uygulanacağını belirtir. Yalnızca overlay desteklenir ve varsayılan değer overlay'dır. Bu güncelleme uygulanmadan önce bu mülkle ilgili önceki Taxes ve Fees temizlenir.
TaxFeeInfo / Property / ID 1 string Tesisin benzersiz tanımlayıcısı. Bu değer, Otel Listesi Feed'indeki <listing> öğesinde <id> kullanılarak belirtilen otel kimliğiyle eşleşmelidir. Otel kimliği, Hotel Center'da da listelenir.
TaxFeeInfo / Property / Taxes 0..1 Taxes Bir veya daha fazla <Tax> öğesinin kapsayıcısıdır.
TaxFeeInfo / Property / Taxes / Tax 1..n Tax Tesis için geçerli olan ayrı bir vergidir.
TaxFeeInfo / Property / Taxes / Tax / RoomTypes 0..1 RoomTypes Verginin geçerli olduğu oda türleri listesinin kapsayıcısıdır. Vergi, belirtilen her bir <RoomType> için geçerlidir. <RoomTypes> belirtilmezse vergi tüm odalar için geçerli olur.
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType 1..n RoomType Oda türünü belirtir. Oda türü, Transaction (Tesis Verileri) mesajında bulunan ve RoomID'si kullanılarak tanımlanan <RoomData> öğesinde belirtilir. (<RoomID> değeri, OTA_HotelRateAmountNotifRQ mesajlarındaki InvTypeCode özelliği tarafından da belirtilir.)
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType / @id 1 string Envanterin benzersiz tanımlayıcısıdır (oda türü). Bu değer, Transaction (Tesis Verileri) mesajlarındaki <RoomID> ile eşlenir. İzin verilen maksimum karakter sayısı 50'dir.
TaxFeeInfo / Property / Taxes / Tax / RatePlans 0..1 RatePlans Verginin uygulandığı ücret planları listesinin kapsayıcısıdır. <RatePlans> belirtilmezse vergi tüm ücret planları için geçerlidir.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan 1..n RatePlan Ücret planını belirtir. Ücret planı; Transaction (Tesis Verileri), OA_HotelRateAmountNotifRQ ve OTA_HotelAvailNotifRQ mesajlarında belirtilen ve PackageID tarafından tanımlanan paket, ücret ve stok durumunun birleşimiyle tanımlanır.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan / @id 1 string Ücret planının benzersiz tanımlayıcısıdır. Bu değer, Transaction (Tesis Verileri) mesajının <PackageData> öğesindeki PackageID değeriyle ve hem <OTA_HotelRateAmountNotifRQ> hem de <OTA_HotelAvailNotifRQ> mesajlarında <StatusApplicationControl> özelliği altında ayarlanan RatePlanCode değeriyle eşlenir. İzin verilen maksimum karakter sayısı 50'dir.
TaxFeeInfo / Property / Taxes / Tax / BookingDates 0..1 BookingDates Verginin uygulanabilmesi için rezervasyonun ne zaman gerçekleşmesi gerektiğini tanımlayan bir veya daha fazla tarih aralığının kapsayıcısıdır.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange 1..99 DateRange Verginin uygulanması için rezervasyonun ne zaman gerçekleşmesi gerektiğini belirten tarih aralığıdır.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @start 0..1 Date Tarih aralığının (girilen tarihler dahil) başlangıç tarihidir (tesisin bulunduğu saat dilimine göre). Bu tarih, end tarihinden önce veya ilgili tarihle aynı olmalıdır. start belirtilmezse tarih aralığı, başlangıç tarihi açısından etkin bir şekilde sınırlandırılmaz.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @end 0..1 Date Tarih aralığının (girilen tarihler dahil) bitiş tarihidir (tesisin bulunduğu saat dilimine göre). Bu tarih, start tarihiyle aynı veya ilgili tarihten sonra olmalıdır. end belirtilmezse tarih aralığı, bitiş tarihi açısından etkin bir şekilde sınırlandırılmaz.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @days_of_week 0..1 string

Tarih aralığında izin verilen günlerdir. Belirtilmezse tarih aralığında tüm günlere izin verilir. Dizedeki her karakter bir gün belirtir. Örneğin "MTWHF", tarih aralığında hafta içindeki günlere izin verildiğini belirtir.

Geçerli karakterler şunlardır:

  • Pazartesi için M
  • Salı için T
  • Çarşamba için W
  • Perşembe için H
  • Cuma için F
  • Cumartesi için S
  • Pazar için U

Herhangi bir karakter kombinasyonu geçerlidir.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates 0..1 CheckinDates Verginin uygulanabilmesi için check-in işleminin ne zaman yapılması gerektiğini tanımlayan bir veya daha fazla tarih aralığının kapsayıcısıdır.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange 1..20 DateRange Verginin uygulanabilmesi için check-in işleminin ne zaman yapılması gerektiğini belirten tarih aralığıdır.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @start 0..1 Date Tarih aralığının (girilen tarihler dahil) başlangıç tarihidir (tesisin bulunduğu saat dilimine göre). Bu tarih, end tarihinden önce veya ilgili tarihle aynı olmalıdır. start belirtilmezse tarih aralığı, başlangıç tarihi açısından etkin bir şekilde sınırlandırılmaz.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @end 0..1 Date Tarih aralığının (girilen tarihler dahil) bitiş tarihidir (tesisin bulunduğu saat dilimine göre). Bu tarih, start tarihiyle aynı veya ilgili tarihten sonra olmalıdır. end belirtilmezse tarih aralığı, bitiş tarihi açısından etkin bir şekilde sınırlandırılmaz.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @days_of_week 0..1 string

Tarih aralığında izin verilen günlerdir. Belirtilmezse tarih aralığında tüm günlere izin verilir. Dizedeki her karakter bir gün belirtir. Örneğin "MTWHF", tarih aralığında hafta içindeki günlere izin verildiğini belirtir.

Geçerli karakterler şunlardır:

  • Pazartesi için M
  • Salı için T
  • Çarşamba için W
  • Perşembe için H
  • Cuma için F
  • Cumartesi için S
  • Pazar için U

Herhangi bir karakter kombinasyonu geçerlidir.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates 0..1 CheckoutDates Verginin uygulanabilmesi için ne zaman çıkış yapılması gerektiğini tanımlayan bir veya daha fazla tarih aralığının kapsayıcısıdır.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange 1..20 DateRange Verginin uygulanabilmesi için ne zaman çıkış yapılması gerektiğini belirten tarih aralığıdır.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @start 0..1 Date Tarih aralığının (girilen tarihler dahil) başlangıç tarihidir (tesisin bulunduğu saat dilimine göre). Bu tarih, end tarihinden önce veya ilgili tarihle aynı olmalıdır. start belirtilmezse tarih aralığı, başlangıç tarihi açısından etkin bir şekilde sınırlandırılmaz.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @end 0..1 Date Tarih aralığının (girilen tarihler dahil) bitiş tarihidir (tesisin bulunduğu saat dilimine göre). Bu tarih, start tarihiyle aynı veya ilgili tarihten sonra olmalıdır. end belirtilmezse tarih aralığı, bitiş tarihi açısından etkin bir şekilde sınırlandırılmaz.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @days_of_week 0..1 string

Tarih aralığında izin verilen günlerdir. Belirtilmezse tarih aralığında tüm günlere izin verilir. Dizedeki her karakter bir gün belirtir. Örneğin "MTWHF", tarih aralığında hafta içindeki günlere izin verildiğini belirtir.

Geçerli karakterler şunlardır:

  • Pazartesi için M
  • Salı için T
  • Çarşamba için W
  • Perşembe için H
  • Cuma için F
  • Cumartesi için S
  • Pazar için U

Herhangi bir karakter kombinasyonu geçerlidir.
TaxFeeInfo / Property / Taxes / Tax / StayDates 0..1 StayDates

Sezonluk indirimlerin karşılanması gibi amaçlarla verginin uygulanıp uygulanmayacağını belirleyen bir veya daha fazla tarih aralığının kapsayıcısıdır.
TaxFeeInfo / Property / Taxes / Tax / StayDates / @application 1 enum

Verginin nasıl uygulanması gerektiğini açıklar.

Geçerli değerler şunlardır:

  • all: Seyahat planındaki tüm tarihler konaklama tarihleriyle çakışıyorsa vergiyi seyahat planındaki her geceye uygular.
  • any: Seyahat planındaki herhangi bir tarih, konaklama tarihleri aralığındaki bir tarihle çakışıyorsa vergiyi seyahat planındaki tüm gecelere uygular.
  • overlap: Vergi yalnızca konaklama tarihleri aralığındaki bir tarihle çakışan seyahat planındaki gecelere uygulanır.

    Not: overlap yalnızca <Period> night olarak ayarlandığında geçerli olur.

Bu özellik her zaman belirtilmelidir.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange 1..99 DateRange Verginin uygulanacağı tarihleri belirten tarih aralığıdır.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @start 0..1 Date Tarih aralığının (girilen tarihler dahil) başlangıç tarihidir (tesisin bulunduğu saat dilimine göre). Bu tarih, end tarihinden önce veya ilgili tarihle aynı olmalıdır. start belirtilmezse tarih aralığı, başlangıç tarihi açısından etkin bir şekilde sınırlandırılmaz.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @end 0..1 Date Tarih aralığının (girilen tarihler dahil) bitiş tarihidir (tesisin bulunduğu saat dilimine göre). Bu tarih, start tarihiyle aynı veya ilgili tarihten sonra olmalıdır. end belirtilmezse tarih aralığı, bitiş tarihi açısından etkin bir şekilde sınırlandırılmaz.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @days_of_week 0..1 string

Tarih aralığında izin verilen günlerdir. Belirtilmezse tarih aralığında tüm günlere izin verilir. Dizedeki her karakter bir gün belirtir. Örneğin "MTWHF", tarih aralığında hafta içindeki günlere izin verildiğini belirtir.

Geçerli karakterler şunlardır:

  • Pazartesi için M
  • Salı için T
  • Çarşamba için W
  • Perşembe için H
  • Cuma için F
  • Cumartesi için S
  • Pazar için U

Herhangi bir karakter kombinasyonu geçerlidir.
TaxFeeInfo / Property / Taxes / Tax / Type 1 enum

Geçerli değerler şunlardır:

  • percent: Toplam oranın yüzdesi
  • amount: Son orana eklenecek sabit tutar
  • cumulative_percent: Bu vergi veya ücretin hesaplanmasından önce biriken toplam oran, vergi ve ücretlerin yüzdesi. Bu değer belirtilirse <Rank> da belirtilmelidir.

    • <Brackets> ve <AgeBrackets>, cumulative_percent türüyle birlikte belirtilemez.
TaxFeeInfo / Property / Taxes / Tax / Basis 1 enum

Geçerli değerler şunlardır:

  • room: <Amount>, odaya uygulanır.
  • person: <Amount>, kişi başına uygulanır. Bu değer yalnızca <Type> öğesi "amount" (tutar) olarak ayarlanmışsa geçerlidir.
TaxFeeInfo / Property / Taxes / Tax / Period 1 enum

Geçerli değerler şunlardır:

  • stay: <Amount>, konaklamanın toplam oranına eklenir.
  • night: <Amount> konaklama gecesi başına eklenir.
TaxFeeInfo / Property / Taxes / Tax / Currency 0..1 string Verginin üç harfli para birimi kodu (örneğin, USD).

Not: <Currency> belirtilmemiş ancak <Amount> belirtilmişse <Currency> değeri varsayılan olarak temel oran para birimi olur.

TaxFeeInfo / Property / Taxes / Tax / Amount 0..1 float Vergi yüzdesi veya tutarının değeridir.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights 0..1 ApplicableNights Bu değer yalnızca <Type> amount (tutar) ve <Period> night (gece) olarak ayarlanmışsa geçerli olur.

Bir verginin uygulanabileceği gece sayısını sınırlar.

max ve excluded ikilisinden birini belirtin; ikisini birden belirtmeyin.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @max 0..1 integer <ApplicableNights max="N">, ilk N geceden sonraki gecelerin hariç tutulması gerektiğini gösterir.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @excluded 0..1 integer <ApplicableNights excluded="N">, ilk N gecenin hariç tutulması gerektiğini gösterir.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay 0..1 LengthOfStay Bu verginin uygulanabileceği konaklama süresi sınırlarını belirler. Konaklama süresi minimum ve maksimum sınırların dışında olduğunda vergi uygulanmaz.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay / @min 0..1 integer Verginin uygulanabilmesi için konaklama süresinde izin verilen minimum gece sayısıdır. Belirtilmezse minimum değer yoktur.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay / @max 0..1 integer Verginin uygulanabilmesi için konaklama süresinde izin verilen maksimum gece sayısıdır. Belirtilmezse maksimum değer yoktur.
TaxFeeInfo / Property / Taxes / Tax / Brackets 0..1 Brackets Bir veya daha fazla <Bracket> öğesinin kapsayıcısıdır. Bitişik olmayan ve örtüşmeyen vergi dilimlerini tanımlar. Örneğin: Hindistan'daki kademeli KDV vergileri.

Bu öğe yalnızca <Period>, night olarak ayarlanmışsa ve <Amount> belirtilmemişse geçerlidir.
TaxFeeInfo / Property / Taxes / Tax / Brackets / @base_amount 0..1 float İlk dilimin starts_at değerinin altındaki gece fiyatlarına uygulanan vergi yüzdesi veya tutarının değeri.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket 1..n Bracket Gecelik ücretlere göre bir vergi dilimi tanımlar.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @starts_at 1 float

Bir vergi diliminin alt sınırını tanımlar. Üst sınır, sonraki dilimin starts_at alanında belirtilir. Son dilimin üst sınırı yoktur.

Vergi dilimi, gecelik ücret dilimin starts_at değerine eşit veya daha yüksek olduğunda ve sonraki dilimin starts_at değerinden daha az olduğunda etkin olur.

Bu değer 0'dan büyük olmalıdır.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @amount 1 float Bu vergi dilimine uygulanan vergi yüzdesi veya tutarının değeridir.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets 0..1 AgeBrackets Konaklayanların yaşına göre bir dizi vergi belirtilmesine olanak tanır.

Bu öğe yalnızca <Brackets> ve <Amount> belirtilmediğinde, <Basis> person olarak ayarlandığında ve <Type> amount olarak ayarlandığında geçerlidir.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge 0..1 AdultCharge Yetişkinler için vergileri belirtmeye yarayan kapsayıcı.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge / @amount 1 float Yetişkinler için uygulanan sabit vergi tutarı.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets 0..1 ChildAgeBrackets Bir veya daha fazla <ChildAgeBracket> öğesini tutmak için kullanılan kapsayıcıdır.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket 1..n ChildAgeBracket Çocuklar için bir yaş aralığı ve ilgili vergi tutarını tanımlar.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @max_age 1 integer

Çocuğun yaşı için üst sınırı tanımlar. Alt sınır, önceki dilimin max_age alanında belirtilen değer + 1'dir. Üst ve alt sınırlar dahildir. İlk dilimin alt sınırı 0'dır.

max_age, 0 ile 17 (bu sayılar dahil) arasında olmalıdır.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @amount 1 float Bu yaş aralığındaki çocuklara uygulanan sabit vergi tutarıdır.
TaxFeeInfo / Property / Taxes / Tax / UserCountries 0..1 UserCountries Verginin dahil edildiği veya hariç tutulduğu kullanıcı ülkelerini listeleyen kapsayıcıdır. Vergi varsa yalnızca belirtilen ülkelerdeki kullanıcılar için dahil edilir veya hariç tutulur.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / @type 0..1 enum UserCountries spesifikasyonunun türü.

Geçerli değerler include ve exclude'dir.

UserCountries type include olarak ayarlanırsa vergi yalnızca listelenen ülkelerdeki kullanıcılar için geçerli olur.

UserCountries type exclude ise vergi yalnızca listelenen ülkeler dışındaki kullanıcılar için geçerli olur.

UserCountries type ayarlanmamışsa include olarak kabul edilir ve vergi yalnızca listelenen ülkelerdeki kullanıcılar için geçerli olur.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country 1..n Country UserCountries listesinde bir ülkeyi tanımlar.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country / @code 1 string CLDR ülke kodu (ör. DE veya FR). Bazı ülkelerde CLDR ülke kodunun 2 harfli ISO ülke koduyla aynı olmadığını unutmayın. Ayrıca CLDR bölge kodları desteklenmez.
TaxFeeInfo / Property / Taxes / Tax / Rank 1 integer

Vergi veya ücretin uygulanma sırasını belirten bir sıralama. Örneğin, 2 değeri, verginin ikinci olarak uygulandığı anlamına gelir. <Type>, cumulative_percent olarak ayarlanmışsa bu öğe her zaman belirtilmelidir. Genel olarak bu sıralama hem vergiler hem de ücretler için geçerlidir.

<Rank>2</Rank>

Vergi ve ücretler arasında yinelenen sıralama değerlerine izin verilir ancak bu durum, vergi ve ücretlerin rastgele ve kümülatif bir şekilde uygulandığı tanımlanmamış davranışlara neden olabilir.

Alternatif olarak, aynı sıralamadaki tüm vergi ve ücretlerin fiyata uygulandığını belirtmek için <Rank> içinde "exclusive" parametresini kullanın. Varsayılan değer false'dır ve aynı sıralamaya sahip tüm vergi ve ücretler, orana rastgele bir şekilde uygulanır. "exclusive" isteğe bağlıdır.

exclusive parametresi true olarak ayarlanmışsa or içindeki ilk vergi veya <Tax> içindeki ilk ücret orana uygulanır.<Fee> 

<Rank exclusive="true">1</Rank>

Vergiler, ücretlerden önce uygulanır. Bu nedenle, bir vergi ve ücret aynı sıralamaya sahipse ve ücret için "exclusive", true olarak ayarlanmışsa vergi yine de önce uygulanır. En iyi uygulama, vergilerin ve ücretlerin uygulanması gereken sırayla listelenmesidir.

Aynı sıradaki tüm vergi ve ücretleri dahil etmek için exclusive değerini true olarak ayarlamayın.

Sıralaması olmayan vergiler ve ücretler, sıralanmış tüm girişlerden önce uygulanır.

<Rank>, 1 ile 99 arasında (bu değerler dahil) olmalıdır.

TaxFeeInfo / Property / Fees 0..1 Fees Bir veya daha fazla <Fee> öğesinin kapsayıcısıdır.
TaxFeeInfo / Property / Fees / Fee 1..n Fee

Tesis için geçerli olan ayrı bir ücrettir.

Tüm <Tax> alt öğeleri, aynı söz dizimiyle <Fee> için de desteklenir.

Örnekler

Tesis başına 300 vergi ve ücret sınırı vardır. Bir mülkten vergileri ve ücretleri kaldırmak için "Vergileri silme" örneğine bakın.

Temel mesaj

Temel bir TaxFeeInfo mesajı:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2024-05-18T16: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>10.00</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>amount</Type>
        <Basis>person</Basis>
        <Period>night</Period>
        <Currency>USD</Currency>
        <Amount>5.00</Amount>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

Vergileri silme

Belirtilen otelin tesis düzeyindeki vergi ve ücretlerinin hepsi silinir:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2024-06-16T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property action="overlay"/>
    <ID>Property_1</ID>
  </Property>
</TaxFeeInfo>

Kademeli vergi

Gecelik ücretlere göre uygulanan, Hindistan'daki kademeli KDV vergisidir. Vergi dilimleri şunlardır:

  • 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.
<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2024-05-18T16: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>

Yaşa göre vergiler

Vergiler, konaklayanların yaşına göre uygulanır:

  • Yetişkinler için 20 ABD doları vergi.
  • 11-17 yaş arası çocuklar için 10 ABD doları vergi alınır.
  • 0-10 yaş arası çocuklar için 5 ABD doları vergi alınır.
<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2024-05-18T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>amount</Type>
        <Basis>person</Basis>
        <Period>night</Period>
        <AgeBrackets>
          <AdultCharge amount="20"/>
          <ChildAgeBrackets>
            <ChildAgeBracket max_age="10" amount="5"/>
            <ChildAgeBracket max_age="17" amount="10"/>
          </ChildAgeBrackets>
        </AgeBrackets>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

Çakışan konaklama tarihleri aralıkları

Birbiriyle çakışan birden fazla konaklama tarihi aralığı tanımlandığında, belirtilen konaklama tarihinin bu aralıkların yalnızca birini karşılaması yeterlidir. Konaklama tarih aralıkları tek bir başlangıç ve bitiş aralığında belirtilmelidir.

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2025-03-12T10:59:49+01:00"
            id="12345678"
            partner="partner_key">
  <Property action="overlay">
    <ID>987654</ID>
      <Taxes>
        <Tax>
          <Type>amount</Type>
          <Basis>person</Basis>
          <Period>night</Period>
          <RoomTypes>
            <RoomType id="RoomID_1"/>
            <RoomType id="RoomID_2"/>
          </RoomTypes>
          <StayDates application="any">
            <DateRange start="2025-06-16"/>
          </StayDates>
          <Currency>USD</Currency>
          <Amount>50</Amount>
        </Tax>
      </Taxes>
      <Fees>
        <Fee>
          <Type>amount</Type>
          <Basis>room</Basis>
          <Period>stay</Period>
          <StayDates application="any">
            <DateRange start="2025-03-12" end="2025-03-18"/>
          </StayDates>
          <Currency>USD</Currency>
          <Amount>200</Amount>
        </Fee>
        <Fee>
          <Type>amount</Type>
          <Basis>room</Basis>
          <Period>stay</Period>
          <StayDates application="any">
            <DateRange start="2025-03-19"/>
          </StayDates>
          <Currency>USD</Currency>
          <Amount>300</Amount>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

Ayrıcalıklı sıralamaya sahip birden fazla vergi ve ücret

Aşağıda, exclusive="true" ile birden fazla vergi ve ücretin yer aldığı ve farklı sıralara sahip bir örnek verilmiştir. Ücrete uygulanması gereken aşağıdaki vergi ve ücretleri göz önünde bulundurun:

  • 1. sırada exclusive="true" olan% 5'lik bir konaklama vergisi.
  • 1. sıradaki 10 ABD doları tutarında oda servisi vergisi.
  • 2. derece exclusive="true" için 50 ABD doları tutarında temizlik ücreti.
  • 3. sırada yer alan tesisler için% 2 oranında tesis ücreti.

Vergilerin ve ücretlerin <Rank>'ya göre uygulanma sırası şöyledir:

  1. exclusive="true" ile 1. sıradaki konaklama vergisi önce uygulanır.
  2. Önceki konaklama vergisi hariç tutulduğu için 1. sıradaki oda servisi vergisi uygulanmaz.
  3. exclusive="true" ve 2. sıradaki temizlik ücreti uygulanır.
  4. 3. sıradaki hizmet ücreti, 2. sıradaki temizlik ücretinden sonra uygulanır.

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2024-02-29T12:00:00Z"
            id="tax-fee-id"
            partner="partner_key">
  <Property action="overlay">
    <ID>765432</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Amount>5</Amount>
        <Period>stay</Period>
        <Basis>room</Basis>
        <Rank exclusive="true">1</Rank>
      </Tax>
      <Tax>
        <Type>amount</Type>
        <Amount>10</Amount>
        <Period>night</Period>
        <Basis>room</Basis>
        <Currency>USD</Currency>
        <Rank>1</Rank>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>amount</Type>
        <Amount>50</Amount>
        <Period>night</Period>
        <Basis>room</Basis>
        <Currency>USD</Currency>
        <Rank exclusive="true">2</Rank>
      </Fee>
      <Fee>
        <Type>percent</Type>
        <Amount>2</Amount>
        <Period>stay</Period>
        <Basis>room</Basis>
        <Rank>3</Rank>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

Yanıtlar

Söz dizimi

TaxFeeInfoResponse mesajında şu söz dizimi kullanılır:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfoResponse timestamp="timestamp"
                    id="message_ID"
                    partner="partner_key">
  <!-- Either Success or Issues will be populated. -->
  <Success/>
  <Issues>
    <Issue code="issue_code" status="issue_type">issue_description</Issue>
  </Issues>
</TaxFeeInfoResponse>

Öğeler ve özellikler

TaxFeeInfoResponse mesajında aşağıdaki öğeler ve özellikler bulunur:

Öğe / @Özellik Yineleme sayısı Tür Açıklama
TaxFeeInfoResponse 1 Complex element Alınan TaxFeeInfo istek mesajının başarısını veya sorunlarını gösteren kök öğedir.
TaxFeeInfoResponse / @timestamp 1 DateTime Bu mesajın oluşturulma tarihi ve saatidir.
TaxFeeInfoResponse / @id 1 string İlişkilendirilmiş TaxFeeInfo mesajındaki benzersiz tanımlayıcıdır.
TaxFeeInfoResponse / @partner 1 string Bu mesajın iş ortağı hesabı.
TaxFeeInfoResponse / Success 0..1 Success TaxFeeInfo mesajının uyarı, hata veya sorun olmadan başarıyla işlendiğini belirtir.

Her mesajda <Success> veya <Issues> bulunur.
TaxFeeInfoResponse / Issues 0..1 Issues TaxFeeInfo mesajı işlenirken karşılaşılan bir veya daha fazla sorun için kullanılan bir kapsayıcıdır.

Her mesajda <Success> veya <Issues> bulunur.
TaxFeeInfoResponse / Issues / Issue 1..n Issue TaxFeeInfo mesajı işlenirken karşılaşılan uyarı, hata veya sorunun açıklamasıdır. Bu sorunlarla ilgili ayrıntılar Feed Durumu Hata Mesajları konusunda bulunabilir.
TaxFeeInfoResponse / Issues / Issue / @code 1 integer Sorunun tanımlayıcısıdır.
TaxFeeInfoResponse / Issues / Issue / @status 1 enum

Karşılaşılan sorunun türü.

Geçerli değerler warning, error ve failure şeklindedir .

Örnekler

Başarılı

Aşağıda, başarıyla işlenmiş bir TaxFeeInfo mesajına yanıt yer almaktadır.

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfoResponse timestamp="2024-05-18T16:20:00-04:00"
                    id="12345678"
                    partner="partner_key">
  <Success/>
</TaxFeeInfoResponse>

Sorunlar

Aşağıda, hatalar nedeniyle işlenmemiş bir TaxFeeInfo mesajına yanıt yer almaktadır.

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfoResponse timestamp="2024-05-18T16:20:00-04:00"
                    id="12345678"
                    partner="partner_key">
  <Issues>
    <Issue code="1001" status="error">Example</Issue>
  </Issues>
</TaxFeeInfoResponse>