Message sur les taxes et les frais

Présentation

Le message TaxFeeInfo définit les taxes et les frais applicables à un utilisateur lorsqu'il réserve un établissement, en fonction des réglementations fiscales de l'établissement indiquées sur le site Web. Pour ajouter des données sur les taxes et les frais, vous devez utiliser le message sur les tarifs (OTA_HotelRateAmountNotifRQ).

Remarque : Le type de message TaxFeeinfo est recommandé, mais il n'est pas obligatoire si AmountAfterTax est spécifié dans le message de taux.

La seule action acceptée pour ce message est overlay, qui permet de remplacer les données sur les taxes et les frais pour chaque établissement. Il est important d'envoyer des informations actualisées sur les taxes et les frais chaque fois qu'ils changent.

Point clé : Vous devez inclure toutes les taxes et tous les frais qu'un utilisateur doit payer (TVA, taxe de séjour, taxe de ville, etc.), même s'ils ne sont pas payés au moment de la réservation ou directement à l'établissement.

Pour savoir comment envoyer les taxes et les frais, ainsi que pour obtenir des informations spécifiques sur les tarifs, consultez les Règles relatives aux taxes et aux frais.

Méthodes pour ajouter des taxes et des frais

Il existe deux façons générales d'ajouter des taxes et des frais :

Dans la première méthode, vous spécifiez AmountAfterTax dans le message sur les tarifs. Vous ajoutez les taxes et les frais en envoyant des messages sur les tarifs qui contiennent à la fois les tarifs de base par nuit (hors taxes et frais) et les tarifs totaux par nuit (taxes et frais inclus). Comme ces tarifs sont par nuit, cette approche ne fonctionne que pour les taxes et frais basés sur un pourcentage ou les montants fixes par nuit. Les taxes et frais par séjour ne peuvent pas être utilisés.

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

Point clé : Vous pouvez indiquer jusqu'à 300 taxes et frais par établissement. Vous pouvez utiliser le message TaxFeeInfo pour supprimer les taxes et les frais d'un établissement.

Cette page décrit et fait uniquement référence à la méthode privilégiée d'utilisation de TaxFeeInfo, et non à la méthode de spécification de AmountAfterTax dans le message sur les tarifs (OTA_HotelRateAmountNotifRQ).

Méthodes de configuration des taxes

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

• Basis = [room|person]
• Période = [stay|night]
• Type = [percent|amount]

Lorsque la période est définie sur stay et le type sur percent, Google applique les taxes et les frais pour l'ensemble du séjour, même si une seule date de l'itinéraire chevauche la plage StayDates. Vous ne pouvez pas spécifier d'appliquer une taxe et des frais uniquement si TOUTES les dates du séjour chevauchent la plage de dates du séjour. Pour plusieurs plages de dates de séjour qui se chevauchent, les plages StayDates sont spécifiées dans une seule plage ouverte. Consultez les exemples TaxFeeInfo.

Pour obtenir des exemples de différents scénarios liés aux taxes, consultez Procédure. Les exemples couvrent certains des principaux scénarios fiscaux, y compris des tutoriels pour :

1. Taxe forfaitaire et taxe en pourcentage appliquées par établissement
2. Taxe en pourcentage appliquée uniquement aux nuits suivant la première nuit
3. Méthode pour remplacer les anciennes taxes par les nouvelles
4. Inclure ou exclure les taxes pour les pays
5. Définir une taxe par tranche avec des fourchettes
6. Définir les taxes et les frais imposables

Les sections suivantes présentent des consignes générales, un exemple de base et des scénarios pratiques pour vous aider à ajouter et à modifier vos informations fiscales.

Éléments obligatoires et facultatifs

La référence XML fournit des descriptions des éléments obligatoires et facultatifs. Pour en savoir plus sur les attributs et les éléments enfants, consultez É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 d'utiliser le bon format. 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 le schéma du message TaxFeeinfo, consultez Schémas des annonces d'hôtel.

Consignes

Cette section présente les consignes générales 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'une propriété. L'action overlay est l'action par défaut et la seule action acceptée. Toutes les taxes et tous les frais précédents pour cet établissement seront supprimés une fois cette mise à jour appliquée.

Général

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

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

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

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

  • Ne s'applique qu'à certains types de chambres et plans tarifaires.
  • ne s'applique qu'à des dates de séjour spécifiques.

  Ces contraintes sont facultatives. 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 changent.

Exemple

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

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

Pour savoir comment envoyer/publier le message, consultez Envoyer des messages.

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

Pour l'attribut hotel_id, utilisez l'identifiant unique de l'hôtel 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 taux de taxe de 10 % et un montant de frais de 50 $pour un établissement pour le séjour complet (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>

Remarque : Si <Currency> n'est pas spécifié, mais que <Amount> l'est, la valeur <Currency> est définie par défaut sur la devise du taux de base.

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 configuration 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 ou le séjour par établissement plutôt qu'une taxe en pourcentage.

Solution

Utilisez amount plutôt que percentage pour ajouter l'option de taxe forfaitaire.

Échantillon

Cet exemple montre comment ajouter une taxe forfaitaire à l'aide de amount plutôt que de 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 de ApplicableNights

Description

Vous souhaitez appliquer une taxe forfaitaire uniquement aux nuits suivant la première nuit. Par exemple, des frais obligatoires peuvent s'appliquer à l'utilisation quotidienne d'un certain équipement, mais pas à la première nuit, car les clients n'auraient pas eu l'occasion d'utiliser cet équipement.

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 frais par les nouveaux

Description

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

Solution

Utilisez l'action overlay pour supprimer toutes les taxes et tous les frais existants.

Remarque : L'action overlay est l'action par défaut si elle n'est pas spécifiée. Cela signifie qu'il n'est possible de remplacer toutes les taxes et tous les 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 toutes les taxes et tous les 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 les taxes pour les pays

Description

Vous devez inclure les taxes pour certains pays et les exclure pour d'autres. Par exemple, vous devez exclure les taxes pour une petite confédération avec des taxes non européennes, tout en taxant tous les autres pays.

Solution

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

Échantillon

L'exemple suivant montre comment définir les taxes pour les utilisateurs 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 une taxe par tranche avec des fourchettes

Description

Vous souhaitez ajouter une taxe indienne sur les produits et services (TPS) appliquée en fonction des tarifs par nuit.

Remarque : Pour ce scénario, utilisez Brackets (ensemble de tranches d'imposition non chevauchantes) pour définir cette option.

Solution

Pour ce scénario, supposons que les tranches de TPS du pays cible sont 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 par tranche avec des parenthèses :

<?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 une taxe et des frais imposables

Description

Vous souhaitez ajouter une taxe telle que la TVA, ainsi que des frais de service supplémentaires qui s'appliquent également à cette taxe.

Solution

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

• La taxe et les frais imposables sont définis comme des frais en pourcentage.
• La taxe est un pourcentage, tandis que les frais imposables sont un montant fixe par séjour.

Exemples

Frais taxables en pourcentage

Dans cet exemple, le AmountBeforeTax est de 100 $, la TPS de 18 % et les frais de service supplémentaires de 5 %. Le pourcentage total des frais imposables est donc de 5,9 % (5*1,18) et le montant total du tarif de 123,90 $ [= 118 $ (TPS de 18 %) + 5,9 $ (frais de service de 5,9 %)].

L'extrait suivant définit la taxe (TPS) et les frais imposables (frais de service) en tant que 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 (montant)

Dans cet exemple, le AmountBeforeTax est de 100 $, la TPS est de 18 % et des frais supplémentaires de 20 $sont appliqués. Le montant total des frais imposables est donc de 23,60 $ (20 $*1,18) et le montant total du tarif est de 141,60 $ [= 118 $ (TPS de 18 %) + 23,60 $ (frais forfaitaires de 20 $)].

L'extrait suivant définit la taxe (TPS) en pourcentage et les frais imposables (frais de service) en 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>