VibeFox Packeta for PrestaShop — Aide

Prérequis

PrestaShop : 8.0 à 9.x.

PHP : 8.0 ou ultérieur. Le module refuse de s'installer sur les versions plus anciennes de PHP.

Clé API Packeta : vous la trouvez dans l'espace client de Packeta (client.packeta.com), sous Client support. Elle comporte 16 lettres et chiffres. Le widget en a besoin pour s'ouvrir au paiement ; le transporteur n'est donc affiché aux clients qu'après la saisie de la clé API.

Pays : la République tchèque, la Slovaquie, la Hongrie ou la Roumanie doivent être des pays actifs de votre boutique, dans une zone à laquelle le transporteur est rattaché.

Clé de licence VibeFox : achetée sur vibefox.net. Une clé fonctionne sur un seul domaine.

Installation

1. Dans le back-office, allez dans Modules > Module Manager et cliquez sur Upload a module. Choisissez le fichier ZIP du module.

2. Une fois le téléversement terminé, cliquez sur Configure, ou retrouvez VibeFox Packeta plus tard dans la liste des modules et cliquez sur Configure.

3. Saisissez votre clé de licence VibeFox dans License key du bloc de licence en haut de la page de configuration et cliquez sur Activate (voir Clé de licence).

4. Saisissez votre API key Packeta et vos tarifs : au moins une ligne Country prices (par exemple * Default) ou un Fallback cost. Cliquez sur Save. La page indique si Packeta a accepté la clé.

À l'installation, le module crée le transporteur Packeta pickup point avec le texte de délai de livraison Packeta pickup point or Z-BOX. Il est rattaché aux zones de la République tchèque, de la Slovaquie, de la Hongrie et de la Roumanie, ainsi qu'à tous les groupes de clients. Vous pouvez modifier les zones, les groupes de clients, le délai de livraison et le logo dans Shipping > Carriers. N'y définissez pas de prix : le prix provient toujours du module.

Configuration

Tous les réglages se trouvent sur la page du module : Modules > Module Manager > VibeFox Packeta > Configure. Chaque section dispose de son propre bouton Save, qui enregistre la page entière.

Le transporteur n'est proposé que pour les pays du réseau de points relais propre à Packeta : CZ, SK, HU et RO. Au-dessus des réglages, la page affiche le résultat de la vérification de la clé API ainsi que des avertissements sur les problèmes : absence de clé API, absence de prix, pays sélectionnés hors du réseau Packeta, transporteur manquant ou unité de poids de la boutique que le module ne connaît pas.

Tous les prix et limites acceptent la virgule ou le point comme séparateur décimal (4,99 ou 4.99). Un nombre invalide ou négatif est refusé avec un message, et la valeur précédente est conservée.

Général

Enable/Disable : active ou désactive Packeta au paiement.

Name : le nom du transporteur affiché au client. C'est aussi le nom du transporteur dans Shipping > Carriers. Par défaut : Packeta pickup point. Obligatoire, 64 caractères au maximum.

API key : votre clé API Packeta, disponible dans client.packeta.com > Client support. Vous pouvez aussi coller le mot de passe API de 32 caractères : seuls ses 16 premiers caractères, qui constituent la clé API, sont enregistrés. La clé API est publique : elle est envoyée au navigateur du client pour ouvrir le widget. Lorsque vous enregistrez une nouvelle clé, elle est vérifiée auprès du flux des transporteurs de Packeta, et la page affiche Packeta API key verified ou indique que Packeta l'a refusée. Si la vérification ne peut pas être effectuée, la clé est enregistrée et sera de nouveau vérifiée lors du prochain enregistrement.

Widget language : la langue du widget des points relais. Store / visitor language (par défaut) suit la langue de la page. Vous pouvez aussi la fixer en tchèque, slovaque, hongrois, roumain, anglais, allemand, polonais ou ukrainien.

Pickup point types : les points Packeta que propose le widget.

Tax status : les règles de taxes appliquées au prix de livraison. None (no tax on shipping) ou Taxable avec l'un de vos groupes de règles de taxes. Le choix est enregistré sur le transporteur.

Tarifs

Packeta ne propose pas d'API publique de tarifs. Les prix proviennent de ce tableau et sont saisis dans la devise par défaut de votre boutique, hors taxes. Les clients qui paient dans une autre devise voient le prix converti.

Calculation type : Per order applique le prix une seule fois. Per item (price x quantity) le multiplie par le nombre d'articles physiques du panier.

Country prices : un prix par pays de destination et par poids de colis. Cliquez sur Add country pour ajouter une ligne, et sur la croix pour en supprimer une. Chaque ligne contient un Price et des colonnes de poids : XS jusqu'à 1 kg, S de 1 à 2 kg, M de 2 à 3 kg, L de 3 à 5 kg et XL au-delà de 5 kg. Une colonne de poids laissée à 0 utilise la colonne Price. La ligne * Default s'applique aux pays qui n'ont pas de ligne propre. Une nouvelle ligne commence comme * Default avec tous les prix à 0, ce qui signifie livraison gratuite. Choisissez le pays et saisissez les prix avant d'enregistrer, ou supprimez la ligne. Si le même pays (ou * Default) figure dans deux lignes, seule la première est conservée à l'enregistrement. Si une valeur du tableau n'est pas un nombre valide, le tableau n'est pas enregistré et la page indique les valeurs incorrectes.

Fallback cost : utilisé lorsque le tableau des pays n'a pas de ligne pour la destination et qu'il n'existe pas de ligne * Default. Laissez ce champ vide pour ne pas proposer le transporteur dans ce cas.

Free shipping from : le sous-total du panier (après remises, hors taxes) à partir duquel la livraison Packeta est gratuite. Ce seuil est vérifié avant le tableau des prix : à partir de ce montant, la livraison est gratuite dans chaque pays Packeta où le transporteur est proposé, y compris un pays sans ligne ni coût de repli. Laissez ce champ vide pour ne jamais proposer la livraison gratuite.

Disponibilité

Minimum weight (kg) : masque le transporteur lorsque le panier pèse moins. Le poids du panier est converti à partir de l'unité de poids de votre boutique. Vide ou 0 signifie aucune limite.

Maximum weight (kg) : masque le transporteur lorsque le panier pèse davantage. Par défaut : 15. Les points relais et les Z-BOX Packeta acceptent en général les colis jusqu'à 15 kg ; vérifiez votre contrat Packeta. Vide ou 0 signifie aucune limite. Un poids minimum supérieur au poids maximum est refusé à l'enregistrement, et les deux valeurs précédentes sont conservées.

Minimum cart subtotal : ne propose le transporteur que lorsque le sous-total du panier (après remises, hors taxes) atteint ce montant.

Ignore shipping zones : lorsque cette option est activée, le transporteur est rattaché à toutes les zones et proposé pour les pays sélectionnés ci-dessous. Les zones créées ensuite sont rattachées immédiatement. Lorsque vous la désactivez, le transporteur retrouve les zones qu'il avait auparavant. Lorsqu'elle est désactivée, le transporteur n'est proposé que dans les zones définies pour lui dans Shipping > Carriers.

Countries (ignore zones mode) : les pays de destination pour ce mode. Laissez vide pour utiliser tous les pays Packeta. Les pays hors du réseau de points relais Packeta sont ignorés. Maintenez la touche Ctrl enfoncée et cliquez pour en sélectionner plusieurs. Ce champ n'est utilisé que lorsque Ignore shipping zones est activé.

Avancé

Debug log : écrit les calculs de tarifs et les choix de points relais dans modules/vfd_packeta/logs/. Le fichier ne peut pas être ouvert depuis le web. Aucune donnée personnelle de client et aucune clé API ne sont journalisées. Les erreurs et les vérifications de clé API échouées sont toujours journalisées. Désactivez le journal lorsque vous avez terminé.

Log (last lines) : affiche les dernières entrées du journal de débogage. Cliquez sur Clear log pour le vider.

Remove data on uninstall : lorsque cette option est activée, la désinstallation du module supprime les réglages et le journal. Le point relais enregistré dans les commandes est toujours conservé.

Fonctionnement au paiement

À l'étape de livraison, PrestaShop demande au module le prix Packeta. Seuls les produits physiques comptent : les produits virtuels n'ajoutent pas de poids et ne sont pas inclus dans le sous-total. Le module vérifie les conditions : pays de livraison dans le réseau Packeta, clé API, liste des pays en mode ignore zones, poids du panier et sous-total minimum du panier. Si la livraison gratuite s'applique, le prix est de 0. Sinon, le prix provient du tableau des pays, puis du coût de repli. S'il n'existe pas de prix, le transporteur est masqué.

Lorsque le client sélectionne le transporteur Packeta, un bouton Choose pickup point apparaît sous celui-ci. Il ouvre dans le navigateur du client le widget officiel de Packeta, avec le pays de destination, le poids du panier, les types de points choisis et la langue du widget. Une fois qu'il a choisi un point, son nom et son adresse s'affichent sous le transporteur, et le bouton devient Change pickup point. Le point est enregistré avec le panier et conservé lorsque la page est rechargée. Un point choisi pour un autre pays est supprimé lorsque l'adresse de livraison change.

Votre serveur n'interroge pas Packeta au paiement. Le script du widget est chargé depuis widget.packeta.com. S'il est bloqué (par un bloqueur de publicités ou de confidentialité, une politique de sécurité du contenu ou une panne de Packeta), le client voit le message : « The Packeta pickup point widget could not be loaded. Please reload the page or choose another shipping method. »

Si vous modifiez le transporteur dans Shipping > Carriers après qu'il a reçu des commandes, PrestaShop l'enregistre comme une nouvelle version du transporteur. Le module suit automatiquement la nouvelle version.

Les prix Packeta ne sont pas demandés en direct ; ils proviennent de votre tableau. Le module ne crée pas d'envois Packeta, n'imprime pas d'étiquettes et ne suit pas les colis ; il ne propose pas non plus, par défaut, de livraison à domicile ni de points relais d'autres transporteurs partenaires. Transmettez l'identifiant du point relais de la commande à Packeta de la manière habituelle, par exemple par import dans client.packeta.com.

Points relais

Le point relais est obligatoire. Si le client clique sur Continue à l'étape de livraison sans en choisir un, l'étape n'est pas validée et le client voit le message : « Please choose a Packeta pickup point. » Si le point choisi se trouve dans un autre pays que l'adresse de livraison, le client voit le message : « The selected Packeta pickup point is not in your shipping country. Please choose a pickup point again. » Le module ne vérifie pas l'identifiant du point auprès de Packeta ; il contrôle seulement qu'un point a été choisi et que son pays correspond.

Le point est rattaché à la commande lors de sa création :

Page de commande du back-office : un bloc Packeta pickup point avec le nom, l'adresse, le Pickup point ID et le pays. Si une commande Packeta n'a pas de point, le bloc indique : « No pickup point was selected for this order. »

Pages de confirmation et de détail de la commande : Packeta pickup point : avec le nom et l'adresse.

E-mails de commande : le nom et l'adresse du point sont ajoutés au transporteur dans l'e-mail de confirmation de commande. L'e-mail de nouvelle commande destiné au marchand contient en outre le Pickup point ID.

Le point est stocké dans la table du module vfd_pckt_point (panier, commande, identifiant du point, nom et adresse, pays).

Clé de licence

Le module fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox Packeta est le premier bloc de Modules > Module Manager > VibeFox Packeta > Configure, au-dessus des réglages. Saisissez la clé dans License key et cliquez sur Activate. Ensuite, le bloc affiche la clé masquée, le statut (par exemple la date jusqu'à laquelle la licence est active et votre domaine) ainsi que les boutons Check now pour vérifier à nouveau le statut, Change key pour saisir une autre clé et Remove key pour retirer la clé de cette boutique. En dessous figurent la ligne Product: presta-shipping-packeta et le lien Manage licenses and domains in your account, qui ouvre votre compte vibefox.net. Seuls les employés disposant de l'autorisation Configure pour le module peuvent modifier la clé. Les textes du bloc suivent la langue du back-office (l'anglais et le russe sont inclus).

Si la clé n'est pas acceptée, le bloc indique la raison, par exemple Key not found, This key belongs to another product, Domain limit reached ou License expired on suivi d'une date. Après un changement d'adresse de la boutique, ou après avoir libéré un emplacement de domaine dans votre compte, cliquez sur Check now. Si le serveur de licences est injoignable, le module continue de fonctionner avec le dernier statut connu.

Une clé fonctionne sur un seul domaine : le domaine de la boutique principale, y compris dans une configuration multiboutique. Retirer la clé de la boutique ne libère pas son emplacement de domaine. Libérez-le dans votre compte vibefox.net.

Sans clé active, le transporteur Packeta n'est pas affiché aux clients au moment du paiement et aucun tarif n'est calculé. La boutique PrestaShop ne sait pas que vous êtes connecté au back-office : le transporteur est donc masqué pour vous aussi. Vous pouvez configurer le module avant d'acheter une clé, mais vous ne pouvez pas le tester au paiement. Un rappel apparaît dans Modules > Module Manager, sous l'onglet Alerts. Les commandes existantes ne sont pas affectées.

Lorsqu'une licence expire, le module continue de fonctionner, mais les mises à jour et l'assistance nécessitent un renouvellement. Le statut est vérifié automatiquement pendant votre travail dans le back-office : une fois par jour pendant les 14 premiers jours après la saisie de la clé, puis une fois par semaine. Aucune tâche cron n'est nécessaire. La désinstallation ou la réinitialisation du module supprime toujours la clé de licence et le statut de la licence.

Dépannage

Packeta n'apparaît pas au paiement : vérifiez que la licence est active, que Enable/Disable est activé, que la API key est saisie et que le pays de livraison est CZ, SK, HU ou RO. Vérifiez qu'un prix est défini pour le pays (ligne du pays, ligne * Default ou Fallback cost), les limites de poids et de sous-total, et que le transporteur couvre la zone du pays du client ainsi que son groupe dans Shipping > Carriers (ou que Ignore shipping zones est activé). Les produits peuvent aussi être limités à certains transporteurs sur la fiche produit. La page des réglages liste les problèmes de configuration en haut. Activez Debug log pour voir la raison dans Log (last lines).

Packeta a refusé la clé API : copiez à nouveau la clé API depuis client.packeta.com > Client support et enregistrez. Tant que ce n'est pas fait, le widget ne peut pas s'ouvrir au paiement.

Le widget ne s'ouvre pas : le script de Packeta est bloqué par un bloqueur de publicités ou de confidentialité, par une politique de sécurité du contenu ou par une panne de Packeta. Autorisez widget.packeta.com dans votre politique de sécurité du contenu. Les développeurs peuvent modifier l'URL du script avec le hook actionVfdPcktWidgetUrl.

La livraison est gratuite par erreur : vérifiez dans Country prices les lignes dont le Price est de 0, en particulier une ligne * Default ajoutée avec Add country et laissée vide, et vérifiez Free shipping from.

Les limites de poids ou les colonnes de poids semblent incorrectes : si la page signale l'unité de poids de la boutique, réglez kg, g, lb ou oz dans International > Localization (Local units). Les autres unités sont lues comme des kilogrammes.

Autres pays ou transporteurs : par défaut, le transporteur fonctionne pour CZ, SK, HU et RO. Les développeurs peuvent ajouter des pays avec le hook actionVfdPcktCountries et transmettre les identifiants de transporteurs au widget avec le hook actionVfdPcktWidgetOptions.

La page indique que le transporteur Packeta est manquant : le transporteur a été supprimé dans Shipping > Carriers. Réinitialisez le module dans Modules > Module Manager pour le recréer.

Désinstallation

Allez dans Modules > Module Manager, ouvrez le menu à côté de VibeFox Packeta et choisissez Uninstall. La clé de licence et le statut de la licence sont toujours supprimés. Le transporteur Packeta est toujours supprimé (les commandes conservent leur transporteur), ainsi que le résultat enregistré de la vérification de la clé API. Si Remove data on uninstall est activé, les réglages, le journal et les points relais des paniers qui ne sont jamais devenus des commandes sont supprimés. S'il est désactivé, les réglages sont conservés pour une réinstallation, qui recrée le transporteur. Les commandes existantes conservent toujours le point relais enregistré.

Packeta est une marque de son propriétaire respectif. Ce module n'est ni affilié à Packeta ni approuvé par Packeta.