Importer un catalogue fournisseur dans Sylius avec l'IA
Pour importer un catalogue fournisseur (CSV, Excel ou PDF) dans Sylius avec un agent IA, l'agent lit le fichier, en extrait les produits, propose la correspondance entre les colonnes du fournisseur et vos champs Sylius, reconnaît les produits déjà présents et prépare le tout dans une zone d'attente. Des contrôles automatiques et une validation humaine précèdent l'import. Rien n'arrive dans la boutique sans votre accord.
Chaque fournisseur a son format. L'un envoie un CSV propre, l'autre un Excel aux colonnes fusionnées, un troisième un PDF de cinquante pages. Remettre tout cela au format de votre boutique, produit par produit, prend des jours à chaque nouvelle collection. Je suis développeur Sylius indépendant, j'intègre des agents IA dans des boutiques Sylius, et l'import fournisseur est un cas où l'IA enlève la partie la plus pénible : la lecture et la remise en forme.
Pourquoi l'import fournisseur est-il si pénible ?
Parce qu'il n'y a pas de format commun. Les colonnes portent des noms différents, les tailles sont écrites de dix façons, les unités varient, les descriptions sont dans une langue ou une autre, et les PDF mélangent tableaux et texte libre. Un script d'import classique fonctionne pour un format figé ; il casse au premier changement. Résultat : la saisie retombe sur une personne, avec son lot d'erreurs de copie.
L'administration standard de Sylius ne propose pas d'import de catalogue par fichier. Il faut passer par un plugin, un script ou l'API, ce qui suppose des données déjà propres. C'est précisément l'étape qui manque.
Comment l'agent lit-il un CSV, un Excel ou un PDF ?
Pour un CSV ou un Excel, la lecture des cellules est faite par du code classique, sans IA : c'est plus sûr et plus économique. Le modèle intervient pour comprendre ce que contiennent les colonnes et proposer leur correspondance avec vos champs. Pour un PDF, le modèle extrait les tableaux et le texte, ce qui est plus fragile et justifie des contrôles renforcés.
| Étape | Qui la fait | Contrôle |
|---|---|---|
| Lecture des cellules CSV ou Excel | Code, sans IA | Nombre de lignes lues comparé au fichier |
| Extraction d'un PDF | Modèle de langage | Échantillon relu, totaux vérifiés |
| Correspondance des colonnes avec Sylius | Modèle, proposition | Validée une fois par fournisseur, puis réutilisée |
| Rattachement aux produits existants | Code, par référence ou code | Correspondance incertaine signalée |
| Normalisation des tailles, unités, valeurs | Modèle et règles | Valeurs hors liste signalées |
| Import dans Sylius | Code, après validation | Rapport d'import ligne par ligne |
Ce découpage suit un principe que j'applique partout : ne confier au modèle que ce que le code ne sait pas faire. Le routeur de modèles réserve un modèle capable à l'extraction des PDF difficiles et un modèle plus léger aux tâches simples.
Et si un agent le faisait pour vous ?
Laissez votre numéro : je vous rappelle sous 24 heures ouvrées et je regarde avec vous ce qu'un agent peut prendre en charge dans votre boutique, dans votre budget.
Comment les données arrivent-elles dans Sylius ?
L'agent prépare chaque produit dans la structure de Sylius : produit, traduction par langue, options et variantes (taille, couleur), attributs, taxon, codes. Les produits nouveaux et les mises à jour sont présentés séparément, avec les écarts par rapport à l'existant. Une fois le lot validé, l'import passe par l'API d'administration de Sylius 2, réservée au rôle ROLE_API_ACCESS dans la configuration standard, ou par du code dans la boutique.
Les produits importés arrivent de préférence désactivés, le temps de compléter les visuels et les textes. L'enrichissement des caractéristiques et la rédaction des descriptions sont des étapes à part, décrites dans l'article sur les attributs et l'article sur les fiches produits. Le classement dans les catégories est traité dans l'article sur les taxons.
Ce que l'agent ne fait jamais seul
L'agent n'importe rien sans validation, ne met en ligne aucun produit, ne modifie ni prix ni stock d'un produit existant, ne supprime aucun produit absent du nouveau fichier et ne fusionne pas deux produits sur une correspondance incertaine. Il prépare, compare, signale ; une personne valide le lot. Ces interdits sont dans le code, sous forme de garde-fous : l'agent n'a pas d'outil pour publier ou supprimer.
Le rapport de chaque lot distingue clairement trois piles : les produits nouveaux, les mises à jour avec leurs écarts, et les lignes écartées avec la raison du rejet, comme une référence absente ou une unité incompréhensible. La relecture porte ainsi sur les cas qui le méritent, pas sur des centaines de lignes sans histoire.
Ce n'est pas de la prudence excessive. Un import raté peut dupliquer des centaines de produits ou écraser des prix en ligne en quelques secondes. La zone d'attente coûte quelques minutes de relecture ; une erreur en production coûte une journée de réparation.
Comment fiabiliser l'import dans la durée ?
La correspondance validée pour chaque fournisseur est enregistrée et réutilisée : le deuxième fichier du même fournisseur passe beaucoup plus vite que le premier. L'agent ne revient vers vous que si le format a changé. Chaque import est tracé, avec le fichier source, les correspondances appliquées, les lignes importées et celles écartées. Ce sont les tests et les traces, qui permettent de retrouver d'où vient une donnée des mois plus tard.
Les commandes et factures fournisseurs, qui arrivent elles aussi en PDF, relèvent d'un autre circuit, détaillé dans l'article sur les factures fournisseurs.
Par où commencer ?
Prenez le fichier du fournisseur qui vous coûte le plus de temps, et celui qui change le plus souvent de format. Ce sont vos deux cas de test. Je propose un diagnostic IA offert : je vous rappelle sous 24 heures ouvrées, j'examine vos fichiers fournisseurs et votre boutique Sylius, et je vous propose la solution qui rentre dans votre budget, avec un code qui vous appartient.