Livraison Sec et Réfrigéré PrestaShop : installation et configuration

Présentation

Le module est fait pour les boutiques qui vendent des produits secs et des produits réfrigérés. Le client garde un seul panier, paie une fois et reçoit une seule commande avec un seul montant de livraison. Ce montant dépend de la zone (pays et code postal) et du contenu du panier : sec seul, réfrigéré seul ou les deux. Le réfrigéré est refusé dans les zones que la chaîne du froid ne dessert pas. Après la commande, le module sépare la commande en colis, un par type, chacun avec son transporteur et son suivi.

Installation

1. Dans Modules > Gestionnaire de modules, cliquez sur Installer un module et envoyez le fichier dfcoldchain-1.0.2.zip.
2. Le module crée son transporteur, nommé Envío estándar. Renommez-le dans Livraison > Transporteurs si besoin : le module suit le transporteur même après modification.
3. Vérifiez que le transporteur a une règle de taxe. Le module reprend celle du transporteur par défaut à l’installation.
4. Ouvrez la configuration du module et commencez par l’onglet Diagnostic.

Zones et tarifs

Les zones sont lues de haut en bas, par numéro de priorité croissant. La première zone active dont le pays et le code postal correspondent à l’adresse s’applique. Une destination qui ne correspond à aucune zone ne reçoit pas ce transporteur, et le réfrigéré y est refusé.

Champs d’une zone

• Nom et Active.
• Priorité : placez les zones les plus précises (une ville, des îles) avant les zones larges (tout un pays).
• Pays (ISO) : un ou plusieurs codes séparés par des virgules, par exemple ES,PT.
• Codes postaux : vide pour tout le pays, sinon un code par ligne ou séparés par des virgules.
• Gratuit dès : seuil de livraison gratuite, 0 pour aucun seuil.
• Sec seul, Réfrigéré seul, Sec et réfrigéré : tarifs TTC dans la devise par défaut.
• Les produits réfrigérés peuvent être livrés : décoché, tout panier contenant du réfrigéré est bloqué pour cette zone.
• Séparer la commande en un envoi par type : décoché, la commande part en un seul envoi (livraison locale par exemple).

Syntaxe des codes postaux

• valeur exacte : 50001
• plage : 50001-50020 (les deux bornes doivent avoir la même longueur), ou 50001..50020
• préfixe : 07*
• code à tiret : 1000-001 est lu comme un code exact. Une plage sur les 4 premiers chiffres s’écrit 4000-4999.

Montant affiché

Les tarifs sont saisis TTC. Le module calcule le hors taxe avec le taux du transporteur pour l’adresse du client, si bien que le montant affiché est toujours celui saisi, quel que soit le pays. Les montants sont convertis dans la devise du panier.

Produits réfrigérés

Dans l’onglet Produits réfrigérés, sélectionnez les catégories concernées (Ctrl ou Cmd pour en choisir plusieurs) et cochez Inclure les sous-catégories si besoin. Un produit est réfrigéré s’il appartient à l’une de ces catégories, même si ce n’est pas sa catégorie par défaut. Tout le reste est sec.

La zone Exceptions par produit permet de chercher un produit par nom, référence ou ID et de le forcer en réfrigéré ou en sec. Les changements sont enregistrés immédiatement.

Colis après la commande

Quand une commande est passée avec le transporteur du module dans une zone qui sépare les envois, le module crée un colis par type présent : le réfrigéré d’abord, puis le sec. Dans l’onglet Envois, réglez pour chaque type :

• le nom du transporteur affiché au client (par défaut SEUR Frío pour le réfrigéré et Transporte estándar pour le sec) ;
• l’URL de suivi, où @ est remplacé par le numéro de suivi.

Dans une zone sans séparation, la commande a un seul envoi qui reprend le nom et l’URL de suivi du transporteur de la commande.

Checkout

• Masquer les autres transporteurs quand celui du module est disponible : le client voit un seul montant.
• Transporteurs toujours conservés : par exemple le retrait en boutique. Ils restent visibles et ne sont pas bloqués par la restriction du réfrigéré.
• Seuil de livraison gratuite calculé après bons de réduction : par défaut, le seuil porte sur le total produits TTC avant réduction.
• Mention sur les fiches des produits réfrigérés.
• Vérificateur de code postal dans le panier quand il contient du réfrigéré.
• Bouton pour retirer les produits réfrigérés quand l’adresse n’est pas desservie.

Comment fonctionne le blocage

Quand le panier contient du réfrigéré et que l’adresse de livraison est hors zone, le module retire les options de livraison dans la liste que PrestaShop construit pour tous les tunnels de commande. Sans option de livraison, la commande ne peut pas être payée. Le client voit un message avec les produits concernés, affiché par le hook displayBeforeCarrier du checkout natif et injecté par JavaScript dans les checkouts en une page qui rechargent leurs transporteurs en AJAX.

Pour un client invité, le panier est estimé avec le pays de la boutique, ou avec le code postal saisi dans le vérificateur du panier, jusqu’à ce que l’adresse soit saisie au checkout.

Textes client

La mention de la fiche produit et le message de blocage se modifient par langue dans l’onglet Checkout.

Simulateur

L’onglet Simulateur calcule, avec les zones enregistrées, la zone retenue, le montant et les colis prévus pour un pays, un code postal, un total produits et un contenu (sec, réfrigéré ou les deux). Enregistrez avant de simuler si vous avez modifié les zones.

Diagnostic

L’onglet Diagnostic vérifie que le transporteur existe et a une règle de taxe, que les seuils natifs de livraison gratuite sont désactivés (Livraison > Préférences), qu’aucun frais de manutention ne s’ajoute, que des produits réfrigérés sont définis et qu’aucun produit n’est restreint à des transporteurs. Il liste aussi les modules qui agissent sur les mêmes points (transporteurs, checkout, validation de commande). Le bouton Recréer le transporteur répare une installation où le transporteur a été supprimé.

Côté commandes

• Fiche commande : un panneau Envois affiche chaque colis avec ses produits, son transporteur, son numéro et son URL de suivi, et son statut (À préparer, Expédié, Livré).
• Email au client : cochez la case avant d’enregistrer un colis expédié pour envoyer le contenu du colis et le lien de suivi. Modèle dfcoldchain_shipped dans le dossier mails/ du module, en anglais, espagnol, français et portugais.
• Bordereau de préparation : une page imprimable par colis, avec un bandeau RÉFRIGÉRÉ pour le froid.
• Reconstruire les envois : à utiliser après une modification des lignes de commande, tant qu’aucun colis n’est expédié.
• Alerte : si une commande contient du réfrigéré pour une zone hors chaîne du froid, un message rouge le signale.
• Côté client : quand la commande a plusieurs colis ou un numéro de suivi, ils apparaissent dans le détail de commande de son compte.

Limites connues

• Le module ne génère pas d’étiquettes : créez-les chez vos transporteurs ou dans leurs modules.
• Un produit restreint à certains transporteurs peut amener PrestaShop à scinder le panier en plusieurs commandes. Retirez ces restrictions.
• Un seuil natif de livraison gratuite (Livraison > Préférences) prend le pas sur les zones du module.
• Les zones et réglages sont communs à toutes les boutiques en multiboutique.
• Un pack natif est classé selon le produit pack lui-même, pas selon ses composants.
• Chaque checkout en une page a son propre balisage : testez une commande complète en invité et en client inscrit sur une copie de la boutique avant la mise en ligne.