Ajoutez les identifiants produit exigés par l'UE pour les envois B2C de faible
valeur, pour chaque intégration Zonos.
À partir du 1er novembre 2026, l'UE exige des identifiants produit (PID) pour chaque article des envois entre entreprises et consommateurs entrant dans l'UE d'une valeur de 150 € ou moins. Les envois qui en sont dépourvus peuvent être retenus ou refusés par la douane. Ce guide indique où ajouter les identifiants pour chaque intégration Zonos.
Les marchands Shopify ajoutent les identifiants dans Shopify, et Zonos les récupère automatiquement. Pour toutes les autres intégrations, ajoutez-les dans Zonos Catalog, ou mappez-les à partir des champs de votre boutique si les paramètres de votre plugin proposent un mappage personnalisé.
Intégration↕
Où ajouter les identifiants↕
Shopify (Zonos Duty and Tax)
Sur chaque variante de produit dans l'administration Shopify
Magento
Zonos Catalog, ou mappage des attributs dans les paramètres du plugin Zonos (étapes ci-dessous)
Ajoutez les trois identifiants sur chaque variante dans l'administration Shopify. L'application Zonos les récupère.
Dans l'administration Shopify, ouvrez Products et sélectionnez un produit.
Ouvrez la variante à mettre à jour.
Pour l'identifiant produit du marchand (M-PID), l'application Zonos utilise automatiquement l'ID produit Shopify. Pour utiliser plutôt votre SKU, chaque produit doit avoir un SKU et chaque SKU doit être unique : vérifiez que le champ SKU est renseigné et que le SKU n'est utilisé sur aucune autre variante.
Ajoutez le numéro du fabricant sous forme de code-barres de type NS-PID (identifiant produit du fabricant non standardisé).
Si le produit possède un code UPC, EAN, GTIN ou ISBN, ajoutez-le comme second code-barres avec le type correspondant.
Enregistrez, puis répétez l'opération pour chaque variante.
Conseils :
Placez le numéro du fabricant dans son propre code-barres NS-PID, et non dans le champ SKU ou UPC. Zonos transmet chaque type de code-barres à la douane comme un identifiant distinct.
Une variante peut contenir plusieurs codes-barres, mais Zonos lit les cinq premiers. Veillez à ce que le NS-PID et le code-barres principal du produit en fassent partie.
Les codes-barres saisis avant ce changement fonctionnent toujours comme code UPC/EAN. Seul le numéro du fabricant est nouveau.
Magento, WooCommerce, BigCommerce, Miva et toute autre intégration peuvent ajouter les identifiants dans Zonos Catalog. Certains plugins peuvent également les mapper à partir des champs de votre boutique. Choisissez l'option la mieux adaptée à votre gestion actuelle des données produit.
Recherchez le produit. Chaque variante constitue un article distinct du catalogue.
Renseignez les trois champs d'identifiant :
SKU ou Product ID : votre identifiant produit du marchand (M-PID). L'un ou l'autre convient.
Manufacturer product ID : le numéro du fabricant
GTIN : le code UPC, EAN, GTIN ou ISBN, si le produit en possède un
Enregistrez, puis répétez l'opération pour chaque article.
Pour un catalogue volumineux, ajoutez les identifiants dans un fichier d'import de catalogue plutôt que de modifier les articles un par un. Assurez-vous que le SKU de chaque article dans Zonos Catalog correspond exactement au SKU de votre boutique.
Les identifiants de Catalog ne figurent sur vos étiquettes que dans deux cas
Zonos utilise les identifiants de Zonos Catalog uniquement si :
Vous imprimez les étiquettes d'expédition depuis Dashboard.
Vous imprimez les étiquettes en dehors de Dashboard et appelez l'API Zonos pour obtenir les détails catalogue du produit avant de demander l'étiquette à votre transporteur. Consultez Rechercher un produit pour savoir comment rechercher un article du catalogue.
Si vous imprimez les étiquettes en dehors de Dashboard sans appeler l'API Zonos pour obtenir les détails catalogue, collaborez avec votre fournisseur d'étiquettes pour inclure les identifiants lors de l'impression de l'étiquette.
Option 2 : Mappage personnalisé dans les paramètres de votre plugin
Certains plugins Zonos peuvent lire les identifiants à partir de champs que vous gérez déjà dans votre boutique, comme un attribut personnalisé. Ouvrez les paramètres de votre plugin Zonos et recherchez une option de mappage personnalisé ou de mappage des attributs. Si elle existe, mappez :
votre champ SKU vers SKU
le champ contenant le numéro du fabricant vers Manufacturer product ID
votre champ UPC ou EAN vers GTIN
Si votre plugin ne propose pas de mappage personnalisé, utilisez Zonos Catalog. Choisissez votre plateforme pour afficher ses étapes de configuration.
Important : le mappage des attributs pour le numéro du fabricant et le GTIN nécessite le module Zonos Checkout (zonos/checkout) en version 2.3.40 ou ultérieure. Pour vérifier la version installée, exécutez composer show zonos/checkout. Pour les étapes d'installation, consultez le guide d'intégration Magento.
Le plugin Magento lit le numéro du fabricant et le GTIN à partir des attributs produit. Si vos produits ne disposent pas encore d'attributs pour ces valeurs, créez-les d'abord.
1. Créer les attributs
Ignorez les attributs que vous possédez déjà.
Accédez à Stores > Attributes > Product et cliquez sur Add New Attribute.
Définissez Default Label sur un nom facile à reconnaître, par exemple ns_pid pour le numéro du fabricant ou gtin pour le code-barres.
Définissez Catalog Input Type for Store Owner sur Text Field et Values Required sur No.
Cliquez sur Save Attribute, puis répétez l'opération pour le second attribut.
2. Ajouter les attributs à vos jeux d'attributs
Accédez à Stores > Attributes > Attribute Set et ouvrez le jeu utilisé par vos produits.
Faites glisser chaque nouvel attribut depuis Unassigned Attributes vers un groupe, par exemple Product Details.
Cliquez sur Save. Répétez l'opération pour chaque jeu d'attributs utilisé par vos produits destinés à l'UE.
3. Renseigner les valeurs sur vos produits
Ouvrez chaque produit dans Catalog > Products et saisissez son numéro du fabricant et son GTIN. Pour définir des valeurs sur plusieurs produits à la fois, sélectionnez-les dans la grille des produits et choisissez Update attributes dans le menu Actions.
4. Mapper les attributs dans les paramètres Zonos
Accédez à Stores > Configuration > Zonos > Zonos Duty and Tax.
Faites défiler jusqu'aux champs de mappage des attributs (Brand, HS code, Length, etc.).
Définissez GTIN / EAN / UPC sur votre attribut de code-barres, par exemple gtin.
Définissez Manufacturer Product ID sur votre attribut de numéro du fabricant, par exemple ns_pid.
Si vous intégrez Zonos directement plutôt que via un plugin de plateforme, vous disposez de deux façons de fournir les identifiants : les enregistrer une fois par produit dans Zonos Catalog, ou les transmettre sur chaque article de votre requête. Catalog complète tout identifiant laissé vide dans votre requête; la plupart des marchands les enregistrent donc une seule fois et n'envoient rien de plus au moment de la soumission.
Identifiant sur cette page↕
Champ de l'API↕
Identifiant produit du marchand (M-PID)
sku ou productId
Numéro du fabricant
manufacturerProductId
S-PID (GTIN, UPC, EAN, ISBN)
gtin
Pour le M-PID, envoyez soit sku, soit productId. Les noms de champ sont identiques sur itemCreateWorkflow, sur les articles d'un panier et sur catalogItemCreate : rien ne change entre le parcours de la soumission et celui du catalogue.
Ajoutez les identifiants à chaque article dans itemCreateWorkflow. Utilisez cette méthode si vous ne gérez pas de catalogue avec Zonos, ou lorsque les identifiants d'un article diffèrent de son entrée de catalogue.
Envoyez le gtin uniquement sous forme de chiffres, sans tirets ni espaces. Les valeurs UPC, EAN, JAN et ISBN à 13 chiffres vont toutes dans ce même champ, et Zonos détermine la norme concernée à partir du numéro lui-même.
Correct : 012345678905
Refusé : 0-12345-67890-5
Si vous disposez d'un ISBN à 10 chiffres, envoyez plutôt sa version à 13 chiffres, car un ISBN à 10 chiffres peut se terminer par la lettre X.
Si un produit n'a pas de code-barres, omettez gtin plutôt que d'envoyer une chaîne vide, de réutiliser votre SKU ou de le remplir avec un texte de substitution comme N/A. Un identifiant qui renvoie au mauvais produit est pire que l'absence d'identifiant, car la douane peut l'utiliser pour identifier la marchandise.
Ajouter les identifiants produit UE
Ajouter les identifiants produit UE (PID)
Ajoutez les identifiants produit exigés par l'UE pour les envois B2C de faible valeur, pour chaque intégration Zonos.
À partir du 1er novembre 2026, l'UE exige des identifiants produit (PID) pour chaque article des envois entre entreprises et consommateurs entrant dans l'UE d'une valeur de 150 € ou moins. Les envois qui en sont dépourvus peuvent être retenus ou refusés par la douane. Ce guide indique où ajouter les identifiants pour chaque intégration Zonos.
Pour en savoir plus sur la réglementation, notamment les codes TARIC et les exceptions, consultez le guide des identifiants produit UE (PID).
Éléments requis
Chaque produit nécessite jusqu'à trois identifiants. Deux sont toujours obligatoires; le S-PID n'est obligatoire que si le produit en possède un.
TSHIRT-BLU-MMX-500-BLK012345678905Pour l'identifiant produit du marchand (M-PID), vous pouvez utiliser soit le SKU du produit, soit son ID produit. Un seul des deux suffit.
Si vous fabriquez vous-même le produit, votre propre numéro de modèle ou référence constitue le numéro du fabricant.
Où les ajouter
Les marchands Shopify ajoutent les identifiants dans Shopify, et Zonos les récupère automatiquement. Pour toutes les autres intégrations, ajoutez-les dans Zonos Catalog, ou mappez-les à partir des champs de votre boutique si les paramètres de votre plugin proposent un mappage personnalisé.
Shopify
Ajoutez les trois identifiants sur chaque variante dans l'administration Shopify. L'application Zonos les récupère.
Conseils :
Toute intégration : Zonos Catalog ou mappage du plugin
Magento, WooCommerce, BigCommerce, Miva et toute autre intégration peuvent ajouter les identifiants dans Zonos Catalog. Certains plugins peuvent également les mapper à partir des champs de votre boutique. Choisissez l'option la mieux adaptée à votre gestion actuelle des données produit.
Option 1 : Zonos Catalog
Pour un catalogue volumineux, ajoutez les identifiants dans un fichier d'import de catalogue plutôt que de modifier les articles un par un. Assurez-vous que le SKU de chaque article dans Zonos Catalog correspond exactement au SKU de votre boutique.
Zonos utilise les identifiants de Zonos Catalog uniquement si :
Si vous imprimez les étiquettes en dehors de Dashboard sans appeler l'API Zonos pour obtenir les détails catalogue, collaborez avec votre fournisseur d'étiquettes pour inclure les identifiants lors de l'impression de l'étiquette.
Pour savoir où saisir vos PID selon votre transporteur, consultez notre guide des identifiants produit UE.
Option 2 : Mappage personnalisé dans les paramètres de votre plugin
Certains plugins Zonos peuvent lire les identifiants à partir de champs que vous gérez déjà dans votre boutique, comme un attribut personnalisé. Ouvrez les paramètres de votre plugin Zonos et recherchez une option de mappage personnalisé ou de mappage des attributs. Si elle existe, mappez :
Si votre plugin ne propose pas de mappage personnalisé, utilisez Zonos Catalog. Choisissez votre plateforme pour afficher ses étapes de configuration.
Le plugin Magento lit le numéro du fabricant et le GTIN à partir des attributs produit. Si vos produits ne disposent pas encore d'attributs pour ces valeurs, créez-les d'abord.
1. Créer les attributs
Ignorez les attributs que vous possédez déjà.
ns_pidpour le numéro du fabricant ougtinpour le code-barres.2. Ajouter les attributs à vos jeux d'attributs
3. Renseigner les valeurs sur vos produits
Ouvrez chaque produit dans Catalog > Products et saisissez son numéro du fabricant et son GTIN. Pour définir des valeurs sur plusieurs produits à la fois, sélectionnez-les dans la grille des produits et choisissez Update attributes dans le menu Actions.
4. Mapper les attributs dans les paramètres Zonos
gtin.ns_pid.API Checkout et Landed Cost
Si vous intégrez Zonos directement plutôt que via un plugin de plateforme, vous disposez de deux façons de fournir les identifiants : les enregistrer une fois par produit dans Zonos Catalog, ou les transmettre sur chaque article de votre requête. Catalog complète tout identifiant laissé vide dans votre requête; la plupart des marchands les enregistrent donc une seule fois et n'envoient rien de plus au moment de la soumission.
skuouproductIdmanufacturerProductIdgtinPour le M-PID, envoyez soit
sku, soitproductId. Les noms de champ sont identiques suritemCreateWorkflow, sur les articles d'un panier et surcatalogItemCreate: rien ne change entre le parcours de la soumission et celui du catalogue.Ajoutez les identifiants à chaque article dans
itemCreateWorkflow. Utilisez cette méthode si vous ne gérez pas de catalogue avec Zonos, ou lorsque les identifiants d'un article diffèrent de son entrée de catalogue.mutation ItemCreateWorkflow($input: [ItemCreateWorkflowInput!]!) {itemCreateWorkflow(input: $input) {idskumanufacturerProductIdgtin}}Envoyez le
gtinuniquement sous forme de chiffres, sans tirets ni espaces. Les valeurs UPC, EAN, JAN et ISBN à 13 chiffres vont toutes dans ce même champ, et Zonos détermine la norme concernée à partir du numéro lui-même.0123456789050-12345-67890-5Si vous disposez d'un ISBN à 10 chiffres, envoyez plutôt sa version à 13 chiffres, car un ISBN à 10 chiffres peut se terminer par la lettre X.
Si un produit n'a pas de code-barres, omettez
gtinplutôt que d'envoyer une chaîne vide, de réutiliser votre SKU ou de le remplir avec un texte de substitution commeN/A. Un identifiant qui renvoie au mauvais produit est pire que l'absence d'identifiant, car la douane peut l'utiliser pour identifier la marchandise.Avant le 1er novembre
Cette page vous a-t-elle été utile?