Prix de livraison — Modes par pays
Pour chaque pays de vos zones de livraison PrestaShop, vous choisissez précisément comment ses prix de livraison apparaissent dans le flux : ignorer entièrement le pays, publier une ligne pour l'ensemble du pays, ou développer une ligne distincte par état ou région.
Disponible depuis la v2.3.5
Vue d'ensemble
Facebook et Instagram exigent que le champ shipping de votre flux de produits liste les prix sous forme d'entrées spécifiques à chaque pays (et, en option, à chaque état). Lorsque votre boutique expédie vers plusieurs pays, ou vers un pays avec des zones tarifaires régionales — comme les États-Unis ou le Canada — vous avez besoin d'un contrôle précis sur ce qui apparaît dans la colonne de livraison de chaque produit.
L'onglet Countries dans le panneau de configuration de la livraison vous propose trois choix pour chaque pays actif de votre boutique. Le module attribue automatiquement le mode le plus adapté aux nouveaux pays : les pays pour lesquels des états sont définis dans PrestaShop utilisent par défaut le Mode États ; tous les autres utilisent par défaut le Mode Pays.
Signification des modes
Chaque pays dispose de l'une des trois options sous forme de bouton radio :
| Mode | Valeur de config | Libellé dans le Back Office | Ce qui apparaît dans le flux |
|---|---|---|---|
| Do not generate | 0 | Do not generate | Aucune ligne de livraison pour ce pays — le pays est entièrement ignoré |
| Country Mode | 1 | Country Mode | Une ligne de livraison par transporteur, utilisant le prix de la zone au niveau national |
| States Mode | 2 | States Mode | Une ligne de livraison par transporteur et par état, utilisant le prix de la zone propre à cet état |
Do Not Generate (valeur 0)
Le pays est exclu de toutes les sorties de livraison. Aucune entrée shipping n'est générée pour ce pays, quel que soit le transporteur qui le dessert.
Utilisez ce mode lorsque vous ne livrez pas réellement dans ce pays, lorsque le pays est actif dans PrestaShop pour des raisons sans rapport avec la livraison (adresses de facturation, règles fiscales), ou lorsque vous souhaitez masquer l'affichage de la livraison pour un marché spécifique.
Country Mode (valeur 1)
Le module génère une ligne de livraison par transporteur pour l'ensemble du pays. La ligne utilise le prix de la zone couvrant ce pays dans la configuration des transporteurs PrestaShop. Le format dans le flux est :
CC::CarrierName:9.90 EUR
où CC est le code pays ISO et le champ vide entre les deux-points indique l'absence de subdivision par état.
Utilisez le Country Mode pour les pays où un tarif national unique s'applique — la plupart des pays européens, par exemple — ou lorsque le détail par état n'est pas requis par la configuration de votre catalogue Facebook.
States Mode (valeur 2)
Le module développe le pays en une ligne de livraison par transporteur et par état. Chaque ligne utilise le prix de la zone couvrant cet état en particulier dans la configuration des transporteurs PrestaShop. Le format dans le flux est :
US:CA:CarrierName:7.99 USD
US:NY:CarrierName:7.99 USD
où le deuxième champ est le code ISO de l'état.
Utilisez le States Mode pour les pays dont les zones tarifaires des transporteurs sont définies au niveau de l'état ou de la région, le plus souvent les États-Unis et le Canada. Si votre transporteur utilise une seule zone pour l'ensemble du pays même si des états existent dans PrestaShop, toutes les lignes d'états afficheront le même prix — ce qui est valide mais verbeux.
Remarque : Le States Mode ne produit un résultat significatif que si les états de ce pays disposent de leurs propres affectations de zones de transporteur dans PrestaShop. Si tous les états partagent une même zone, le Country Mode produit le même résultat avec une ligne unique et plus claire.
Quand utiliser chaque mode
Configuration typique pour une boutique européenne expédiant à l'international :
- Pays d'origine européen : Country Mode — tarif national unique
- Autres pays UE vers lesquels vous expédiez : Country Mode — tarifs forfaitaires par pays
- États-Unis (si vous y expédiez) : States Mode — la tarification par zone aux USA est souvent définie par état
- Pays vers lesquels vous n'expédiez pas : Do Not Generate — maintient le flux propre
Boutique basée aux États-Unis :
- États-Unis : States Mode — correspond à la tarification par état de la plupart des transporteurs américains
- Canada : States Mode si vous disposez de tarifs par province ; Country Mode pour un tarif uniforme sur tout le Canada
- Destinations internationales : Country Mode ou Do Not Generate selon que vous y expédiez ou non
Remarques importantes
- La liste des modes n'affiche que les pays actifs dans votre back office PrestaShop. Si un pays n'apparaît pas dans la liste, activez-le d'abord sous International > Countries.
- Définir un pays sur Do Not Generate ne le supprime pas de la liste des pays actifs de PrestaShop — cela supprime uniquement la sortie de livraison pour ce pays dans le flux.
- Lors de la première configuration du module, les pays pour lesquels des états sont définis dans PrestaShop sont initialisés par défaut en States Mode (valeur 2) ; tous les autres pays sont initialisés en Country Mode (valeur 1). Aucun pays n'est initialisé par défaut sur Do Not Generate.
- Ces paramètres s'appliquent par boutique dans une configuration multi-boutiques. Chaque boutique conserve sa propre configuration de mode par pays via les clés
FPF_COUNTRY_MODE_{ISO}. - La section livraison dans son ensemble doit être activée (le bouton Generate Shipping Prices doit être activé) pour que tout mode par pays soit pris en compte.
Résolution des problèmes
| Problème | Solution |
|---|---|
| Un pays vers lequel j'expédie est absent de la liste | Allez dans International > Countries dans PrestaShop et assurez-vous que le pays est défini comme actif |
| Le States Mode ne produit aucune sortie pour les USA | Vérifiez que vos transporteurs ont des affectations de zones couvrant les états américains dans Shipping > Carriers > modifier le transporteur > zones |
| Tous les états américains affichent le même prix | Votre transporteur utilise une seule zone pour tous les états américains — c'est un comportement normal ; envisagez de passer au Country Mode pour réduire la verbosité du flux |
| Un pays affiche la livraison mais je n'y expédie pas | Définissez ce pays sur Do Not Generate |
| Le Country Mode affiche un prix incorrect | Vérifiez l'affectation de zone pour ce pays dans la configuration du transporteur — le prix de zone est lu depuis les tables de plages de livraison de PrestaShop |
Foire aux questions
Dois-je définir un mode pour chaque pays de la liste ?
Non. Le module pré-remplit une valeur par défaut appropriée pour chaque pays actif lors de la première installation. Vous n'avez besoin de modifier le mode que pour les pays où la valeur par défaut ne correspond pas à votre configuration de livraison réelle.
Que se passe-t-il pour les pays définis en States Mode qui n'ont pas d'états dans PrestaShop ?
Si un pays ne possède pas d'états, le States Mode se comporte de manière identique au Country Mode — le module génère en repli une seule ligne de livraison au niveau national, car il n'y a pas d'entrées d'états à développer.
Puis-je définir tous les pays sur Do Not Generate et inclure quand même la livraison pour des pays spécifiques ?
Oui. Définissez chaque pays non souhaité sur Do Not Generate et activez uniquement le Country Mode ou le States Mode pour les destinations que vous desservez réellement. Le flux n'inclura des entrées de livraison que pour ces pays activés.
La modification du mode d'un pays nécessite-t-elle de régénérer le flux ?
Oui. Le paramètre de mode est lu au moment de la génération du flux. Enregistrez vos modifications et régénérez le flux pour que les nouveaux paramètres apparaissent dans le fichier de sortie.
Le States Mode est-il obligatoire pour les États-Unis, ou le Country Mode fonctionne-t-il aussi ?
Le Country Mode est valide et produira une seule ligne US::CarrierName:prix que Facebook accepte. Le States Mode est recommandé si votre transporteur applique des tarifs différents selon l'état américain, car il fournit à Facebook des données plus précises pour associer les acheteurs au bon coût de livraison.