Bpost Prestashop : 20 problèmes et solutions pour corriger
20 Problèmes Courants et Solutions pour bpost sur PrestaShop
L'intégration de bpost avec PrestaShop peut parfois poser des difficultés techniques. Voici 20 problèmes fréquents rencontrés avec le module bpost et les solutions adaptées pour les résoudre.
📌 Sommaire
- Problème d'affichage des points de retrait bpost sur PrestaShop
- Échec de connexion entre bpost et PrestaShop
- Le module bpost ne s’installe pas sur PrestaShop
- Les tarifs de livraison bpost sont erronés sur PrestaShop
- Les numéros de suivi bpost ne s'affichent pas sur PrestaShop
- Les modes d’expédition bpost ne s’affichent pas sur PrestaShop
- Impossible d’imprimer les étiquettes bpost sur PrestaShop
- Le statut des commandes bpost ne se met pas à jour sur PrestaShop
- Conflit entre bpost et d'autres modules PrestaShop
- Erreur 500 lors de l’utilisation de bpost sur PrestaShop
- Problème de traduction du module bpost sur PrestaShop
- Problèmes de cache liés au module bpost sur PrestaShop
- Les adresses clients ne sont pas reconnues par bpost sur PrestaShop
- Le module bpost est incompatible avec certains thèmes PrestaShop
- Les taxes sur les livraisons bpost sont mal calculées sur PrestaShop
- Les commandes bpost ne se synchronisent pas avec PrestaShop
- Le module bpost ne se met pas à jour sur PrestaShop
- bpost est incompatible avec la version PHP utilisée sur PrestaShop
- Les bordereaux d’expédition bpost sont incorrects sur PrestaShop
- Les zones d’expédition bpost sont mal configurées sur PrestaShop
Problème d'affichage des points de retrait bpost sur PrestaShop
Si les points de retrait bpost ne s’affichent pas sur PrestaShop, cela peut être dû à une incompatibilité JavaScript avec d'autres modules ou à une erreur dans les paramètres API. Vérifiez que le module bpost est bien activé et compatible avec la version actuelle de votre boutique.
Une autre cause peut être liée au cache PrestaShop. Essayez de vider le cache via Paramètres avancés > Performances et de désactiver les modules affectant le checkout. Si le problème persiste, activez le mode debug dans config/defines.inc.php pour repérer d’éventuelles erreurs.
Échec de connexion entre bpost et PrestaShop
Une connexion impossible entre bpost et PrestaShop peut être causée par des identifiants API incorrects ou un pare-feu qui bloque la communication. Vérifiez vos identifiants API dans le module bpost et assurez-vous qu’ils correspondent bien à ceux fournis par bpost.
Testez la connexion en désactivant temporairement votre pare-feu et tout autre module de sécurité qui pourrait bloquer l’accès aux serveurs bpost. Consultez aussi les logs PrestaShop pour voir si des erreurs de requête sont signalées.
Le module bpost ne s’installe pas sur PrestaShop
Si l’installation du module bpost échoue sur PrestaShop, cela peut être dû à une version incompatible ou à des permissions incorrectes sur les fichiers. Assurez-vous d’utiliser une version compatible du module avec votre version actuelle de PrestaShop.
Essayez d’installer le module manuellement via FTP en copiant les fichiers dans le dossier /modules. Ensuite, videz le cache de PrestaShop et réessayez d’installer le module depuis le back-office.
Les tarifs de livraison bpost sont erronés sur PrestaShop
Si les tarifs d’expédition bpost affichés sur PrestaShop sont incorrects, vérifiez que les zones d’expédition et les poids des produits sont bien paramétrés dans Transport > Transporteurs.
Un autre facteur pouvant fausser les tarifs est une mauvaise configuration de la TVA. Assurez-vous que les taxes sont bien paramétrées dans Localisation > Taxes et appliquez la bonne règle aux frais de livraison bpost.
Les numéros de suivi bpost ne s'affichent pas sur PrestaShop
Si les numéros de suivi bpost ne sont pas générés automatiquement sur PrestaShop, vérifiez que l’option "Suivi des colis" est activée dans le module bpost.
Assurez-vous également que les commandes passent bien en statut expédié, car c’est ce changement qui déclenche l’attribution d’un numéro de suivi. Vous pouvez aussi tester en créant une nouvelle commande pour voir si le problème persiste.
Les modes d’expédition bpost ne s’affichent pas sur PrestaShop
Si les options d’expédition bpost ne s’affichent pas lors du passage en caisse sur PrestaShop, cela peut être dû à une mauvaise configuration du module bpost ou à des restrictions sur les zones de livraison. Accédez à Transport > Transporteurs et vérifiez que bpost est bien assigné aux bonnes zones et groupes de clients.
Un autre problème courant est lié aux paramètres de poids et dimensions. bpost impose des limites, et si un produit dépasse ces restrictions, l’option d’expédition peut ne pas apparaître. Vérifiez que les paramètres des produits correspondent aux conditions d’expédition de bpost.
Impossible d’imprimer les étiquettes bpost sur PrestaShop
L’impossibilité d’imprimer les étiquettes bpost sur PrestaShop peut être causée par un problème de connexion API ou un format de fichier incompatible. Assurez-vous que vos identifiants API sont valides et que votre compte bpost est actif.
Testez également l’impression d’une étiquette en modifiant le format (PDF, ZPL, PNG) dans les paramètres du module. Si le problème persiste, videz le cache de PrestaShop et redémarrez votre navigateur pour éliminer tout problème d'affichage.
Le statut des commandes bpost ne se met pas à jour sur PrestaShop
Si le statut des commandes ne change pas automatiquement après l’expédition via bpost sur PrestaShop, cela peut être dû à une problématique de synchronisation API. Vérifiez que la mise à jour automatique du statut est bien activée dans les paramètres du module bpost.
Dans certains cas, la mise à jour peut être bloquée par une erreur de communication entre bpost et PrestaShop. Consultez les logs d’erreurs PrestaShop dans Paramètres avancés > Journaux pour voir si des requêtes API échouent et reconfigurez l’API si nécessaire.
Conflit entre bpost et d'autres modules PrestaShop
Certains modules installés sur PrestaShop peuvent entraîner des conflits avec bpost, notamment les modules de gestion de transporteurs tiers ou les plugins de checkout personnalisés. Désactivez temporairement tous les modules non essentiels et testez si bpost fonctionne correctement.
Si le problème disparaît après la désactivation d’un module spécifique, contactez le développeur du module en conflit pour voir s’il existe une mise à jour ou un correctif permettant la compatibilité avec bpost.
Erreur 500 lors de l’utilisation de bpost sur PrestaShop
Une erreur 500 avec le module bpost sur PrestaShop est souvent causée par un problème PHP ou une erreur dans le fichier .htaccess. Activez le mode debug dans config/defines.inc.php en mettant define('_PS_MODE_DEV_', true); pour identifier le problème exact.
Si l’erreur vient d’une incompatibilité PHP, vérifiez que votre serveur utilise une version de PHP supportée par PrestaShop et bpost (7.4 ou 8.0 selon les versions). Mettez à jour PrestaShop ou changez de version PHP via le panneau d’administration de votre hébergeur.
Problème de traduction du module bpost sur PrestaShop
Si certaines traductions du module bpost ne s’affichent pas sur PrestaShop, cela peut être dû à un problème de cache des langues. Accédez à International > Traductions, sélectionnez le module bpost et réinitialisez les traductions.
Dans certains cas, il peut être nécessaire d’ajouter manuellement les fichiers de langue en copiant les traductions depuis un module similaire et en les enregistrant dans le dossier /modules/bpost/translations/.
Problèmes de cache liés au module bpost sur PrestaShop
Le cache de PrestaShop peut empêcher le bon fonctionnement du module bpost, notamment en bloquant les mises à jour d’affichage des options d’expédition ou des tarifs. Pour résoudre cela, accédez à Paramètres avancés > Performances et désactivez le cache temporairement pour tester.
Si le problème vient d’un cache persistant, essayez de vider le cache manuel en supprimant les fichiers contenus dans /var/cache/. Redémarrez ensuite PrestaShop pour voir si les changements sont bien pris en compte.
Les adresses clients ne sont pas reconnues par bpost sur PrestaShop
Si bpost ne reconnaît pas certaines adresses saisies par les clients sur PrestaShop, cela peut être dû à une erreur dans le formatage des adresses. Vérifiez que les champs obligatoires (numéro, rue, code postal) sont bien remplis et que le module bpost est bien configuré pour prendre en charge ces formats.
Dans certains cas, activer la validation d’adresse automatique dans les paramètres du module peut éviter ces erreurs. Vous pouvez aussi contacter bpost pour voir s’il y a des restrictions sur certaines zones de livraison.
Le module bpost est incompatible avec certains thèmes PrestaShop
Certains thèmes personnalisés de PrestaShop peuvent entraîner des conflits d’affichage avec le module bpost, notamment si des fichiers .tpl du checkout ont été modifiés. Pour tester cela, essayez d’activer le thème par défaut de PrestaShop et vérifiez si bpost fonctionne correctement.
Si le problème vient d’un conflit CSS ou JavaScript, il peut être nécessaire de modifier les fichiers de votre thème pour s’assurer qu’ils sont compatibles avec le module bpost. Consultez la documentation du thème pour voir si des ajustements spécifiques sont nécessaires.
Les taxes sur les livraisons bpost sont mal calculées sur PrestaShop
Si les taxes appliquées aux livraisons bpost sont incorrectes sur PrestaShop, cela peut être dû à une mauvaise configuration des règles fiscales. Accédez à International > Taxes et assurez-vous que les bonnes valeurs sont appliquées aux frais de transport.
Dans certains cas, PrestaShop peut ne pas appliquer la TVA correcte en fonction de la zone d’expédition. Testez avec différents comptes clients pour voir si le problème se produit uniquement pour certaines adresses.
Les commandes bpost ne se synchronisent pas avec PrestaShop
Si les commandes bpost ne se synchronisent pas automatiquement avec PrestaShop, il peut s'agir d'un problème de communication API ou d’un temps de réponse trop long côté serveur. Commencez par tester la connexion API en allant dans Modules > bpost > Paramètres et en lançant un test de synchronisation manuelle.
Vérifiez également les logs PrestaShop dans Paramètres avancés > Journaux pour voir si des erreurs API sont signalées. Si la connexion est instable, contactez le support bpost pour vérifier si des restrictions ont été mises en place sur votre compte ou si des mises à jour récentes du module affectent la synchronisation.
Le module bpost ne se met pas à jour sur PrestaShop
Si vous ne parvenez pas à mettre à jour le module bpost sur PrestaShop, cela peut être causé par des permissions de fichiers incorrectes ou un problème de compatibilité avec votre version de PrestaShop. Accédez à Modules > Gestionnaire de modules, cherchez bpost et tentez de forcer la mise à jour.
Si l'installation échoue, essayez une mise à jour manuelle en téléchargeant la dernière version du module depuis le site officiel et en l’installant via FTP dans le dossier /modules/. Assurez-vous également que votre boutique utilise une version PHP compatible avec la dernière mise à jour du module.
bpost est incompatible avec la version PHP utilisée sur PrestaShop
Si votre module bpost ne fonctionne pas après une mise à jour de votre serveur, il est possible que la version PHP utilisée ne soit pas supportée. Pour vérifier cela, allez dans Paramètres avancés > Informations et regardez la version PHP en cours d’utilisation.
Si la version est trop récente (ex. PHP 8.2) ou trop ancienne (ex. PHP 7.0), changez-la via le panneau de gestion de votre hébergement pour une version stable, comme PHP 7.4 ou 8.0, qui sont généralement compatibles avec la majorité des modules PrestaShop.
Les bordereaux d’expédition bpost sont incorrects sur PrestaShop
Si les étiquettes d’expédition bpost générées via PrestaShop contiennent des erreurs (adresse incomplète, mauvais tarif, etc.), commencez par vérifier que les informations des commandes sont correctement remplies, notamment le poids et les dimensions des colis.
Testez aussi d’autres formats d’impression (PDF, ZPL) dans le module bpost. Si les bordereaux restent incorrects, il peut être nécessaire de réinitialiser les paramètres du module en désinstallant et réinstallant bpost pour corriger les paramètres corrompus.
Les zones d’expédition bpost sont mal configurées sur PrestaShop
Si certaines zones d’expédition bpost ne sont pas disponibles sur PrestaShop, cela peut être dû à une mauvaise configuration des zones géographiques dans Transport > Zones. Assurez-vous que toutes les zones de livraison bpost sont bien activées et assignées au transporteur bpost.
Dans certains cas, la liste des pays acceptés par bpost peut être limitée dans le module. Accédez aux paramètres du module bpost et vérifiez que toutes les destinations souhaitées sont bien activées. Pensez aussi à contacter bpost pour voir si certaines zones ont été restreintes récemment.