VergiÜcretiBilgisi

İstekler

Söz dizimi

TaxFeeInfo mesajında aşağıdaki 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]</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>
      </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]</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>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

Öğeler ve özellikler

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

Öğe / @Özellik Yineleme sayısı Type Açıklama
TaxFeeInfo 1 Complex element Tek bir tesisin vergilerini ve ücretlerini 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ı için benzersiz bir tanımlayıcı. Bu değer, yanıt mesajında döndürülür. İzin verilen karakterler şunlardır: a-z, A-Z, 0-9, _ (alt çizgi) ve - (tire).
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 için <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 vergileri ve ücretleri tanımlayan bir kapsayıcıdır.
TaxFeeInfo / Property / @action 0..1 string Güncellemenin nasıl uygulanacağını belirtir. Yalnızca overlay desteklenir ve varsayılan olarak overlay kullanılır. Bu özellik uygulanmadan önce bu mülkle ilgili önceki Taxes ve Fees öğeleri temizlenecek.
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ındaki <RoomData> öğesinde ve RoomID'si kullanılarak tanımlanan şekilde tanımlanır. (OTA_HotelRateAmountNotifRQ değerindeki <RoomID> özelliği de InvTypeCode özelliğine referans veriyor.)
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType / @id 1 string Envanterin benzersiz tanımlayıcısı (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 geçerli olduğu ü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ı belirtir. Ücret planı; Transaction (Tesis Verileri), OTA_HotelRateAmountNotifRQ ve OTA_HotelAvailNotifRQ mesajlarında belirtilen ve PackageID tarafından tanımlanan paket, ücret ve müsaitlik durumu kombinasyonuyla 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ında <PackageData> içindeki <StatusApplicationControl> ve hem <OTA_HotelRateAmountNotifRQ> hem de <OTA_HotelAvailNotifRQ> mesajlarındaki <StatusApplicationControl> içindeki RatePlanCode özelliğinde PackageID 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 uygulanabilmesi 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 bitiş tarihiyle 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 bu 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çi 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 günü için U

Karakter kombinasyonu geçerli.
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 bitiş tarihiyle 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 bu 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çi 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 günü için U

Karakter kombinasyonu geçerli.
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 bitiş tarihiyle 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 bu 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çi 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 günü için U

Karakter kombinasyonu geçerli.
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.

Valid values are:

  • 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çerlidir.

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 bitiş tarihiyle 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 bu 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çi 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 günü için U

Karakter kombinasyonu geçerli.
TaxFeeInfo / Property / Taxes / Tax / Type 1 enum

Valid values are:

  • percent: Toplam ücretin yüzdesi
  • amount: Nihai ücrete eklenecek sabit tutar
TaxFeeInfo / Property / Taxes / Tax / Basis 1 enum

Valid values are:

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

Valid values are:

  • 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 kodu (ör. USD).
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.

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

max veya excluded değerini belirtin ancak 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ğ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. Bir değer 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 (ör. Hindistan'daki kademeli KDV vergileri) tanımlar.

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 gecelik ücretlere uygulanan vergi yüzdesi veya miktarı.
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 parantezin starts_at alanında belirtilir. Son basamak için üst sınır yoktur.

Vergi dilimi, gecelik aralığın starts_at değerine eşit veya daha yüksek olduğunda ve sonraki parantezin 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 Yolcuların yaşlarına göre bir dizi vergi belirtilmesine olanak tanır.

Bu öğe yalnızca <Brackets> ve <Amount> belirtilmediğinde <Basis>, person ve <Type>, amount olarak ayarlandığında geçerlidir.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge 0..1 AdultCharge Yetişkinler için vergileri belirtmek için kullanılan 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ı.
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

Bir çocuğun yaşındaki üst sınırı tanımlar. Alt sınır, önceki parantezin max_age alanında + 1'de belirtilir. Hem üst hem de alt sınırlar buna dahildir. İlk köşeli parantezin alt sınırı 0'dır.

max_age, 0 ile 17 (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ıdır.
TaxFeeInfo / Property / Taxes / Tax / UserCountries 0..1 UserCountries Verginin dahil edildiği veya hariç tutulduğu kullanıcı ülkelerini listelemek için kullanılan kapsayıcı. 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 Kullanıcı Ülkeleri spesifikasyonunun türü.

Geçerli değerler include ve exclude değerleridir.

Kullanıcı ülkeleri type, include olarak ayarlanırsa vergi yalnızca listelenen ülkelerdeki kullanıcılara uygulanır.

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

Ayarlanmayan Kullanıcı Ülkeleri (type) include olarak değerlendirilir ve vergi yalnızca listelenen ülkelerdeki kullanıcılara uygulanır.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country 1..n Country Kullanıcı ülkeleri 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 / 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 de aynı söz dizimiyle <Fee> için desteklenir.

Örnekler

Temel mesaj

Temel bir TaxFeeInfo mesajı:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2020-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 otel için tesis düzeyindeki tüm vergileri ve ücretleri silin:

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

Plak vergisi

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

  • Gecelik ücret 1.000 veya daha azsa vergi uygulanmaz.
  • Gecelik ücret 1.000'den fazla ve 7.500 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="2020-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 bağlı vergiler

Yolcuların yaşlarına göre uygulanan vergiler:

  • Yetişkin yolcular için 20 ABD doları vergi.
  • 11-17 yaş arasındaki çocuklar için 10 ABD doları vergi.
  • 0-10 yaş arasındaki çocuklar için 5 ABD doları vergi.
<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2020-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 aşağıdaki 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ı Type Açıklama
TaxFeeInfoResponse 1 Complex element Alınan TaxFeeInfo istek mesajının başarısını veya sorunlarını gösteren kök öğe.
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ı. Bu sorunlarla ilgili ayrıntıları Feed Durumu Hata Mesajları bölümünde bulabilirsiniz.
TaxFeeInfoResponse / Issues / Issue / @code 1 integer Sorunun tanımlayıcısı.
TaxFeeInfoResponse / Issues / Issue / @status 1 enum

Karşılaşılan sorun tü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="2020-05-18T16:20:00-04:00"
                    id="12345678"
                    partner="partner_key">
  <Success/>
</TaxFeeInfoResponse>

Sorunlar

Aşağıda, hatalar nedeniyle işlenmeyen TaxFeeInfo mesajına yanıt verilmiştir.

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