VibeFox DPD Pickup for PrestaShop — Aide

Prérequis

PrestaShop : de 8.0 à 9.x.

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

Identifiants DPD Baltic (Lituanie, Lettonie, Estonie) : la liste des points de retrait provient du service web de DPD Baltic. Vous avez besoin du nom d'utilisateur et du mot de passe de l'API que DPD remet à ses clients professionnels. Demandez-les à votre gestionnaire de compte DPD ou au service client DPD de votre pays. Un compte liste les points de retrait de Lituanie, de Lettonie et d'Estonie.

DPD Slovaquie : la recherche publique de parcelshops DPD Slovaquie ne demande aucun identifiant.

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 plus tard VibeFox DPD Pickup dans la liste des modules et cliquez sur Configure.

3. Saisissez votre clé de licence VibeFox dans le champ License key du bloc de licence en haut de la page Configure, puis cliquez sur Activate (voir Clé de licence).

4. Choisissez votre API DPD. Pour DPD Lituanie, Lettonie ou Estonie, saisissez le nom d'utilisateur et le mot de passe de l'API. Vérifiez les tarifs par pays, puis cliquez sur Save. Cliquez ensuite sur Refresh pickup points pour vérifier la connexion (voir Configuration).

À l'installation, le module crée le transporteur DPD Pickup Point avec le texte de délai de livraison DPD Pickup point or locker. Le transporteur est associé aux zones de Slovaquie, de Lituanie, de Lettonie et d'Estonie ainsi qu'à tous les groupes de clients, sans règle de taxe. Vous pouvez modifier les zones, les groupes de clients, le texte de délai de livraison, le logo et les limites de taille 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 DPD Pickup > Configure. Chaque section possède son propre bouton Save, qui enregistre la page entière. Chaque enregistrement vide aussi les listes de points de retrait mises en cache.

Des avertissements en haut de la page vous signalent un nom d'utilisateur ou un mot de passe DPD Baltic vide, l'absence de tarifs (dans les deux cas, le transporteur n'est pas affiché à la commande), la suppression du transporteur, et une unité de poids de la boutique (International > Localization, Local units) inconnue du module, auquel cas les poids des produits sont lus en kg. Une valeur qui n'est pas un nombre, ou un nombre négatif, dans un champ de montant ou de poids n'est pas enregistrée : le champ est vidé et un avertissement le signale. Les lignes de Country prices qui ne sont pas au format CC:PRIX sont listées dans un avertissement et ignorées.

Général

Enable/Disable : active ou désactive DPD Pickup. C'est le même interrupteur que le statut du transporteur dans Shipping > Carriers.

Name : le nom du transporteur affiché au client à la commande. Par défaut : DPD Pickup Point. Obligatoire, 64 caractères maximum.

Tax status : la règle de taxe du transporteur appliquée au prix de livraison. None signifie aucune taxe. Les autres options affichent Taxable avec le nom d'une règle de taxe de votre boutique.

Liste des points de retrait DPD

Les points de retrait sont chargés depuis DPD et mis en cache pendant 24 heures.

DPD API : la société DPD auprès de laquelle vous avez votre compte. Les comptes Baltic utilisent le service web de leur propre pays.

API username (Baltic) : votre nom d'utilisateur du service web DPD Baltic. Inutile pour DPD Slovaquie. Le vider efface aussi le mot de passe enregistré.

API password (Baltic) : votre mot de passe du service web DPD Baltic. Inutile pour DPD Slovaquie. Après l'enregistrement, le champ reste vide et affiche Saved - leave empty to keep it. Ne saisissez une nouvelle valeur que pour la modifier.

Pickup points : le bouton Refresh pickup points vide le cache et charge maintenant les points de retrait depuis DPD : Lituanie, Lettonie et Estonie pour l'API Baltic, et une recherche test à Bratislava pour DPD Slovaquie. Il affiche le nombre de points de retrait ou l'erreur pour chaque pays. Enregistrez d'abord les réglages.

Tarifs

Les tarifs de livraison sont fixes par pays, dans la devise par défaut de votre boutique, hors taxes. Les tarifs DPD ne sont pas demandés à l'API.

Country prices : une ligne par pays : CC:prix, par exemple EE:3.50. La virgule décimale est acceptée. Par défaut : SK:3.50, LT:4.00, LV:4.00, EE:4.00.

Fallback cost : le tarif des pays qui ne figurent pas dans Country prices. Par défaut : 5.00. Laissez le champ vide pour ne proposer le transporteur que dans les pays listés.

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

Free shipping from : la livraison est gratuite lorsque le sous-total de la commande (après remises, avant taxes) atteint ce montant. Laissez le champ vide pour la désactiver.

Disponibilité

Le transporteur est aussi masqué lorsque DPD ne renvoie aucun point de retrait pour l'adresse du client ou lorsque l'API DPD est injoignable, car une commande ne peut pas être livrée sans point de retrait.

Min weight (kg) : le poids minimal du panier. Les poids des produits sont convertis depuis l'unité de poids de votre boutique. Vide ou 0 signifie aucune limite.

Max weight (kg) : les paniers plus lourds ne voient pas le transporteur. Par défaut : 31.5. 0 signifie aucune limite. Vérifiez les limites de poids des colis acceptés par les points de retrait et consignes DPD de votre pays. Un Min weight (kg) supérieur au Max weight (kg) est refusé, et rien n'est enregistré.

Minimum subtotal : n'affiche le transporteur que lorsque le sous-total de la commande (après remises, avant taxes) atteint au moins ce montant. Laissez le champ vide pour l'afficher toujours.

Ignore shipping zones : lorsqu'elle est activée, le transporteur est lié à toutes les zones et proposé pour les pays indiqués ci-dessous. Une zone que vous créez plus tard est liée immédiatement. Lorsqu'elle est désactivée, le transporteur n'est proposé que dans ses zones de Shipping > Carriers. La désactiver rétablit les zones que le transporteur avait auparavant.

Countries : les pays de destination pour ce mode. Laissez le champ vide pour tous les pays. Utilisé uniquement avec Ignore shipping zones.

Sélecteur de point de retrait

City order : affiche d'abord les grandes villes (Tallinn, Riga, Vilnius, Bratislava et d'autres). Activé par défaut.

City list width : la largeur CSS de la liste des villes, par exemple 100% ou 300px. Par défaut : 100%.

Pickup point list width : la largeur CSS de la liste des points de retrait, par exemple 100% ou 400px. Par défaut : 100%.

Avancé

Debug log : écrit les requêtes API et les étapes de la commande dans logs/vfd_dpd_debug.log.php, dans le dossier du module. Le fichier ne peut pas être ouvert depuis le web. Les erreurs de l'API sont toujours journalisées, même si cette option est désactivée. Les identifiants ne sont jamais journalisés.

Log : affiche la taille et les dernières entrées du journal de débogage. Cliquez sur Clear log pour le vider.

Remove data on uninstall : lorsqu'elle est activée, la désinstallation du module supprime ses réglages et le transporteur. Le point de retrait enregistré dans les commandes est toujours conservé.

Fonctionnement à la commande

À l'étape de livraison, PrestaShop demande au module le prix de DPD Pickup. 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 pays (avec Ignore shipping zones), le poids du panier et le sous-total minimal, prend le tarif du pays (ou le coût de secours) et applique la livraison gratuite si le sous-total est suffisant. Il charge ensuite les points de retrait DPD pour l'adresse. Si DPD n'en renvoie aucun, ne répond pas ou si les identifiants Baltic sont absents, le transporteur est masqué. Le prix est calculé dans la devise par défaut de votre boutique, puis affiché dans la devise du panier du client.

Une liste de points de retrait est mise en cache pendant 24 heures, une liste vide pendant 1 heure. Une requête échouée est retenue pendant 5 minutes, de sorte qu'une panne de DPD ne ralentit jamais le paiement. Le délai d'attente de l'API est de 15 secondes.

Si vous modifiez le transporteur dans Shipping > Carriers alors qu'il a déjà des commandes, PrestaShop l'enregistre comme une nouvelle version du transporteur. Le module suit automatiquement la nouvelle version.

Le module ne demande pas les tarifs DPD, ne crée pas d'envois DPD, n'imprime pas d'étiquettes, ne crée pas de manifestes, ne commande pas d'enlèvement par coursier, ne suit pas les colis et n'affiche pas de carte. Seuls le service web DPD Baltic et la recherche de parcelshops DPD Slovaquie sont pris en charge.

Points de retrait

Lorsque le client sélectionne DPD Pickup, une liste de villes et une liste de points de retrait apparaissent sous le transporteur. La ville de l'adresse du client est présélectionnée. Le choix est enregistré dans le panier dès que le client le sélectionne. Avec DPD Slovaquie, le client voit Enter your city and postcode to see the DPD pickup points nearby. tant que l'adresse n'est pas complète, puis les points les plus proches. Si DPD ne dispose d'aucun point pour l'adresse, le client voit No DPD pickup points are available for this address right now. Please check the address or choose another shipping method.

Un point de retrait est obligatoire. Sans lui, le client ne peut pas poursuivre et voit Please select a DPD pickup point. Le serveur vérifie que le point appartient à la liste DPD pour l'adresse du client. Un choix falsifié ou périmé est refusé avec The selected DPD pickup point is not available for this address. Please choose another one.

Le point choisi est enregistré dans la commande. Il est affiché sur la page de confirmation de commande et dans le détail de commande du client sous la forme DPD pickup point:. Dans l'e-mail de confirmation de commande, il est ajouté après le nom du transporteur. Le nouvel e-mail de commande envoyé à la boutique (ps_emailalerts) affiche aussi l'identifiant du point. Le nom enregistré dans la commande provient de DPD, et non du navigateur.

Sur la page de commande du back office, le bloc DPD pickup point affiche le nom du point, son identifiant et son pays. Cliquez sur Edit, choisissez une ville et un autre point, puis cliquez sur Save. Le point est vérifié par rapport à la liste DPD pour l'adresse de la commande, et la page affiche Pickup point updated. ou Pickup point not found for the order address. La modification du point nécessite l'autorisation de modifier les commandes, et non l'accès aux pages Modules. Chaque modification est enregistrée dans Advanced Parameters > Logs de la commande, avec l'ancien point, le nouveau point et l'employé. Pour modifier le point avec DPD Slovaquie, la commande doit avoir une ville et un code postal de livraison.

Si un panier est scindé en plusieurs commandes, le point de retrait reste attaché à la première commande. Les autres commandes affichent No pickup point was selected for this order., le journal de débogage contient une erreur pour chacune d'elles, et Edit y affiche The pickup point of this cart belongs to another order of the same cart. Nothing was changed. Transmettez à DPD, manuellement, le point d'une telle commande.

Clé de licence

Le module fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox DPD Pickup est le premier bloc de Modules > Module Manager > VibeFox DPD Pickup > 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-dpd-pickup 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 : celui 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 l'emplacement dans votre compte vibefox.net.

Sans clé active, le transporteur DPD Pickup n'est pas affiché aux clients à la commande et aucun tarif n'est calculé. La vitrine PrestaShop ne sait pas que vous êtes connecté au back office, donc le transporteur est aussi masqué pour vous : vous pouvez configurer le module avant d'acheter une clé, mais ne pouvez pas le tester à la commande. Un rappel apparaît dans Modules > Module Manager, sur 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 le support nécessitent un renouvellement. Le statut est vérifié à nouveau 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

DPD Pickup n'apparaît pas à la commande : vérifiez que la licence est active et que Enable/Disable est activé. Dans Shipping > Carriers, vérifiez que le transporteur couvre la zone du pays du client et le groupe de clients (ou que Ignore shipping zones est activé et que le pays est autorisé). Consultez les avertissements en haut de la page du module et cliquez sur Refresh pickup points. Vérifiez les limites de poids et de sous-total, ainsi que la présence d'un tarif (ou d'un coût de secours) pour le pays. Les produits peuvent aussi être limités à certains transporteurs dans la page du produit.

Une erreur après Refresh pickup points : le résultat affiche l'erreur DPD pour chaque pays. Par exemple, « Login failed » signifie que DPD a refusé les identifiants Baltic : aucun point de retrait ne peut être chargé. Vérifiez le nom d'utilisateur et le mot de passe de l'API auprès de DPD.

DPD Slovaquie n'affiche aucun point : les points apparaissent lorsque le client a saisi la ville et le code postal. DPD ne liste que les points situés à moins de 50 km de cette adresse. Les développeurs peuvent modifier ce rayon avec le hook du module actionVfdDpdSkSearchRadius.

Trouver la cause : activez le Debug log, rechargez la page de commande et consultez le champ Log de la page du module. Chaque décision y est écrite. Les erreurs de l'API sont toujours journalisées. Les noms d'utilisateur et les mots de passe de l'API ne sont jamais écrits dans le journal.

Les points de retrait semblent périmés après une modification : cliquez sur Save ou sur Refresh pickup points sur la page du module. Les deux vident les listes en cache.

La page indique que le transporteur DPD Pickup est introuvable : 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 DPD Pickup et choisissez Uninstall. La clé de licence, le statut de la licence et le cache des points de retrait sont toujours supprimés. Si Remove data on uninstall est activé, le transporteur est supprimé (les commandes conservent leur historique), ainsi que les réglages, le journal et les choix des paniers non terminés. Si l'option est désactivée, le transporteur est seulement désactivé et tous les réglages sont conservés. Réinstaller le module, ou effectuer une réinitialisation, rend au transporteur enregistré le statut qu'il avait auparavant : un transporteur désactivé reste désactivé. Le point de retrait enregistré dans les commandes n'est jamais supprimé.

DPD est une marque déposée de son propriétaire. Ce module n'est ni affilié à DPD ni approuvé par DPD.