İ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 |
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 inç 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:
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:
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:
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:
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:
Karakter kombinasyonları geçerlidir. |
TaxFeeInfo / Property / Taxes / Tax / Type | 1 | enum | Geçerli değerler şunlardır:
|
TaxFeeInfo / Property / Taxes / Tax / Basis | 1 | enum | Geçerli değerler şunlardır:
|
TaxFeeInfo / Property / Taxes / Tax / Period | 1 | enum |
Geçerli değerler şunlardır:
|
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.
|
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 |
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 Gecelik ücret şundan yüksek veya bu değere eşit olduğunda vergi dilimi etkin olur
dilimin 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 |
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
|
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: Kullanıcı ülkeleri Kullanıcı Ülkeleri UserCountry |
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.
|
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. |
Ö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.
|
TaxFeeInfoResponse / Issues | 0..1 | Issues | işlenirken karşılaşılan bir veya daha fazla sorun için bir kapsayıcı
TaxFeeInfo mesaj.
|
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 |
Ö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>