Régler les stocks depuis un CSV

Le problème

Votre fournisseur vous envoie un inventaire. Vous sortez un comptage de votre tableur. Et il faut reporter trois cents quantités à la main dans le back-office, une fiche après l'autre.

Comment ça marche

Deux colonnes suffisent : l'identifiant du produit, et la quantité.

id;quantite
42;17
43;0

Trois colonnes pour viser une déclinaison précise :

id;declinaison;quantite
51;120;8
51;121;3

Le séparateur est détecté : point-virgule, virgule, tabulation ou barre verticale. Le fichier que votre tableur vient de produire convient tel quel, y compris en « CSV UTF-8 » avec sa marque d'octets invisible.

La première ligne n'est traitée comme un en-tête que si elle ne commence pas par un nombre : un export sans ligne de titres garde donc son premier produit.

L'essai à blanc est actif par défaut

Sur un module qui écrit dans votre stock, le premier geste ne doit pas être celui qui écrit. L'essai à blanc lit le fichier, affiche le séparateur détecté, l'en-tête reconnu, les lignes applicables et les lignes refusées — et n'écrit rien.

Ce qu'il refuse, et pourquoi c'est le cœur du module

Un refus porte sur une ligne, pas sur le fichier : l'import va au bout sans elle, et le rapport nomme son numéro de ligne.

Ligne	Ce qui se passe
42;rupture	refusée. Une cellule de texte ne met pas un produit à zéro.
42;10.6	refusée. Une quantité décimale n'est pas tronquée à 10 — c'est une question à vous poser.
42;12 pièces	refusée. Elle ne vaut pas 12.
REF-123;10	refusée. Ce module travaille sur les identifiants de produit, pas sur les références.
51;8 quand 51 a des déclinaisons	refusée, et le message vous dit d'ajouter la colonne de déclinaison.
51;999;8 quand 999 appartient à un autre produit	refusée. Une erreur de colonnes ne crée pas de stock fantôme.
42;10 deux fois	la dernière vaut, et le rapport nomme la ligne remplacée. Les quantités ne s'additionnent pas.

Un produit à déclinaisons ne peut pas être réglé en deux colonnes, et le module le dit plutôt que de deviner. La table de stock porte une ligne par déclinaison, plus une ligne agrégée que PrestaShop recalcule comme leur somme : écrire la même valeur partout donne un stock juste à l'instant de l'import, puis faux à la première vente.

Ce qu'il écrit, et par où

Aucune requête SQL dans les tables de stock. Le module passe par l'API de la boutique — celle qui tient la ligne agrégée, respecte le contexte de boutique, inscrit le mouvement de stock et prévient les autres modules qui en dépendent.

Après l'import, la quantité est relue et comparée à celle demandée : le rapport ne dit « réglé » que sur ce qui l'est vraiment. En multiboutique, l'import s'applique à la boutique du contexte courant, et le rapport la nomme.

Les bornes

Borne	Valeur	Pourquoi
Taille du fichier	8 Mo	au-delà, découpez
Nombre de lignes	20 000	un import tué par le délai d'exécution du serveur laisse un catalogue à moitié réglé sans qu'on sache où il s'est arrêté. Le refus arrive avant la première écriture.
Lignes par appel	500	borne la mémoire, ne change rien au résultat

Si vous veniez de la version 1.0.0

Elle ne fonctionnait pas sur PHP 8, et c'est mesuré : un fichier de moins de 500 lignes ne changeait rien du tout, et l'écran rendait une erreur serveur. Elle faisait aussi dériver le stock des produits à déclinaisons — 10 demandé, 29 annoncé à la première vente.

Les quantités déjà posées par la 1.0.0 ne sont pas corrigées par la mise à jour : elle ne peut pas savoir ce que vous vouliez. Un produit dont le stock a dérivé se règle en redéposant son fichier, cette fois avec la colonne de déclinaison — l'essai à blanc vous montrera le résultat avant de l'écrire.

Installation

Back-office → Modules → Installer un module → déposer le .zip, puis Configurer. Aucune table créée, aucun greffon posé, aucune clé de configuration : la désinstallation ne laisse rien derrière elle.

Le module n'a qu'un seul point d'entrée, la page de configuration, derrière la session employé et le jeton d'administration que PrestaShop pose lui-même.