Message sur les taxes et les frais

Présentation

Le message TaxFeeInfo définit les taxes et les frais applicables à un utilisateur lors de la réservation d'un établissement, en fonction de la réglementation fiscale de l'établissement décrite sur le site Web. Pour ajouter des données de taxes et de frais, utilisez le message "Tarif" (OTA_HotelRateAmountNotifRQ).

Remarque :Le type de message TaxFeeinfo est recommandé. Il n'est pas obligatoire si AmountAfterTax est spécifié dans le message Rate.

La seule action acceptée pour ce message est overlay, qui permet de remplacer les données de taxes et de frais pour chaque établissement. Il est important d'envoyer des mises à jour sur les taxes et les frais à chaque changement.

Important :Vous devez inclure l'ensemble des taxes et des frais qu'un utilisateur doit payer (TVA, taxe de séjour, taxe de séjour, etc.), même s'ils ne sont pas réglés au moment de la réservation ou s'ils ne sont pas directement versés à l'établissement.

Méthodes pour ajouter des taxes et des frais

Vous pouvez ajouter des taxes et des frais de deux manières générales: dans la première, vous spécifiez AmountAfterTax dans le message "Rate" (Tarif), et vous ajoutez les taxes et les frais en envoyant des messages de tarifs contenant à la fois les tarifs par nuit de base (hors taxes et frais) et les tarifs totaux par nuit (tous taxes et frais compris). Étant donné que ces tarifs s'appliquent à la nuit, cette approche ne fonctionne que pour les taxes/frais basés sur des pourcentages ou les montants fixes par nuit. Les taxes/frais par séjour ne peuvent pas être utilisées.

La deuxième méthode (recommandée) consiste à n'envoyer que les tarifs par nuit de base hors taxes dans les messages sur les tarifs et à utiliser TaxFeeInfo pour indiquer les taxes/frais au niveau de l'établissement. Les taxes/frais individuels peuvent toujours être limités à des types de chambres et à des plans tarifaires spécifiques, et/ou à certaines plages de dates.

Remarque :Cette page décrit et fait uniquement référence à la méthode à privilégier pour utiliser TaxFeeInfo, et non à la méthode de spécification de AmountAfterTax dans le message de tarif (OTA_HotelRateAmountNotifRQ).

Méthodes de définition des taxes

Vous disposez des options suivantes pour définir les taxes:

• Base = [salle|personne]
• Règles = [séjour|nuit]
• Type = [pourcentage|quantité]

Lorsque la période correspond à stay et que le type est défini sur percent, Google applique des taxes/frais pour l'intégralité du séjour, même si une date du séjour chevauche la plage StayDates. Vous ne pouvez pas indiquer que des taxes ou des frais sont appliqués uniquement si TOUTES les dates du séjour chevauchent la plage de dates des dates de séjour.

Pour consulter des exemples de différents scénarios fiscaux, reportez-vous aux guides pratiques. Les exemples couvrent les principaux scénarios fiscaux, y compris les tutoriels suivants:

• Pourcentage de taxe
• Taxes forfaitaires par propriété
• Pourcentage de taxe appliqué uniquement aux nuitées après la première nuit
• Méthode pour remplacer les anciennes taxes par de nouvelles taxes
• Inclure ou exclure les taxes pour les pays
• Définir une taxe appliquée à un rectangle avec des crochets
• Définir les taxes et les frais imposables

Les sections suivantes présentent les consignes générales, un exemple de base et des tutoriels pour vous aider à ajouter et à mettre à jour vos informations fiscales.

Éléments obligatoires et facultatifs

La référence XML fournit une description des éléments obligatoires et facultatifs. Pour en savoir plus sur les attributs et les éléments enfants, consultez la section Éléments et attributs TaxFeeInfo.

Syntaxe et schémas

Utilisez l'exemple de syntaxe TaxFeeInfo comme référence lorsque vous créez le message pour vous assurer que vous suivez le format correct. Vous pouvez utiliser un outil XML tiers tel que xmllint pour valider vos flux avec les schémas publiés avant de les envoyer à Google. Pour connaître le schéma du message TaxFeeinfo, consultez la section Schémas des annonces d'hôtel.

Consignes

Cette section présente les consignes courantes et les instructions spéciales pour définir les taxes et les frais.

Actions

Superposition

Utilisez l'action overlay pour remplacer toutes les taxes d'un établissement. L'action overlay est l'action par défaut et la seule action prise en charge. Toutes les taxes et tous les frais antérieurs liés à cet établissement seront effacés après l'application de cette mise à jour.

Questions d'ordre général

• Chaque Tax est évalué et, le cas échéant, calculé en fonction du montant AmountBeforeTax spécifié dans BaseByGuestAmt.

• Une fois que toutes les taxes et tous les frais applicables ont été calculés, ils sont ajoutés au prix de base pour former le prix total.

• La syntaxe de <Tax> et de <Fee> est identique.

• Les taxes/frais peuvent être soumis à des contraintes, par exemple:

  • S'applique uniquement à des types de chambres et/ou des plans tarifaires spécifiques.
  • S'applique uniquement à des dates de séjour spécifiques.

  Ces contraintes sont facultatives et vous n'avez pas besoin de définir tous les types de contraintes. Vous pouvez les laisser vides si elles s'appliquent à tous.

• Envoyez une mise à jour TaxFeeInfo chaque fois que les taxes ou les frais sont modifiés.

Exemple

Cette section fournit un exemple de base de message TaxFeeInfo utilisant des éléments obligatoires et facultatifs. Une fois le fichier préparé, vous devez l'envoyer à Google via un message POST à ce point de terminaison:

https://www.google.com/travel/hotels/uploads/taxes

Pour en savoir plus sur l'envoi/la publication du message, consultez la section Envoi de messages.

Important :Envoyez à Google un message TaxFeeInfo actualisé à chaque fois que vos taxes et frais changent.

Pour l'attribut hotel_id, utilisez l'identifiant d'hôtel unique que vous avez utilisé dans votre système pour identifier 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. La cohérence avec votre système est essentielle pour vous assurer que Google affiche correctement vos données.

Cet exemple montre comment définir un pourcentage de taxe de 10% et un montant de frais de 50 $pour un établissement pour l'ensemble du séjour (et non par nuit):

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-20T16:20:00-04:00"
            partner=""partner_key"
            id="12345678">
  <Property>
    <ID>HOTELID</ID>
    <Taxes>
      <Tax>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>10</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>50</Amount>
        <Currency>USD</Currency>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

Pour obtenir des exemples d'ajout de taxes liées à l'âge et d'autres exemples, consultez Exemples de taxes.

Guides pratiques

Cette section fournit des solutions aux scénarios que vous pouvez rencontrer lors de la définition des taxes et des frais.

Scénario 1: Ajouter une taxe forfaitaire

Cet exemple de taxe montre comment définir une taxe forfaitaire par propriété.

Description

Vous souhaitez appliquer une taxe forfaitaire pour la chambre et le séjour par établissement plutôt qu'un pourcentage de taxe.

Solution

Utilisez amount au lieu de percentage pour ajouter l'option de taxe forfaitaire.

Échantillon

Cet exemple montre comment ajouter une taxe forfaitaire en utilisant amount plutôt que percentage:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>30</Amount>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

Scénario 2: Cibler les taxes à l'aide du ApplicableNights

Description

Vous souhaitez appliquer une taxe forfaitaire uniquement aux nuits suivant la première nuit. Par exemple, des frais obligatoires sont appliqués pour l'utilisation quotidienne d'un service spécifique qui est exclu la première nuit lorsque le ou les clients n'auraient pas eu la possibilité de s'en servir.

Solution

Utilisez <ApplicableNights excluded="1"/> pour contrôler les nuits auxquelles des taxes sont appliquées.

Échantillon

Cet exemple montre comment utiliser ApplicableNights:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
            id="12345678"
            partner="partner_key">
  <Property>
    <ID>Property_1</ID>
    <Taxes>
      <Tax>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>night</Period>
        <Amount>50</Amount>
        <ApplicableNights excluded="1"/>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

Scénario 3: Remplacer les anciennes taxes et les nouveaux frais

Description

Les taxes/frais actuels ont changé et doivent être remplacés par de nouveaux.

Solution

Utilisez l'action overlay pour supprimer l'ensemble des taxes et des frais existants.

Remarque :Si l'action overlay n'est pas spécifiée, il s'agit de l'action par défaut. Cela signifie qu'il est uniquement possible de remplacer l'ensemble des taxes/frais pour chaque établissement, et que vous ne pouvez pas ajouter de nouvelles taxes/frais de manière incrémentielle.

Échantillon

L'exemple suivant montre comment supprimer l'ensemble des taxes/frais pour un établissement:

    <?xml version="1.0" encoding="UTF-8"?>
    <TaxFeeInfo timestamp="2022-08-16T16:20:00-04:00"
                id="12345678"
                partner="partner_key">
      <Property action="overlay">
        <ID>Property_1</ID>
      </Property>
    </TaxFeeInfo>

Scénario 4: Inclure ou exclure des taxes pour les pays

Description

Vous devez inclure la taxe pour certains pays tout en l'excluant d'un autre. Par exemple, vous devez exclure les taxes pour une confédération plus petite, avec des taxes situées en dehors de l'UE, tout en imposant tous les autres pays.

Solution

Utilisez les options include ou exclude pour UserCountries type. Utilisez include pour appliquer la taxe uniquement au pays indiqué ou exclude pour l'appliquer à tous les pays, à l'exception de celui indiqué.

Échantillon

L'exemple suivant montre comment définir les taxes pour les utilisateurs situés en dehors du pays de l'hôtel (Israël):

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-16T16: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>
        <UserCountries type="exclude">
          <Country code="IL"/>
        </UserCountries>
      </Tax>
    </Taxes>
  </Property>
</TaxFeeInfo>

Scénario 5: Définir des taxes d'application avec des crochets

Description

Vous souhaitez ajouter une taxe associée à la TPS appliquée en fonction des tarifs par nuit.

Remarque :Pour ce scénario, utilisez Brackets (ensemble de crochets de taxe qui ne se chevauchent pas) pour définir cette option.

Solution

Dans ce scénario, supposons que les tranches de taxe sur les biens et services TPS du pays cible soient les suivantes:

• 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.

Échantillon

L'exemple suivant montre comment définir une taxe de type "slab" entre crochets:

<?xml version="1.0" encoding="UTF-8"?>
<TaxFeeInfo timestamp="2022-08-28T16: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>

Scénario 6: Définir des taxes et des frais imposables

Description

Vous souhaitez ajouter une taxe telle que la TVA, ainsi que d'autres frais de service qui sont également applicables à cette taxe.

Solution

Ce scénario prend en compte deux exemples de cas d'utilisation de frais imposables:

• Les taxes et les frais imposables sont définis sous la forme d'un pourcentage de frais.
• Les taxes correspondent à un pourcentage, tandis que les frais imposables correspondent à un montant fixe par séjour.

Exemples

Frais imposables en pourcentage

Dans cet exemple, le montant avant taxe de 100 $, d'une taxe TPS de 18 % et de frais de service supplémentaires de 5% s'élève à 5,9% (5 x 1,18) et le tarif total s'élève à 123,90 $. [= 118 $ (18% de TPS) + 5,9 $ (frais de service de 5,9 %)]

L'extrait suivant définit les taxes (TPS) et les frais imposables (frais de service) sous forme de pourcentages :

<TaxFeeInfo timestamp="2022-08-16T16: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>18</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>percent</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>5.9</Amount>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>

Frais imposables en fonction du montant

Dans cet exemple, le montant avant taxe de 100 $, d'une taxe GST de 18 % et d'un taux fixe supplémentaire de 20 $, soit le total des frais imposables de 23,60 $ (20 $ x 1,18) et le montant total de 141,60 $ [= 118 $ (18% de TPS) + 23,60 $) (23,60 $) (20,60 $)

L'extrait suivant définit la taxe (TPS) en pourcentage et en frais imposables (frais de service) comme un montant forfaitaire :

<TaxFeeInfo timestamp="2022-08-16T16: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>18</Amount>
      </Tax>
    </Taxes>
    <Fees>
      <Fee>
        <Type>amount</Type>
        <Basis>room</Basis>
        <Period>stay</Period>
        <Amount>23.6</Amount>
      </Fee>
    </Fees>
  </Property>
</TaxFeeInfo>