L’expédition dans une boutique en ligne est rarement simple. Les paramètres standard de Magento conviennent aux scénarios simples, mais deviennent vite insuffisants lorsque la boutique vend des produits de dimensions, poids, exigences de transport ou coûts de manutention différents. En pratique, cela signifie qu’il faut masquer certaines méthodes de livraison, ajouter des frais d’emballage, appliquer des exceptions pour des produits spécifiques et créer des règles dépendant du pays, de la valeur du panier ou des attributs du produit.
Kowal ShippingRules a été créé pour gérer ce type de règles dans un seul module. L’extension réunit trois domaines souvent répartis entre plusieurs modules distincts : les méthodes d’expédition, les restrictions des méthodes de livraison et les extra fees. La boutique peut ainsi gérer la logique de livraison de manière plus structurée et plus prévisible.
Le module permet de créer vos propres méthodes d’expédition dans Magento 2, de leur attribuer des tarifs, de définir quand une méthode doit être visible, de bloquer les options de livraison indisponibles et d’ajouter des frais supplémentaires uniquement lorsque les conditions de la commande le justifient. Les règles peuvent se baser sur les données du panier, l’adresse de livraison, la méthode d’expédition choisie et les attributs des produits.
La plus grande valeur du module est le contrôle. L’administrateur de la boutique peut définir des règles qui adaptent automatiquement les méthodes de livraison disponibles et les frais à une commande donnée. Le client voit des options de livraison plus pertinentes, et l’équipe de la boutique réduit le nombre de corrections manuelles après la passation de commande.
Dans de nombreuses boutiques Magento 2, le coût et la disponibilité de la livraison dépendent de plus de facteurs que la seule valeur du panier. Les produits peuvent différer par leur poids, leur taille, leur mode d’emballage, leur catégorie, leur type de transport ou leur risque de détérioration. En outre, la boutique peut appliquer des règles différentes selon les pays, les régions, les codes postaux, les groupes de clients ou les méthodes d’expédition.
Sans règles dédiées, des problèmes typiques apparaissent :
Kowal ShippingRules remet de l’ordre dans ces situations. Le module permet de transférer les règles logistiques dans le panneau Magento et de les appliquer automatiquement lors du choix de la livraison.
Kowal ShippingRules regroupe la gestion des méthodes d’expédition, des restrictions et des frais supplémentaires. La boutique n’a donc pas besoin de maintenir un module séparé pour les tables de tarifs, un autre pour bloquer les méthodes de livraison et encore un autre pour les extra fees.
Les décisions peuvent dépendre du contenu du panier, des attributs des produits, de la valeur de la commande, du poids, de la quantité de produits, du lieu de livraison et de la méthode d’expédition choisie. Cela permet de créer de véritables scénarios logistiques, et pas seulement de simples tarifs par pays ou par poids.
Le client voit des méthodes de livraison adaptées à sa commande. Si une méthode n’est pas disponible, la boutique peut la masquer ou afficher un message expliquant la raison de l’indisponibilité. Cela réduit le nombre de malentendus au moment de finaliser l’achat.
Des frais supplémentaires peuvent être appliqués uniquement dans des cas précis : pour des produits volumineux, fragiles, nécessitant un emballage spécial ou pour des méthodes de livraison spécifiques. La boutique peut ainsi récupérer des coûts logistiques auparavant cachés dans la marge.
Le module a été conçu comme une solution indépendante, mais il prend en compte le scénario de transition depuis des modules Amasty utilisés pour l’expédition, les restrictions et les extra fees. Il peut ainsi servir de base à la consolidation de la configuration de livraison dans un seul module.
Kowal ShippingRules est destiné aux boutiques Magento 2 qui ont besoin de plus de flexibilité dans la gestion de la livraison que ce que permet la configuration standard de Magento.
Le module sera particulièrement utile pour les boutiques qui :
Le module permet de créer des méthodes d’expédition gérées directement depuis le panneau Magento. Chaque méthode peut avoir son propre nom, code, description, ordre d’affichage, statut d’activité et conditions de disponibilité.
Exemples :
Des tarifs dépendant des paramètres de la commande peuvent être attribués aux méthodes. Les tarifs peuvent être filtrés notamment par pays, région, code postal, subtotal, poids, quantité de produits et type d’expédition.
Exemples :
Kowal ShippingRules permet de limiter la disponibilité des méthodes d’expédition. Une règle peut masquer une méthode ou afficher au client un message indiquant qu’un mode de livraison donné n’est pas disponible pour cette commande.
Exemples :
Le module permet d’appliquer des frais supplémentaires sur la base de règles. L’extra fee peut être appliqué à l’ensemble du panier, à chaque unité de produit ou aux produits remplissant des conditions spécifiques.
Exemples :
Kowal ShippingRules utilise un générateur de conditions connu de Magento. Pour les personnes qui gèrent la boutique, cela signifie un mode de travail proche de la configuration des promotions panier : choisissez une condition, un opérateur et une valeur.
Les conditions peuvent concerner :
Toutes les commandes n’ont pas le même coût de traitement logistique. Les produits volumineux, fragiles ou nécessitant un emballage spécial génèrent souvent des coûts supplémentaires. Kowal ShippingRules permet d’ajouter ces coûts de manière contrôlée, au lieu de les cacher dans la marge ou de les traiter manuellement après la commande.
Si le client choisit une méthode de livraison qui ne convient pas au produit, la boutique doit ensuite résoudre le problème manuellement. Le module limite ce type de situation, car il peut masquer les méthodes indisponibles avant même la validation de la commande.
Au lieu de supprimer une méthode sans explication, la boutique peut afficher un message au client. C’est particulièrement utile lorsque la limitation résulte des caractéristiques du produit, de la localisation ou des exigences de transport.
Les règles automatiques réduisent le nombre d’exceptions gérées par l’équipe commerciale ou logistique. Si la boutique définit clairement les règles de livraison au niveau du panier, moins de situations nécessitent une correction après l’achat.
Les méthodes, restrictions et frais supplémentaires sont liés entre eux. Les maintenir dans un seul module réduit le risque de conflits et facilite le contrôle de la configuration.
La boutique vend des produits qui ne peuvent pas être expédiés par transporteur standard ni vers un consigne automatique. L’administrateur peut marquer ces produits avec un attribut, puis préparer une règle qui masquera le consigne automatique, affichera une livraison sur palette et ajoutera des frais pour gabarit.
Effet : le client voit immédiatement la bonne méthode de livraison, et la boutique n’a pas besoin de le contacter après l’achat pour un supplément.
Les produits nécessitant une protection supplémentaire peuvent générer un coût d’emballage. Le module permet d’ajouter ces frais uniquement lorsqu’un produit remplissant la condition se trouve dans le panier.
Effet : la boutique récupère le coût de l’emballage, et le client connaît le prix total avant de passer commande.
La boutique peut rendre disponible la méthode Livraison locale uniquement pour certains codes postaux ou certaines régions. Pour les autres localisations, la méthode ne sera pas visible.
Effet : le client ne choisira pas une livraison que la boutique ne peut pas assurer.
En vente B2B, le coût de livraison peut dépendre du groupe client, de la valeur de la commande, de la région ou du type de produits. Le module permet de préparer des règles qui correspondent mieux à la politique commerciale de la boutique.
Effet : la boutique peut appliquer des règles différentes selon les types de clients sans maintenir plusieurs processus séparés.
Certains produits peuvent ne pas être disponibles pour l’expédition à l’étranger. Le module permet de limiter les méthodes de livraison pour des pays précis ou selon des conditions liées aux produits.
Effet : la boutique réduit le risque de commandes qu’elle ne peut pas exécuter conformément à son règlement ou aux restrictions du transporteur.
Si la méthode de livraison choisie génère un coût de traitement supplémentaire, il est possible d’y associer un extra fee.
Effet : les frais n’apparaissent que lorsque le client choisit une méthode d’expédition précise.
gabaryt, masquer le consigne automatique.L’administrateur de la boutique travaille dans le panneau Magento. Il crée d’abord une méthode d’expédition, puis lui attribue des tarifs et des conditions. Si des limitations sont nécessaires, il peut ajouter une restriction pour une méthode ou un groupe de méthodes spécifique. Si la commande doit inclure des frais supplémentaires, l’administrateur crée une règle d’extra fee.
Exemple de processus :
shipping_type = pallet.Magento standard permet de configurer les méthodes de livraison de base, mais les scénarios plus complexes nécessitent des extensions supplémentaires ou des modifications sur mesure.
La boutique peut utiliser un module séparé pour les tarifs, un autre pour les restrictions et un autre pour les frais. Le problème est alors de maintenir la cohérence entre les configurations.
Kowal ShippingRules regroupe les méthodes, les restrictions et les extra fees dans un seul module. Les règles de livraison sont ainsi plus faciles à comprendre, à maintenir et à tester.
Le module n’est pas directement un outil SEO, mais il peut indirectement améliorer l’expérience d’achat, ce qui compte pour la conversion et la qualité globale de la boutique :
Une meilleure gestion de la livraison peut réduire le nombre de paniers abandonnés liés à des coûts peu clairs ou à des méthodes d’expédition indisponibles.
| Compatibilité avec le modèle | Luma / Blank, KOWAL |
|---|
Ce document décrit la mise en œuvre pratique et l’utilisation du module Kowal_ShippingRules dans Magento 2. Il s’adresse aux personnes responsables de l’installation du module, de la configuration de la boutique, des tests de déploiement et de la gestion quotidienne des règles d’expédition.
Le document couvre :
Nom technique du module :
Kowal_ShippingRulesEmplacement du module :
vendor/kowal/module-shipping-rulesCode du carrier :
kowal_shippingrulesLe code de la méthode d’expédition dans le checkout a le format suivant :
kowal_shippingrules_Exemple :
kowal_shippingrules_dostawa_paletowaAvant l’installation, vérifiez que :
>=8.1,Kowal_Base est disponible,setup:upgrade et setup:di:compile,Les identifiants d’accès au dépôt Composer, à savoir l’adresse e-mail du client et le token de licence, vous seront envoyés par e-mail après l’achat. Ils sont également disponibles dans l’espace client après connexion sur kowal.store. Remplacez TWOJ_EMAIL_KLIENTA par l’adresse e-mail de votre compte et TWOJ_TOKEN par le token reçu. Exécutez les commandes dans le répertoire racine de Magento.
composer config repositories.kowal composer https://repo.kowal.storecomposer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'composer require kowal/module-shipping-rulesbin/magento module:enable Kowal_ShippingRulesSi Kowal_Base n’est pas encore activé, activez-le au préalable ou en même temps que le module :
bin/magento module:enable Kowal_Base Kowal_ShippingRulesbin/magento setup:upgradeCette commande crée les tables du module et ajoute les colonnes requises pour la gestion de l’Extra Fee dans quote, order, invoice et creditmemo.
En production :
bin/magento setup:di:compilebin/magento cache:flushbin/magento module:status Kowal_ShippingRulesLe module doit apparaître dans la liste des modules actifs.
Après l’installation, lancez le diagnostic :
bin/magento kowal:shippingrules:stabilization:checkVersion complète en JSON :
bin/magento kowal:shippingrules:stabilization:check --jsonLa commande est en lecture seule et ne modifie pas les données. Elle vérifie notamment :
Si la commande renvoie des erreurs, le module ne doit pas être basculé en utilisation en production avant qu’elles soient expliquées.
Chemin dans le panneau Magento :
Stores / Configuration / Sales / Delivery Methods / Shipping Methods & RulesChamps :
Enabled — active ou désactive le carrier kowal_shippingrules.Title — nom du groupe de méthodes visible dans le checkout.Test Method Name — nom de la méthode de configuration de test.Test Method Price — prix de la méthode de configuration de test.Sort Order — ordre du carrier dans la liste des méthodes de livraison.Show Method If Not Applicable — indique s’il faut afficher une erreur lorsqu’aucune méthode n’est disponible.Displayed Error Message — message affiché lorsque la méthode n’est pas disponible.Paramètre le plus important :
carriers/kowal_shippingrules/active = 1Si le carrier est désactivé, les méthodes créées dans le module ne seront pas disponibles dans le checkout.
Chemin dans le panneau Magento :
Stores / Configuration / Sales / Shipping Methods & RulesSection General Diagnostics :
Enable Debug Logging — enregistre les détails des décisions dans le journal.Shadow Mode — mode prévu pour comparer le comportement pendant la migration.Section Restrictions :
Enable Restrictions — active ou désactive uniquement les restrictions.Section Extra Fees :
Enable Extra Fees — active ou désactive uniquement les frais supplémentaires.Fee Tax Mode — définit le mode de gestion de la taxe pour l’Extra Fee.Modes de taxe disponibles :
Do Not Calculate Tax — le module ne calcule pas la taxe sur l’Extra Fee.Calculate by Fee Tax Class — le module calcule la taxe selon la classe fiscale définie sur la règle de fee.Paramètres par défaut sûrs :
kowal_shippingrules/general/debug = 0kowal_shippingrules/general/shadow_mode = 0kowal_shippingrules/restrictions/enabled = 1kowal_shippingrules/fees/enabled = 1kowal_shippingrules/fees/tax_mode = noneChemin :
Sales / Shipping Methods & RulesSections disponibles :
Shipping Methods — méthodes d’expédition et tarifs,Shipping Restrictions — restrictions des méthodes de livraison,Extra Fees — frais supplémentaires.Créez une méthode d’expédition lorsque la boutique a besoin d’une option de livraison spécifique, par exemple :
Accédez à :
Sales / Shipping Methods & Rules / Shipping MethodsSélectionnez ensuite Add New ou modifiez une méthode existante.
Champs typiques de la méthode :
Is Active — indique si la méthode est active.Code — code technique de la méthode.Name — nom visible par le client.Description — description de la méthode.Sort Order — ordre d’affichage.Store Views — visibilité par vue de magasin.Customer Groups — visibilité par groupes clients.Conditions — conditions de disponibilité de la méthode.Recommandations pour le champ Code :
Exemples :
dostawa_paletowatransport_specjalnykurier_gabarytdostawa_lokalnaLe code complet de la méthode dans le checkout aura le préfixe du carrier :
kowal_shippingrules_dostawa_paletowaUne méthode active doit avoir au moins un tarif actif. Si la méthode n’a aucun tarif correspondant, elle n’apparaîtra pas dans le checkout.
Le tarif peut dépendre :
Modes de prix :
fixed — prix fixe,percent_subtotal — pourcentage du sous-total.Exemples :
Les conditions définissent quand la méthode doit être disponible.
Exemples :
Si les conditions sont vides, la méthode est limitée uniquement par le statut, la vue de magasin, le groupe client et un tarif correspondant.
Les restrictions servent à masquer ou bloquer les méthodes d’expédition qui ne doivent pas être disponibles pour une commande donnée.
Exemples :
Accédez à :
Sales / Shipping Methods & Rules / Shipping RestrictionsSélectionnez ensuite Add New ou modifiez une restriction existante.
Champs typiques :
Is Active — indique si la restriction fonctionne.Name — nom interne.Target Carrier — carrier concerné par la restriction.Target Method — méthode concernée par la restriction.Action — mode d’action.Message — message destiné au client.Priority — priorité.Stop Processing — indique s’il faut arrêter la vérification des règles suivantes.Store Views — périmètre des vues de magasin.Customer Groups — périmètre des groupes clients.Conditions — conditions de correspondance.hide :
error :
Les règles sont vérifiées selon leur priorité. Une priorité plus élevée signifie une vérification plus précoce.
Stop Processing = Yes signifie qu’après la correspondance avec cette restriction, le module ne vérifie plus les restrictions suivantes pour cette méthode.
Recommandation :
Stop Processing si la règle doit déterminer définitivement la disponibilité de la méthode.L’Extra Fee sert à ajouter des frais supplémentaires à la commande.
Exemples :
Accédez à :
Sales / Shipping Methods & Rules / Extra FeesSélectionnez ensuite Add New ou modifiez des frais existants.
Champs typiques :
Is Active — indique si le fee fonctionne.Name — nom interne.Label — nom des frais visible dans les totals.Target Carrier — carrier concerné par le fee.Target Method — méthode concernée par le fee.Price Type — type de prix.Price — montant des frais.Apply Mode — mode de calcul.Tax Class ID — classe fiscale si le tax mode est utilisé.Priority — priorité.Stop Processing — indique s’il faut arrêter le calcul des fees suivants.Store Views — périmètre des vues de magasin.Customer Groups — périmètre des groupes clients.Conditions — conditions d’application.fixed :
percent_subtotal :
cart :
per_item :
per_matching_item :
Exemple :
Si les frais de protection spéciale s’élèvent à 5 zł et que le panier contient 3 produits remplissant la condition, le mode per_matching_item calculera 15 zł.
Par défaut, la taxe sur l’Extra Fee n’est pas calculée :
kowal_shippingrules/fees/tax_mode = nonePour calculer la taxe :
Fee Tax Mode sur Calculate by Fee Tax Class.Tax Class ID sur la règle Extra Fee.La taxe sur l’Extra Fee doit toujours être vérifiée avec la configuration fiscale de la boutique concernée.
Le module utilise un générateur de conditions similaire aux règles Magento.
Les conditions peuvent notamment porter sur :
Hypothèse :
shipping_type,pallet.Règle :
Jeżeli produkt w koszyku ma shipping_type = palletActions possibles :
Dostawa paletowa,Transport gabarytowy.Fichier journal dédié :
var/log/kowal_shipping_rules.logLe mode debug peut être activé dans :
Stores / Configuration / Sales / Shipping Methods & Rules / General DiagnosticsActivez :
Enable Debug Logging = YesRecommandations :
Si un problème survient après le déploiement, vous pouvez désactiver séparément :
Stores / Configuration / Sales / Delivery Methods / Shipping Methods & Rules / Enabled = NoEffet :
kowal_shippingrules ne seront pas disponibles.Stores / Configuration / Sales / Shipping Methods & Rules / Restrictions / Enable Restrictions = NoEffet :
Stores / Configuration / Sales / Shipping Methods & Rules / Extra Fees / Enable Extra Fees = NoEffet :
La migration depuis Amasty vise à faciliter le transfert de la configuration des restrictions et des extra fees vers Kowal_ShippingRules.
Le module Kowal ne nécessite pas Amasty pour fonctionner normalement. Amasty peut être utilisé comme source de données de migration et comme point de référence pendant les tests.
Le migrateur analyse :
amasty_shiprestriction_ruleamasty_extrafeeamasty_extrafee_optionTables cibles :
kowal_shipping_restrictionkowal_shipping_feeLa migration a été conçue avec prudence :
--execute,ready sont enregistrés,manual_review et unsupported sont ignorés,migration_source et migration_source_key,Exécutez :
bin/magento kowal:shippingrules:amasty:reportLe rapport sera enregistré dans :
var/report/kowal_shippingrules_amasty_report.jsonLe rapport indique la présence et le volume des tables Amasty ainsi que des tables Kowal.
Exécutez :
bin/magento kowal:shippingrules:amasty:report --dry-run --limit=100Le dry-run prépare le plan de transformation, mais n’enregistre rien.
Statuts des enregistrements :
ready — l’enregistrement peut être migré automatiquement,manual_review — l’enregistrement nécessite une analyse manuelle,unsupported — l’enregistrement n’est pas pris en charge par le migrateur automatique.Si le rapport contient de nombreux manual_review ou unsupported, analysez ces règles avant apply.
Exécutez :
bin/magento kowal:shippingrules:amasty:apply --limit=100Cela n’enregistre toujours aucune donnée. La commande indique combien d’enregistrements seraient créés, ignorés ou terminés avec une erreur.
Après validation de l’aperçu :
bin/magento kowal:shippingrules:amasty:apply --type=restrictions --limit=100 --executeLa commande enregistrera uniquement les restrictions avec le statut ready.
Après validation de l’aperçu :
bin/magento kowal:shippingrules:amasty:apply --type=fees --limit=100 --executeLa commande enregistrera uniquement les extra fees avec le statut ready.
Exécutez :
bin/magento kowal:shippingrules:stabilization:checkVérifiez également le panneau :
Sales / Shipping Methods & Rules / Shipping RestrictionsSales / Shipping Methods & Rules / Extra FeesAvant de désactiver ou de remplacer la configuration Amasty, comparez les résultats pour des paniers de test.
Paniers recommandés :
Pour chaque panier, vérifiez :
Ce n’est qu’après validation des résultats qu’il est possible de planifier le basculement de la configuration de production.
Recommandations :
Si un problème survient :
Kowal ShippingRules.Enable Restrictions.Enable Extra Fees.module:status affiche Kowal_ShippingRules comme actif,setup:upgrade s’est terminé sans erreur,setup:di:compile s’est terminé sans erreur,cache:flush a été exécuté,stabilization:check ne renvoie aucune erreur,Shipping Methods & Rules,hide masque la méthode,error affiche un message,Vérifiez :
Vérifiez :
Enable Extra Fees = Yes,Stop Processing d’une règle précédente n’a pas arrêté le calcul suivant.Vérifiez :
Enable Restrictions = Yes,Stop Processing ne termine pas le traitement plus tôt.Vérifiez :
Fee Tax Mode = Calculate by Fee Tax Class,Tax Class ID défini,README.md — description technique du module pour les développeurs.docs/WDROZENIE.md — documentation détaillée de déploiement et architecture.docs/OPIS_MARKETINGOWY.md — description marketing du module.