Infos sur les taxes

Demandes

Syntaxe

Le message TaxFeeInfo utilise la syntaxe suivante:

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

Éléments et attributs

Le message TaxFeeInfo contient les éléments suivants et Attributs:

Élément / @Attribut Occurrences Type Description
TaxFeeInfo 1 Complex element Élément racine d'un message définissant les taxes et les frais pour un .
TaxFeeInfo / @timestamp 1 DateTime Date et heure de création de ce message.
TaxFeeInfo / @id 1 string Identifiant unique de ce message de requête. Cette valeur est renvoyée dans le message de réponse. Caractères autorisés : a-z, A-Z, 0-9 et _ (trait de soulignement) et - (trait d'union).
TaxFeeInfo / @partner 1 string Compte du partenaire pour ce message. Cette valeur de chaîne est la "Clé partenaire" valeur indiquée sur le <ph type="x-smartling-placeholder"></ph> Page "Paramètres du compte" dans Hotel Center.

Remarque:Si vous disposez d'un backend qui fournit des flux pour plusieurs comptes, cette valeur doit correspondre à l'ID spécifiée dans <RequestorID> de votre <OTA_HotelRateAmountNotifRQ> et <OTA_HotelAvailNotifRQ> messages pour le même compte.
TaxFeeInfo / Property 1..n Property Conteneur permettant de définir les taxes et les frais pour un seul établissement.
TaxFeeInfo / Property / @action 0..1 string Indique la manière dont la mise à jour est appliquée. Seul overlay est pris en charge, et la valeur par défaut est overlay. Toutes les valeurs précédentes Taxes et Fees pour cet établissement seront effacés avant l'application de cette mise à jour.
TaxFeeInfo / Property / ID 1 string Identifiant unique de l'établissement. Cette valeur doit correspondre au Identifiant de l'hôtel spécifié à l'aide de la balise <id> dans l'élément <listing> dans la section Flux de listes. L'ID de l'hôtel est également indiqué dans Hotel Center.
TaxFeeInfo / Property / Taxes 0..1 Taxes Conteneur pour un ou plusieurs éléments <Tax>.
TaxFeeInfo / Property / Taxes / Tax 1..n Tax Taxe individuelle qui s'applique à l'établissement.
TaxFeeInfo / Property / Taxes / Tax / RoomTypes 0..1 RoomTypes Conteneur pour la liste des types de chambres auxquels la taxe s'applique. La taxe est appliquée à chaque <RoomType> spécifié. Si <RoomTypes> n'est pas spécifié, le les taxes s'appliquent à toutes les chambres.
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType 1..n RoomType Spécifie un type de chambre. Un type de chambre est défini Élément <RoomData> dans une un message Transaction (Données sur un établissement), et comme identifié à l'aide de son RoomID. (Il est La valeur <RoomID> est également référencée par le Attribut InvTypeCode dans OTA_HotelRateAmountNotifRQ messages.)
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType / @id 1 string Identifiant unique de l'inventaire (type de chambre). Cette valeur correspond à <RoomID> dans une Transaction (Données sur un établissement). Le nombre maximal de caractères autorisé est de 50.
TaxFeeInfo / Property / Taxes / Tax / RatePlans 0..1 RatePlans Conteneur pour la liste des plans tarifaires auxquels la taxe s'applique. Si <RatePlans> n'est pas spécifié, la taxe s'applique à tous les plans tarifaires.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan 1..n RatePlan Spécifie un plan tarifaire. Un plan tarifaire est défini par une combinaison le forfait, les tarifs et la disponibilité, tels que définis dans l'article (Données sur un établissement), OTA_HotelRateAmountNotifRQ et OTA_HotelAvailNotifRQ et tel qu'identifié par le PackageID.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan / @id 1 string Identifiant unique du plan tarifaire. Cette valeur correspond au la valeur PackageID dans Les messages Transaction (Property Data) <PackageData> et la valeur RatePlanCode définie dans l'attribut <StatusApplicationControl> dans les deux <OTA_HotelRateAmountNotifRQ> et <OTA_HotelAvailNotifRQ> messages. Le nombre maximal de caractères autorisés est de 50.
TaxFeeInfo / Property / Taxes / Tax / BookingDates 0..1 BookingDates Conteneur pour une ou plusieurs plages de dates qui définissent le moment auquel la réservation doit se produire pour que la taxe soit appliquée.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange 1..99 DateRange Plage de dates indiquant le moment auquel la réservation doit être effectuée pour que la taxe soit appliquée appliquée.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @start 0..1 Date Date de début (en fonction du fuseau horaire de l'établissement), date de début incluse, la plage de dates. Cette date doit être antérieure ou identique à la date Date end. Si start n'est pas spécifié, la date est en fait illimitée en termes de date de début.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @end 0..1 Date Date de fin (en fonction du fuseau horaire de l'établissement), incluse, de l'événement la plage de dates. Cette date doit être identique ou postérieure au start la date de début. Si end n'est pas spécifié, la date est en réalité illimitée en termes de date de fin.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @days_of_week 0..1 string

Jours de la semaine autorisés dans la plage de dates. Si ce n'est pas le cas tous les jours sont autorisés dans la plage de dates. Chaque caractère de la chaîne indique un jour. Par exemple, « MTWHF ». spécifie que les jours de la semaine sont autorisés dans la plage de dates.

Les caractères suivants sont acceptés:

  • M pour lundi
  • T pour mardi
  • W pour mercredi
  • H pour jeudi
  • F pour vendredi
  • S pour samedi
  • U pour dimanche

Toute combinaison de caractères est valide.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates 0..1 CheckinDates Conteneur pour une ou plusieurs plages de dates qui définissent le moment auquel se produisent pour que la taxe soit appliquée.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange 1..20 DateRange Plage de dates indiquant à quel moment l'arrivée doit avoir lieu pour que la taxe soit applicable être appliqué.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @start 0..1 Date Date de début (en fonction du fuseau horaire de l'établissement), date de début incluse, la plage de dates. Cette date doit être antérieure ou identique à la date Date end. Si start n'est pas spécifié, la date est en fait illimitée en termes de date de début.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @end 0..1 Date Date de fin (en fonction du fuseau horaire de l'établissement), incluse, de l'événement la plage de dates. Cette date doit être identique ou postérieure au start la date de début. Si end n'est pas spécifié, la date est en réalité illimitée en termes de date de fin.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @days_of_week 0..1 string

Jours de la semaine autorisés dans la plage de dates. Si ce n'est pas le cas tous les jours sont autorisés dans la plage de dates. Chaque caractère de la chaîne indique un jour. Par exemple, « MTWHF ». spécifie que les jours de la semaine sont autorisés dans la plage de dates.

Les caractères suivants sont acceptés:

  • M pour lundi
  • T pour mardi
  • W pour mercredi
  • H pour jeudi
  • F pour vendredi
  • S pour samedi
  • U pour dimanche

Toute combinaison de caractères est valide.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates 0..1 CheckoutDates Conteneur pour une ou plusieurs plages de dates qui définissent le moment du départ pour que la taxe soit appliquée.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange 1..20 DateRange Plage de dates indiquant à quel moment le départ doit avoir lieu pour que la taxe soit applicable être appliqué.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @start 0..1 Date Date de début (en fonction du fuseau horaire de l'établissement), date de début incluse, la plage de dates. Cette date doit être antérieure ou identique à la date Date end. Si start n'est pas spécifié, la date est en fait illimitée en termes de date de début.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @end 0..1 Date Date de fin (en fonction du fuseau horaire de l'établissement), incluse, de l'événement la plage de dates. Cette date doit être identique ou postérieure au start la date de début. Si end n'est pas spécifié, la date est en réalité illimitée en termes de date de fin.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @days_of_week 0..1 string

Jours de la semaine autorisés dans la plage de dates. Si ce n'est pas le cas tous les jours sont autorisés dans la plage de dates. Chaque caractère de la chaîne indique un jour. Par exemple, « MTWHF ». spécifie que les jours de la semaine sont autorisés dans la plage de dates.

Les caractères suivants sont acceptés:

  • M pour lundi
  • T pour mardi
  • W pour mercredi
  • H pour jeudi
  • F pour vendredi
  • S pour samedi
  • U pour dimanche

Toute combinaison de caractères est valide.
TaxFeeInfo / Property / Taxes / Tax / StayDates 0..1 StayDates

Conteneur pour une ou plusieurs plages de dates qui déterminent si la taxe est appliquée, par exemple pour tenir compte des remises saisonnières.
TaxFeeInfo / Property / Taxes / Tax / StayDates / @application 1 enum

Décrit comment la taxe doit être appliquée.

Les valeurs valides sont les suivantes :

  • all: applique la taxe à chaque nuit dans le séjour si toutes les dates du séjour se chevauchent avec les dates de séjour.
  • any: les taxes sont appliquées à toutes les nuits du séjour si une date du séjour chevauche une date du la plage de dates du séjour.
  • overlap: la taxe s'applique uniquement aux nuits de l'itinéraire qui chevauche une date de la plage de dates du séjour.

    Remarque: overlap n'est valide que lorsque <Period> est défini sur night.

Cet attribut doit toujours être spécifié.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange 1..99 DateRange Plage de dates indiquant les dates auxquelles la taxe doit être appliquée.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @start 0..1 Date Date de début (en fonction du fuseau horaire de l'établissement), date de début incluse, la plage de dates. Cette date doit être antérieure ou identique à la date Date end. Si start n'est pas spécifié, la date est en fait illimitée en termes de date de début.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @end 0..1 Date Date de fin (en fonction du fuseau horaire de l'établissement), incluse, de l'événement la plage de dates. Cette date doit être identique ou postérieure au start la date de début. Si end n'est pas spécifié, la date est en réalité illimitée en termes de date de fin.
TaxFeeInfo / Property / Taxes / Tax / StayDates / DateRange / @days_of_week 0..1 string

Jours de la semaine autorisés dans la plage de dates. Si ce n'est pas le cas tous les jours sont autorisés dans la plage de dates. Chaque caractère de la chaîne indique un jour. Par exemple, « MTWHF ». spécifie que les jours de la semaine sont autorisés dans la plage de dates.

Les caractères suivants sont acceptés:

  • M pour lundi
  • T pour mardi
  • W pour mercredi
  • H pour jeudi
  • F pour vendredi
  • S pour samedi
  • U pour dimanche

Toute combinaison de caractères est valide.
TaxFeeInfo / Property / Taxes / Tax / Type 1 enum

Les valeurs valides sont les suivantes :

  • percent: : pourcentage du tarif total
  • amount: : montant fixe à ajouter au tarif final
  • cumulative_percent: Un pour cent le tarif total, les taxes et les frais accumulés avant le calcul de cette taxe ou ces frais. Si cette valeur est spécifiée, <Rank> doit également être spécifié.

    • <Brackets> et <AgeBrackets> ne peut pas être spécifié avec cumulative_percent.
TaxFeeInfo / Property / Taxes / Tax / Basis 1 enum

Les valeurs valides sont les suivantes :

  • room: La <Amount> est appliquée à la salle.
  • person: Le <Amount> est appliqué par personne. Cette valeur ne s'applique que si <Type> est défini sur "amount" (montant).
TaxFeeInfo / Property / Taxes / Tax / Period 1 enum

Les valeurs valides sont les suivantes :

  • stay: Le <Amount> est ajouté à le tarif total du séjour.
  • night: Le <Amount> est ajouté par nuitée.
TaxFeeInfo / Property / Taxes / Tax / Currency 0..1 string Code de devise à trois lettres correspondant à la taxe (par exemple, USD).
TaxFeeInfo / Property / Taxes / Tax / Amount 0..1 float Valeur du pourcentage ou du montant de la taxe.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights 0..1 ApplicableNights Cette valeur ne s'applique que si <Type> est défini sur amount et <Period> sont définis sur nuit.

Limite le nombre de nuits pour lesquelles une taxe peut être appliquée.

Spécifiez max ou excluded, mais pas les deux.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @max 0..1 integer <ApplicableNights max="N"> indique que les nuits après les N premières nuits.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @excluded 0..1 integer <ApplicableNights excluded="N"> indique que le Les N premières nuits doivent être exclues.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay 0..1 LengthOfStay Définit la durée maximale de séjour pendant laquelle cette taxe peut être appliquée. La taxe n'est pas appliquée lorsque la durée du séjour est en dehors des valeurs minimale et maximale des limites.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay / @min 0..1 integer Nombre minimal de nuits autorisées dans le séjour pour que la taxe soit appliquée. Si cet attribut n'est pas spécifié, il n'y a pas de minimum.
TaxFeeInfo / Property / Taxes / Tax / LengthOfStay / @max 0..1 integer Nombre maximal de nuits autorisées dans le séjour pour que la taxe soit appliquée. Si cet attribut n'est pas spécifié, il n'y a pas de valeur maximale.
TaxFeeInfo / Property / Taxes / Tax / Brackets 0..1 Brackets Conteneur pour un ou plusieurs éléments <Bracket>. Définit un ensemble de tranches de taxes contiguës et qui ne se chevauchent pas. (par exemple, les tranches de taxe TPS indiennes).

Cet élément n'est valide que lorsque <Period> est défini sur Les champs night et <Amount> ne sont pas spécifiés.
TaxFeeInfo / Property / Taxes / Tax / Brackets / @base_amount 0..1 float Valeur du pourcentage ou du montant de taxe, appliquée aux tarifs par nuit sous la valeur starts_at de la première parenthèse.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket 1..n Bracket Définit une tranche de taxe en fonction des tarifs par nuit.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @starts_at 1 float

Définit la limite inférieure d'une tranche de taxe. La limite supérieure est spécifié dans le champ starts_at de la plage suivante. Il n'y a pas de limite supérieure pour la dernière tranche.

Une tranche de taxe est active lorsque le tarif par nuit est supérieur ou égal à la valeur starts_at de la parenthèse, et strictement inférieure à la valeur starts_at de la plage suivante.

Cette valeur doit être strictement supérieure à 0.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket / @amount 1 float Valeur du pourcentage ou du montant de taxe appliqué à cette tranche de taxe.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets 0..1 AgeBrackets Permet de spécifier un ensemble de taxes en fonction des taxes âges.

Cet élément n'est valide que lorsque <Brackets> et <Amount> ne sont pas spécifiés, <Basis> est défini sur person et La valeur de <Type> est amount.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge 0..1 AdultCharge Conteneur permettant de spécifier les taxes pour les adultes.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / AdultCharge / @amount 1 float Montant fixe de la taxe appliquée pour les adultes.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets 0..1 ChildAgeBrackets Conteneur pour un ou plusieurs <ChildAgeBracket> éléments.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket 1..n ChildAgeBracket Définit une tranche d'âge pour les enfants et le montant de taxe correspondant.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @max_age 1 integer

Définit la limite supérieure de l'âge d'un enfant. La limite inférieure est spécifié dans le champ max_age de la parenthèse précédente + 1. Les limites supérieure et inférieure sont toutes deux incluses. La limite inférieure de première parenthèse est 0.

max_age doit être compris entre 0 et 17 (inclus).
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket / @amount 1 float Montant fixe de la taxe appliquée aux enfants de cette tranche d'âge.
TaxFeeInfo / Property / Taxes / Tax / UserCountries 0..1 UserCountries Conteneur permettant de lister les pays des utilisateurs pour lesquels la taxe est : incluses ou exclues. Si elle est présente, la taxe sera uniquement incluse ou exclu pour les utilisateurs des pays spécifiés.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / @type 0..1 enum Type de spécification UserCountries.

Les valeurs valides sont include et exclude

Si la propriété UserCountries type est définie sur include, la taxe ne s'appliquera qu'aux utilisateurs résidant pays listés.

En revanche, si type est défini sur "UserCountries" exclude, la taxe ne s'appliquera qu'aux utilisateurs situés en dehors pays listés.

Si la valeur type UserCountries n'est pas définie, nous la traitons comme include et la taxe ne s'appliquera qu'aux utilisateurs situés dans le pays listés.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country 1..n Country Définit un pays dans la liste UserCountries.
TaxFeeInfo / Property / Taxes / Tax / UserCountries / Country / @code 1 string Un code pays CLDR comme DE ou FR. Notez que, pour certains pays, le code pays CLDR n'est pas le même que les codes ISO à deux lettres code pays. De plus, les codes de région CLDR ne sont pas acceptés.
TaxFeeInfo / Property / Taxes / Tax / Rank 1 integer

Classement indiquant l'ordre d'application de cette taxe ou de ces frais. Par exemple, la valeur 2 signifie que la taxe est appliquée en deuxième. Cet élément doit toujours être spécifié si <Type> est définie sur cumulative_percent. En général, cet ordre est appliquées à la fois aux taxes et aux frais. Les valeurs de classement en double sont autorisées entre les taxes et les frais, mais cela peut entraîner un comportement non défini les taxes et les frais seront appliqués de manière arbitraire et cumulative. Les taxes et les frais sans classement sont appliqués avant chaque entrée de classement.

<Rank> doit être compris entre 1 et 99 (inclus).

TaxFeeInfo / Property / Fees 0..1 Fees Conteneur pour un ou plusieurs éléments <Fee>.
TaxFeeInfo / Property / Fees / Fee 1..n Fee

Frais individuels qui s'appliquent à l'établissement.

Tous les éléments enfants de <Tax> sont également pris en charge pour <Fee> avec la même syntaxe.

Exemples

La limite est de 300 taxes et frais par établissement. Consultez le "Supprimer les taxes" par exemple pour supprimer les taxes et les frais d'un établissement.

Message de base

Un message TaxFeeInfo de base:

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

Supprimer les taxes

Supprimez tous les frais et taxes au niveau de l'établissement pour l'hôtel spécifié:

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

Tranches de taxes

Taxe indienne sur les produits et services (TPS) appliquée en fonction des tarifs par nuit. Tranches de taxe sont:

  • Aucune taxe si le tarif par nuit est inférieur ou égal à 1 000.
  • 12% de taxe si le tarif par nuit est supérieur à 1 000 et inférieur à égal à 7 500.
  • 18% de taxe si le tarif par nuit est supérieur à 7 500.
<?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>

Taxes basées sur l'âge

Taxes appliquées en fonction de l'âge des occupants:

  • Taxe de 20 $ pour les adultes.
  • Taxe de 10 $ pour les enfants âgés de 11 à 17 ans.
  • Taxe de 5 $ pour les enfants âgés de 0 à 10 ans.
<?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>

Réponses

Syntaxe

Le message TaxFeeInfoResponse utilise la syntaxe suivante:

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

Éléments et attributs

Le message TaxFeeInfoResponse contient les éléments suivants : éléments et attributs:

Élément / @Attribut Occurrences Type Description
TaxFeeInfoResponse 1 Complex element Élément racine indiquant le succès ou les problèmes d'une réponse Message de requête TaxFeeInfo.
TaxFeeInfoResponse / @timestamp 1 DateTime Date et heure de création de ce message.
TaxFeeInfoResponse / @id 1 string Identifiant unique du message TaxFeeInfo associé.
TaxFeeInfoResponse / @partner 1 string Compte du partenaire pour ce message.
TaxFeeInfoResponse / Success 0..1 Success Indique que le message TaxFeeInfo a bien été traité sans avertissement, erreur ni échec.

<Success> ou <Issues> est présentes dans chaque message.
TaxFeeInfoResponse / Issues 0..1 Issues Conteneur pour un ou plusieurs problèmes rencontrés lors du traitement de la Message TaxFeeInfo.

<Success> ou <Issues> est présentes dans chaque message.
TaxFeeInfoResponse / Issues / Issue 1..n Issue La description d'un avertissement, d'une erreur ou d'un échec rencontré pendant le traitement du message TaxFeeInfo. Pour en savoir plus sur ces problèmes, dans Messages d'erreur concernant l'état du flux.
TaxFeeInfoResponse / Issues / Issue / @code 1 integer Identifiant du problème.
TaxFeeInfoResponse / Issues / Issue / @status 1 enum

Type de problème rencontré.

Les valeurs valides sont warning, error, et failure .

Exemples

Opération réussie

Voici une réponse à une erreur TaxFeeInfo correctement traitée .

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

Problèmes

La réponse ci-dessous est une réponse à un message TaxFeeInfo non traité en raison de les erreurs.

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