Ce site est optimisé pour être consulté depuis un navigateur moderne dans lequel JavaScript est activé.

Personnaliser le format des références de commande

mathildeweb

Bonjour à tous,

Je suis un peu bloquée avec les références de commande par défaut de PrestaShop. Elles sont générées de manière aléatoire (par exemple, XJKSPOQWE) et c'est vraiment un casse-tête pour notre service client et la comptabilité au téléphone.

J'aimerais avoir un format plus structuré, du type ORD-AAAA-NNNNN (comme ORD-2024-00452). J'ai tenté de modifier ça via un module custom en utilisant le hook actionObjectOrderAddAfter, mais ça ne semble pas persister correctement ou ça crée des doublons de référence. Je suis sur PrestaShop 8.1.0 avec PHP 8.1.

Voici ce que j'ai essayé dans mon module :

public function hookActionObjectOrderAddAfter($params)
{
    /** @var Order $order */
    $order = $params['object'];
    if (Validate::isLoadedObject($order) && empty($order->reference)) {
        $year = date('Y');
        // Ceci est simpliste, l'ID n'est pas séquentiel globalement
        $newReference = 'ORD-' . $year . '-' . str_pad($order->id, 5, '0', STR_PAD_LEFT);
        $order->reference = $newReference;
        // J'ai peur que le save() ici déclenche d'autres choses ou soit trop tard

Le problème, c'est que parfois la référence reste l'ancienne, ou alors ça me sort des erreurs si j'essaie de save() trop tôt. Des idées pour faire ça proprement ?

nicolaspro

Salut @mathildeweb,

Je vois ton souci. Le hookActionObjectOrderAddAfter est exécuté après que l'objet Order a été ajouté en base, et donc la référence est déjà générée par la méthode generateReference() du coeur de PrestaShop au moment du add(). Tenter de modifier et save() à nouveau dans ce hook peut effectivement causer des problèmes, car tu risques d'écraser des données ou de déclencher des hooks une seconde fois, ce qui n'est pas idéal.

Pour la référence unique séquentielle, c'est encore plus complexe car l'ID de commande ($order->id) n'est disponible qu'après la première sauvegarde. Utiliser $order->id pour la référence, puis sauvegarder, crée une boucle potentielle ou des références non uniques si tu as plusieurs commandes qui arrivent en même temps.

hugomode57

Exactement ce que dit @nicolaspro. Le meilleur endroit pour définir la référence initiale est au moment de sa génération. La méthode generateReference() dans classes/order/Order.php est celle qui est appelée par le coeur pour créer cette chaîne aléatoire. Si tu veux la personnaliser, c'est cette méthode qu'il faut surcharger (override).

L'avantage, c'est que generateReference() est conçue pour garantir l'unicité via une boucle interne (do...while (Order::referenceExists($this->reference))). Si tu passes par un hook après l'ajout, tu perds cette mécanique de vérification d'unicité, à moins de la réimplémenter toi-même, ce qui est risqué.

Milo

Bonjour @mathildeweb,

Les camarades ont mis le doigt sur le problème. Tenter de modifier la référence après l'ajout de la commande via actionObjectOrderAddAfter est une solution bancale car la référence est déjà fixée et le save() postérieur peut entraîner des effets de bord ou des conflits.

La méthode generateReference() de la classe OrderCore est le point d'entrée pour la création de la référence. Pour obtenir le format ORD-AAAA-NNNNN, la méthode la plus propre est de surcharger cette fonction dans votre propre fichier d'override override/classes/order/Order.php. Voici comment vous pourriez le faire :

class Order extends OrderCore
{
    protected function generateReference()
    {
        $year = date('Y');
        $prefix = Configuration::get('PS_ORDER_PREFIX', null, null, null, 'ORD');
        $uniquePart = Tools::strtoupper(Tools::passwdGen(5)); // Génère 5 caractères aléatoires
        $this->reference = $prefix . '-' . $year . '-' . $uniquePart;
        // La classe OrderCore contient déjà la boucle do...while pour assurer l'unicité
        // en appelant Order::referenceExists(), nous nous concentrons juste sur le format.

Après avoir ajouté ce fichier, n'oubliez pas de vider le cache de PrestaShop (rubrique 'Performances' dans les Paramètres avancés) pour que l'override soit pris en compte.

Attention, cette solution générera bien ORD-AAAA-RANDOM, où RANDOM est une suite unique de 5 caractères, mais pas un ID séquentiel global. Pour avoir un vrai ID séquentiel qui s'incrémente (comme 00452, 00453, etc.), cela demande une logique plus avancée (souvent avec un compteur en base de données) et un module dédié est souvent la meilleure approche pour la pérennité et les mises à jour. Notre module Générateur de référence commande PRO gère précisément ce type de besoin avec un contrôle total sur le format et la séquence.

mathildeweb

Merci beaucoup @Milo et à tous pour ces explications claires ! J'avais bien essayé d'overrider Order.php mais ma logique était un peu bancale, je tentais d'utiliser $this->id ce qui n'était pas possible à ce stade. Je comprends mieux pourquoi mon save() posait problème.

J'ai appliqué l'override que tu as proposé, et après avoir vidé le cache, ça fonctionne parfaitement pour le format ORD-AAAA-RANDOM. C'est déjà un énorme progrès pour nous ! Pour le séquentiel pur, je vais regarder le module que tu as mentionné, ça semble être la solution la plus robuste pour éviter les tracas futurs. Merci encore !