Importer depuis un CSV ou Excel

De quoi s’agit-il ?

Importer depuis un CSV ou Excel transforme un tableur en recettes AreaCacao. Vous préparez le fichier, vous décidez de la signification de chaque colonne, et l’importateur crée (ou met à jour) les recettes. Aucune IA n’intervient dans la lecture du fichier et aucun crédit n’est consommé.

• Chemin : https://app.areacacao.com/import-recipe, onglet Nouvel import.
• Comment y accéder : barre latérale → FORMULATION → Importer des recettes → onglet Nouvel import. La carte se trouve sous la zone d’import des photos/PDF.
• Disponibilité : activée par défaut dans toutes les offres. La seule exception est le compte gratuit limité (celui auquel un compte peut passer quand l’essai de 14 jours se termine sans souscription) : en cliquant sur Importer un CSV/Excel, vous verrez le message « L’import depuis Excel ou CSV est inclus dans les offres Starter et Pro. » avec le bouton Voir les offres.

En quoi il diffère de l’import d’une photo ou d’un PDF

La seule étape où l’IA peut intervenir est facultative et c’est vous qui la choisissez : compléter les ingrédients absents de votre catalogue (voir la section Ingrédients absents du catalogue, plus bas).

La carte et ses deux boutons

La carte s’intitule « CSV ou Excel (sans crédits) » et son texte est : « Importez vos recettes depuis un tableur. Aucun crédit consommé et aucune limite d’utilisation. Importez une ou plusieurs recettes à la fois. »

Elle comporte deux boutons et un menu dépliant :

• Importer un CSV/Excel — ouvre l’assistant.
• Télécharger le modèle — télécharge le fichier directement, sans passer par le serveur.
• Guide rapide : comment préparer votre fichier — un menu dépliant avec les règles de remplissage, la liste des valeurs valides de filling_type et les valeurs de recipe_type.

Le modèle

Le bouton Télécharger le modèle enregistre areacacao-modele-recettes.csv sur votre ordinateur. C’est un CSV avec BOM UTF-8 (pour qu’Excel respecte les accents) qui contient l’en-tête canonique et trois recettes d’exemple, choisies pour montrer les trois schémas que l’importateur comprend :

1. Ganache au fruit de la passion — garniture simple : cinq lignes partagent le même recipe_name, et la dernière contient les étapes. Quatre ingrédients sont associés par ingredient_code et un seul (la pulpe de fruit de la passion) uniquement par son nom.
2. Truffe classique au cacao — garniture en couches : la colonne part sépare « Intérieur » d’« Enrobage ».
3. Tablette noire 70 % — recette de chocolat : elle utilise chocolate_type et cocoa_percent, et laisse filling_type vide.

Le modèle suit la langue de l’interface : avec l’application en français, le fichier s’appelle areacacao-modele-recettes.csv et les noms des recettes, des ingrédients, des sections et des étapes sont en français ; les en-têtes et les identifiants (ganache_bombon, negro…) restent toujours les mêmes. Les coûts d’exemple sont au kilo (cost_unit = kg) et en euros (EUR).

Vous n’êtes pas obligé d’utiliser le modèle : vous pouvez importer votre propre feuille avec vos propres en-têtes et indiquer, à l’étape d’association, à quoi correspond chaque colonne.

Colonnes

Le modèle contient 17 colonnes, dans cet ordre :

recipe_name, recipe_type, chocolate_type, filling_type, cocoa_percent, part, ingredient_code, ingredient_name, quantity, unit, weight_g, cost_per_unit, cost_unit, cost_currency, is_supply, supply_code, steps

Dans l’assistant, vous pouvez associer 18 champs : les 17 du modèle plus recipe_id (ID de la recette), qui existe comme destination d’association même s’il ne figure pas dans le modèle.

Comment les lignes sont regroupées

Les lignes sont regroupées par recipe_name normalisé : minuscules, sans accents et avec les espaces internes réduits à un seul. Autrement dit, « Praliné Noisette Grillée » et « praline noisette grillee » aboutissent à la même recette.

Règles de remplissage appliquées par l’importateur

• Un ingrédient par ligne. N’écrivez pas la liste complète des ingrédients dans une seule cellule : l’importateur ne peut pas la découper.
• Étapes avec |. Il suffit de remplir steps sur n’importe quelle ligne de la recette.
• Couches avec part. Même recipe_name sur toutes les lignes et le nom de la couche dans part. Si la recette n’a qu’une couche, laissez part vide.
• filling_type avec l’identifiant exact, en minuscules et avec des tirets bas. ganache tout court n’est pas une valeur valide ; la ganache classique de bonbon est ganache_bombon. La liste complète se trouve dans le menu dépliant Guide rapide de l’écran.

L’assistant, pas à pas

L’assistant s’intitule « Importer des recettes depuis un CSV » et comporte cinq écrans.

Ingrédients absents du catalogue

L’importateur traite chaque ligne ainsi : s’il y a un ingredient_code, il cherche cette fiche précise ; sinon, il cherche par nom dans votre catalogue. Si le nom correspond à plusieurs fiches, la ligne reste en attente avec une courte liste de fiches candidates parmi lesquelles choisir dans la recette ; si la fiche a été déduite en retirant une marque ou un pourcentage du nom, la ligne est signalée pour que vous la vérifiiez. Quand il ne trouve rien, il applique l’option choisie à l’étape Options :

• Créer les ingrédients manquants comme « en attente » (sans coût) — « Les ingrédients introuvables sont ajoutés avec le statut « en attente », sans données nutritionnelles ni de coût. Vous pourrez les compléter plus tard. Ne consomme aucun crédit. » C’est l’option par défaut.
• Compléter les ingrédients manquants avec l’IA — 5 crédits par ingrédient — « Pour chaque ingrédient introuvable, l’IA estime les macros, les allergènes et les données de coût. 5 crédits sont facturés par nouvel ingrédient. »

Fournitures

Les lignes marquées avec is_supply ou supply_code sont traitées comme des fournitures. Elles sont reliées uniquement par code à votre catalogue de fournitures. Si le code n’existe pas, la ligne est tout de même importée mais signalée pour vérification, et le total Fournitures introuvables de l’aperçu vous prévient à l’avance. L’import ne crée jamais de nouvelles fournitures — pas même en mode IA, qui ne s’applique qu’aux ingrédients.

Créer ou mettre à jour

• Sans recipe_id → une nouvelle recette est toujours créée.
• Avec recipe_id → si cet identifiant existe et vous appartient, la recette est mise à jour. S’il n’existe pas ou ne vous appartient pas, une nouvelle recette est créée.
• Quand une recette est créée avec un nom qui existe déjà dans votre catalogue, AreaCacao différencie automatiquement le nom au lieu de le dupliquer aveuglément. Cela ne s’applique qu’à la création, jamais à la mise à jour.
• Une recette en erreur n’interrompt pas le lot : elle est marquée avec son erreur et l’importateur passe à la suivante.

Limites

Si vous tentez de lancer un import alors qu’un autre est encore en file d’attente ou en cours de traitement, le serveur le refuse : il faut attendre que le précédent soit terminé.

Ce qu’il NE fait PAS

• Il ne lit pas votre fichier avec l’IA. L’association des colonnes vous revient et l’analyse du fichier est déterministe.
• Il n’apparaît pas dans l’onglet Historique. Cet onglet liste les imports de photos et de PDF. Même si l’assistant indique « Vous pouvez fermer cette fenêtre ; l’import continue et vous le retrouverez dans l’Historique. », les imports depuis un tableur n’apparaissent aujourd’hui sur aucun écran : leur statut n’est visible que dans la fenêtre de l’assistant tant qu’elle reste ouverte. Si vous la fermez, l’import continue, mais pour vérifier le résultat il faudra regarder dans Mes recettes.
• Il ne peut pas être annulé. Une fois que vous avez cliqué sur Importer, il n’y a pas de bouton d’annulation ; l’assistant permet seulement de fermer la fenêtre.
• Il ne crée pas de nouvelles fournitures.
• Il ne lit pas plus d’une feuille d’un classeur Excel.
• Il n’importe pas depuis un lien Google Sheets ni depuis une URL : il faut envoyer le fichier. Pour importer depuis une page web, il existe une autre option, voir Importer une recette par URL.
• Il ne valide pas filling_type à votre place. Si vous saisissez un identifiant qui n’existe pas, la recette est importée sans validation technique de garniture.

Étapes suivantes