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>

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 Nachricht definiert sind Property.
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. Zulässige Zeichen sind a-z, A-Z, 0-9, _ (Unterstrich) und - (Bindestrich).
TaxFeeInfo / @partner 1 string Das Partnerkonto für diese Nachricht. Dieser Zeichenfolgenwert ist der „Partnerschlüssel“ Wert aufgelistet auf die Seite „Kontoeinstellungen“ im Hotel Center.

Hinweis: Wenn Sie ein Back-End haben, das Feeds für mehreren Konten besteht, muss dieser Wert mit dem Wert ID übereinstimmen. in <RequestorID> angegebener Attributwert deines <OTA_HotelRateAmountNotifRQ> und <OTA_HotelAvailNotifRQ> Nachrichten für dasselbe Konto.

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. Nur overlay ist unterstützt und der Standardwert ist overlay. Alle vorherigen Taxes und Fees werden für diese Property gelöscht.
TaxFeeInfo / Property / ID 1 string Die eindeutige Kennung für die Unterkunft. Dieser Wert muss mit der Mit <id> angegebene Hotel-ID in das Element <listing> im Hotel Listenfeed. 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 <RoomType> angewendet angegeben ist. Wenn <RoomTypes> nicht angegeben ist, wird der gilt für alle Zimmer die Steuer.
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType 1..n RoomType Gibt einen Zimmertyp an. Ein Zimmertyp wird in einem <RoomData>-Element in einem Transaktion (Unterkunftsdaten) und als RoomID identifiziert wird. (Die Der Wert <RoomID> wird auch vom Attribut „InvTypeCode“ in OTA_HotelRateAmountNotifRQ messages.)
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType / @id 1 string Die eindeutige Kennung für das Inventar (Zimmertyp). Dieser Wert wird zugeordnet an <RoomID> in einer Transaktion (Unterkunftsdaten) angezeigt. Es sind maximal Zeichen zulässig: 50.
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, wird die Steuer gilt für alle Preispläne.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan 1..n RatePlan Gibt einen Preisplan an. Ein Preisplan wird durch eine Kombination Paket, Preise und Verfügbarkeit, wie in „Transaktion“ definiert (Unterkunftsdaten), OTA_HotelRateAmountNotifRQ und OTA_HotelAvailNotifRQ Nachrichten und wie durch die PackageID identifiziert.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan / @id 1 string Die eindeutige Kennung für den Preisplan. Dieser Wert wird der PackageID-Wert im Nachricht Transaktion (Unterkunftsdaten) <PackageData> und RatePlanCode-Wert, der unter der <StatusApplicationControl>-Attribut in beiden <OTA_HotelRateAmountNotifRQ> und <OTA_HotelAvailNotifRQ> Nachrichten. 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 erfolgen, 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.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @start 0..1 Date Das Startdatum (basierend auf der Zeitzone der Unterkunft), einschließlich, von Zeitraum Dieses Datum muss vor dem end Datum. Wenn start nicht angegeben ist, wird das Datum ist in Bezug auf ein Startdatum praktisch unbegrenzt.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @end 0..1 Date Das Enddatum (basierend auf der Zeitzone der Unterkunft), einschließlich des Enddatums des Zeitraum. Dieses Datum muss mit dem Datum „start“ übereinstimmen oder danach liegen Datum. Wenn end nicht angegeben ist, wird das Datum Der Zeitraum ist in Bezug auf ein Enddatum praktisch unbegrenzt.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @days_of_week 0..1 string

Die Wochentage, die im Zeitraum zulässig sind. Falls nicht angegeben ist, sind im Zeitraum alle Tage zulässig. Jedes in der Zeichenfolge einen Tag angibt. Beispiel: „MTWHF“ gibt 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 ein Check-in erfolgen muss auftreten, 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 werden.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @start 0..1 Date Das Startdatum (basierend auf der Zeitzone der Unterkunft), einschließlich, von Zeitraum Dieses Datum muss vor dem end Datum. Wenn start nicht angegeben ist, wird das Datum ist in Bezug auf ein Startdatum praktisch unbegrenzt.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @end 0..1 Date Das Enddatum (basierend auf der Zeitzone der Unterkunft), einschließlich des Enddatums des Zeitraum. Dieses Datum muss mit dem Datum „start“ übereinstimmen oder danach liegen Datum. Wenn end nicht angegeben ist, wird das Datum Der Zeitraum ist in Bezug auf ein Enddatum praktisch unbegrenzt.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @days_of_week 0..1 string

Die Wochentage, die im Zeitraum zulässig sind. Falls nicht angegeben ist, sind im Zeitraum alle Tage zulässig. Jedes in der Zeichenfolge einen Tag angibt. Beispiel: „MTWHF“ gibt 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 den Check-out definieren muss eintreten, 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 werden.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @start 0..1 Date Das Startdatum (basierend auf der Zeitzone der Unterkunft), einschließlich, von Zeitraum Dieses Datum muss vor dem end Datum. Wenn start nicht angegeben ist, wird das Datum ist in Bezug auf ein Startdatum praktisch unbegrenzt.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @end 0..1 Date Das Enddatum (basierend auf der Zeitzone der Unterkunft), einschließlich des Enddatums des Zeitraum. Dieses Datum muss mit dem Datum „start“ übereinstimmen oder danach liegen Datum. Wenn end nicht angegeben ist, wird das Datum Der Zeitraum ist in Bezug auf ein Enddatum praktisch unbegrenzt.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @days_of_week 0..1 string

Die Wochentage, die im Zeitraum zulässig sind. Falls nicht angegeben ist, sind im Zeitraum alle Tage zulässig. Jedes in der Zeichenfolge einen Tag angibt. Beispiel: „MTWHF“ gibt 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, wird die Steuer angewendet, z. B. bei saisonalen Rabatten.

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, wenn sich alle Datumsangaben im Reiseplan überschneiden mit den Aufenthaltsdaten.
  • any: Die Steuer gilt für alle Nächte im Reiseplan, wenn sich ein Datum im Reiseplan mit einem Datum im Aufenthaltszeitraum.
  • overlap: Die Steuer gilt nur für die Übernachtungen im Reiseplan, die sich mit einem Datum im Aufenthaltszeitraum überschneiden.

    Hinweis: overlap ist nur gültig, wenn <Period> ist auf night eingestellt.

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 Unterkunft), einschließlich, von Zeitraum Dieses Datum muss vor dem end Datum. Wenn start nicht angegeben ist, wird das Datum ist in Bezug auf ein Startdatum praktisch unbegrenzt.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @end 0..1 Date Das Enddatum (basierend auf der Zeitzone der Unterkunft), einschließlich des Enddatums des Zeitraum. Dieses Datum muss mit dem Datum „start“ übereinstimmen oder danach liegen Datum. Wenn end nicht angegeben ist, wird das Datum Der Zeitraum ist in Bezug auf ein Enddatum praktisch unbegrenzt.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @days_of_week 0..1 string

Die Wochentage, die im Zeitraum zulässig sind. Falls nicht angegeben ist, sind im Zeitraum alle Tage zulässig. Jedes in der Zeichenfolge einen Tag angibt. Beispiel: „MTWHF“ gibt 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 Prozent der Gesamtpreis, Steuern und Gebühren, die vor der Berechnung von diese Steuer oder Gebühr. Wenn dieser Wert angegeben ist, gilt: <Rank> müssen ebenfalls angegeben werden.
  • <Brackets> und <AgeBrackets> darf nicht angegeben werden mit cumulative_percent als Typ.

TaxFeeInfo / Property / Taxes / Tax / Basis 1 enum

Gültige Werte sind:

  • room: Die <Amount> wird auf den Raum 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: Das <Amount> wird hinzugefügt zu Der Gesamtpreis des Aufenthalts.
  • night: <Amount> wird hinzugefügt pro Übernachtung.
TaxFeeInfo / Property / Taxes / Tax / Currency 0..1 string Der dreistellige 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> sind auf Nacht.

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 es nachts nach den ersten N Nächten ausgeschlossen werden.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @excluded 0..1 integer <ApplicableNights excluded="N"> gibt an, dass der die ersten N Nächte ausgeschlossen werden sollen.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay 0..1 LengthOfStay Definiert die Längenbeschränkungen für die Aufenthaltsdauer, innerhalb derer diese Steuer angewendet werden kann. Die Steuer wird nicht angewendet, wenn die Aufenthaltsdauer außerhalb des Mindest- und Höchstwerts liegt Beschränkungen.
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. Wenn 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 zusammenhängender und nicht überlappender Steuerklassen. Beispiel: GST-Steuergruppe für Indien.

Dieses Element ist nur gültig, wenn für <Period> Folgendes festgelegt ist: night und <Amount> sind nicht angegeben.

TaxFeeInfo / Property / Taxes / Tax / Brackets / @base_amount 0..1 float Der Wert des Prozentsatzes oder Betrags der Steuern, der auf Übernachtungspreise angewendet wird unter dem starts_at-Wert der ersten Klammer.
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 ist im Feld starts_at der nachfolgenden Klammer angegeben. Für die letzte Klammer gibt es keine Obergrenze.

Eine Steuerklasse ist aktiv, wenn der Übernachtungspreis größer oder gleich ist auf den starts_at-Wert der Klammer und kleiner als den Wert starts_at der nachfolgenden Klammer.

Dieser Wert muss größer als 0 sein.

TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @amount 1 float Der Wert des Prozentsatzes oder Betrags der auf diese Steuerklasse angewendeten Steuern.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets 0..1 AgeBrackets Ermöglicht die Angabe eines Satzes von Steuern basierend auf den Informationen der Insassen Alter.

Dieses Element ist nur gültig, wenn <Brackets> und <Amount> sind nicht angegeben, <Basis> ist auf person eingestellt und <Type> ist auf amount gesetzt.

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 Pauschalsteuerbetrag für Erwachsene.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets 0..1 ChildAgeBrackets Container für eine oder mehrere <ChildAgeBracket> Elemente.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket 1..n ChildAgeBracket Definiert eine 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 ist im Feld max_age der vorangehenden Klammer + 1 angegeben. Sowohl die Ober- als auch die Untergrenze sind eingeschlossen. Die Untergrenze für die die erste Klammer 0 ist.

max_age muss im Bereich von 0 bis 17 (einschließlich) liegen.

TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @amount 1 float Der Pauschalsteuerbetrag, der auf Kinder in dieser Altersgruppe angewendet wird.
TaxFeeInfo / Property / Taxes / Tax / UserCountries 0..1 UserCountries Container zum Auflisten der Nutzerländer, für die die Steuer entweder eingeschlossen oder ausgeschlossen werden. Falls vorhanden, wird die Steuer nur angegeben oder für Nutzer in den angegebenen Ländern ausgeschlossen.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / @type 0..1 enum Der Typ der Usercountries-Spezifikation.

Gültige Werte sind include und exclude.

Wenn für das Nutzerland type folgender Wert festgelegt ist: include, gilt die Steuer nur für Nutzer aus den aufgeführten Ländern.

Wenn hingegen das Feld „UserCountry“ type den Wert exclude, gilt die Steuer nur für Nutzer außerhalb der aufgeführten Ländern.

Wenn das Feld „UserCountry“ (type) nicht konfiguriert ist, wird es wie folgt behandelt: include und die Steuern gelten 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 dasselbe wie der aus zwei Buchstaben bestehende ISO-Code 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 als Zweites angewendet wird. Dieses Element sollte immer angegeben werden, wenn <Type> auf cumulative_percent festgelegt. Im Allgemeinen ist diese Reihenfolge auf Steuern und Gebühren angewendet. Doppelte Rangwerte sind zulässig Dies kann jedoch undefiniertes Verhalten zur Folge haben, Steuern und Gebühren werden willkürlich und kumulativ angewendet. Steuern und Gebühren ohne Ränge werden vor allen bewerteten Beiträgen berechnet.

<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> sind auch wird für <Fee> mit derselben Syntax unterstützt.

Beispiele

Pro Unterkunft sind nur bis zu 300 Steuern und Gebühren zulässig. Weitere Informationen finden Sie im „Steuern löschen“ Beispiel, um Steuern und Gebühren aus einer Unterkunft zu entfernen.

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

Steuergruppe

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

  • Keine Steuern, wenn der Übernachtungspreis kleiner oder gleich 1.000 ist.
  • 12% Steuern, wenn der Übernachtungspreis über 1.000 liegt und unter oder liegt gleich 7.500.
  • 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

Je nach Alter der Personen werden Steuern erhoben:

  • 20 $ Steuern für Erwachsene.
  • 10 $ Steuern für Kinder zwischen 11 und 17 Jahren.
  • 5 $ Steuern 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 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 Folgendes: -Elemente und -Attribute:

Element / @Attribut Häufigkeit Typ Beschreibung
TaxFeeInfoResponse 1 Complex element Das Stammelement, das den Erfolg oder Probleme für eine empfangene Anfragenachricht für TaxFeeInfo.
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 erfolgreich verarbeitet wurde ohne Warnungen oder Fehler.

Entweder <Success> oder <Issues> ist Nachrichten enthalten.

TaxFeeInfoResponse / Issues 0..1 Issues Ein Container für ein oder mehrere Probleme, die bei der Verarbeitung der TaxFeeInfo-Nachricht.

Entweder <Success> oder <Issues> ist Nachrichten enthalten.

TaxFeeInfoResponse / Issues / Issue 1..n Issue Die Beschreibung einer Warnung oder eines Fehlers, der aufgetreten ist während der Verarbeitung der TaxFeeInfo-Nachricht. Details zu diesen Problemen finden Sie siehe 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 angezeigt.

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

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