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>

Not: Her TaxFeeInfo mesajı, belirtilen oteller için yer paylaşımı olarak kabul edilir. Diğer bir deyişle, geçerli bir <ID> öğesine sahip her bir <Property> öğesi için geçerli güncelleme uygulanmadan önce o otelle ilgili önceki TaxFeeInfo güncellemeleri etkin şekilde temizlenir.

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

Not: <Currency> belirtilmez ancak <Amount> belirtilirse <Currency> değeri varsayılan olarak temel ücret para birimi olur.

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>