Numérotation des commandes personnalisée : installation et aide

Téléversez et installez mprordernumber via "Modules" > "Module Manager". Cliquez sur Configurer pour ouvrir le tableau de bord. Utilisez "Improve" > Numérotation des commandes pour accéder à Tableau de bord, Générateur de format, Références générées et Paramètres. Sur les versions plus anciennes, utilisez l’écran équivalent de téléversement des modules.

Nécessite PrestaShop 1.6.1 ou une version ultérieure et PHP 7.1 ou une version ultérieure.

L’installation crée le stockage des compteurs, des références clients et des références générées. Elle élargit orders.reference et order_payment.order_reference à VARCHAR(64) si nécessaire. L’utilisateur de la base de données doit pouvoir créer des tables et modifier ces colonnes. L’intégration pour les anciennes versions comprend override/classes/order/Order.php ; vérifiez "Integrity" et les overrides Order existants après l’installation.

Ouvrez Générateur de format. Saisissez votre modèle dans Modèle, utilisez les balises disponibles, examinez l’aperçu en direct et enregistrez. Le modèle défini à l’installation est {YYYY}/{MM}/{NNNNNN}.

Le champ Modèle se modifie dans Générateur de format. L’onglet actuel Paramètres > "Format" contient Préfixe et Suffixe, sans champ supplémentaire pour le modèle de commande.

Pour une référence annuelle telle que ORD-2026-000042 :

Pattern: {YYYY}-{NNNNNN}
Prefix: ORD-
Suffix: empty
Counter Reset: yearly
Counter Scope: global

Pour une séquence mensuelle avec le pays :

Pattern: {COUNTRY}-{YYYY}-{MM}-{NNNNNN}
Counter Reset: monthly
Counter Scope: global

Enregistrez le modèle et les options du compteur avec leurs commandes respectives. Un aperçu ne réserve pas de numéro.

Les commandes du préfixe, du suffixe, de la portée, de la réinitialisation et du prochain numéro figurent aussi dans les paramètres du compteur de Générateur de format. Définir le prochain numéro est utilisé puis vidé lors de la génération du compteur concerné. Cela ne renumérote pas les commandes existantes. Évitez de définir une valeur dont la référence résultante existe déjà.

Les règles de réinitialisation exigent des balises de date dans le modèle :

Les compteurs sont stockés par boutique. Le mot global désigne le compteur commun à la boutique, pas une séquence partagée entre toutes les boutiques. Utilisez {SHOP_ID} si vous devez distinguer visiblement les boutiques. Les réglages de format sont partagés entre les boutiques même si leurs compteurs sont séparés.

Pour une séquence par client, incluez un élément distinctif unique accepté. Par exemple :

Pattern: CUST-{CUSTOMER_REF}-{CUSTOMER_NNNN}
Counter Scope: customer
Counter Reset: never

Les balises distinctives acceptées comprennent {CUSTOMER_REF}, {CUSTOMER_ID}, {CART_ID} et de {RAND6} à {RAND9}. Plusieurs clients peuvent avoir le même préfixe d’adresse e-mail.

Le module refuse {ORDER_ID}, {INVOICE_ID}, {DOC_TYPE} et {PAYMENT} pour les références de commande, car la commande n’existe pas au moment de la génération. Un modèle valide nécessite un compteur, des éléments de réinitialisation valides et un aperçu de 64 caractères au maximum, préfixe et suffixe compris. Utilisez {NNNNN} pour compléter sur cinq chiffres ; le formateur n’utilise pas la syntaxe {number:5}.

Le module fournit actionGenerateDocumentReference pour le processus natif de génération des références de commande et actionValidateOrder pour relier une entrée d’audit à la commande enregistrée. L’override fourni de Order::generateReference() assure l’intégration pour les anciennes versions. Examinez les conflits si un autre module surcharge également cette méthode.

Le générateur valide le format, consomme uniquement les compteurs requis par ses balises, résout la référence et recherche les doublons dans les commandes existantes, les références de paiement et le journal du module. Les incréments des compteurs utilisent une transaction et le verrouillage des lignes. Une génération échouée, un parcours abandonné ou une commande annulée peut laisser des trous dans la séquence.

Références générées affiche la valeur formatée, le compteur, le modèle, les dates et le contexte de commande/client associé. Le tableau de bord affiche les références récentes et les statistiques des compteurs. Les références de commande déjà enregistrées ne sont pas réécrites.

La référence générée est la référence de commande habituelle de PrestaShop. Les clients la voient partout où les modèles de la boutique utilisent ce champ. Un développeur peut lire $params['order']->reference dans actionValidateOrder pour une intégration ERP une fois la commande créée.

1. Enregistrez un format annuel avec une plage de prochains numéros encore inutilisée.
2. Passez une commande de test avec votre processus de paiement habituel.
3. Vérifiez la référence de commande, l’e-mail de confirmation et l’entrée dans Références générées.
4. Passez une autre commande et vérifiez l’incrément attendu.
5. Si vous utilisez une portée par client, testez avec deux clients et vérifiez l’élément distinctif.

Si le format ne s’enregistre pas, vérifiez les balises inconnues, les éléments de date de réinitialisation, la présence d’un compteur, l’élément distinctif de la portée et la longueur de l’aperçu. Si le processus de commande revient à une référence aléatoire, vérifiez Activer la numérotation personnalisée des commandes, les hooks, les overrides, "Integrity" et les journaux PrestaShop. Les formats invalides à l’exécution et l’épuisement des tentatives d’évitement des doublons ne renvoient aucune référence personnalisée.

Vérifiez les intégrations qui supposent des références de neuf caractères avant d’adopter un modèle plus long. Modifier Définir le prochain numéro ne contourne pas la protection contre les doublons.

Exportez le journal des références générées et notez la position de votre compteur avant la désinstallation. Celle-ci supprime la configuration du module, les préférences, le menu et les tables de schéma propres au module. La désinstallation standard gère également ses hooks enregistrés et sa contribution d’override. Les nouvelles commandes retrouvent les références natives ; les références déjà stockées dans les commandes et les paiements sont conservées. La procédure de désinstallation ne réduit pas les colonnes natives élargies.