Documentation

Importer et exporter le catalogue

Enregistrer votre catalogue dans un fichier, le recharger, fusionner ou remplacer vos produits à partir d'un fichier JSON.

Sur cette page

La page Catalogue sait enregistrer tout votre catalogue dans un fichier, et le recharger. C'est utile pour garder une copie, pour préparer de nombreux produits d'un coup, ou pour reprendre un catalogue existant.

Le fichier est au format JSON (un format texte structuré). Il ne contient pas les photos elles-mêmes.

Exporter le catalogue

  1. Ouvrez Catalogue.
  2. Cliquez sur la flèche à droite du bouton Ajouter, puis sur Exporter le catalogue.
  3. Le fichier products-AAAAMMJJ-HHmm.json se télécharge.

Le fichier contient tous vos produits, quels que soient la recherche ou le filtre affichés : pour chacun, son nom, sa description, son prix, son unité, sa disponibilité, sa catégorie, son producteur, sa position et la référence de sa photo.

À savoir

L'export ne contient ni les photos, ni l'adresse des producteurs, ni les icônes et l'ordre des catégories. Ce n'est donc pas une sauvegarde complète de votre espace.

Importer un catalogue

  1. Ouvrez Catalogue, cliquez sur la flèche à droite du bouton Ajouter, puis sur Importer un catalogue….
  2. Choisissez le fichier JSON (5 Mo au maximum). Rien n'est encore enregistré : Ma Commande affiche un aperçu.
  3. Lisez l'aperçu : nombre de produits lus, nouveaux et déjà présents, et remarques éventuelles (produits ignorés ou corrigés).
  4. Choisissez le Mode d'import : Fusionner ou Remplacer tout le catalogue.
  5. Cliquez sur Importer.
Fenêtre Importer un catalogue : fichier choisi, aperçu de 187 produits lus et choix du mode d'import Fusionner ou Remplacer tout le catalogue (agrandir l'image)
L'aperçu d'un import, avant confirmation.

L'import est enregistré en entier, ou pas du tout : en cas d'erreur, votre catalogue reste tel qu'il était.

Fusionner ou remplacer

Mode Produits déjà présents Produits nouveaux Produits absents du fichier
Fusionner (par défaut) mis à jour ajoutés conservés
Remplacer tout le catalogue mis à jour ajoutés supprimés

Attention

Remplacer tout le catalogue supprime définitivement les produits qui ne figurent pas dans le fichier. Les commandes déjà passées n'en sont pas affectées.

Quand un produit est-il « déjà présent » ?

Un produit du fichier correspond à un produit existant :

  • s'il porte l'identifiant d'un produit de ce catalogue (cas d'un fichier exporté depuis votre espace) ;
  • sinon, s'il a le même nom chez le même producteur.

Dans les autres cas, il est créé comme nouveau produit.

Ce que l'import vérifie

Chaque produit doit avoir un nom, un producteur et une catégorie, et un prix compris entre 0 et 100 000 €. Un produit qui ne respecte pas ces règles, ou dont un texte est trop long, est ignoré et signalé dans l'aperçu. Une unité manquante est remplacée par votre première unité.

Les producteurs, catégories et unités que le fichier nomme sans qu'ils existent sont créés (sans tenir compte des majuscules : « légumes » et « Légumes » désignent la même catégorie).

Et les photos ?

Le fichier ne transporte qu'une référence de photo, jamais l'image. Une référence n'est reprise que si elle désigne une photo de votre propre espace ; sans référence, un produit déjà présent garde sa photo. Importer le catalogue d'un autre espace crée donc des produits sans photo.

Limites

  • Fichier de 5 Mo au plus.
  • L'import est refusé s'il porterait votre catalogue au-delà de 3 000 produits.

Vous ne trouvez pas la réponse ? Écrivez au support : [email protected], en indiquant la Référence de votre espace (menu Paramètres).