Cette page a été traduite par l'API Cloud Translation.

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 inclut les éléments et les attributs suivants :

É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 seul établissement.
TaxFeeInfo / @timestamp	1	DateTime	Date et heure de création de ce message.
TaxFeeInfo / @id	1	string	Identifiant unique pour ce message de demande. Cette valeur est renvoyée dans le message de réponse. Les caractères autorisés sont `a-z`, `A-Z`, `0-9`, `_` (trait de soulignement) et `-` (trait d'union).
TaxFeeInfo / @partner	1	string	Compte partenaire pour ce message. Cette valeur de chaîne correspond à la valeur "Partner key" (Clé partenaire) indiquée sur la page Paramètres du compte dans Hotel Center. Remarque : Si vous avez un backend qui fournit des flux pour plusieurs comptes, cette valeur doit correspondre à la valeur de l'attribut `ID` spécifiée dans l'élément `<RequestorID>` de vos messages `<OTA_HotelRateAmountNotifRQ>` et `<OTA_HotelAvailNotifRQ>` pour le même compte.
TaxFeeInfo / Property	1..n	Property	Conteneur permettant de définir les taxes et les frais pour un même établissement.
TaxFeeInfo / Property / @action	0..1	string	Spécifie comment la mise à jour est appliquée. Seul `overlay` est accepté, et la valeur par défaut est `overlay`. Tous les `Taxes` et `Fees` précédents de cette propriété seront supprimés avant que cette mise à jour ne soit appliquée.
TaxFeeInfo / Property / ID	1	string	Identifiant unique de l'établissement. Cette valeur doit correspondre à l'identifiant de l'hôtel spécifié à l'aide de <id> dans l'élément <listing> du flux Hotel List Feed. 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 s'appliquant à 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é, la taxe s'applique à 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 dans un élément `<RoomData>` d'un message Transaction (Données sur un établissement) et identifié à l'aide de son RoomID. (Sa valeur `<RoomID>` est également référencée par l'attribut `InvTypeCode` dans les messages `OTA_HotelRateAmountNotifRQ`.)
TaxFeeInfo / Property / Taxes / Tax / RoomTypes / RoomType / @id	1	string	Identifiant unique de l'inventaire (type de chambre). Cette valeur correspond à `<RoomID>` dans un message Transaction (Données sur un établissement). Le nombre maximal de caractères autorisés 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 de séjours organisés, de tarifs et de disponibilités, telle que définie dans les messages Transaction (Données sur un établissement), OTA_HotelRateAmountNotifRQ et OTA_HotelAvailNotifRQ, et telle qu'identifiée par l'identifiant PackageID.
TaxFeeInfo / Property / Taxes / Tax / RatePlans / RatePlan / @id	1	string	Identifiant unique du plan tarifaire. Cette valeur correspond à la valeur PackageID dans l'élément `<PackageData>` du message Transaction (Données sur un établissement) et à la valeur `RatePlanCode` définie sous l'attribut `<StatusApplicationControl>` dans les messages `<OTA_HotelRateAmountNotifRQ>` et `<OTA_HotelAvailNotifRQ>`. 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 être effectuée 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.
TaxFeeInfo / Property / Taxes / Tax / BookingDates / DateRange / @start	0..1	Date	Date de début (en fonction du fuseau horaire de l'établissement), incluse, de la plage de dates. Cette date doit être antérieure ou identique à la date `end`. Si `start` n'est pas spécifié, la plage de dates est effectivement 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 la plage de dates. Cette date doit être identique ou postérieure à la date `start`. Si `end` n'est pas spécifié, la plage de dates est en fait illimitée en ce qui concerne la 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 cet attribut n'est pas spécifié, tous les jours sont autorisés dans la plage de dates. Chaque caractère de la chaîne spécifie un jour. Par exemple, "MTWHF" indique que les jours de la semaine sont autorisés dans la plage de dates. Caractères valides : `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 l'arrivée doit avoir lieu pour que la taxe soit appliquée.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange	1..20	DateRange	Plage de dates indiquant le moment auquel l'arrivée doit avoir lieu pour que la taxe soit appliquée.
TaxFeeInfo / Property / Taxes / Tax / CheckinDates / DateRange / @start	0..1	Date	Date de début (en fonction du fuseau horaire de l'établissement), incluse, de la plage de dates. Cette date doit être antérieure ou identique à la date `end`. Si `start` n'est pas spécifié, la plage de dates est en fait illimitée en ce qui concerne la 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 la plage de dates. Cette date doit être identique ou postérieure à la date `start`. Si `end` n'est pas spécifié, la plage de dates est en fait illimitée en ce qui concerne la 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 cet attribut n'est pas spécifié, tous les jours sont autorisés dans la plage de dates. Chaque caractère de la chaîne spécifie un jour. Par exemple, "MTWHF" indique que les jours de la semaine sont autorisés dans la plage de dates. Caractères valides : `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 auquel le départ doit avoir lieu pour que la taxe soit appliquée.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange	1..20	DateRange	Plage de dates indiquant le moment auquel le départ doit avoir lieu pour que la taxe soit appliquée.
TaxFeeInfo / Property / Taxes / Tax / CheckoutDates / DateRange / @start	0..1	Date	Date de début (en fonction du fuseau horaire de l'établissement), incluse, de la plage de dates. Cette date doit être antérieure ou identique à la date `end`. Si `start` n'est pas spécifié, la plage de dates est en fait illimitée en ce qui concerne la 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 la plage de dates. Cette date doit être identique ou postérieure à la date `start`. Si `end` n'est pas spécifié, la plage de dates est en fait illimitée en ce qui concerne la 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 cet attribut n'est pas spécifié, tous les jours sont autorisés dans la plage de dates. Chaque caractère de la chaîne spécifie un jour. Par exemple, "MTWHF" indique que les jours de la semaine sont autorisés dans la plage de dates. Caractères valides : `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 prendre en charge les 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 du séjour si toutes les dates du séjour se chevauchent. `any` : applique la taxe à toutes les nuits du séjour si une date du séjour chevauche une date de la plage de dates du séjour. `overlap`: applique uniquement la taxe aux nuits du séjour qui chevauchent une date de la plage de dates de séjour. Remarque : `overlap` n'est valide que lorsque la valeur de `<Period>` est définie 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), incluse, de la plage de dates. Cette date doit être antérieure ou identique à la date `end`. Si `start` n'est pas spécifié, la plage de dates est en fait illimitée en ce qui concerne la 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 la plage de dates. Cette date doit être identique ou postérieure à la date `start`. Si `end` n'est pas spécifié, la plage de dates est en fait illimitée en ce qui concerne la 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 cet attribut n'est pas spécifié, tous les jours sont autorisés dans la plage de dates. Chaque caractère de la chaîne spécifie un jour. Par exemple, "MTWHF" indique que les jours de la semaine sont autorisés dans la plage de dates. Caractères valides : `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:` Pourcentage du tarif total, des taxes et des frais cumulés avant le calcul de cette taxe ou de ces frais. Si cette valeur est spécifiée, `<Rank>` doit également être spécifié. `<Brackets>` et `<AgeBrackets>` ne peuvent pas être spécifiés avec le type `cumulative_percent`.
TaxFeeInfo / Property / Taxes / Tax / Basis	1	enum	Les valeurs valides sont les suivantes : `room:` Le `<Amount>` est appliqué à la chambre. `person:` La valeur `<Amount>` est appliquée 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:` La valeur `<Amount>` est ajoutée au prix total du séjour. `night:` La valeur `<Amount>` est ajoutée à chaque nuit du séjour.
TaxFeeInfo / Property / Taxes / Tax / Currency	0..1	string	Code de devise à trois lettres de la taxe (par exemple, USD). Remarque:Si `<Currency>` n'est pas spécifié, mais que `<Amount>` l'est également, la valeur `<Currency>` est définie par défaut sur la devise du tarif de base.
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>` sur night. Limite le nombre de nuits à celles pour lesquelles une taxe est applicable. Indiquez `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 doivent être exclues.
TaxFeeInfo / Property / Taxes / Tax / ApplicableNights / @excluded	0..1	integer	`<ApplicableNights excluded="N">` indique que les premières N 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. Les taxes ne sont pas appliquées lorsque la durée du séjour est en dehors des limites minimales et maximales.
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 taxation indiennes sur les produits et services). Cet élément n'est valide que si `<Period>` est défini sur `night` et si `<Amount>` n'est pas spécifié.
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 tranche.
TaxFeeInfo / Property / Taxes / Tax / Brackets / Bracket	1..n	Bracket	Définit une tranche de taxation 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ée dans le champ `starts_at` de la tranche suivante. Il n'y a pas de limite supérieure pour la dernière tranche. Une tranche de taxation est active lorsque le tarif par nuit est supérieur ou égal à la valeur `starts_at` de la tranche et strictement inférieur à la valeur `starts_at` de la tranche 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ée à cette tranche de taxe.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets	0..1	AgeBrackets	Permet de spécifier un ensemble de taxes en fonction de l'âge des occupants. Cet élément n'est valide que si `<Brackets>` et `<Amount>` ne sont pas spécifiés, si `<Basis>` est défini sur `person` et si `<Type>` est défini sur `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 pouvant contenir un ou plusieurs éléments `<ChildAgeBracket>`.
TaxFeeInfo / Property / Taxes / Tax / AgeBrackets / ChildAgeBrackets / ChildAgeBracket	1..n	ChildAgeBracket	Définit une tranche d'âge pour les enfants et le montant de la taxe correspondante.
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ée dans le champ `max_age` de la tranche précédente + 1. Les limites supérieure et inférieure sont toutes deux inclusives. La limite inférieure de la première tranche 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 répertorier les pays des utilisateurs pour lesquels la taxe est incluse ou exclue. Si elle est présente, la taxe ne sera incluse ou exclue que 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 le `type` de UserCountries est défini sur `include`, la taxe ne s'appliquera qu'aux utilisateurs des pays répertoriés. En revanche, si le `type` de UserCountries est `exclude`, la taxe ne s'appliquera qu'aux utilisateurs situés en dehors des pays indiqué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 les 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	Code pays CLDR, tel que `DE` ou `FR`. Notez que, pour certains pays, le code pays CLDR est différent du code pays ISO à deux lettres. De plus, les codes de région CLDR ne sont pas acceptés.
TaxFeeInfo / Property / Taxes / Tax / Rank	1	integer	Niveau qui spécifie 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éfini sur `cumulative_percent`. En général, cet ordre s'applique aux taxes et aux frais. Les valeurs de classement en double sont autorisées pour les taxes et les frais, mais cela peut entraîner un comportement indéfini, où 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 acceptés pour `<Fee>` avec la même syntaxe.

Exemples

Vous pouvez indiquer jusqu'à 300 taxes et frais par établissement. Reportez-vous à l'exemple "Supprimer les taxes" 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="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>

Supprimer les taxes

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

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

Tranches de taxes

Taxe indienne sur les produits et services (TPS) appliquée en fonction des tarifs par nuit. Voici les différentes tranches :

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 ou é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="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>

Taxes basées sur l'âge

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

Taxe de 20 $ pour les occupants adultes.
Taxe de 10 $ pour les enfants âgés de 11 à 17 ans.
5 $ de taxe pour les enfants de 0 à 10 ans

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

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 inclut les éléments et les attributs suivants :

Élément / @Attribut	Occurrences	Type	Description
TaxFeeInfoResponse	1	Complex element	Élément racine indiquant la réussite d'un message de demande TaxFeeInfo reçu ou ses problèmes.
TaxFeeInfoResponse / @timestamp	1	DateTime	Date et heure de création de ce message.
TaxFeeInfoResponse / @id	1	string	Identifiant unique indiqué dans le message TaxFeeInfo associé.
TaxFeeInfoResponse / @partner	1	string	Compte partenaire pour ce message.
TaxFeeInfoResponse / Success	0..1	Success	Indique que le message TaxFeeInfo a bien été traité sans avertissement, erreur ni échec. Chaque message contient soit `<Success>`, soit `<Issues>`.
TaxFeeInfoResponse / Issues	0..1	Issues	Conteneur pour un ou plusieurs problèmes rencontrés lors du traitement du message `TaxFeeInfo`. Chaque message contient soit `<Success>`, soit `<Issues>`.
TaxFeeInfoResponse / Issues / Issue	1..n	Issue	Description d'un avertissement, d'une erreur ou d'un échec survenus lors du traitement du message TaxFeeInfo. Pour en savoir plus sur ces problèmes, consultez 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

Vous trouverez ci-dessous une réponse à un message TaxFeeInfo correctement traité.

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfoResponse timestamp="2024-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 d'erreurs.

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