Diese Seite wurde von der Cloud Translation API übersetzt.

TaxFeeInfo (Steuerinformationen)

Anfragen

Syntax

Die TaxFeeInfo-Nachricht 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]</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>
      </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]</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>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

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, mit der die Steuern und Gebühren für eine einzelne Property definiert werden.
TaxFeeInfo / @timestamp	1	DateTime	Erstellungsdatum und -uhrzeit dieser 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 den „Partnerschlüssel“, der im Hotel Center auf der Seite Kontoeinstellungen aufgeführt ist. Hinweis:Wenn du ein Back-End hast, das Feeds für mehrere Konten bereitstellt, muss dieser Wert mit dem Attributwert `ID` übereinstimmen, der im `<RequestorID>`-Element deiner `<OTA_HotelRateAmountNotifRQ>`- und `<OTA_HotelAvailNotifRQ>`-Nachrichten für dasselbe Konto angegeben ist.
TaxFeeInfo / Property	1..n	Property	Ein Container zum Definieren von Steuern und Gebühren für eine einzelne Property.
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 diese Aktualisierung angewendet wird.
TaxFeeInfo / Property / ID	1	string	Die eindeutige Kennung für die Unterkunft. Dieser Wert muss mit der Hotel-ID übereinstimmen, die mit <id> im Element <listing> im Hotellistenfeed angegeben wird. 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 auf die Unterkunft anfällt.
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 jedes angegebene `<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 einer Transaktion (Unterkunftsdaten) definiert und anhand seiner RoomID identifiziert. In `OTA_HotelRateAmountNotifRQ`-Nachrichten wird auch auf das Attribut `<RoomID>` durch das Attribut `InvTypeCode` verwiesen.
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 Transaktions-(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 `<PackageData>` in einer Transaktion (Unterkunftsdaten) und im Attribut `RatePlanCode` in `<StatusApplicationControl>` in den Nachrichten `<OTA_HotelRateAmountNotifRQ>` und `<OTA_HotelAvailNotifRQ>` zugeordnet. 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 festlegen, wann eine Buchung erfolgen muss, damit die Steuer angewendet werden kann.
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 Startdatum (basierend auf der Zeitzone der Property), einschließlich des Zeitraums. Dieses Datum muss vor dem `end`-Datum liegen oder diesem entsprechen. 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 Enddatum (einschließlich der Zeitzone der Property), einschließlich des Zeitraums. Dieses Datum muss dem `start`-Datum entsprechen oder danach liegen. Wenn `end` nicht angegeben ist, ist der Zeitraum in Bezug auf das Enddatum praktisch 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. „MTWHF“ gibt beispielsweise an, dass an Tagen im Zeitraum entsprechende Daten 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 Alle Zeichenkombinationen sind gültig.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates	0..1	CheckinDates	Ein Container für einen oder mehrere Zeiträume, die definieren, wann ein 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 Startdatum (basierend auf der Zeitzone der Property), einschließlich des Zeitraums. Dieses Datum muss vor dem `end`-Datum liegen oder diesem entsprechen. Wenn `start` nicht angegeben ist, ist der Zeitraum in Bezug auf das Startdatum praktisch unbegrenzt.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @end	0..1	Date	Das Enddatum (einschließlich der Zeitzone der Property), einschließlich des Zeitraums. Dieses Datum muss dem `start`-Datum entsprechen oder danach liegen. Wenn `end` nicht angegeben ist, ist der Zeitraum in Bezug auf das Enddatum praktisch 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. „MTWHF“ gibt beispielsweise an, dass an Tagen im Zeitraum entsprechende Daten 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 Alle Zeichenkombinationen sind 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 der Check-out erfolgen muss, damit die Steuer angewendet wird.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @start	0..1	Date	Das Startdatum (basierend auf der Zeitzone der Property), einschließlich des Zeitraums. Dieses Datum muss vor dem `end`-Datum liegen oder diesem entsprechen. 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 Enddatum (einschließlich der Zeitzone der Property), einschließlich des Zeitraums. Dieses Datum muss dem `start`-Datum entsprechen oder danach liegen. Wenn `end` nicht angegeben ist, ist der Zeitraum in Bezug auf das Enddatum praktisch 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. „MTWHF“ gibt beispielsweise an, dass an Tagen im Zeitraum entsprechende Daten 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 Alle Zeichenkombinationen sind 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`: Wendet die Steuern auf jede Nacht im Reiseplan an, 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 für `<Period>` der Wert `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 Startdatum (basierend auf der Zeitzone der Property), einschließlich des Zeitraums. Dieses Datum muss vor dem `end`-Datum liegen oder diesem entsprechen. Wenn `start` nicht angegeben ist, ist der Zeitraum in Bezug auf das Startdatum praktisch unbegrenzt.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @end	0..1	Date	Das Enddatum (einschließlich der Zeitzone der Property), einschließlich des Zeitraums. Dieses Datum muss dem `start`-Datum entsprechen oder danach liegen. Wenn `end` nicht angegeben ist, ist der Zeitraum in Bezug auf das Enddatum praktisch 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. „MTWHF“ gibt beispielsweise an, dass an Tagen im Zeitraum entsprechende Daten 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 Alle Zeichenkombinationen sind gültig.
TaxFeeInfo / Property / Taxes / Tax / Type	1	enum	Gültige Werte sind: `percent:` % des Gesamtpreises `amount:` Ein Pauschalbetrag, der dem Endpreis hinzugefügt werden soll
TaxFeeInfo / Property / Taxes / Tax / Basis	1	enum	Gültige Werte sind: `room:` `<Amount>` wird auf das Zimmer angewendet. `person:` Der `<Amount>` wird pro Person angewendet. Dieser Wert gilt nur, wenn für `<Type>` der Betrag festgelegt wurde.
TaxFeeInfo / Property / Taxes / Tax / Period	1	enum	Gültige Werte sind: `stay:` Der `<Amount>` wird zum Gesamtpreis des Aufenthalts addiert. `night:` Der `<Amount>` wird pro Nacht des Aufenthalts hinzugefügt.
TaxFeeInfo / Property / Taxes / Tax / Currency	0..1	string	Der aus drei Buchstaben bestehende Währungscode für die Steuer (z. B. USD).
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, auf 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ächte nach den ersten N Nächten 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 Aufenthaltsdauer, in der 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 an Übernachtungen im Aufenthalt, damit die Steuern angewendet werden. Wenn dies nicht angegeben ist, gibt es keine Mindestanzahl.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay / @max	0..1	integer	Die maximale Anzahl an Übernachtungen im Aufenthalt, damit die Steuern angewendet werden. Wenn dies nicht angegeben ist, gibt es keine Begrenzung.
TaxFeeInfo / Property / Taxes / Tax / Brackets	0..1	Brackets	Container für ein oder mehrere `<Bracket>`-Elemente. Definiert eine Reihe zusammenhängender und nicht überlappende Steuerklammern, z.B. die indischen GST-Steuern. 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 Wert von `starts_at` in der ersten Klammer liegen.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket	1..n	Bracket	Definiert eine Steuerklasse, die auf nächtlichen Preisen basiert.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @starts_at	1	float	Definiert die Untergrenze einer Steuerklasse. Die Obergrenze wird im Feld `starts_at` der nachfolgenden Klammer angegeben. Es gibt keine Obergrenze für die letzte Klammer. Eine Steuergruppe ist aktiv, wenn der Übernachtungspreis größer oder gleich dem Wert von `starts_at` und genau kleiner als der Wert von `starts_at` der nachfolgenden Klammer 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 Steuer, der auf diese Steuerklasse angewendet wird.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets	0..1	AgeBrackets	Damit kann eine Reihe von Steuern angegeben werden, die auf dem Alter der Bewohner 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 zur Angabe von Steuern für Erwachsene.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge / @amount	1	float	Der Pauschalsteuersatz 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	Definiert die Altersgruppe für Kinder und den entsprechenden Steuerbetrag.
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 vorherigen Klammer angegeben. Die Ober- und Untergrenzen sind beide eingeschlossen. Die Untergrenze für die erste Klammer ist 0. `max_age` muss im Bereich von 0 bis 17 liegen.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @amount	1	float	Der Pauschalsteuersatz für Kinder in diesem Alter.
TaxFeeInfo / Property / Taxes / Tax / UserCountries	0..1	UserCountries	Container zum Auflisten der Nutzerländer, in denen die Steuern enthalten sind oder ausgeschlossen sind. Sofern vorhanden, wird die Steuer nur für Nutzer in den angegebenen Ländern ein- oder ausgeschlossen.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / @type	0..1	enum	Typ der UserCountry-Spezifikation Gültige Werte sind `include` und `exclude`. Wenn für die `type` des Nutzers „`include`“ festgelegt ist, gilt die Steuer nur für Nutzer aus den aufgeführten Ländern. Wenn jedoch die `type` für Nutzerländer `exclude` ist, gilt die Steuer nur für Nutzer außerhalb der aufgeführten Länder. Wenn die `type` der Nutzerländer nicht konfiguriert ist, wird sie 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	Ein CLDR-Ländercode, z. B. `DE` oder `FR`. Bei einigen Ländern ist der CLDR-Ländercode nicht mit dem zweistelligen ISO-Ländercode identisch. Außerdem werden CLDR-Regionscodes nicht unterstützt.
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

Einfache Nachricht

Eine einfache TaxFeeInfo-Nachricht:

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

Steuern löschen

Alle Steuern und Gebühren auf Hotelebene für das angegebene Hotel löschen:

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

Plattensteuer

Indische GST-Steuer auf der Grundlage der Übernachtungspreise. Die Klammern 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="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>

Altersabhängige Steuern

Steuern basierend auf dem Alter der Bewohner:

20 $ Steuern für erwachsene Personen.
10 $ Steuern für Kinder zwischen 11 und 17 Jahren.
5 $ für Kinder zwischen 0 und 10 Jahren

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

Antworten

Syntax

Die TaxFeeInfoResponse-Nachricht 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 die folgenden Elemente und Attribute:

Element / @Attribut	Häufigkeit	Typ	Beschreibung
TaxFeeInfoResponse	1	Complex element	Das Stammelement, das den Erfolg oder Probleme einer empfangenen TaxFeeInfo-Anfragenachricht angibt.
TaxFeeInfoResponse / @timestamp	1	DateTime	Erstellungsdatum und -uhrzeit dieser Nachricht.
TaxFeeInfoResponse / @id	1	string	Die eindeutige Kennung aus 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 verarbeitet wurde. In jeder Nachricht ist entweder `<Success>` oder `<Issues>` enthalten.
TaxFeeInfoResponse / Issues	0..1	Issues	Ein Container für ein oder mehrere Probleme, die bei der Verarbeitung der Nachricht `TaxFeeInfo` aufgetreten sind. In jeder Nachricht ist entweder `<Success>` oder `<Issues>` enthalten.
TaxFeeInfoResponse / Issues / Issue	1..n	Issue	Die Beschreibung einer Warnung, eines Fehlers oder eines Fehlers, die bei der Verarbeitung der TaxFeeInfo-Nachricht aufgetreten ist. Details zu diesen Problemen finden Sie unter Feedstatus-Fehlermeldungen.
TaxFeeInfoResponse / Issues / Issue / @code	1	integer	Die ID des Problems.
TaxFeeInfoResponse / Issues / Issue / @status	1	enum	Die Art des aufgetretenen 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="2020-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 wird.

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