LNK Numérotation et références : vos numéros de facture, d'avoir et de bon de livraison, et le bon de commande du client
Votre client professionnel a un numéro de bon de commande, et sa comptabilité ne paie pas une facture qui ne le porte pas. Aujourd'hui, il l'écrit dans un message et vous le recopiez à la main. LNK Numérotation et références lui donne un champ à l'étape Paiement, et le numéro suit la commande jusqu'à la facture. Le module numérote aussi vos documents selon votre format : F2026-00042 pour une facture, AV2026-00007 pour un avoir.
- Version 1.1.1 · PrestaShop 1.7.6 à 8.x
- Version 1.9.1 · PrestaShop 9
- PrestaShop 1.7.6 à 9.x
- PHP 7.1 à 8.4
- Contient un override du cœur
Captures d'écran
Points clés
- Séries de numérotation par boutique : commande, facture, avoir, bon de livraison.
- Motif à balises ({YYYY}, {YY}, {MM}, {SHOP}, {NNNNN}), remise à zéro annuelle ou mensuelle.
- Aperçu du prochain numéro, journal et recherche des numéros donnés.
- Un numéro donné ne change jamais ; compteur sans doublon, même à la même seconde.
- Avoir qui cite la facture d'origine.
- Champ « Votre référence de commande » en haut de l'étape Paiement.
- Saisie enregistrée au fil de l'eau, recopiée sur la commande.
- Obligatoire pour les groupes de clients choisis, contrôlé par le serveur.
- Sur la facture et le bon de livraison PDF.
- Colonne et filtre dans la liste des commandes.
- Modifiable depuis la page de la commande.
- Variable
{lnk_poref}pour les e-mails de la commande. - 0,5 Ko de CSS et 1,3 Ko de JavaScript, seulement sur la page de commande.
- Multiboutique : réglages par boutique.
- Français, anglais et arabe (de droite à gauche).
- PrestaShop 1.7.6 à 9, deux overrides déclarés (numéros de l'avoir et du bon de livraison PDF).
Vos numéros de facture, d'avoir et de bon de livraison
Une série par document et par boutique : référence de commande, facture, avoir, bon de livraison. Vous écrivez le motif avec des balises : {YYYY} pour l'année, {MM} pour le mois, {SHOP} pour la boutique, {NNNNN} pour le compteur. Le compteur repart chaque année, chaque mois ou jamais, et l'aperçu affiche le prochain numéro pendant la saisie. Il démarre juste au-dessus du dernier numéro de PrestaShop, pour qu'aucun numéro déjà imprimé ne revienne.
Un numéro donné ne change plus et n'est jamais redonné. Deux factures émises à la même seconde reçoivent deux numéros qui se suivent : le compteur est pris en une seule requête verrouillée. Une facture émise avant la série garde son numéro. L'avoir cite la facture d'origine, numéro et date. Le journal retrouve n'importe quel numéro et sa commande, et garde chaque changement de série avec l'employé qui l'a fait.
Un champ à l'étape Paiement
« Votre référence de commande » s'affiche en haut de l'étape Paiement. La saisie est enregistrée au fil de l'eau, et recopiée sur la commande quand elle est passée. Lettres et chiffres de toutes les écritures, et les signes courants d'un numéro (. , _ / # : + -), dans la longueur que vous choisissez.
Obligatoire pour vos clients professionnels
Cochez les groupes pour qui la référence est obligatoire : ces clients ne peuvent pas payer sans elle. Le bouton de paiement attend la saisie, et le serveur renvoie à l'étape Paiement un paiement lancé sans référence. Les autres clients ne voient qu'un champ facultatif.
Sur la facture, le bon de livraison et dans la liste des commandes
La référence s'imprime sur la facture et le bon de livraison PDF. Elle a sa colonne dans la liste
des commandes du back-office, avec un filtre : tapez le numéro que le client vous donne au
téléphone, la commande sort. Elle s'affiche dans le détail de la commande du client, et vous la
corrigez depuis la page de la commande. Les e-mails de la commande peuvent l'afficher avec la
variable {lnk_poref}.
Léger et rapide
Chiffres mesurés sur le module livré, compressés (zlib, niveau 9) : 0,5 Ko de CSS et 1,3 Ko de JavaScript, chargés seulement sur la page de commande. Aucune autre page de la boutique ne charge rien.
Compatibilité PrestaShop 1.7.6, 8 et 9
Deux versions du module, une par génération : la 1.1 pour PrestaShop 1.7.6 à 8.x, la 1.9 pour PrestaShop 9, avec une page de réglages native de chaque back-office, sous Commandes. Vérifié au banc sur 1.7.6, 8.1, 9.0 et 9.2 avec le thème Classic. Deux overrides, déclarés (les numéros de l'avoir et du bon de livraison PDF), aucun modèle d'e-mail modifié, aucun appel externe.
Questions fréquentes
Où le client saisit-il sa référence ?
En haut de l'étape Paiement du tunnel de commande, avant le choix du moyen de paiement. La saisie est enregistrée au fil de l'eau ; le client voit « Enregistrée. » sous le champ.
Peut-on rendre la référence obligatoire pour les seuls clients professionnels ?
Oui. Cochez les groupes de clients concernés dans les réglages. Ces clients ne peuvent pas payer sans référence ; les autres voient un champ facultatif. Le groupe retenu est le groupe par défaut du client.
Un client peut-il contourner la référence obligatoire ?
Pas par le tunnel. Le bouton de paiement attend la référence, et si un paiement est lancé sans elle, le serveur renvoie le client à l'étape Paiement avec un message, avant que la commande soit créée. Une seule limite : un paiement confirmé hors du tunnel, par un appel de serveur à serveur d'un prestataire de paiement (sans le panier du visiteur), n'est pas contrôlé. La commande est alors créée sans référence, et vous pouvez l'ajouter depuis sa page.
La référence apparaît-elle sur la facture ?
Oui, sur la facture et sur le bon de livraison PDF, sous le détail de la commande, avec le libellé du champ dans la langue de la commande. Un interrupteur des réglages la retire des deux documents.
Comment retrouver une commande à partir du numéro du client ?
Dans la liste des commandes du back-office, la colonne « Réf. client » a son filtre : tapez tout ou partie du numéro. La recherche porte sur toutes les commandes, pas seulement sur la page affichée.
Peut-on corriger une référence après la commande ?
Oui, depuis la page de la commande au back-office, par un employé qui a le droit de modifier les commandes. Un champ vide retire la référence.
La référence peut-elle apparaître dans les e-mails ?
Oui. Les e-mails de la commande (confirmation, changements d'état) reçoivent la variable
{lnk_poref}. Le module ne modifie aucun modèle d'e-mail : ajoutez la variable où vous voulez dans
vos modèles. Elle est vide quand la commande n'a pas de référence.
Quels caractères sont acceptés ?
Les lettres et les chiffres de toutes les écritures, les espaces et . , _ / # : + -, avec une lettre ou un chiffre en premier. La longueur maximale se règle, 40 caractères par défaut et 64 au plus. Une saisie refusée affiche un message sous le champ.
Le libellé du champ peut-il être changé ?
Oui, dans chaque langue : « Numéro de bon de commande », « PO number », par exemple. Vide, le champ garde « Votre référence de commande » traduit. Le même libellé est repris dans le détail de la commande et sur les documents.
Est-ce que ça ralentit la boutique ?
Non. Le module charge 0,5 Ko de CSS et 1,3 Ko de JavaScript compressés, sur la page de commande seulement. Les autres pages ne chargent rien.
Fonctionne-t-il avec mon thème et mon tunnel de commande ?
Avec le tunnel natif de PrestaShop, sans réglage (vérifié avec Classic sur 1.7.6, 8.1 et 9.2). Un
thème ou un tunnel sur mesure place le crochet displayLnkPorefField ; la garde du serveur
s'applique de toute façon.
Est-il compatible multiboutique ?
Oui. Les réglages se font par boutique, par groupe de boutiques ou pour toutes. Chaque référence est liée à la boutique de sa commande. Les séries de numérotation se règlent boutique par boutique, chacune avec son compteur.
Comment numéroter mes factures à mon format ?
Dans les réglages, rubrique Numérotation, ouvrez Factures. Écrivez le motif, par exemple F{YYYY}-{NNNNN}, choisissez quand le compteur repart (jamais, chaque année, chaque mois), puis activez la série. L'aperçu affiche le prochain numéro pendant la saisie. Les commandes, les avoirs et les bons de livraison ont chacun leur série, sur le même modèle.
Que deviennent les factures déjà émises ?
Elles gardent leur numéro : le module ne renumérote jamais un document émis. La série ne s'applique qu'aux documents suivants, et son départ proposé est juste au-dessus du dernier numéro de PrestaShop, pour qu'aucun numéro déjà imprimé ne revienne.
Deux factures émises à la même seconde peuvent-elles recevoir le même numéro ?
Non. Le compteur est pris en une seule requête qui verrouille sa ligne, et un index unique refuse tout doublon. Deux documents émis ensemble reçoivent deux numéros qui se suivent.
L'avoir cite-t-il la facture d'origine ?
Oui. L'avoir PDF porte son numéro de série en titre et en nom de fichier, et une ligne cite la facture d'origine avec son numéro et sa date, dans la langue de la commande.
Peut-on changer de motif en cours d'année ?
Oui. Les numéros déjà donnés restent tels quels, et le nouveau motif vaut pour les documents suivants. Un numéro déjà donné n'est jamais redonné. Le journal garde chaque changement, avec l'employé et la date.
Le module modifie-t-il des fichiers de PrestaShop ?
Il passe par les accroches du cœur partout où elles existent. Pour le titre et le nom du fichier de l'avoir et du bon de livraison PDF, le cœur n'en offre pas qui fonctionne : le module installe deux overrides déclarés, et un troisième pour la référence de commande en 1.7.6 à 8.0. PrestaShop les pose et les retire avec le module. Aucun modèle d'e-mail n'est modifié.
Journal des versions
-
Version 1.9.1 PrestaShop 9
Nouveautés
- Le module devient « LNK Numérotation et références » : en plus de la référence de l'acheteur, il numérote les documents de la boutique.
- Séries de numérotation par boutique, pour la référence de commande, le numéro de facture, le numéro d'avoir et le numéro de bon de livraison : balises {YYYY}, {YY}, {MM}, {SHOP} et compteur {N…}, remise à zéro jamais, chaque année ou chaque mois, numéro de départ.
- Compteur atomique : deux documents émis à la même seconde reçoivent deux numéros différents, à la suite. Un numéro n'est jamais donné deux fois, et un document émis garde son numéro.
- Facture : le numéro de la série est attribué au passage au statut « facture », et affiché sur le PDF, au back-office et pour LNK Facture électronique. Une facture émise avant la série garde son numéro.
- Avoir : le numéro de la série est attribué à la création de l'avoir. Le PDF le porte en titre et en nom de fichier, et cite la facture d'origine (numéro et date).
- Bon de livraison : le numéro de la série est attribué au changement d'état qui crée le bon. Le PDF le porte en titre et en nom de fichier. Un bon émis avant la série garde son numéro.
- Back-office : une rubrique par document (motif, remise à zéro, numéro de départ replié sous « Avancé »), aperçu en direct des prochains numéros, et un journal : recherche d'un numéro, d'une référence de commande ou d'une référence d'acheteur, derniers numéros donnés et changements des séries. Sur la page d'une commande, les numéros de la série en face de ceux de PrestaShop.
- Contrat lnk.poref.reference/1 : la référence de l'acheteur pour LNK Facture électronique.
-
Version 1.9.0 PrestaShop 9
Nouveautés
- Champ « Votre référence de commande » en haut de l'étape Paiement : le numéro de bon de commande de l'acheteur, enregistré sur le panier au fil de la saisie, puis recopié sur la commande.
- Référence obligatoire pour les groupes de clients choisis : le bouton de paiement attend la référence, et le serveur renvoie à l'étape Paiement un paiement lancé sans elle.
- La référence dans le détail de la commande côté client, sur la page de la commande au back-office (modifiable), dans une colonne filtrable de la liste des commandes, sur la facture et le bon de livraison PDF, et dans la variable {lnk_poref} des e-mails de la commande.
- Contrat de thème lnk.poref/1 : crochets displayLnkPorefField et displayLnkPoref, événement lnk:poref:saved, variables CSS --lnk-poref-*.
- Page de réglages sur l'habillage commun des modules LNK, sous Commandes, avec un aperçu du champ, du détail de commande et de la facture.
- Multiboutique : réglages par boutique, par groupe ou communs ; références liées à la boutique de leur commande.
- Français, anglais et arabe (de droite à gauche).
-
Version 1.1.1 PrestaShop 1.7.6 à 8.x
Nouveautés
- Le module devient « LNK Numérotation et références » : en plus de la référence de l'acheteur, il numérote les documents de la boutique.
- Séries de numérotation par boutique, pour la référence de commande, le numéro de facture, le numéro d'avoir et le numéro de bon de livraison : balises {YYYY}, {YY}, {MM}, {SHOP} et compteur {N…}, remise à zéro jamais, chaque année ou chaque mois, numéro de départ.
- Compteur atomique : deux documents émis à la même seconde reçoivent deux numéros différents, à la suite. Un numéro n'est jamais donné deux fois, et un document émis garde son numéro.
- Facture : le numéro de la série est attribué au passage au statut « facture », et affiché sur le PDF, au back-office et pour LNK Facture électronique. Une facture émise avant la série garde son numéro.
- Avoir : le numéro de la série est attribué à la création de l'avoir. Le PDF le porte en titre et en nom de fichier, et cite la facture d'origine (numéro et date).
- Bon de livraison : le numéro de la série est attribué au changement d'état qui crée le bon. Le PDF le porte en titre et en nom de fichier. Un bon émis avant la série garde son numéro.
- Back-office : une rubrique par document (motif, remise à zéro, numéro de départ replié sous « Avancé »), aperçu en direct des prochains numéros, et un journal : recherche d'un numéro, d'une référence de commande ou d'une référence d'acheteur, derniers numéros donnés et changements des séries. Sur la page d'une commande, les numéros de la série en face de ceux de PrestaShop.
- Contrat lnk.poref.reference/1 : la référence de l'acheteur pour LNK Facture électronique.
Voir la version précédente
-
Version 1.1.0 PrestaShop 1.7.6 à 8.x
Nouveautés
- Champ « Votre référence de commande » en haut de l'étape Paiement : le numéro de bon de commande de l'acheteur, enregistré sur le panier au fil de la saisie, puis recopié sur la commande.
- Référence obligatoire pour les groupes de clients choisis : le bouton de paiement attend la référence, et le serveur renvoie à l'étape Paiement un paiement lancé sans elle.
- La référence dans le détail de la commande côté client, sur la page de la commande au back-office (modifiable), dans une colonne filtrable de la liste des commandes, sur la facture et le bon de livraison PDF, et dans la variable {lnk_poref} des e-mails de la commande.
- Contrat de thème lnk.poref/1 : crochets displayLnkPorefField et displayLnkPoref, événement lnk:poref:saved, variables CSS --lnk-poref-*.
- Page de réglages sur l'habillage commun des modules LNK, sous Commandes, avec un aperçu du champ, du détail de commande et de la facture.
- Multiboutique : réglages par boutique, par groupe ou communs ; références liées à la boutique de leur commande.
- Français, anglais et arabe (de droite à gauche).