Informacje podatkowe

Żądania

Składnia

Komunikat TaxFeeInfo ma taką składnię:

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

Uwaga: każda wiadomość TaxFeeInfo jest traktowana jako nakładka dotycząca określonych hoteli. Oznacza to, że w przypadku każdego elementu <Property> z prawidłowym elementem <ID> wszelkie wcześniejsze aktualizacje TaxFeeInfo dla tego hotelu są usuwane przed zastosowaniem bieżącej aktualizacji.

Elementy i atrybuty

Wiadomość TaxFeeInfo składa się z tych elementów i atrybutów:

Element / @Atrybut	Wystąpienia	Typ	Opis
TaxFeeInfo	1	Complex element	Główny element wiadomości definiujący podatki i opłaty za pojedynczą usługę.
TaxFeeInfo / @timestamp	1	DateTime	Data i godzina utworzenia tej wiadomości.
TaxFeeInfo / @id	1	string	Unikalny identyfikator tej wiadomości z żądaniem. Ta wartość jest zwracana w wiadomości z odpowiedzią. Dozwolone znaki to a-z, A-Z, 0-9, _ (podkreślenie) i - (łącznik).
TaxFeeInfo / @partner	1	string	Konto partnera, z którego pochodzi ta wiadomość. Ta wartość ciągu znaków to wartość „Klucz partnera” podana na stronie Ustawienia konta w Hotel Center. Uwaga: jeśli masz backend, który udostępnia pliki danych dla wielu kont, ta wartość musi odpowiadać wartości atrybutu ID określonej w elemencie <RequestorID> wiadomości <OTA_HotelRateAmountNotifRQ> i <OTA_HotelAvailNotifRQ> dla tego samego konta.
TaxFeeInfo / Property	1..n	Property	Kontener do określania podatków i opłat dla jednej usługi.
TaxFeeInfo / Property / @action	0..1	string	Określa sposób stosowania aktualizacji. Obsługiwana jest tylko wartość overlay, a wartość domyślna to overlay. Przed zastosowaniem tej aktualizacji wszystkie wcześniejsze Taxes i Fees w tej usłudze zostaną wyczyszczone.
TaxFeeInfo / Property / ID	1	string	Unikalny identyfikator usługi. Ta wartość musi pasować do identyfikatora hotelu określonego za pomocą elementu <id> w elemencie <listing> w pliku danych z listą hoteli. Identyfikator hotelu jest też podany w Hotel Center.
TaxFeeInfo / Property / Taxes	0..1	Taxes	Kontener na co najmniej 1 element <Tax>.
TaxFeeInfo / Property / Taxes / Tax	1..n	Tax	Indywidualny podatek obowiązujący w przypadku nieruchomości.
TaxFeeInfo / Property / Taxes / Tax / RoomTypes	0..1	RoomTypes	Kontener zawierający listę typów pomieszczeń, do których obowiązuje podatek. Podatek jest stosowany do każdego określonego zasobu (<RoomType>). Jeśli nie określisz wartości <RoomTypes>, podatek będzie dotyczył wszystkich sal.
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType	1..n	RoomType	Określa typ pomieszczenia. Typ pokoju jest zdefiniowany w elemencie <RoomData> w wiadomości Transakcja (dane usługi) i za pomocą identyfikatora pokoju. (Do jej wartości <RoomID> odwołują się również atrybut InvTypeCode w komunikatach OTA_HotelRateAmountNotifRQ.)
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType / @id	1	string	Unikalny identyfikator zasobów reklamowych (typ pomieszczenia). Ta wartość jest mapowana na <RoomID> w komunikacie Transaction (Dane usługi). Maksymalna dozwolona liczba znaków to 50.
TaxFeeInfo / Property / Taxes / Tax / RatePlans	0..1	RatePlans	Kontener listy planów stawek, do których obowiązuje podatek. Jeśli nie określisz wartości <RatePlans>, podatek będzie stosowany do wszystkich planów stawek.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan	1..n	RatePlan	Określa plan stawek. Plan stawek jest definiowany przez połączenie pakietu, stawek i dostępności zgodnie z definicją w danych transakcji (danych obiektu), komunikatach OTA_HotelRateAmountNotifRQ i OTA_HotelAvailNotifRQ oraz określa identyfikator pakietu.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan / @id	1	string	Unikalny identyfikator abonamentu. Ta wartość jest mapowana na wartość identyfikatora pakietu w <PackageData> w komunikacie Transakcja (dane usługi) oraz w atrybucie RatePlanCode w <StatusApplicationControl> w komunikatach <OTA_HotelRateAmountNotifRQ> i <OTA_HotelAvailNotifRQ>. Maksymalna dozwolona liczba znaków to 50.
TaxFeeInfo / Property / Taxes / Tax / BookingDates	0..1	BookingDates	Kontener dla co najmniej jednego zakresu dat, który określa, kiedy nastąpi rezerwacja, aby podatek mógł zostać zastosowany.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange	1..99	DateRange	Zakres dat, w którym musi zostać naliczona rezerwacja, aby naliczył się podatek.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @start	0..1	Date	Data rozpoczęcia (na podstawie strefy czasowej usługi) włącznie z datą rozpoczęcia zakresu dat. Ta data nie może być wcześniejsza niż data end. Jeśli nie określisz wartości start, zakres dat będzie w praktyce nieograniczony.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @end	0..1	Date	Data końcowa z zakresu dat (na podstawie strefy czasowej usługi). Ta data musi być taka sama jak data start lub później. Jeśli nie określisz wartości end, zakres dat będzie nieograniczony, jeśli chodzi o datę zakończenia.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @days_of_week	0..1	string	Dni tygodnia, które są dozwolone w zakresie dat. Jeśli go nie podasz, dozwolone będą wszystkie dni w zakresie dat. Każdy znak w ciągu określa dzień. Na przykład ciąg „MTWHF” wskazuje, że w zakresie dat dozwolone są dni robocze. Prawidłowe znaki to: M na poniedziałek T na wtorek W na środę H na czwartek F na piątek S na sobotę U na niedzielę Obowiązuje każda kombinacja znaków.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates	0..1	CheckinDates	Kontener na co najmniej 1 zakres dat, który określa, kiedy należy zameldować się, aby naliczyć podatek.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange	1..20	DateRange	Zakres dat, w którym należy się zameldować, aby naliczony podatek został naliczony.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @start	0..1	Date	Data rozpoczęcia (na podstawie strefy czasowej usługi) włącznie z datą rozpoczęcia zakresu dat. Ta data nie może być wcześniejsza niż data end. Jeśli nie określisz wartości start, zakres dat będzie w praktyce nieograniczony.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @end	0..1	Date	Data końcowa z zakresu dat (na podstawie strefy czasowej usługi). Ta data musi być taka sama jak data start lub później. Jeśli nie określisz wartości end, zakres dat będzie nieograniczony, jeśli chodzi o datę zakończenia.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @days_of_week	0..1	string	Dni tygodnia, które są dozwolone w zakresie dat. Jeśli go nie podasz, dozwolone będą wszystkie dni w zakresie dat. Każdy znak w ciągu określa dzień. Na przykład ciąg „MTWHF” wskazuje, że w zakresie dat dozwolone są dni robocze. Prawidłowe znaki to: M na poniedziałek T na wtorek W na środę H na czwartek F na piątek S na sobotę U na niedzielę Obowiązuje każda kombinacja znaków.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates	0..1	CheckoutDates	Kontener na co najmniej 1 zakres dat, który określa, kiedy wymeldować się trzeba, aby naliczyć podatek.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange	1..20	DateRange	Zakres dat, w którym musi nastąpić wymeldowanie, aby możliwe było naliczenie podatku.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @start	0..1	Date	Data rozpoczęcia (na podstawie strefy czasowej usługi) włącznie z datą rozpoczęcia zakresu dat. Ta data nie może być wcześniejsza niż data end. Jeśli nie określisz wartości start, zakres dat będzie w praktyce nieograniczony.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @end	0..1	Date	Data końcowa z zakresu dat (na podstawie strefy czasowej usługi). Ta data musi być taka sama jak data start lub później. Jeśli nie określisz wartości end, zakres dat będzie nieograniczony, jeśli chodzi o datę zakończenia.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @days_of_week	0..1	string	Dni tygodnia, które są dozwolone w zakresie dat. Jeśli go nie podasz, dozwolone będą wszystkie dni w zakresie dat. Każdy znak w ciągu określa dzień. Na przykład ciąg „MTWHF” wskazuje, że w zakresie dat dozwolone są dni robocze. Prawidłowe znaki to: M na poniedziałek T na wtorek W na środę H na czwartek F na piątek S na sobotę U na niedzielę Obowiązuje każda kombinacja znaków.
TaxFeeInfo / Property / Taxes / Tax / StayDates	0..1	StayDates	Kontener na co najmniej 1 zakres dat, który określa, czy podatek jest naliczany, w celu uwzględnienia rabatów sezonowych.
TaxFeeInfo / Property / Taxes / Tax / StayDates / @application	1	enum	Opisuje sposób naliczania podatku. Prawidłowe wartości to: all: stosuje podatek do każdej nocy w planie podróży, jeśli wszystkie daty w planie podróży pokrywają się z datami pobytu. any: stosuje podatek do wszystkich nocy w planie podróży, jeśli dowolna data w planie podróży pokrywa się z datą w zakresie dat pobytu. overlap: stosuje podatek tylko do tych nocy w planie podróży, które pokrywają się z datą w zakresie dat pobytu. Uwaga: właściwość overlap jest prawidłowa tylko wtedy, gdy <Period> ma wartość night. Ten atrybut musi być zawsze określony.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange	1..99	DateRange	Zakres dat określający daty zastosowania podatku.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @start	0..1	Date	Data rozpoczęcia (na podstawie strefy czasowej usługi) włącznie z datą rozpoczęcia zakresu dat. Ta data nie może być wcześniejsza niż data end. Jeśli nie określisz wartości start, zakres dat będzie w praktyce nieograniczony.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @end	0..1	Date	Data końcowa z zakresu dat (na podstawie strefy czasowej usługi). Ta data musi być taka sama jak data start lub później. Jeśli nie określisz wartości end, zakres dat będzie nieograniczony, jeśli chodzi o datę zakończenia.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @days_of_week	0..1	string	Dni tygodnia, które są dozwolone w zakresie dat. Jeśli go nie podasz, dozwolone będą wszystkie dni w zakresie dat. Każdy znak w ciągu określa dzień. Na przykład ciąg „MTWHF” wskazuje, że w zakresie dat dozwolone są dni robocze. Prawidłowe znaki to: M na poniedziałek T na wtorek W na środę H na czwartek F na piątek S na sobotę U na niedzielę Obowiązuje każda kombinacja znaków.
TaxFeeInfo / Property / Taxes / Tax / Type	1	enum	Prawidłowe wartości to: percent: Procent sumy stawki amount: Kwota zryczałtowana, która zostanie dodana do stawki końcowej. cumulative_percent: Odsetek łącznej stawki, podatków i opłat powstałych przed obliczeniem tego podatku lub opłaty. Jeśli jest określona, musisz też podać <Rank>. <Brackets> i <AgeBrackets> nie mogą być używane z typem cumulative_percent.
TaxFeeInfo / Property / Taxes / Tax / Basis	1	enum	Prawidłowe wartości to: room: <Amount> jest stosowany do pokoju. person: <Amount> dotyczy każdej osoby. Ta wartość ma zastosowanie tylko wtedy, gdy w polu <Type> ustawiono kwotę.
TaxFeeInfo / Property / Taxes / Tax / Period	1	enum	Prawidłowe wartości to: stay: <Amount> jest dodawana do łącznej ceny za pobyt. night: Opłata <Amount> jest naliczana za każdą noc.
TaxFeeInfo / Property / Taxes / Tax / Currency	0..1	string	Trzyliterowy kod waluty podatku (np. PLN).
TaxFeeInfo / Property / Taxes / Tax / Amount	0..1	float	Wartość procentu lub kwoty podatku.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights	0..1	ApplicableNights	Ta wartość ma zastosowanie tylko wtedy, gdy <Type> jest ustawiona na amount, a <Period> jest ustawiona na noc. Ogranicza liczbę nocy, za które może zostać naliczony podatek. Określ max lub excluded, ale nie obie.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @max	0..1	integer	<ApplicableNights max="N"> oznacza, że należy wykluczyć noce po pierwszych N nocy.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @excluded	0..1	integer	<ApplicableNights excluded="N"> oznacza, że dane z pierwszych N nocy powinny zostać wykluczone.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay	0..1	LengthOfStay	Określa limity długości pobytu, w ramach którego można naliczyć podatek. Podatek nie jest naliczany, gdy długość pobytu wykracza poza limity minimalne i maksymalne.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay / @min	0..1	integer	Minimalna liczba nocy przebytych w trakcie pobytu, by mogła zostać naliczona podatek. Jeśli ta wartość nie zostanie określona, nie ma minimalnej wartości.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay / @max	0..1	integer	Maksymalna liczba nocy w trakcie pobytu, która może zostać naliczona, aby doliczyć podatek. Jeśli nie podasz żadnej wartości, nie będzie maksymalnej wartości.
TaxFeeInfo / Property / Taxes / Tax / Brackets	0..1	Brackets	Kontener na co najmniej 1 element <Bracket>. Określa zestaw ciągłych i niepokrywających się przedziałów podatkowych, np. indyjskie podatki od podatku od towarów i usług. Ten element jest prawidłowy tylko wtedy, gdy <Period> ma wartość night, a <Amount> nie jest określony.
TaxFeeInfo / Property / Taxes / Tax / Brackets / @base_amount	0..1	float	Wartość procentu lub kwoty podatku zastosowana do stawek za noc poniżej wartości starts_at w pierwszym przedziale czasu.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket	1..n	Bracket	Określa przedział podatkowy na podstawie stawek za noc.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @starts_at	1	float	Określa dolną granicę przedziału podatkowego. Górną granicę określa się w polu starts_at następnego nawiasu. Nie istnieje górna granica ostatniego nawiasu. Przedział podatkowy jest aktywny, gdy stawka za noc jest wyższa lub równa wartości starts_at w nawiasie i ściśle mniejsza niż wartość starts_at w kolejnym nawiasie. Ta wartość musi być ściśle większa niż 0.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @amount	1	float	Wartość procentu lub kwoty podatku zastosowanych do tego przedziału podatkowego.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets	0..1	AgeBrackets	Umożliwia określenie zestawu podatków na podstawie wieku gości. Ten element jest prawidłowy tylko wtedy, gdy nie określono właściwości <Brackets> i <Amount>, <Basis> ma wartość person, a <Type> ma wartość amount.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge	0..1	AdultCharge	Kontener do określania podatków dla osób dorosłych.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge / @amount	1	float	Stała kwota podatku dla osób dorosłych.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets	0..1	ChildAgeBrackets	Kontener do przechowywania co najmniej 1 elementu <ChildAgeBracket>.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket	1..n	ChildAgeBracket	Definiuje przedział wiekowy dzieci i odpowiednią kwotę podatku.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @max_age	1	integer	Określa górną granicę wieku dziecka. Dolna granica jest określona w polu max_age poprzedniego nawiasu + 1. Górna i dolna granica wyznaczają warunki włącznie. Dolna granica pierwszego nawiasu to 0. max_age musi należeć do zakresu od 0 do 17 (włącznie).
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @amount	1	float	Zryczałtowana kwota podatku dla dzieci w tym przedziale wiekowym.
TaxFeeInfo / Property / Taxes / Tax / UserCountries	0..1	UserCountries	Kontener do wyświetlania listy krajów użytkowników, w przypadku których podatek jest uwzględniony lub nie. Jeśli podatek będzie określony, zostanie on uwzględniony lub nieuwzględniony tylko w przypadku użytkowników z określonych krajów.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / @type	0..1	enum	Typ specyfikacji krajów użytkowników. Prawidłowe wartości to include i exclude. Jeśli zasada type User countries ma wartość include, podatek będzie dotyczył tylko użytkowników z wymienionych krajów. Jeśli type w krajach użytkowników to exclude, podatek będzie dotyczył tylko użytkowników spoza wymienionych krajów. Jeśli zasada type User countries nie jest skonfigurowana, będziemy traktować ją jako include, a podatek będzie stosowany tylko w przypadku użytkowników z wymienionych krajów.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country	1..n	Country	Definiuje jeden kraj z listy krajów użytkowników.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country / @code	1	string	Kod kraju CLDR, na przykład DE lub FR. Pamiętaj, że w niektórych krajach kod kraju CLDR różni się od 2-literowego kodu ISO kraju. Kody regionów CLDR nie są też obsługiwane.
TaxFeeInfo / Property / Taxes / Tax / Rank	1	integer	Pozycja, która określa kolejność stosowania danego podatku lub opłaty. Na przykład wartość 2 oznacza, że podatek będzie naliczany w drugiej kolejności. Ten element powinien być zawsze określony, jeśli <Type> ma wartość cumulative_percent. Ogólnie to zamówienie obejmuje zarówno podatki, jak i opłaty. Zduplikowane wartości pozycji w podatkach i opłatach są dozwolone, ale może to skutkować nieokreślonym zachowaniem i zastosowaniem podatków i opłat w sposób arbitrażowy i łączny. Podatki i opłaty bez pozycji w rankingu są stosowane przed wszystkimi pozycjami w rankingu. <Rank> musi należeć do zakresu od 1 do 99 (włącznie).
TaxFeeInfo / Property / Fees	0..1	Fees	Kontener na co najmniej 1 element <Fee>.
TaxFeeInfo / Property / Fees / Fee	1..n	Fee	Opłata indywidualna za pobyt w obiekcie. Wszystkie elementy podrzędne elementu <Tax> są również obsługiwane w <Fee> o tej samej składni.

Przykłady

Podstawowa wiadomość

Podstawowy komunikat w TaxFeeInfo:

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

Usuń podatki

Usuń wszystkie podatki i opłaty obowiązujące w przypadku wybranego hotelu:

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

Podatek Slab

Indyjski podatek od towarów i usług (GST) obowiązujący na podstawie stawek za noc. Przedziały podatkowe:

• Bez podatku, jeśli cena za noc jest mniejsza niż lub równa 1000.
• 12% podatku, jeśli cena za noc jest większa niż 1000 i mniejsza niż 7500.
• 18% podatku, jeśli cena za nocleg przekracza 7500.

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

Podatki na podstawie wieku

Podatki naliczane na podstawie wieku mieszkańców:

• Podatek 20 USD dla osób dorosłych.
• Podatek 10 USD dla dzieci w wieku od 11 do 17 lat.
• 5 USD podatku w przypadku dzieci w wieku do 10 lat.

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

Odpowiedzi

Składnia

Komunikat TaxFeeInfoResponse ma taką składnię:

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

Elementy i atrybuty

Wiadomość TaxFeeInfoResponse składa się z tych elementów i atrybutów:

Element / @Atrybut	Wystąpienia	Typ	Opis
TaxFeeInfoResponse	1	Complex element	Element główny wskazujący powodzenie lub problemy związane z otrzymanym żądaniem TaxFeeInfo.
TaxFeeInfoResponse / @timestamp	1	DateTime	Data i godzina utworzenia tej wiadomości.
TaxFeeInfoResponse / @id	1	string	Unikalny identyfikator powiązanej wiadomości TaxFeeInfo.
TaxFeeInfoResponse / @partner	1	string	Konto partnera, z którego pochodzi ta wiadomość.
TaxFeeInfoResponse / Success	0..1	Success	Wskazuje, że wiadomość TaxFeeInfo została przetworzona bez ostrzeżeń, błędów i niepowodzeń. Każda wiadomość zawiera element <Success> lub <Issues>.
TaxFeeInfoResponse / Issues	0..1	Issues	Kontener rozwiązania co najmniej jednego problemu, który wystąpił podczas przetwarzania wiadomości TaxFeeInfo. Każda wiadomość zawiera element <Success> lub <Issues>.
TaxFeeInfoResponse / Issues / Issue	1..n	Issue	Opis ostrzeżenia, błędu lub błędu napotkanych podczas przetwarzania wiadomości TaxFeeInfo. Szczegółowe informacje o tych problemach znajdziesz w artykule Komunikaty o błędach stanu pliku danych.
TaxFeeInfoResponse / Issues / Issue / @code	1	integer	Identyfikator problemu.
TaxFeeInfoResponse / Issues / Issue / @status	1	enum	Typ napotkanego problemu. Prawidłowe wartości to warning, error i failure .

Przykłady

Gotowe

Poniżej znajdziesz odpowiedź na pomyślnie przetworzoną wiadomość TaxFeeInfo.

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfoResponse timestamp="2020-05-18T16:20:00-04:00"
                    id="12345678"
                    partner="partner_key">
  <Success/>
</TaxFeeInfoResponse>

Problemy

Poniżej znajdziesz odpowiedź na komunikat TaxFeeInfo nieprzetworzony z powodu błędów.

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