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_account_name"> <Property> <ID>HotelID</ID> <Taxes> <Tax> <StayDates> <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/> <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/> </StayDates> <RoomTypes> <RoomType id="RoomID_1"/> <RoomType id="RoomID_2"/> </RoomTypes> <RatePlans> <RatePlan id="PackageID_1"/> <RatePlan id="PackageID_2"/> </RatePlans> <Type>[percent|amount]</Type> <Basis>[room|person]</Basis> <Period>[stay|night]</Period> <Currency>currency_code</Currency> <Amount>tax_amount</Amount> </Tax> </Taxes> <Fees> <Fee> <StayDates> <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/> <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week="MTWHFSU_or_subset"/> </StayDates> <RoomTypes> <RoomType id="RoomID_1"/> <RoomType id="RoomID_2"/> </RoomTypes> <RatePlans> <RatePlan id="PackageID_1"/> <RatePlan id="PackageID_2"/> </RatePlans> <Type>[percent|amount]</Type> <Basis>[room|person]</Basis> <Period>[stay|night]</Period> <Currency>currency_code</Currency> <Amount>fee_amount</Amount> </Fee> </Fees> </Property> </TaxFeeInfo>
Öğeler ve Özellikler
TaxFeedInfo mesajında aşağıdaki öğeler ve özellikler bulunur:Öğe / @Özellik | Gerçekleşme sayısı | Tür | Açıklama |
---|---|---|---|
TaxFeeInfo | 1 | Karmaşık öğe | Tek bir tesise ait vergileri ve ücretleri tanımlayan mesajın kök öğesidir. |
TaxFeeInfo / @timestamp | 1 | DateTime | Bu mesajın oluşturulma tarihi ve saatidir. |
TaxFeeInfo / @id | 1 | Dize | Her TaxFeeInfo mesajının benzersiz tanımlayıcısıdır. |
TaxFeeInfo / @partner | 1 | Dize | 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 |
TaxFeeInfo / Property | 1..n | Tesis | Tek bir tesise ait vergilerin ve ücretlerin tanımlandığı kapsayıcıdır. |
TaxFeeInfo / Property / ID | 1 | Dize | 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 | Vergiler | Bir veya daha fazla <Tax> öğesinin kapsayıcısıdır. |
TaxFeeInfo / Property / Taxes / Tax | 1..n | Vergi | Tesis için geçerli olan ayrı bir vergidir. |
TaxFeeInfo / Property / Taxes / Tax / StayDates | 0..1 | StayDates | Verginin uygulanıp uygulanmayacağını belirleyen (örneğin, sezonluk vergileri karşılamak için) bir veya daha fazla tarih aralığının kapsayıcısıdır:
Not: |
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 | Tarih | 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 / StayDates / DateRange / @end | 0..1 | Tarih | Tarih aralığının (girilen tarihler dahil) bitiş tarihidir (tesisin bulunduğu saat dilimine göre). 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 | Dize | 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:
Karakter kombinasyonu uygulanabilir. |
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 | Dize | 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), OA_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 | Dize | Ücret planının benzersiz tanımlayıcısıdır. Bu değer, Transaction (Tesis Verileri) mesajındaki <PackageData> öğesinde ve hem <OTA_HotelRateAmountNotifRQ> hem de <OTA_HotelAvailNotifRQ> mesajlarının <StatusApplicationControl> öğesindeki RatePlanCode özelliğinde bulunan PackageID değeriyle eşlenir.
İzin verilen maksimum karakter sayısı 50'dir. |
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 | Bu değer yalnızca Geçerli değerler şunlardır:
|
TaxFeeInfo / Property / Taxes / Tax / Currency | 0..1 | Dize | Verginin üç harfli para birimi kodudur (örneğin, USD). |
TaxFeeInfo / Property / Taxes / Tax / Amount | 1 | Float | Vergi yüzdesi veya tutarının değeridir. |
TaxFeeInfo / Property / Fees | 0..1 | Ücretler | Bir veya daha fazla <Fee> öğesinin kapsayıcısıdır. |
TaxFeeInfo / Property / Fees / Fee | 1..n | Ücret | Tesis için geçerli olan ayrı bir ücrettir. |
TaxFeeInfo / Property / Fees / Fee / StayDates | 0..1 | StayDates | Ücretin uygulanıp uygulanmayacağını (örneğin, sezonluk ücretleri karşılamak için) belirleyen bir veya daha fazla tarih aralığının kapsayıcısıdır:
Not: |
TaxFeeInfo / Property / Fees / Fee / StayDates / DateRange | 1..20 | DateRange | Ücretin uygulanacağı tarihleri belirten tarih aralığıdır. |
TaxFeeInfo / Property / Fees / Fee / StayDates / DateRange / @start | 0..1 | Tarih | 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 / Fees / Fee / StayDates / DateRange / @end | 0..1 | Tarih | Tarih aralığının (girilen tarihler dahil) bitiş tarihidir (tesisin bulunduğu saat dilimine göre). 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 / Fees / Fee / StayDates / DateRange / @days_of_week | 0..1 | Dize | 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:
Karakter kombinasyonu uygulanabilir. |
TaxFeeInfo / Property / Fees / Fee / RoomTypes | 0..1 | RoomTypes | Ücretin geçerli olduğu oda türleri listesinin kapsayıcısıdır.
Ücret, belirtilen her bir <RoomType> için geçerlidir. <RoomTypes> belirtilmezse ücret tüm odalar için geçerli olur. |
TaxFeeInfo / Property / Fees / Fee / RoomTypes / RoomType | 1..n | RoomType | Oda türünü belirtir. Oda türü, Transaction (Tesis Verileri) mesajındaki bir <RoomData> öğesinde tanımlanır ve <RoomID> değeri kullanılarak belirtilir. (<RoomID> değeri, OTA_HotelRateAmountNotifRQ mesajlarındaki InvTypeCode özelliği tarafından da belirtilir.) |
TaxFeeInfo / Property / Fees / Fee / RoomTypes / RoomType / @id | 1 | Dize | 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 / Fees / Fee / RatePlans | 0..1 | RatePlans | Ücretin uygulandığı ücret planları listesinin kapsayıcısıdır.
<RatePlans> belirtilmezse ücret tüm ücret planları için geçerlidir. |
TaxFeeInfo / Property / Fees / Fee / RatePlans / RatePlan | 1..n | RatePlan | Ücret planını belirtir. Ücret planı; Transaction (Tesis Verileri), OA_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 / Fees / Fee / RatePlans / RatePlan / @id | 1 | Dize | Ücret planının benzersiz tanımlayıcısıdır. Bu değer, Transaction (Tesis Verileri) mesajındaki <PackageData> öğesinde ve hem <OTA_HotelRateAmountNotifRQ> hem de <OTA_HotelAvailNotifRQ> mesajlarının <StatusApplicationControl> öğesindeki RatePlanCode özelliğinde bulunan PackageID değeriyle eşlenir.
İzin verilen maksimum karakter sayısı 50'dir. |
TaxFeeInfo / Property / Fees / Fee / Type | 1 | Enum | Geçerli değerler şunlardır:
|
TaxFeeInfo / Property / Fees / Fee / Basis | 1 | Enum | Geçerli değerler şunlardır:
|
TaxFeeInfo / Property / Fees / Fee / Period | 1 | Enum | Bu değer yalnızca Geçerli değerler şunlardır:
|
TaxFeeInfo / Property / Fees / Fee / Currency | 0..1 | Dize | Ücretin üç harfli para birimi kodudur (örneğin, USD). |
TaxFeeInfo / Property / Fees / Fee Amount | 1 | Float | Ücret yüzdesi veya tutarının değeridir. |
Örnekler
1. Örnek
Aşağıdaki örnekte temel bir TaxFeeInfo
mesajı gösterilmektedir:
<?xml version="1.0" encoding="UTF-8"?> <TaxFeeInfo timestamp="2020-05-18T16:20:00-04:00" id="12345678"> <Property> <ID>Property_1</ID> <Taxes> <Tax> <Type>percent</Type> <Basis>room</Basis> <Period>night</Period> <Currency>USD</Currency> <Amount>10.00</Amount> </Tax> </Taxes> <Fees> <Fee> <Type>amount</Type> <Basis>room</Basis> <Period>stay</Period> <Currency>USD</Currency> <Amount>5.00</Amount> </Fee> </Fees> </Property> </TaxFeeInfo>