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>
        <Rank>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>
        <Rank>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 bir 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ıdır. 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 vergi ve ücretleri tanımlayan kapsayıcıdır.
TaxFeeInfo / Property / @action 0..1 string Güncellemenin nasıl uygulandığını belirtir. Yalnızca overlay desteklenir. Varsayılan değer overlay'tır. Bu güncelleme uygulanmadan önce bu mülke ait önceki Taxes ve Fees temizlenir.
TaxFeeInfo / Property / ID 1 string Tesisin benzersiz tanımlayıcısıdır. Bu değer, Otel Listesi Feed'indeki <listing> öğesinde <id> kullanılarak belirtilen Otel Kimliği ile 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ğerine, OTA_HotelRateAmountNotifRQ mesajlarındaki InvTypeCode özelliği tarafından da referans verilir.)
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), OTA_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> öğesinde bulunan PackageID değeriyle ve hem <OTA_HotelRateAmountNotifRQ> hem de <OTA_HotelAvailNotifRQ> mesajlarının <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ırsızdır.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @end 0..1 Date Tarih aralığının (tesisin bulunduğu saat dilimine göre) bitiş tarihidir. Bu tarih, start tarihiyle aynı veya bu tarihten sonra olmalıdır. end belirtilmezse tarih aralığı, bitiş tarihi açısından etkin bir şekilde sınırsızdır.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @days_of_week 0..1 string

Tarih aralığında izin verilen günleri ifade eder. 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 ne zaman check-in 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ırsızdır.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @end 0..1 Date Tarih aralığının (tesisin bulunduğu saat dilimine göre) bitiş tarihidir. Bu tarih, start tarihiyle aynı veya bu tarihten sonra olmalıdır. end belirtilmezse tarih aralığı, bitiş tarihi açısından etkin bir şekilde sınırsızdır.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @days_of_week 0..1 string

Tarih aralığında izin verilen günleri ifade eder. 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 (tesisin bulunduğu saat dilimine göre) başlangıç tarihidir. 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ırsızdır.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @end 0..1 Date Tarih aralığının (tesisin bulunduğu saat dilimine göre) bitiş tarihidir. Bu tarih, start tarihiyle aynı veya bu tarihten sonra olmalıdır. end belirtilmezse tarih aralığı, bitiş tarihi açısından etkin bir şekilde sınırsızdır.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @days_of_week 0..1 string

Tarih aralığında izin verilen günleri ifade eder. 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

Karakter kombinasyonları 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: Vergiyi yalnızca konaklama tarihleri aralığındaki bir tarihle çakışan seyahat planındaki gecelere uygular.

    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 bu tarihle aynı olmalıdır. start belirtilmezse tarih aralığı, başlangıç tarihi açısından etkin bir şekilde sınırsızdır.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @end 0..1 Date Tarih aralığının (tesisin bulunduğu saat dilimine göre) bitiş tarihidir. Bu tarih, start tarihiyle aynı veya bu tarihten sonra olmalıdır. end belirtilmezse tarih aralığı, bitiş tarihi açısından etkin bir şekilde sınırsızdır.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @days_of_week 0..1 string

Tarih aralığında izin verilen günleri ifade eder. 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

Karakter kombinasyonları 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 toplanan toplam ücretin, vergilerin ve ücretlerin yüzdesidir. Bu değer belirtilirse <Rank> da belirtilmelidir.

    • <Brackets> ve <AgeBrackets>, tür olarak cumulative_percent ile 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>, tutar olarak ayarlanmışsa geçerlidir.
TaxFeeInfo / Property / Taxes / Tax / Period 1 enum

Geçerli değerler şunlardır:

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

Not: <Currency> belirtilmez ancak <Amount> belirtilirse <Currency> değeri varsayılan olarak taban ücret 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çerlidir.

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 belirtir.
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 ve örtüşmeyen vergi parantezleri kümesini tanımlar. Örneğin: Hindistan'daki kademeli KDV vergisi.

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 Kiracıların yaşına göre bir dizi vergi belirtmenize olanak tanır.

Bu öğe yalnızca <Brackets> ve <Amount> belirtilmemişse, <Basis> person olarak ayarlanmışsa ve <Type> amount olarak ayarlanmışsa geçerlidir.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge 0..1 AdultCharge Yetişkinler için vergileri belirten kapsayıcı.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge / @amount 1 float Yetişkinler için uygulanan sabit vergi tutarıdır.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets 0..1 ChildAgeBrackets Bir veya daha fazla <ChildAgeBracket> öğesini barındıran kapsayıcıdır.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket 1..n ChildAgeBracket Çocuklar için bir yaş aralığı ve buna karşılık gelen vergi tutarını tanımlar.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @max_age 1 integer

Çocuğun yaşının üst sınırını tanımlar. Alt sınır, önceki dilimin max_age alanında + 1 olarak belirtilir. Üst ve alt sınırlar dahildir. İlk dilimin alt sınırı 0'dır.

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

Geçerli değerler include ve exclude şeklindedir.

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

Kullanıcı Ülkeleri type değeri exclude ise vergi yalnızca listelenen ülkelerin dışındaki kullanıcılar için geçerli olur.

UserCountries type ayarlanmamışsa include olarak değerlendirilir ve vergi yalnızca listelenen ülkelerdeki kullanıcılar için geçerli olur.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country 1..n Country UserCountry listesinde bir ülkeyi tanımlar.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country / @code 1 string DE veya FR gibi bir CLDR ülke kodu. 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

Bu vergi veya ücretin başvuru sırasını belirten bir sıralama. Örneğin, 2 değeri, bu verginin ikinci olarak uygulanacağı 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. Vergiler ve ücretler arasında yinelenen sıralama değerlerine izin verilir. Ancak bu durum, vergi ve ücretlerin rastgele ve kümülatif şekilde uygulandığı tanımlanmamış davranışlara neden olabilir. Sıralama içermeyen vergiler ve ücretler, sıralanmış tüm girişlerden önce uygulanır.

<Rank>, 1 ile 99 arasında (1 ve 99 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 dizimine sahip <Fee> için de desteklenir.

Örnekler

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

Temel mesaj

Temel bir TaxFeeInfo mesajıdı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>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 bu değerden 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, konukların yaşına göre uygulanır:

  • Yetişkin konuklar için 20 ABD doları vergi.
  • 11-17 yaş arası çocuklar için 10 ABD doları vergi.
  • 0-10 yaş arası çocuklar için 5 ABD doları vergi.
<?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>

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 saati.
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ıdır.
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üdür.

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

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