Importer et exporter des produits avec Excel
Exportez des produits avec tous les forfaits. Lite et Premium permettent aussi d’importer de nouveaux produits ou de mettre à jour des produits existants depuis un classeur .xlsx. Utilisez Télécharger le modèle sur la page Produits ou exportez vos produits pour modifier le fichier.
Conserver la structure du modèle
Utilisez exactement Products et Links, avec un tableau par feuille : ProductsTable et LinksTable, commençant en A1. Conservez les en-têtes téléchargés dans leur ordre initial, y compris les colonnes facultatives. N’ajoutez pas de feuilles, de totaux, de formules ni de notes hors des tableaux. Ajoutez les lignes dans les tableaux. Les lignes vides sont ignorées. Les couleurs, les largeurs et l’ordre des onglets peuvent changer.
Utilisez un fichier .xlsx non protégé : 10 Mio téléversés, 100 Mio décompressés et 2 000 produits maximum. Les limites existantes de 16 sujets, 32 liens et quatre liens par sujet s’appliquent. Les nouveaux produits doivent aussi respecter la limite du forfait.
Products / ProductsTable
| Colonne | Valeur à saisir |
|---|---|
| ProductKey | Clé obligatoire dans le fichier, par exemple coffee250. Réutilisez la même clé dans Links. |
| GTIN | Texte obligatoire. GTIN-8, GTIN-12, GTIN-13 ou GTIN-14 valide. Conservez les zéros initiaux. |
| Name | Nom affiché obligatoire, 200 caractères maximum. |
| Resolver | Origine HTTPS facultative, sans chemin, requête ni fragment. Une cellule vide utilise le résolveur CodePersist configuré; l’exportation laisse la cellule vide pour ce résolveur. Un domaine personnalisé doit appartenir à votre espace de travail et être actif. Conservez le domaine personnalisé d’un produit existant; laisser la cellule vide ne transfère pas ce produit. |
| ShowLinkChoices | true affiche une page où les visiteurs choisissent parmi les liens du produit après le scan. false ou une cellule vide redirige vers le lien par défaut. |
| QrErrorCorrection | L, M, Q ou H. Laissez vide pour utiliser M. L’exportation laisse cette cellule vide lorsque la valeur enregistrée est M. |
| XDimensionMm | Taille du module QR en millimètres, de 0.396 à 0.990 par pas de 0.001. Laissez vide pour utiliser 0.495. L’exportation laisse cette cellule vide lorsque la valeur enregistrée est 0.495. |
Links / LinksTable
| Colonne | Valeur à saisir |
|---|---|
| ProductKey | Obligatoire. ProductKey exact de Products. |
| TopicKey | Sujet de l’éditeur : allergens, ingredients, nutrition, instructions, certification, safety, quick-start, tutorials, handling-storage, recall-status, registration, service, support ou verification-service. Les sujets sont déduits des liens. Laissez cette cellule vide sur exactement une ligne par produit pour identifier sa page produit obligatoire. |
| Title | Titre du lien obligatoire destiné aux clients, 200 caractères maximum. |
| Url | Destination HTTP ou HTTPS absolue obligatoire, 2 048 caractères maximum, sans identifiants intégrés. |
| Languages | Codes de langue facultatifs séparés par des points-virgules, par exemple en;fr-CA;es. Utilisez deux lettres, avec éventuellement une région de deux lettres. Laissez vide pour product-page; ses métadonnées de langue enregistrées sont conservées. |
| IsDefault | true sélectionne ce lien par défaut pour le produit. Utilisez true sur une seule ligne par produit au maximum; plusieurs valeurs true sont refusées. false ou une cellule vide laisse la ligne non sélectionnée. Sans sélection, la page produit est utilisée. |
| LinkId | Identifiant facultatif fourni par l’exportation pour un lien enregistré. Conservez-le pour modifier un lien existant; laissez-le vide pour chaque nouveau lien, y compris ceux d’un nouveau produit. Chaque identifiant fourni doit appartenir à ce produit et ne figurer qu’une fois. L’identifiant de la page produit reste sur sa ligne. Une cellule vide ou contenant seulement des espaces crée toujours un nouveau lien. |
Exemple complet — utilisez la même clé de produit sur chaque feuille
Ces lignes décrivent un café, sa page produit obligatoire et des liens d’ingrédients en anglais et en français. Conservez le GTIN en Texte : 09506000134352. Un Resolver vide utilise le résolveur CodePersist configuré. Saisissez votre domaine personnalisé actif seulement pour l’utiliser. Remplacez les destinations par vos URL publiques. Le modèle ne contient aucun produit d’exemple à supprimer.
Products
| ProductKey | GTIN | Name | Resolver | ShowLinkChoices | QrErrorCorrection | XDimensionMm |
|---|---|---|---|---|---|---|
| coffee250 | 09506000134352 | Ground coffee 250g | false |
Links
| ProductKey | TopicKey | Title | Url | Languages | IsDefault | LinkId |
|---|---|---|---|---|---|---|
| coffee250 | Product page | https://brand.example/coffee | true | |||
| coffee250 | ingredients | Ingredients | https://brand.example/coffee/ingredients/en-es | en;es | ||
| coffee250 | ingredients | Ingrédients | https://brand.example/coffee/ingredients/fr | fr |
Plusieurs langues et valeurs des cellules
Séparez les codes de langue par des points-virgules dans Languages, par exemple en;fr-CA;es. Les espaces autour des codes sont ignorés. Laissez Languages vide pour product-page. Utilisez true ou false pour ShowLinkChoices et un point pour les décimales, par exemple 0.495. Les cellules numériques Excel sont acceptées. Les sujets sont déduits des liens; les sujets vides ne peuvent pas être importés.
Vérifier, importer et publier
Choisissez Importer Excel, téléversez le fichier et corrigez les erreurs. La validation n’enregistre rien. L’aperçu distingue les nouveaux produits des mises à jour, compte les sujets et liens et indique les suppressions. La publication est sélectionnée par défaut pour les produits admissibles; décochez des produits pour enregistrer seulement des brouillons ou utilisez la sélection globale. Confirmez une fois pour commencer. Gardez la fenêtre ouverte pendant les enregistrements successifs. Toutes les tentatives d’enregistrement se terminent avant le début des publications. Si tous les enregistrements réussissent, les versions sélectionnées sont publiées.
Mettre à jour des produits existants
La correspondance utilise l’origine normalisée du résolveur et le GTIN dans votre espace de travail. Un résolveur vide sélectionne celui de CodePersist, jamais un domaine personnalisé existant. Un GTIN existant sur un autre résolveur est refusé. Chaque importation confirmée crée une révision. Les liens modifiables omis et leurs sujets vides sont supprimés; les sujets masqués et ressources hors éditeur restent sur le serveur. Conservez le LinkId exporté pour modifier ce lien en gardant ses métadonnées, même si son URL ou ses langues changent. Laissez LinkId vide pour créer un nouveau lien avec les métadonnées par défaut. Déplacer un lien entre sujets facultatifs conserve ses métadonnées et ajoute la relation requise par le nouveau sujet. Sélectionnez un seul IsDefault par produit au maximum; sans sélection, la page produit est utilisée. Les produits désactivés restent désactivés. Les versions publiées restent actives jusqu’à la publication des remplacements.
En cas d’échec d’enregistrement ou de publication
Si un enregistrement échoue, les autres sont tentés et la publication automatique est suspendue. Réessayez les produits échoués, publiez seulement les produits sélectionnés enregistrés ou quittez sans publier. Réessayer un enregistrement ne lance pas automatiquement la publication. Les enregistrements réussis ne sont pas répétés. Les nouvelles tentatives de publication utilisent la révision enregistrée et n’en créent pas une autre. Les nouvelles tentatives d’enregistrement conservent la version vérifiée au départ et ne peuvent pas résoudre un conflit de version. Si une modification est survenue après l’aperçu ou qu’une erreur réseau laisse l’écriture précédente incertaine, vérifiez les produits actuels et exportez un nouveau classeur. Quittez et rouvrez l’importation pour téléverser vos modifications et les vérifier de nouveau. Fermer la fenêtre n’annule pas les enregistrements terminés et ne programme aucune reprise.
Erreurs courantes et corrections
Products · ligne 1 : structure invalide — rétablissez un en-tête renommé ou déplacé à partir d’un nouveau modèle. Products · ligne 2 · GTIN : texte requis — formatez la cellule en Texte et retapez le GTIN; changer seulement le format ne rétablit pas les zéros perdus. Links · ligne 3 · ProductKey : référence inconnue — copiez la clé exacte de Products. Formule non prise en charge — collez une valeur. Valeur hors tableau — agrandissez le tableau d’origine pour inclure vos lignes. Les messages apparaissent dans la langue de l’application avec la feuille, la ligne et la colonne.
Exporter tous les produits ou une sélection
Dans Produits, sélectionnez des lignes puis choisissez Exporter la sélection. Pour exporter tout le catalogue, effacez la recherche, choisissez Tous les statuts, sélectionnez cette page puis tous les produits correspondants. Les sélections restent cochées entre les pages, recherches et filtres. Le modèle Excel se télécharge dans Plus. L’exportation comprend les champs modifiables, les sujets sélectionnés, les titres, URL et langues des liens et les paramètres QR, y compris pour les produits désactivés sélectionnés. Les définitions des sujets, les métadonnées masquées et les ressources absentes de l’éditeur restent sur le serveur. Le classeur peut être modifié et réimporté avec un forfait payant. Il exclut l’historique, les statistiques, les fichiers de codes, les identifiants secrets et la configuration du fournisseur.