L’import crée ou met à jour vos produits à partir d’un fichier Excel (.xlsx) ou CSV, en quatre étapes : Fichier, Colonnes, Vérification, Import. Il peut aussi enregistrer votre stock de départ : les quantités initiales deviennent des opérations « Stock initial » comptabilisées et numérotées, une par dépôt. Les lignes en erreur sont écartées, le reste est importé.
Qui peut le faire ?
| Action | Permission | Rôles par défaut |
|---|---|---|
| Importer des produits | « Importer des produits » | Propriétaire, Administrateur, Responsable |
| Importer des quantités initiales | en plus, « Saisir le stock initial » sur chaque dépôt concerné | Propriétaire, Administrateur, Responsable |
| Créer des champs personnalisés pendant l’import | en plus, « Modifier les paramètres » | Propriétaire, Administrateur |
L’import est disponible dans toutes les formules, dans la limite de références actives et de champs personnalisés de votre formule.
Préparer votre fichier
- Format Excel (.xlsx) ou CSV (UTF-8), 10 Mo au maximum, une ligne d’en-têtes puis une ligne par produit.
- 20 000 lignes au maximum par fichier. Au-delà, découpez-le en plusieurs fichiers.
- Partez du modèle : à l’étape Fichier, cliquez sur « Télécharger le modèle ». Il contient une colonne par information, avec les en-têtes dans la langue de l’écran, et une ligne d’exemple à remplacer.
- Les en-têtes en français, arabe ou anglais sont reconnus automatiquement (« Référence », « Code article », « SKU », « المرجع »…).
Les colonnes possibles
| Colonne | Obligatoire ? | Ce qu’il faut savoir |
|---|---|---|
| Référence | Oui | Clé de l’import : une référence existante met à jour le produit (64 caractères max) |
| Désignation | Oui | 200 caractères max |
| Désignation arabe | Non | 200 caractères max |
| Description | Non | 2 000 caractères max |
| Catégorie | Non | Chemin avec > ou / : Quincaillerie > Visserie. 5 niveaux max. Créée si elle n’existe pas |
| Marque | Non | Créée si elle n’existe pas |
| Unité de base | Oui, sauf si vous choisissez une Unité par défaut | Code ou nom de l’unité (pce, pièce, kg…) |
| Code-barres | Non | Code de l’unité de base, clé de contrôle vérifiée |
| Coût unitaire | Non | En MAD HT, par unité de base |
| Stock minimum, Point de commande, Stock maximum | Non | En unité de base |
| Quantité initiale | Non | En unité de base ; devient du stock initial |
| Coût initial | Non | Coût unitaire du stock initial, en MAD HT |
| Dépôt | Non | Code ou nom du dépôt du stock initial ; sinon le Dépôt du stock initial choisi à l’étape 1 |
Étape 1 : Fichier
- Ouvrez Produits › Importer.
- Déposez votre fichier dans la zone, ou cliquez sur « Choisir un fichier ».
- Choisissez le Mode :
- « Créer ou mettre à jour par référence » : les références nouvelles sont créées, les existantes sont mises à jour ;
- « Créer uniquement (ignorer les références existantes) » : les références existantes sont écartées.
- Choisissez l’Unité par défaut (pour les lignes sans unité) et le Dépôt du stock initial (pour les lignes sans colonne dépôt).
Étape 2 : Colonnes
Chaque colonne de votre fichier s’affiche sur une ligne, avec jusqu’à 3 exemples de valeurs, une destination et un statut : « Reconnue », « Champ à créer », « Ignorée » ou « À corriger ».
- Vérifiez la destination proposée pour chaque colonne. Stocki la propose d’après l’en-tête, vos champs personnalisés existants et votre dernier import avec les mêmes en-têtes.
- Corrigez si besoin : une information de Stocki, un champ personnalisé existant, « Créer un champ personnalisé » ou « Ignorer cette colonne ».
- Pour transformer d’un coup toutes les colonnes non reconnues en champs personnalisés, activez « Créer automatiquement des champs personnalisés pour les colonnes non reconnues ».
- Pour chaque nouveau champ, vérifiez le Libellé (l’en-tête), le Code (lettres minuscules, chiffres et
_, en commençant par une lettre), le Type et, pour une liste, les Choix (séparés par des virgules). - Cliquez sur « Continuer ».
Le type d’un nouveau champ est proposé d’après les valeurs : Oui / non (oui, non, vrai, faux, نعم, لا…), Nombre, Date, Liste de choix (peu de valeurs différentes, souvent répétées : 12 au plus), sinon Texte. Les valeurs texte et liste de choix seront trouvées par la recherche de produits ; les nombres, dates et oui / non non.
Le compteur « Champs personnalisés : … / … » montre la place restante. Limites par formule : 3 (Petite), 5 (Moyenne), 10 (Grande). Une même destination ne peut servir qu’à une colonne.
Étape 3 : Vérification
Stocki contrôle tout le fichier et affiche :
- les compteurs « À créer », « À mettre à jour », « Inchangés », « Lignes en erreur », « Avertissements » et « Lignes de stock initial » ;
- votre limite de références actives après l’import (« Après l’import : … / … références actives. ») ;
- les 50 premières lignes avec leur résultat et leurs problèmes, ligne et colonne comprises. Activez « Seulement les lignes avec problème » pour ne voir qu’elles.
Une ligne en erreur est écartée entièrement (produit et stock initial). Les autres lignes sont importées. Un avertissement (par exemple « Quantité arrondie à 4 décimales. ») n’empêche pas l’import.
Le stock initial est expliqué avant de lancer : les quantités seront comptabilisées comme opérations « Stock initial », une par dépôt, numérotées, visibles dans Opérations et la fiche de stock.
Étape 4 : Import
- Cliquez sur « Importer … produits ».
- Suivez la progression : « Enregistrement des produits », puis « Comptabilisation du stock initial ». Vous pouvez quitter la page : l’import continue.
- À la fin, lisez le résultat : produits créés et mis à jour, lignes en erreur, numéros des opérations de stock initial (avec un lien vers chacune), et « … lignes ignorées » avec le motif.
- Cliquez sur « Télécharger le rapport d’erreurs » pour obtenir le détail ligne par ligne (feuille « Erreurs » : ligne, colonne, gravité, message).
- Corrigez ces lignes dans votre fichier et importez-le de nouveau : les produits déjà importés restent inchangés et aucun stock initial n’est comptabilisé deux fois.
Règles à connaître
- Une cellule vide n’efface jamais une valeur existante lors d’une mise à jour.
- Nombres :
1290.50,1290,50,1 290,50,1.290,50et les chiffres arabes sont acceptés. Pas de nombre négatif. - Quantités en unité de base, arrondies à 4 décimales (avec un avertissement). Coûts en MAD HT, arrondis au centime (avec un avertissement).
- Dates des champs personnalisés :
jj/mm/aaaa(ouaaaa-mm-jj). - L’unité de base d’un produit existant ne change pas par l’import.
- Stock initial uniquement là où le produit n’a pas encore de stock dans ce dépôt. Pour corriger un stock existant, faites un ajustement ou un inventaire.
- Pas de stock initial pour un produit archivé, ni sur un dépôt de transit ou un dépôt auquel vous n’avez pas accès.
- Le stock initial est comptabilisé par lots de 500 lignes au plus par opération, une série d’opérations par dépôt.
- Une ligne identique à une ligne précédente est ignorée ; une même référence avec des valeurs différentes, ou un même code-barres sur plusieurs références, est une erreur.
- Limite de références actives : l’import est refusé s’il vous ferait dépasser 110 % de la limite (« Import refusé : … »). Archivez des produits, importez moins de lignes ou changez de formule.
Erreurs fréquentes
| Message affiché | Ce que cela veut dire | Que faire |
|---|---|---|
| « Ce fichier ne peut pas être lu. Enregistrez-le au format .xlsx ou .csv (UTF-8) puis réessayez. » | Format non pris en charge (.xls ancien, fichier protégé…). | Dans Excel : Enregistrer sous › Classeur Excel (.xlsx) ou CSV UTF-8. |
| « Le fichier contient trop de lignes : 20 000 au maximum. » | Plus de 20 000 lignes. | Découpez le fichier. |
| « Colonnes obligatoires à choisir : … » | La référence, la désignation ou l’unité n’a pas de colonne. | Associez la colonne, ou choisissez une unité par défaut. |
| « Unité inconnue : créez-la ou corrigez la cellule. » | L’unité n’existe pas dans Paramètres › Unités. | Créez l’unité ou utilisez son code. |
| « Dépôt inconnu ou non autorisé pour le stock initial. » | Le dépôt n’existe pas ou vous n’y avez pas accès. | Créez le dépôt ou corrigez la cellule. |
| « Ce produit a déjà du stock dans ce dépôt : utilisez un ajustement ou un inventaire. » | Le stock initial ne s’ajoute pas à un stock existant. | Retirez la quantité, puis corrigez par ajustement ou inventaire. |
| « L’unité de base d’un produit existant ne peut pas changer. » | L’unité du fichier diffère de celle du produit. | Corrigez la cellule. |
| « Ce code-barres appartient déjà à un autre produit. » | Le code est sur un autre produit. | Vérifiez le code. |
| « Cette référence existe déjà (mode création seule). » | Mode Créer uniquement. | Normal, ou choisissez le mode mise à jour. |
| « Valeur refusée : nombre attendu. » (ou date, oui ou non, choix) | La cellule ne correspond pas au type du champ personnalisé. | Corrigez la valeur ou le type du champ. |
| « Coût initial sans quantité initiale. » | Un coût initial sans quantité. | Ajoutez la quantité ou videz le coût. |
Questions fréquentes
Mon fichier vient d’un autre logiciel avec des colonnes en plus. Ignorez-les, ou transformez-les en champs personnalisés (référence OEM, couleur, emplacement d’origine…) dans la limite de votre formule.
Puis-je importer des numéros de série ? Pas par l’import de produits. Les numéros de série se saisissent dans une entrée (voir Suivi par numéro de série).