Référence des attributs

Attribut tax dans Google Shopping : guide de configuration des taxes des États américains

Q: Les e-commerçants de l'UE ou du Royaume-Uni utilisent-ils l'attribut tax ?

Non. L'attribut tax ne concerne que les e-commerçants américains. L'UE, le Royaume-Uni et la plupart des marchés internationaux exigent que les prix affichés aux consommateurs incluent la TVA — c'est une obligation légale (directive européenne sur la TVA, Consumer Rights Act britannique). Les e-commerçants de l'UE et du Royaume-Uni doivent inclure la TVA dans leur attribut price et soumettre le prix complet toutes taxes comprises. Soumettre un prix net (hors taxes) et utiliser tax pour ajouter la TVA n'est pas pris en charge en dehors des États-Unis et entraînera des erreurs d'affichage des prix ou des problèmes au regard des règles.

Q: Quels sont les sous-attributs de l'attribut tax ?

L'attribut tax possède quatre sous-attributs : country (ISO 3166-1 alpha-2, par exemple, US), region (code d'État américain, par exemple, CA pour la Californie), rate (le taux de taxe en pourcentage sous forme décimale, par exemple, 8.25 pour 8,25 %), et tax_ship (booléen y ou n — si la taxe s'applique aux frais de port). Les quatre sous-attributs sont soumis ensemble dans un seul champ tax. Vous pouvez soumettre plusieurs entrées tax par produit pour indiquer des taux différents selon les États.

Q: Faut-il utiliser les attributs tax au niveau du flux ou les paramètres de taxes au niveau du compte ?

Pour la plupart des e-commerçants américains, les paramètres de taxes au niveau du compte dans Merchant Center sont préférables aux attributs tax au niveau du flux. Les paramètres au niveau du compte appliquent une configuration de taxes cohérente à l'ensemble de votre catalogue sans nécessiter de données par produit, et ils prennent en charge les mises à jour automatisées des taux de taxes de Merchant Center. Les attributs tax au niveau du flux conviennent mieux aux e-commerçants qui ont des taux de taxes spécifiques aux produits — par exemple, les produits alimentaires taxés à un taux inférieur à celui des marchandises générales dans certains États, ou les produits exonérés de taxes dans certaines juridictions.

Q: Que signifie tax_ship = y ?

tax_ship = y indique à Google que le taux de taxe de votre État s'applique aux frais de port ainsi qu'au prix du produit. Certains États américains (par exemple, le Texas, l'Illinois) taxent les frais de port ; d'autres (par exemple, la Californie) ne le font pas. Un paramétrage correct garantit l'exactitude du prix estimé toutes taxes comprises présenté aux acheteurs dans Shopping. Des paramètres tax_ship incorrects amènent Google à afficher un prix total estimé inexact.

Q: Que se passe-t-il si je soumets un prix hors taxes pour un produit vendu aux États-Unis ?

Pour les produits américains, vous devez soumettre des prix hors taxes dans l'attribut price (contrairement à l'UE, où les prix doivent inclure la TVA). Google ajoute ensuite la taxe estimée au niveau de l'État — soit à partir de vos paramètres au niveau du compte, soit de votre attribut tax — pour montrer aux acheteurs un prix total estimé. Si vous soumettez un prix américain toutes taxes comprises par erreur, le prix final affiché comptera la taxe deux fois : celle que vous avez intégrée au prix, plus l'estimation de Google par-dessus.

Q: Mon produit est exonéré de taxes dans certains États américains — comment gérer ce cas ?

Vous pouvez soumettre un attribut tax avec rate = 0 pour les États spécifiques où votre produit est exonéré. Par exemple, certains vêtements sont exonérés de taxes à New York, en Pennsylvanie et au New Jersey. Soumettez des entrées tax distinctes pour ces États avec rate:0, et des entrées distinctes pour les États avec des taux applicables. Cette valeur définie au niveau du produit prime sur vos paramètres de taxes au niveau du compte pour ces États spécifiques.

Guide de l'attribut tax dans Google Merchant Center : sous-attributs country/region/rate/tax_ship et pourquoi Google a cessé d'exiger la sales tax US en 2025.

Mis à jour 3 août 20264 min de lectureJakub Kašparů

Attribut tax — États-Unis : configuration au niveau du compte ou du flux

Sac pour ordinateur portable en cuir — Noir

149,00 $ (+ taxes au moment du paiement)us-accessories.com

Taux configurés une seule fois dans les paramètres du compte Merchant Center. Ils s'appliquent automatiquement à tous les produits. Aucun attribut tax par produit n'est nécessaire.

Sac pour ordinateur portable en cuir — Noir

149,00 € (TVA incluse)de-accessories.com

La loi européenne exige des prix incluant la TVA. Soumettez le prix toutes taxes comprises dans l'attribut price. N'utilisez PAS l'attribut tax — il n'est pas pris en charge pour les marchés de l'UE.

L'attribut tax est uniquement applicable aux États-Unis. Les e-commerçants de l'UE, du Royaume-Uni et de la plupart des autres marchés doivent inclure la TVA/taxe de vente directement dans l'attribut price — c'est ce que la loi locale exige, et ce que les acheteurs s'attendent à voir. Les e-commerçants américains configurent presque toujours les taxes au niveau du compte dans Merchant Center, et non au niveau du flux.

Qu’est-ce que l’attribut tax ?

L’attribut tax permet aux e-commerçants américains d’indiquer les taux de taxe de vente (sales tax) par produit et par État. Il précise à Google le taux applicable à un produit dans certains États ou régions des États-Unis, afin que Shopping puisse afficher aux acheteurs un prix total estimé, taxes comprises.

Mise à jour : depuis le 1er juillet 2025, Google n’exige plus des e-commerçants qu’ils fournissent la taxe de vente américaine, et il est en train de supprimer l’attribut tax ainsi que les paramètres de taxes de Merchant Center. La suite de ce guide décrit le fonctionnement de l’attribut ; ne l’ajoutez pas à de nouveaux flux.

Point essentiel : l’attribut tax est un attribut propre aux États-Unis. Il ne sert à rien dans l’UE, au Royaume-Uni ou dans la plupart des marchés internationaux, où la taxe (TVA) doit légalement être incluse dans le prix affiché et intégrée à la valeur de l’attribut price. Les e-commerçants de l’UE et du Royaume-Uni ne doivent jamais utiliser cet attribut.

Spécifications techniques

Nom dans le flux	`tax`
Marchés applicables	États-Unis uniquement
Requis	N'est plus requis (retiré par Google en 2025)
Sous-attributs	`country`, `region`, `rate`, `tax_ship`
Entrées multiples	Oui — soumettez une entrée `tax` par État/région selon les besoins
Répétable	Oui — jusqu'à 100 entrées de taxes par produit

Détails des sous-attributs

country	Code ISO 3166-1 alpha-2. Pour les taxes américaines : `US`
region	Abréviation de l'État américain (par exemple, `CA`, `NY`, `TX`). Peut être omis pour appliquer le taux à l'ensemble du pays.
rate	Taux de taxe sous forme de pourcentage décimal (par exemple, `8.25` = 8,25 %). Utilisez `0` pour les produits exonérés de taxes.
tax_ship	`y` si la taxe s'applique aux frais de port ; `n` sinon. La valeur par défaut est `n`.

Taxes au niveau du flux ou paramètres de taxes au niveau du compte

Paramètres au niveau du compte	Configurés une fois dans Merchant Center sous « Taxes ». S'appliquent à tous les produits. Google tient à jour les barèmes de chaque État. Idéal pour les e-commerçants dont le traitement fiscal est uniforme sur l'ensemble de leur catalogue.
Attribut tax au niveau du flux	Surcharge au niveau du produit. Utile lorsque certains produits ont des taux de taxes différents (par exemple, l'alimentation à des taux inférieurs, les vêtements exonérés dans certains États). Prévaut sur les paramètres du compte pour les produits et États concernés.
Priorité	L'attribut `tax` au niveau du flux prime sur les paramètres au niveau du compte pour les produits et les États qu'il couvre.

Règles de soumission des prix aux États-Unis (résumé)

États-Unis : soumettez des prix hors taxes dans price. Google ajoute la taxe estimée séparément.
UE/Royaume-Uni/plupart des marchés : soumettez des prix toutes taxes comprises (TVA incluse) dans price. N’utilisez pas l’attribut tax.
Canada : soumettez des prix hors taxes (TPS/TVH ajoutées séparément par Google ou affichée au moment du paiement).

Cas d’usage courants de l’attribut tax au niveau du produit (États-Unis)

Produits alimentaires : taxés à des taux réduits (ou exonérés) dans de nombreux États américains par rapport aux produits courants
Vêtements : exonérés de la taxe de vente à NY, PA, NJ et dans d’autres États pour les articles dont le prix est inférieur à un seuil
Téléchargements numériques : le traitement fiscal varie considérablement selon l’État pour les biens numériques
Produits médicaux/de santé : souvent exonérés ou à taux réduit dans plusieurs États

Règles

N’utilisez pas l’attribut tax pour l’UE, le Royaume-Uni ou les marchés non américains — incluez plutôt la taxe dans price
Ne soumettez pas à la fois tax au niveau du compte et des attributs tax contradictoires au niveau du produit — le niveau du produit l’emporte, ce qui n’est pas forcément ce que vous voulez
Le taux doit être un nombre décimal (par exemple, 8.25), et non une chaîne avec le signe pourcentage (8.25%)
Vérifiez que le prix hors taxes envoyé correspond à celui de votre page de destination — toute incohérence entraîne un refus

Erreurs courantes

E-commerçants de l’UE qui soumettent des prix nets hors TVA et utilisent tax pour rajouter la TVA — non pris en charge, entraîne un affichage incorrect des prix
E-commerçants américains qui incluent la taxe dans price ET soumettent un attribut tax — la taxe est comptée deux fois dans le total affiché
Omettre tax_ship dans les États où les frais de port sont imposables — conduit à un prix total estimé sous-évalué
Ne pas mettre à jour les taux de taxes lorsque la législation de l’État change — les taux de taxe de vente américains changent souvent
Utiliser l’attribut tax pour des remplacements au niveau du produit lorsque les paramètres au niveau du compte sont plus simples et suffisants

Foire aux questions

Les e-commerçants de l'UE ou du Royaume-Uni utilisent-ils l'attribut tax ?

Non. L'attribut tax ne concerne que les e-commerçants américains. L'UE, le Royaume-Uni et la plupart des marchés internationaux exigent que les prix affichés aux consommateurs incluent la TVA — c'est une obligation légale (directive européenne sur la TVA, Consumer Rights Act britannique). Les e-commerçants de l'UE et du Royaume-Uni doivent inclure la TVA dans leur attribut price et soumettre le prix complet toutes taxes comprises. Soumettre un prix net (hors taxes) et utiliser tax pour ajouter la TVA n'est pas pris en charge en dehors des États-Unis et entraînera des erreurs d'affichage des prix ou des problèmes au regard des règles.

Quels sont les sous-attributs de l'attribut tax ?

L'attribut tax possède quatre sous-attributs : country (ISO 3166-1 alpha-2, par exemple, US), region (code d'État américain, par exemple, CA pour la Californie), rate (le taux de taxe en pourcentage sous forme décimale, par exemple, 8.25 pour 8,25 %), et tax_ship (booléen y ou n — si la taxe s'applique aux frais de port). Les quatre sous-attributs sont soumis ensemble dans un seul champ tax. Vous pouvez soumettre plusieurs entrées tax par produit pour indiquer des taux différents selon les États.

Faut-il utiliser les attributs tax au niveau du flux ou les paramètres de taxes au niveau du compte ?

Pour la plupart des e-commerçants américains, les paramètres de taxes au niveau du compte dans Merchant Center sont préférables aux attributs tax au niveau du flux. Les paramètres au niveau du compte appliquent une configuration de taxes cohérente à l'ensemble de votre catalogue sans nécessiter de données par produit, et ils prennent en charge les mises à jour automatisées des taux de taxes de Merchant Center. Les attributs tax au niveau du flux conviennent mieux aux e-commerçants qui ont des taux de taxes spécifiques aux produits — par exemple, les produits alimentaires taxés à un taux inférieur à celui des marchandises générales dans certains États, ou les produits exonérés de taxes dans certaines juridictions.

Que signifie tax_ship = y ?

tax_ship = y indique à Google que le taux de taxe de votre État s'applique aux frais de port ainsi qu'au prix du produit. Certains États américains (par exemple, le Texas, l'Illinois) taxent les frais de port ; d'autres (par exemple, la Californie) ne le font pas. Un paramétrage correct garantit l'exactitude du prix estimé toutes taxes comprises présenté aux acheteurs dans Shopping. Des paramètres tax_ship incorrects amènent Google à afficher un prix total estimé inexact.

Que se passe-t-il si je soumets un prix hors taxes pour un produit vendu aux États-Unis ?

Pour les produits américains, vous devez soumettre des prix hors taxes dans l'attribut price (contrairement à l'UE, où les prix doivent inclure la TVA). Google ajoute ensuite la taxe estimée au niveau de l'État — soit à partir de vos paramètres au niveau du compte, soit de votre attribut tax — pour montrer aux acheteurs un prix total estimé. Si vous soumettez un prix américain toutes taxes comprises par erreur, le prix final affiché comptera la taxe deux fois : celle que vous avez intégrée au prix, plus l'estimation de Google par-dessus.

Mon produit est exonéré de taxes dans certains États américains — comment gérer ce cas ?

Vous pouvez soumettre un attribut tax avec rate = 0 pour les États spécifiques où votre produit est exonéré. Par exemple, certains vêtements sont exonérés de taxes à New York, en Pennsylvanie et au New Jersey. Soumettez des entrées tax distinctes pour ces États avec rate:0, et des entrées distinctes pour les États avec des taux applicables. Cette valeur définie au niveau du produit prime sur vos paramètres de taxes au niveau du compte pour ces États spécifiques.