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 saati.
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. a-z, A-Z, 0-9, _ (alt çizgi) ve - (kısa çizgi) karakterlerine izin verilir.
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 vergilerin ve ücretlerin tanımlandığı kapsayıcıdır.
TaxFeeInfo / Property / @action 0..1 string Güncellemenin nasıl uygulandığını belirtir. Yalnızca overlay desteklenir ve varsayılan değer overlay'tür. Bu güncelleme uygulanmadan önce bu mülk için önceki Taxes ve Fees verileri 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ğ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ğ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), 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 (tesisin bulunduğu saat dilimine göre) başlangıç tarihidir. 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 / 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 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

Karakter kombinasyonları 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 (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ırlandırılmaz.
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 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

Karakter kombinasyonları 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 (tesisin bulunduğu saat dilimine göre) bitiş tarihidir. 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

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: 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 bu 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 (tesisin bulunduğu saat dilimine göre) bitiş tarihidir. 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, vergiler ve ücretlerin yüzdesi. 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çerli olur.

Verginin uygulanabileceği gece sayısını kısıtlar.

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 belirtir.
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ğu zaman 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 ayarlandığında ve <Amount> belirtilmediğinde 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 ve <Type> amount olarak ayarlandığında 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ı.
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 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 + 1 olarak belirtilir. Hem üst hem de 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'dir.

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

UserCountries type ise exclude ise vergi yalnızca listelenen ülkeler 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 UserCountries 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 uygulama 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ıra değerlerine izin verilir ancak bu, vergilerin ve ücretlerin keyfi ve kümülatif bir şekilde uygulanacağı tanımlanmamış bir davranışa neden olabilir. Sıralama içermeyen vergiler ve ücretler, sıralanmış tüm girişlerden önce uygulanır.

<Rank>, 1 ile 99 arasında (ikisi de 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ı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 vergisi. Vergi dilimleri şunlardır:

  • 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.
<?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

Kişilerin yaşlarına göre uygulanan vergiler:

  • 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 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ı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 ş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>