TaxFeeInfo (Steuerinformationen)

Anfragen

Syntax

Die Nachricht TaxFeeInfo verwendet die folgende Syntax:

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

Hinweis: Jede TaxFeeInfo-Nachricht wird als Overlay für die angegebenen Hotels behandelt. Mit anderen Worten: Für jedes <Property>-Element mit einem gültigen <ID>-Element werden alle vorherigen TaxFeeInfo-Aktualisierungen für dieses Hotel gelöscht, bevor die aktuelle Aktualisierung angewendet wird.

Elemente und Attribute

Die Nachricht TaxFeeInfo enthält die folgenden Elemente und Attribute:

Element / @Attribut	Häufigkeit	Typ	Beschreibung
TaxFeeInfo	1	Complex element	Das Stammelement für eine Nachricht, in der Steuern und Gebühren für eine einzelne Unterkunft definiert sind.
TaxFeeInfo / @timestamp	1	DateTime	Erstellungsdatum und -uhrzeit der Nachricht.
TaxFeeInfo / @id	1	string	Eine eindeutige Kennung für diese Anfragenachricht. Dieser Wert wird in der Antwortnachricht zurückgegeben. Zulässige Zeichen sind a-z, A-Z, 0-9, _ (Unterstrich) und - (Bindestrich).
TaxFeeInfo / @partner	1	string	Das Partnerkonto für diese Nachricht. Dieser Stringwert ist der Wert für „Partnerschlüssel“, der im Hotel Center auf der Seite „Kontoeinstellungen“ aufgeführt ist. Hinweis: Wenn Sie ein Backend haben, das Feeds für mehrere Konten bereitstellt, muss dieser Wert mit dem Attributwert ID im Element <RequestorID> der Nachrichten <OTA_HotelRateAmountNotifRQ> und <OTA_HotelAvailNotifRQ> für dasselbe Konto übereinstimmen.
TaxFeeInfo / Property	1..n	Property	Ein Container zum Definieren von Steuern und Gebühren für eine einzelne Unterkunft.
TaxFeeInfo / Property / @action	0..1	string	Gibt an, wie das Update angewendet wird. Es wird nur overlay unterstützt. Der Standardwert ist overlay. Alle vorherigen Taxes und Fees für diese Property werden gelöscht, bevor dieses Update angewendet wird.
TaxFeeInfo / Property / ID	1	string	Die eindeutige Kennung der Unterkunft. Dieser Wert muss mit der Hotel-ID übereinstimmen, die mit <id> im Element <listing> des Hotellistenfeeds angegeben wurde. Die Hotel-ID ist auch im Hotel Center aufgeführt.
TaxFeeInfo / Property / Taxes	0..1	Taxes	Container für ein oder mehrere <Tax>-Elemente.
TaxFeeInfo / Property / Taxes / Tax	1..n	Tax	Eine individuelle Steuer, die für die Unterkunft gilt.
TaxFeeInfo / Property / Taxes / Tax / RoomTypes	0..1	RoomTypes	Container für eine Liste von Zimmertypen, für die die Steuer gilt. Die Steuer wird auf jeden angegebenen <RoomType> angewendet. Wenn <RoomTypes> nicht angegeben ist, gilt die Steuer für alle Zimmer.
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType	1..n	RoomType	Gibt einen Zimmertyp an. Ein Zimmertyp wird in einem <RoomData>-Element in der Nachricht Transaktion (Unterkunftsdaten) definiert und anhand seiner RoomID identifiziert. Sein Wert <RoomID> wird auch vom Attribut InvTypeCode in OTA_HotelRateAmountNotifRQ-Nachrichten referenziert.
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType / @id	1	string	Die eindeutige Kennung für das Inventar (Zimmertyp). Dieser Wert ist <RoomID> in einer Nachricht Transaktion (Unterkunftsdaten) zugeordnet. Es sind maximal 50 Zeichen zulässig.
TaxFeeInfo / Property / Taxes / Tax / RatePlans	0..1	RatePlans	Container für eine Liste von Preisplänen, für die die Steuer gilt. Wenn <RatePlans> nicht angegeben ist, gilt die Steuer für alle Preispläne.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan	1..n	RatePlan	Gibt einen Preisplan an. Ein Preisplan wird durch eine Kombination aus Paket, Preisen und Verfügbarkeit definiert, wie in den Nachrichten Transaktionen (Unterkunftsdaten), OTA_HotelRateAmountNotifRQ und OTA_HotelAvailNotifRQ definiert und durch die PackageID identifiziert.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan / @id	1	string	Die eindeutige Kennung für den Preisplan. Dieser Wert ist dem PackageID-Wert in der Nachricht Transaktion (Unterkunftsdaten) in der Nachricht <PackageData> und dem Wert RatePlanCode zugeordnet, der im Attribut <StatusApplicationControl> sowohl in <OTA_HotelRateAmountNotifRQ>- als auch in <OTA_HotelAvailNotifRQ>-Nachrichten festgelegt ist. Es sind maximal 50 Zeichen zulässig.
TaxFeeInfo / Property / Taxes / Tax / BookingDates	0..1	BookingDates	Ein Container für einen oder mehrere Zeiträume, die definieren, wann eine Buchung erfolgen muss, damit die Steuer angewendet wird.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange	1..99	DateRange	Ein Zeitraum, der angibt, wann eine Buchung erfolgen muss, damit die Steuer angewendet wird.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @start	0..1	Date	Das einschließliche Startdatum (basierend auf der Zeitzone der Unterkunft) des Zeitraums. Dieses Datum muss vor dem end-Datum liegen oder mit diesem übereinstimmen. Wenn start nicht angegeben ist, ist der Zeitraum in Bezug auf das Startdatum praktisch unbegrenzt.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @end	0..1	Date	Das einschließliche Enddatum (basierend auf der Zeitzone der Unterkunft) des Zeitraums. Dieses Datum muss nach dem start-Datum liegen oder mit diesem übereinstimmen. Wird end nicht angegeben, ist der Zeitraum in Bezug auf das Enddatum nahezu unbegrenzt.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @days_of_week	0..1	string	Die Wochentage, die im Zeitraum zulässig sind. Wenn nicht angegeben, sind alle Tage im Zeitraum zulässig. Jedes Zeichen im String gibt einen Tag an. Beispielsweise gibt „MTWHF“ an, dass Wochentage im Zeitraum zulässig sind. Gültige Zeichen sind: M für Montag T für Dienstag W für Mittwoch H für Donnerstag F für Freitag S für Samstag U für Sonntag Jede Zeichenkombination ist gültig.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates	0..1	CheckinDates	Ein Container für einen oder mehrere Zeiträume, die definieren, wann der Check-in erfolgen muss, damit die Steuer angewendet wird.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange	1..20	DateRange	Ein Zeitraum, der angibt, wann ein Check-in erfolgen muss, damit die Steuer angewendet wird.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @start	0..1	Date	Das einschließliche Startdatum (basierend auf der Zeitzone der Unterkunft) des Zeitraums. Dieses Datum muss vor dem end-Datum liegen oder mit diesem übereinstimmen. Wird start nicht angegeben, ist der Zeitraum in Bezug auf das Startdatum prinzipiell unbegrenzt.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @end	0..1	Date	Das einschließliche Enddatum (basierend auf der Zeitzone der Unterkunft) des Zeitraums. Dieses Datum muss nach dem start-Datum liegen oder mit diesem übereinstimmen. Wird end nicht angegeben, ist der Zeitraum in Bezug auf das Enddatum nahezu unbegrenzt.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @days_of_week	0..1	string	Die Wochentage, die im Zeitraum zulässig sind. Wenn nicht angegeben, sind alle Tage im Zeitraum zulässig. Jedes Zeichen im String gibt einen Tag an. Beispielsweise gibt „MTWHF“ an, dass Wochentage im Zeitraum zulässig sind. Gültige Zeichen sind: M für Montag T für Dienstag W für Mittwoch H für Donnerstag F für Freitag S für Samstag U für Sonntag Jede Zeichenkombination ist gültig.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates	0..1	CheckoutDates	Ein Container für einen oder mehrere Zeiträume, die definieren, wann der Check-out erfolgen muss, damit die Steuer angewendet wird.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange	1..20	DateRange	Ein Zeitraum, der angibt, wann ein Check-out erfolgen muss, damit die Steuer angewendet wird.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @start	0..1	Date	Das einschließliche Startdatum (basierend auf der Zeitzone der Unterkunft) des Zeitraums. Dieses Datum muss vor dem end-Datum liegen oder mit diesem übereinstimmen. Wenn start nicht angegeben ist, ist der Zeitraum in Bezug auf das Startdatum praktisch unbegrenzt.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @end	0..1	Date	Das einschließliche Enddatum (basierend auf der Zeitzone der Unterkunft) des Zeitraums. Dieses Datum muss nach dem start-Datum liegen oder mit diesem übereinstimmen. Wird end nicht angegeben, ist der Zeitraum in Bezug auf das Enddatum nahezu unbegrenzt.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @days_of_week	0..1	string	Die Wochentage, die im Zeitraum zulässig sind. Wenn nicht angegeben, sind alle Tage im Zeitraum zulässig. Jedes Zeichen im String gibt einen Tag an. Beispielsweise gibt „MTWHF“ an, dass Wochentage im Zeitraum zulässig sind. Gültige Zeichen sind: M für Montag T für Dienstag W für Mittwoch H für Donnerstag F für Freitag S für Samstag U für Sonntag Jede Zeichenkombination ist gültig.
TaxFeeInfo / Property / Taxes / Tax / StayDates	0..1	StayDates	Ein Container für einen oder mehrere Zeiträume, die bestimmen, ob die Steuer angewendet wird, z. B. für saisonale Rabatte.
TaxFeeInfo / Property / Taxes / Tax / StayDates / @application	1	enum	Beschreibt, wie die Steuer angewendet werden soll. Gültige Werte sind: all: Die Steuer wird auf jede Übernachtung im Reiseplan angewendet, wenn sich alle Datumsangaben im Reiseplan mit den Aufenthaltsdaten überschneiden. any: Die Steuer wird auf alle Übernachtungen im Reiseplan angewendet, wenn sich ein Datum im Reiseplan mit einem Datum im Aufenthaltszeitraum überschneidet. overlap: Die Steuer wird nur auf die Übernachtungen im Reiseplan angewendet, die sich mit einem Datum im Aufenthaltszeitraum überschneiden. Hinweis: overlap ist nur gültig, wenn <Period> auf night festgelegt ist. Dieses Attribut muss immer angegeben werden.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange	1..99	DateRange	Ein Zeitraum, der angibt, wann die Steuer angewendet werden soll.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @start	0..1	Date	Das einschließliche Startdatum (basierend auf der Zeitzone der Unterkunft) des Zeitraums. Dieses Datum muss vor dem end-Datum liegen oder mit diesem übereinstimmen. Wird start nicht angegeben, ist der Zeitraum in Bezug auf das Startdatum prinzipiell unbegrenzt.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @end	0..1	Date	Das einschließliche Enddatum (basierend auf der Zeitzone der Unterkunft) des Zeitraums. Dieses Datum muss nach dem start-Datum liegen oder mit diesem übereinstimmen. Wird end nicht angegeben, ist der Zeitraum in Bezug auf das Enddatum nahezu unbegrenzt.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @days_of_week	0..1	string	Die Wochentage, die im Zeitraum zulässig sind. Wenn nicht angegeben, sind alle Tage im Zeitraum zulässig. Jedes Zeichen im String gibt einen Tag an. Beispielsweise gibt „MTWHF“ an, dass Wochentage im Zeitraum zulässig sind. Gültige Zeichen sind: M für Montag T für Dienstag W für Mittwoch H für Donnerstag F für Freitag S für Samstag U für Sonntag Jede Zeichenkombination ist gültig.
TaxFeeInfo / Property / Taxes / Tax / Type	1	enum	Gültige Werte sind: percent: Ein Prozentsatz des Gesamtpreises amount: Ein Pauschalbetrag, der zum Endpreis hinzugerechnet wird cumulative_percent: Ein Prozentsatz des Gesamtpreises, der Steuern und Gebühren, die vor der Berechnung dieser Steuer oder Gebühr angefallen sind. Wenn dieser Wert angegeben ist, muss auch <Rank> angegeben werden. <Brackets> und <AgeBrackets> dürfen nicht mit cumulative_percent als Typ angegeben werden.
TaxFeeInfo / Property / Taxes / Tax / Basis	1	enum	Gültige Werte sind: room: Der <Amount> wird auf das Zimmer angewendet. person: Die <Amount> gelten pro Person. Dieser Wert gilt nur, wenn <Type> auf einen Betrag festgelegt ist.
TaxFeeInfo / Property / Taxes / Tax / Period	1	enum	Gültige Werte sind: stay: Der <Amount> wird zum Gesamtpreis des Aufenthalts hinzugefügt. night: Der <Amount> wird pro Nacht des Aufenthalts hinzugefügt.
TaxFeeInfo / Property / Taxes / Tax / Currency	0..1	string	Der dreistellige Währungscode für die Steuer (z. B. USD). Hinweis: Wenn <Currency> nicht angegeben ist, aber <Amount>, wird der Wert für <Currency> standardmäßig auf die Währung des Basiszinssatzes festgelegt.
TaxFeeInfo / Property / Taxes / Tax / Amount	0..1	float	Der Wert des Prozentsatzes oder Betrags der Steuer.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights	0..1	ApplicableNights	Dieser Wert gilt nur, wenn <Type> auf amount und <Period> auf night festgelegt ist. Beschränkt die Anzahl der Übernachtungen, für die eine Steuer angewendet werden kann. Geben Sie entweder max oder excluded an, aber nicht beides.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @max	0..1	integer	<ApplicableNights max="N"> gibt an, dass N Nächte nach der ersten Nacht ausgeschlossen werden sollen.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @excluded	0..1	integer	<ApplicableNights excluded="N"> gibt an, dass die ersten N Nächte ausgeschlossen werden sollen.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay	0..1	LengthOfStay	Definiert die Mindest- und Höchstwerte der Aufenthaltsdauer, innerhalb derer diese Steuer angewendet werden kann. Die Steuer wird nicht angewendet, wenn die Aufenthaltsdauer außerhalb der Mindest- und Höchstwerte liegt.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay / @min	0..1	integer	Die Mindestanzahl von Übernachtungen, die während des Aufenthalts erlaubt sind, damit die Steuer angewendet wird. Falls nicht angegeben, gibt es keine Mindestanzahl.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay / @max	0..1	integer	Die maximale Anzahl von Übernachtungen, die während des Aufenthalts erlaubt sind, damit die Steuer angewendet wird. Wird keine Angabe gemacht, gibt es kein Maximum.
TaxFeeInfo / Property / Taxes / Tax / Brackets	0..1	Brackets	Container für ein oder mehrere <Bracket>-Elemente. Definiert eine Reihe von zusammenhängenden und nicht überlappenden Steuerklassen. Beispiel: GST-Steuergruppe für Indien. Dieses Element ist nur gültig, wenn <Period> auf night gesetzt und <Amount> nicht angegeben ist.
TaxFeeInfo / Property / Taxes / Tax / Brackets / @base_amount	0..1	float	Der Wert des Prozentsatzes oder Betrags der Steuer, der auf Übernachtungspreise angewendet wird, die unter dem starts_at-Wert der ersten Klasse liegen.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket	1..n	Bracket	Definiert eine Steuerklasse auf Basis der Übernachtungspreise.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @starts_at	1	float	Definiert die Untergrenze einer Steuerklasse. Die Obergrenze wird im Feld starts_at der nachfolgenden Klasse angegeben. Es gibt keine Obergrenze für die letzte Klasse. Eine Steuerklasse ist aktiv, wenn der Übernachtungspreis größer oder gleich dem starts_at-Wert der Klasse und kleiner als der starts_at-Wert der nachfolgenden Klasse ist. Dieser Wert muss größer als 0 sein.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @amount	1	float	Der Wert des Prozentsatzes oder Betrags der für diese Steuerklasse geltenden Steuern.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets	0..1	AgeBrackets	Ermöglicht die Angabe einer Gruppe von Steuern, die auf dem Alter der Belegungen basieren. Dieses Element ist nur gültig, wenn <Brackets> und <Amount> nicht angegeben sind, <Basis> auf person und <Type> auf amount gesetzt ist.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge	0..1	AdultCharge	Container zum Angeben von Steuern für Erwachsene.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge / @amount	1	float	Der Pauschalsteuerbetrag für Erwachsene.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets	0..1	ChildAgeBrackets	Container für ein oder mehrere <ChildAgeBracket>-Elemente.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket	1..n	ChildAgeBracket	Hier wird ein Altersbereich für Kinder und der entsprechende Steuerbetrag definiert.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @max_age	1	integer	Definiert die Obergrenze für das Alter eines Kindes. Die Untergrenze wird im Feld max_age + 1 der vorangegangenen Klammer angegeben. Sowohl die Ober- als auch die Untergrenze sind inbegriffen. Die Untergrenze für die erste Klammer ist 0. max_age muss zwischen 0 und 17 liegen (einschließlich).
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @amount	1	float	Der Pauschalbetrag der Steuer, der für Kinder in dieser Altersgruppe gilt.
TaxFeeInfo / Property / Taxes / Tax / UserCountries	0..1	UserCountries	Container zum Auflisten der Nutzerländer, in denen die Steuer ein- oder ausgeschlossen ist. Falls vorhanden, wird die Steuer nur für Nutzer aus den angegebenen Ländern ein- oder ausgeschlossen.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / @type	0..1	enum	Der Typ der UserCountries-Spezifikation. Gültige Werte sind include und exclude. Wenn „UserCountries“ type auf „include“ festgelegt ist, gilt die Steuer nur für Nutzer aus den aufgeführten Ländern. Wenn für „UserCountry“-type der Wert exclude lautet, gilt die Steuer nur für Nutzer außerhalb der aufgeführten Länder. Wenn „UserCountry“ (type) nicht konfiguriert ist, wird es als include behandelt und die Steuer gilt nur für Nutzer aus den aufgeführten Ländern.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country	1..n	Country	Definiert ein Land in der Liste der Nutzerländer.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country / @code	1	string	Einen CLDR-Ländercode wie DE oder FR. Bei einigen Ländern ist der CLDR-Ländercode nicht identisch mit dem aus zwei Buchstaben bestehenden ISO-Ländercode. Außerdem werden CLDR-Regionscodes nicht unterstützt.
TaxFeeInfo / Property / Taxes / Tax / Rank	1	integer	Ein Rang, der die Reihenfolge der Anwendung für diese Steuer oder Gebühr angibt. Ein Wert von 2 bedeutet beispielsweise, dass diese Steuer an zweiter Stelle angewendet wird. Dieses Element sollte immer angegeben werden, wenn <Type> auf cumulative_percent festgelegt ist. Im Allgemeinen gilt diese Reihenfolge sowohl für Steuern als auch für Gebühren. Doppelte Rangwerte sind bei Steuern und Gebühren zulässig. Dies kann jedoch zu undefiniertem Verhalten führen, bei dem Steuern und Gebühren willkürlich und kumulativ angewendet werden. Steuern und Gebühren ohne Rang werden vor allen Einträgen mit Rang angewendet. <Rank> muss zwischen 1 und 99 (einschließlich) liegen.
TaxFeeInfo / Property / Fees	0..1	Fees	Container für ein oder mehrere <Fee>-Elemente.
TaxFeeInfo / Property / Fees / Fee	1..n	Fee	Eine individuelle Gebühr, die für die Unterkunft gilt. Alle untergeordneten Elemente von <Tax> werden auch für <Fee> mit derselben Syntax unterstützt.

Beispiele

Pro Unterkunft sind nur bis zu 300 Einträge für Steuern und Gebühren zulässig. Im Beispiel „Steuern löschen“ erfahren Sie, wie Sie Steuern und Gebühren aus einer Unterkunft entfernen.

Einfache Nachricht

Eine einfache TaxFeeInfo-Nachricht:

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

Hinweis: Wenn <Currency> nicht angegeben ist, aber <Amount> angegeben ist, wird für den Wert <Currency> standardmäßig die Währung des Basispreises verwendet.

Steuern löschen

So löschen Sie alle Steuern und Gebühren auf Unterkunftsebene für das angegebene Hotel:

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

Steuergruppe

Die indische GST-Steuergruppe, die basierend auf den Übernachtungspreisen angewendet wird. Die Steuerklassen sind:

• Keine Steuern, wenn der Übernachtungspreis kleiner oder gleich 1.000 ist.
• 12% Steuern, wenn der Übernachtungspreis größer als 1.000 und kleiner oder gleich 7.500 ist.
• 18% Steuern, wenn der Übernachtungspreis über 7.500 liegt.

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

Altersabhängige Steuern

Die Steuern richten sich nach dem Alter der Gäste:

• 20 $ Steuer für Erwachsene.
• 10 $ Steuern für Kinder zwischen 11 und 17 Jahren.
• 5 $ Steuer für Kinder zwischen 0 und 10 Jahren.

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

Antworten

Syntax

Die Nachricht TaxFeeInfoResponse verwendet die folgende Syntax:

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

Elemente und Attribute

Die Nachricht TaxFeeInfoResponse enthält folgende Elemente und Attribute:

Element / @Attribut	Häufigkeit	Typ	Beschreibung
TaxFeeInfoResponse	1	Complex element	Das Stammelement, das den Erfolg oder Probleme für eine empfangene TaxFeeInfo-Anfragenachricht angibt.
TaxFeeInfoResponse / @timestamp	1	DateTime	Erstellungsdatum und -uhrzeit der Nachricht.
TaxFeeInfoResponse / @id	1	string	Die eindeutige Kennung der zugehörigen TaxFeeInfo-Nachricht.
TaxFeeInfoResponse / @partner	1	string	Das Partnerkonto für diese Nachricht.
TaxFeeInfoResponse / Success	0..1	Success	Gibt an, dass die TaxFeeInfo-Nachricht ohne Warnungen oder Fehler erfolgreich verarbeitet wurde. Entweder <Success> oder <Issues> ist in jeder Nachricht enthalten.
TaxFeeInfoResponse / Issues	0..1	Issues	Ein Container für ein oder mehrere Probleme, die bei der Verarbeitung der Nachricht TaxFeeInfo aufgetreten sind. Entweder <Success> oder <Issues> ist in jeder Nachricht enthalten.
TaxFeeInfoResponse / Issues / Issue	1..n	Issue	Die Beschreibung einer Warnung oder eines Fehlers, der bei der Verarbeitung der TaxFeeInfo-Nachricht aufgetreten ist. Details zu diesen Problemen finden Sie unter Fehlermeldungen zum Feedstatus.
TaxFeeInfoResponse / Issues / Issue / @code	1	integer	Die Kennung des Problems.
TaxFeeInfoResponse / Issues / Issue / @status	1	enum	Die Art des Problems. Gültige Werte sind warning, error und failure .

Beispiele

Erfolg

Im Folgenden finden Sie eine Antwort auf eine erfolgreich verarbeitete TaxFeeInfo-Nachricht.

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

Probleme

Im Folgenden finden Sie eine Antwort auf eine TaxFeeInfo-Nachricht, die aufgrund von Fehlern nicht verarbeitet wurde.

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