VibeFox DPD Pickup for WooCommerce — Aide

Prérequis

WordPress : 5.8 ou ultérieur.

WooCommerce : 7.0 ou ultérieur, installé et activé. L'extension refuse de s'activer sans lui.

PHP : 8.0 ou ultérieur.

Identifiants DPD Baltic (Lituanie, Lettonie, Estonie) : la liste des points de retrait provient du service web DPD Baltic. Vous avez besoin du nom d'utilisateur et du mot de passe de l'API que DPD remet à ses clients professionnels. Adressez-vous à votre gestionnaire de compte DPD ou au service client DPD de votre pays. Un seul 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 WordPress, allez dans Plugins > Add New > Upload Plugin, choisissez le fichier ZIP de l'extension et cliquez sur Install Now. Vous pouvez aussi envoyer le dossier vfd_dpd_pickup dans /wp-content/plugins/ par FTP.

2. Cliquez sur Activate.

3. Ouvrez les réglages : WooCommerce > Settings > Shipping > VibeFox DPD Pickup, ou cliquez sur Settings sous le nom de l'extension sur la page Plugins.

4. Saisissez votre clé de licence VibeFox dans le bloc de licence en haut de la page et cliquez sur Activate.

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

6. Ajoutez VibeFox DPD Pickup à vos zones de livraison dans WooCommerce > Settings > Shipping > Shipping zones, ou activez Ignore shipping zones.

Configuration

Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Shipping > VibeFox DPD Pickup. Ils s'appliquent à toutes les zones de livraison. Lorsque vous ajoutez le mode à une zone, la fenêtre de la zone ne contient qu'un champ :

Title (zone): le nom de cette option sur la page de paiement pour cette zone. Laissez-le vide pour utiliser le Name général.

Des avertissements au-dessus des réglages vous indiquent lorsque le nom d'utilisateur ou le mot de passe DPD Baltic est vide et lorsqu'aucun tarif n'est défini. À chaque enregistrement des réglages, le cache des points de retrait est vidé.

Général

Enable/Disable: active ou désactive le mode dans toutes les zones à la fois.

Name: le nom du mode de livraison affiché sur la page de paiement. Par défaut : DPD Pickup Point.

Tax status: Taxable ajoute la taxe WooCommerce au coût de livraison, None ne l'ajoute pas.

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 votre compte est ouvert. Les comptes Baltic utilisent le service web de leur propre pays.

API username (Baltic): votre nom d'utilisateur du service web DPD Baltic. Non nécessaire pour DPD Slovaquie.

API password (Baltic): votre mot de passe du service web DPD Baltic. Non nécessaire pour DPD Slovaquie.

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

Tarifs

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

Country prices: une ligne par pays : CC:price, par exemple EE:3.50. Une 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 absents de Country prices. Par défaut : 5.00. Laissez vide pour ne proposer le mode 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 coupons) atteint ce montant. Laissez vide pour la désactiver.

Disponibilité

Le mode 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 mode. Par défaut : 31.5. 0 signifie aucune limite. Vérifiez les limites de colis des points de retrait et consignes DPD Pickup de votre pays.

Minimum subtotal: n'affiche le mode que lorsque le sous-total de la commande atteint au moins ce montant. Laissez vide pour toujours l'afficher.

Excluded shipping classes: le mode est masqué lorsque le panier contient un produit appartenant à l'une de ces classes d'expédition WooCommerce.

Ignore shipping zones: propose le mode pour les pays indiqués ci-dessous, même si la zone de livraison du client ne le contient pas. Désactivé, vous ajoutez le mode aux zones de livraison comme d'habitude.

Countries: les pays de destination pour ce mode. Laissez 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: enregistre les requêtes API et les étapes du paiement dans WooCommerce > Status > Logs, source vfd-dpd-pickup. Les erreurs API sont toujours enregistrées, même si cette option est désactivée. Les identifiants ne sont jamais enregistrés.

Remove data on uninstall: lorsque l'option est activée, la suppression de l'extension supprime ses réglages et ses méthodes de zone. La désactivation ne supprime jamais les réglages. Le point de retrait enregistré dans les commandes est toujours conservé.

Fonctionnement au paiement

Lorsque le client saisit une adresse de livraison, WooCommerce demande un tarif à l'extension. L'extension vérifie le poids du panier, le sous-total minimal et les classes d'expédition exclues, retient le tarif du pays (ou le tarif de secours) et applique la livraison gratuite si le sous-total est assez élevé. Elle 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 manquent, le mode est masqué.

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

Le mode fonctionne sur le paiement classique et sur les blocs Panier et Paiement. Il est compatible avec WooCommerce High-Performance Order Storage (HPOS).

L'extension 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èvements de 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 mode. La ville de l'adresse du client est présélectionnée. Avec DPD Slovaquie, le client saisit d'abord la ville et le code postal, puis voit les points à proximité. Un point de retrait est obligatoire. Le serveur vérifie que le point appartient au pays et à l'adresse du client, de sorte qu'un choix falsifié ou périmé est refusé.

Le point choisi est enregistré dans la commande. Il est affiché sur l'écran de commande sous l'adresse de livraison, sur la page de remerciement, dans My account > Orders et dans les e-mails de commande (HTML et texte brut) sous le libellé DPD pickup point. Le nom enregistré dans la commande provient de DPD, et non du navigateur.

Sur l'écran de commande, cliquez sur Edit à côté du point de retrait, choisissez une ville et un autre point. Le point est vérifié par rapport à la liste DPD pour l'adresse de la commande. La commande doit avoir une ville et un code postal de livraison pour modifier le point.

Clé de licence

L'extension fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence se trouve en haut de WooCommerce > Settings > Shipping > VibeFox DPD Pickup. Collez la clé dans License key et cliquez sur Activate. Le bloc affiche le statut, par exemple la date jusqu'à laquelle la licence est active, et votre domaine. Utilisez Check now pour vérifier à nouveau le statut, Change key pour saisir une autre clé et Remove key pour la retirer de ce site. Le lien Manage licenses and domains in your account ouvre votre compte vibefox.net.

Une clé fonctionne sur un seul domaine. Retirer la clé d'un site ne libère pas son emplacement de domaine. Libérez-le dans votre compte vibefox.net.

Sans clé active, DPD Pickup n'est pas affiché aux clients au paiement. Les gestionnaires connectés de la boutique le voient toujours, marqué (unlicensed — visible to admins only), afin que vous puissiez configurer et tester l'extension avant d'acheter une clé. Un rappel apparaît sur la page Plugins et sur les pages WooCommerce. Les commandes existantes ne sont pas affectées.

Lorsqu'une licence expire, l'extension continue de fonctionner, mais les mises à jour et le support nécessitent un renouvellement. Le statut est vérifié à nouveau automatiquement en arrière-plan.

Dépannage

DPD Pickup n'apparaît pas au paiement : vérifiez que la licence est active, que Enable/Disable est activé et que le mode est ajouté à la zone du pays du client (ou que Ignore shipping zones est activé et que le pays est autorisé). Consultez les avertissements en haut de la page des réglages et cliquez sur Refresh pickup points. Vérifiez les limites de poids et de sous-total, les classes d'expédition exclues et que le pays a un tarif (ou un tarif de secours).

« Login failed » après Refresh pickup points : DPD a rejeté les identifiants Baltic, donc 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 une fois que 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.

Trouver la cause : activez le Debug log. Chaque décision est enregistrée dans WooCommerce > Status > Logs, source vfd-dpd-pickup. Les erreurs API sont toujours enregistrées. Les noms d'utilisateur et mots de passe de l'API ne sont jamais écrits dans le journal.

Le bloc de licence affiche une erreur : suivez le message affiché dans le bloc. Par exemple, si la clé est déjà utilisée sur un autre domaine, libérez un emplacement dans votre compte vibefox.net et cliquez sur Check now. Si l'adresse du site a changé, cliquez sur Check now pour activer la clé pour le nouveau domaine. Si le serveur de licences est injoignable, l'extension continue de fonctionner avec le dernier statut connu.

Désinstallation

La désactivation de l'extension conserve tous les réglages. Elle vide seulement le cache des points de retrait. Pour supprimer l'extension, désactivez-la puis supprimez-la sur la page Plugins. La clé de licence et le statut de licence de cette extension sont toujours supprimés, de même que le cache des points de retrait. Les réglages et les méthodes de zone ne sont supprimés que si Remove data on uninstall était activé. Sinon, ils sont conservés pour une réinstallation ultérieure. Le point de retrait enregistré dans les commandes n'est jamais supprimé, et les commandes existantes conservent leurs lignes de livraison.

DPD est une marque de commerce de son propriétaire respectif. Cette extension n'est ni affiliée à DPD ni approuvée par DPD.