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|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ı aşağıdaki öğelere sahiptir ve özellikler:

Öğe / @Özellik Yineleme sayısı Tür Açıklama
TaxFeeInfo 1 Complex element Tek bir hesap için vergileri ve ücretleri tanımlayan bir mesajın kök öğesi
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 döndürülür bu mesajdan yararlanabilirsiniz. İzin verilen karakterler: a-z, A-Z 0-9 _ (alt çizgi) ve - (kısa çizgi) tuşlarına basın.
TaxFeeInfo / @partner 1 string Bu mesajın iş ortağı hesabıdır. Bu dize değeri "İş ortağı anahtarı" değeri şurada listelenir: Hotel Center'daki hesap ayarları sayfası.

Not: Aşağıdaki işlemler için feed sağlayan bir arka ucunuz varsa birden fazla hesap varsa bu değerin ID ile eşleşmesi gerekir <RequestorID> özelliğinde belirtilen özellik değeri <OTA_HotelRateAmountNotifRQ> ve Aynı hesap için <OTA_HotelAvailNotifRQ> mesaj.
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 ve varsayılan olarak overlay olur. Önceki herhangi bir Bu mülk için Taxes ve Fees olacak bu güncelleme uygulanmadan önce temizlendi.
TaxFeeInfo / Property / ID 1 string Tesisin benzersiz tanımlayıcısıdır. Bu değer, <id> kullanılarak belirtilen otel kimliği bir listesini oluştur: Otel'deki <listing> öğesi Feed Listele. 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 her <RoomType> için uygulanır belirtiliyor. <RoomTypes> belirtilmezse vergi tüm odalar için geçerlidir.
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType 1..n RoomType Oda türünü belirtir. Oda türü <RoomData> öğesi Transaction (Tesis Verileri) mesajı ve RoomID kullanılarak tanımlandı. ( <RoomID> değerine, OTA_HotelRateAmountNotifRQ içinde InvTypeCode özelliği messages.)
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType / @id 1 string Envanterin benzersiz tanımlayıcısıdır (oda türü). Bu değer, İşlemde <RoomID> adlı alıcıya (Tesis Verileri) mesajı gösterilir. İzin verilen maksimum karakter sayısı 50.)
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ı, (İşlem'de tanımlandığı şekilde paket, ücretler ve stok durumu) (Tesis Verileri), OTA_HotelRateAmountNotifRQ ve OTA_HotelAvailNotifRQ iletilerinin yer aldığı ve PackageID tarafından tanımlandığı şekilde yapılır.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan / @id 1 string Ücret planının benzersiz tanımlayıcısıdır. Bu değer, PackageID değeri Transaction (Tesis Verileri) mesajının <PackageData> ve RatePlanCode değeri Her ikisinde de <StatusApplicationControl> özelliği <OTA_HotelRateAmountNotifRQ> ve <OTA_HotelAvailNotifRQ> mesaj. İzin verilen maksimum karakter sayısı 50'dir.
TaxFeeInfo / Property / Taxes / Tax / BookingDates 0..1 BookingDates Rezervasyonun ne zaman yapılması gerektiğini tanımlayan bir veya daha fazla tarih aralığının kapsayıcısıdır. verginin uygulanabilmesi için gereklidir.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange 1..99 DateRange Verginin geçerli olması için rezervasyonun ne zaman gerçekleşmesi gerektiğini belirten tarih aralığı geçerlidir.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @start 0..1 Date Başlangıç tarihi (tesisin bulunduğu saat dilimine göre), seçin. Bu tarih, end tarihi. 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 Tesisin bulunduğu saat dilimine göre, bitiş tarihi seçin. Bu tarih, start tarihiyle aynı veya bu tarihten sonra olmalıdır tarihi. 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. Değilse belirtilen tarih aralığında tüm günlere izin verilir. Her biri karakteri bir günü belirtir. Örneğin, "MTWHF" belirtir belirtilen tarih aralığında hafta içi günlerine izin verilir.

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 Giriş yapma işleminin ne zaman yapılması gerektiğini tanımlayan bir veya daha fazla tarih aralığının kapsayıcısıdır. gerçekleşeceği tahmin edilen değerleri kullanır.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange 1..20 DateRange Verginin ödeme alması için ne zaman check-in yapılması gerektiğini belirten bir tarih aralığı tarafından uygulanır.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @start 0..1 Date Başlangıç tarihi (tesisin bulunduğu saat dilimine göre), seçin. Bu tarih, end tarihi. 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 Tesisin bulunduğu saat dilimine göre, bitiş tarihi seçin. Bu tarih, start tarihiyle aynı veya bu tarihten sonra olmalıdır tarihi. 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. Değilse belirtilen tarih aralığında tüm günlere izin verilir. Her biri karakteri bir günü belirtir. Örneğin, "MTWHF" belirtir belirtilen tarih aralığında hafta içi günlerine izin verilir.

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 Ödeme zamanını tanımlayan bir veya daha fazla tarih aralığının kapsayıcısıdır. verginin uygulanması için gerçekleşmelidir.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange 1..20 DateRange Verginin ödeme alması için ne zaman çıkış yapılması gerektiğini belirten bir tarih aralığı tarafından uygulanır.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @start 0..1 Date Başlangıç tarihi (tesisin bulunduğu saat dilimine göre), seçin. Bu tarih, end tarihi. 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 Tesisin bulunduğu saat dilimine göre, bitiş tarihi seçin. Bu tarih, start tarihiyle aynı veya bu tarihten sonra olmalıdır tarihi. 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. Değilse belirtilen tarih aralığında tüm günlere izin verilir. Her biri karakteri bir günü belirtir. Örneğin, "MTWHF" belirtir belirtilen tarih aralığında hafta içi günlerine izin verilir.

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

Bir veya daha fazla tarih aralığının yer alıp almayacağını belirleyen Sezonluk indirimlerin karşılanması gibi nedenlerle vergi uygulanır.
TaxFeeInfo / Property / Taxes / Tax / StayDates / @application 1 enum

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

Geçerli değerler şunlardır:

  • all: Vergiyi seyahat planındaki tüm tarihler çakışıyorsa seyahat planı tercih edebilirsiniz.
  • any: Vergiyi üzerindeki herhangi bir tarihin konaklama tarihleri aralığı.
  • overlap: Vergi yalnızca şu ayındaki gecelere uygulanır: konaklama tarihleri aralığındaki bir tarihle çakışan seyahat planı.

    Not: overlap yalnızca şu durumlarda geçerlidir: <Period>, night olarak ayarlandı.

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 Başlangıç tarihi (tesisin bulunduğu saat dilimine göre), seçin. Bu tarih, end tarihi. 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 Tesisin bulunduğu saat dilimine göre, bitiş tarihi seçin. Bu tarih, start tarihiyle aynı veya bu tarihten sonra olmalıdır tarihi. 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. Değilse belirtilen tarih aralığında tüm günlere izin verilir. Her biri karakteri bir günü belirtir. Örneğin, "MTWHF" belirtir belirtilen tarih aralığında hafta içi günlerine izin verilir.

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: hesaplamadan önce biriken toplam oran, vergiler ve ücretler öğrenemez. Bu değer belirtilirse <Rank> belirtilmelidir.

    • <Brackets> <AgeBrackets> şununla belirtilemez: Tür olarak cumulative_percent.
TaxFeeInfo / Property / Taxes / Tax / Basis 1 enum

Geçerli değerler şunlardır:

  • room: Odaya <Amount> 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> eklendi toplam konaklama ücretine karşılık gelir.
  • night: <Amount> eklendi konaklamanın gecelik fiyatı.
TaxFeeInfo / Property / Taxes / Tax / Currency 0..1 string Verginin üç harfli para birimi kodudur (ö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 ve <Period> değeri şuna ayarlandı: gece.

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

max veya excluded belirtin ancak belirtmeyin her ikisini de seçebilirsiniz.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @max 0..1 integer <ApplicableNights max="N">, geceleri gösterir sonra ilk N gece hariç tutulmalıdır.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @excluded 0..1 integer <ApplicableNights excluded="N">, ilk N gece hariç tutulmalıdır.
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 değerlerin dışında olduğunda vergi uygulanmaz anlamına gelir.
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 ve <Amount> belirtilmemiş.
TaxFeeInfo / Property / Taxes / Tax / Brackets / @base_amount 0..1 float Gecelik ücretlere uygulanan vergi yüzdesi veya tutarının değeri ilk dilimin starts_at değerinin altında.
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 ayracın starts_at alanında belirtilir. Son dilimin üst sınırı yoktur.

Gecelik ücret şundan yüksek veya bu değere eşit olduğunda vergi dilimi etkin olur dilimin starts_at değerine ve kesinlikle daha küçüktür sonraki dilimin starts_at değeri.

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 Konuklara göre bir vergi grubu belirtilmesine olanak tanır yaşlar.

Bu öğe yalnızca <Brackets> ve <Amount> belirtilmemiş, <Basis>, person olarak ayarlandı ve <Type>, amount olarak ayarlandı.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge 0..1 AdultCharge Yetişkinler için vergileri belirten kapsayıcıdır.
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> anahtarını barındıran kapsayıcı öğeler.
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şının üst sınırını tanımlar. Alt sınır önceki ayracın max_age alanında + 1 belirtilmiş. Üst ve alt sınırlar dahildir. Bağlantının alt sınırı ilk parantez 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 geçerli olduğu kullanıcı ülkelerini listeleyen kapsayıcı dahil edilir veya hariç tutulur. Varsa vergi yalnızca belirtilen ülkelerdeki kullanıcılar için hariç tutulur.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / @type 0..1 enum UserCountry spesifikasyonunun türü.

Geçerli değerler: include ve exclude.

Kullanıcı ülkeleri type değeri şu şekilde ayarlanırsa: include, vergi yalnızca listelenen ülkeler.

Kullanıcı Ülkeleri type metriğinin exclude, vergi yalnızca listelenen ülkeler.

UserCountry type ayarı ayarlanmazsa şu şekilde ele alırız: include ve vergi yalnızca şu ülkelerdeki/bölgelerdeki kullanıcılar için geçerlidir: listelenen ülkeler.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country 1..n Country UserCountry listesinde bir ülkeyi tanımlar.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country / @code 1 string CLDR ülke kodu, DE veya FR gibi. Bazılarının CLDR ülke kodu, 2 harfli ISO ile aynı değildir ülke kodu. 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> için bu öğe her zaman belirtilmelidir cumulative_percent olarak ayarlandı. Genel olarak bu sıralama, hem vergi hem de ücretlere uygulanır. Yinelenen sıralama değerlerine izin verilir vergi ve ücretler arasında olabilir. Ancak bu durum, vergiler ve ücretler rastgele ve kümülatif şekilde uygulanır. Sıralaması olmayan vergiler ve ücretler, sıralı 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.

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

Örnekler

Tesis başına 300 vergi ve ücret sınırı vardır. Daha fazla bilgi için "Vergileri sil" örnek olarak verilebilir.

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

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 bu tutardan azsa% 12 vergi 7.500'e eşittir.
  • 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 dayalı 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="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 şunlar var: öğeler ve özellikler:

Öğe / @Özellik Yineleme sayısı Tür Açıklama
TaxFeeInfoResponse 1 Complex element Alınan bir öğenin başarısını veya sorunlarını gösteren kök öğe VergiÜcretiBilgisi istek mesajı.
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 başarıyla işlendiğini belirtir uyarı, hata veya sorun yok.

<Success> veya <Issues> her iletide yer alır.
TaxFeeInfoResponse / Issues 0..1 Issues Veri işlenirken karşılaşılan bir veya daha fazla sorun için bir kapsayıcı TaxFeeInfo mesaj.

<Success> veya <Issues> her iletide yer alır.
TaxFeeInfoResponse / Issues / Issue 1..n Issue Güncelleme sırasında karşılaşılan uyarı, hata veya sorunun TaxFeeInfo mesajını işliyor. Bu sorunlarla ilgili ayrıntılar şurada bulunabilir: Feed Durumu Hata Mesajları başlıklı bölüme bakın.
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 .

Örnekler

Başarılı

Aşağıda, başarıyla işlenmiş bir TaxFeeInfo'ya verilen yanıt yer almaktadır mesajını alırsınız.

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

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