VibeFox DHL Packstation 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.

DHL API key : la liste des points provient de l'API gratuite DHL Location Finder. Inscrivez-vous sur le portail développeurs DHL (developer.dhl.com), créez une application, ajoutez l'API « Location Finder - Unified » et copiez la clé API de l'application. Cette API ne nécessite aucun contrat professionnel avec DHL. Sans la clé, la méthode est masquée au paiement. Tenez compte de la limite de requêtes de votre application DHL : chaque nouvelle recherche par code postal ou ville correspond à une requête API.

VibeFox license key : acheté 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_dhl_packstation dans /wp-content/plugins/ par FTP.

2. Cliquez sur Activate.

3. Ouvrez les réglages : WooCommerce > Settings > Shipping > DHL Packstation, 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. Collez la clé API DHL, enregistrez, cliquez sur Test API key, choisissez les types de points et saisissez les prix par pays (voir Configuration).

6. Ajoutez DHL Packstation à une zone de livraison (par exemple l'Allemagne) 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 > DHL Packstation. Ils s'appliquent à toutes les zones de livraison. Lorsque vous ajoutez la méthode à une zone, la fenêtre de la zone ne contient qu'un champ :

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

Des avertissements au-dessus des réglages indiquent quand la clé API DHL est vide et quand les tarifs par pays ne sont pas au bon format. À chaque enregistrement des réglages, le cache des points est vidé.

Général

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

Name : le nom de la méthode de livraison affiché au client. Par défaut : DHL Packstation. Une zone peut le remplacer par son propre Title.

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

DHL Location Finder API

DHL API key : la clé API de votre application sur developer.dhl.com. Sans elle, la méthode est masquée au paiement.

Connection test : le bouton Test API key recherche les points proches de 53113 Bonn avec la clé enregistrée et vide le cache des points. Enregistrez d'abord les réglages. Il indique combien de points ont été trouvés, ou que DHL a refusé la clé (401/403).

Points de retrait

Location types : les points DHL que le client peut choisir : Packstation (parcel locker), Post Office (Postfiliale) et DHL Parcel Shop (Paketshop). Les trois par défaut. Si aucun n'est sélectionné, la méthode est masquée. Pour une Packstation, le client doit saisir son DHL Postnummer.

Search radius (meters) : le rayon autour du code postal ou de la ville recherchés. Par défaut : 5000. DHL autorise jusqu'à 25000 m.

Max results : le nombre maximum de points affichés par recherche. Par défaut : 20. DHL autorise jusqu'à 50.

Shipping address : utilise le point choisi comme adresse de livraison de la commande. Activé par défaut. La ligne d'adresse 1 devient par exemple « Packstation 105 », la ligne 2 « Postnummer » suivi du numéro, plus le code postal et la ville du point, afin que les étiquettes imprimées depuis la commande arrivent au bon endroit. Le Postnummer est aussi enregistré sous _shipping_dhl_postnum, le champ lu par l'extension officielle « DHL Shipping Germany for WooCommerce ».

Tarifs

Country prices : le prix par pays de destination dans la devise de la boutique, au format CC:PRIX, séparés par des virgules ou des retours à la ligne. Par défaut : DE:4.99, AT:5.99. La virgule décimale fonctionne aussi (DE:4,99).

Other countries : le prix pour un pays de destination absent de Country prices. Par défaut : 5.99. Laissez vide pour masquer la méthode pour ces pays.

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

Free shipping from : le sous-total du panier à partir duquel cette livraison est gratuite. Laissez vide si elle n'est jamais gratuite.

Disponibilité

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

Max weight (kg) : la méthode est masquée au-delà de ce poids de panier. Par défaut : 31.5, car une Packstation accepte les colis jusqu'à 31,5 kg. 0 signifie sans limite.

Minimum subtotal : n'affiche la méthode que si le sous-total du panier atteint au moins cette valeur. Laissez vide pour l'afficher toujours.

Excluded shipping classes : la méthode est masquée si le panier contient un produit appartenant à l'une de ces classes d'expédition WooCommerce.

Ignore shipping zones : propose la méthode pour les pays indiqués ci-dessous, même si la zone correspondante ne la contient pas.

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

Avancé

Debug log : enregistre les requêtes API et les étapes du paiement dans WooCommerce > Status > Logs, source vfd-dhl-packstation. Les erreurs API sont toujours enregistrées, même lorsque cette option est désactivée. La clé API, le Postnummer et les adresses des clients ne sont jamais enregistrés.

Remove data on uninstall : si activé, la suppression de l'extension efface ses réglages et ses méthodes de zone. La désactivation ne supprime jamais rien. Les points choisis restent dans les commandes.

Fonctionnement au paiement

Lorsque le client saisit une adresse de livraison, WooCommerce demande un prix à l'extension. L'extension vérifie le poids du panier, le sous-total minimum et les classes d'expédition exclues, prend le prix du pays de destination (ou celui des autres pays) et applique la livraison gratuite si le sous-total est assez élevé.

La méthode fonctionne sur le paiement classique et sur les blocs Panier et Paiement. Elle est compatible avec WooCommerce High-Performance Order Storage (HPOS).

L'extension ne crée pas d'envois DHL, n'imprime pas d'étiquettes et ne suit pas les colis. Utilisez le portail clients professionnels DHL ou une extension d'étiquettes : la commande contient déjà l'adresse de la Packstation et le Postnummer dans le format attendu. L'extension ne calcule pas de tarifs DHL en temps réel et n'affiche aucune carte. Si l'API DHL est injoignable, le client voit un message et ne peut pas utiliser cette méthode tant qu'elle ne fonctionne pas à nouveau. Il n'est pas possible de saisir manuellement un numéro de Packstation.

Points de retrait

Lorsque le client sélectionne DHL Packstation, un sélecteur apparaît sous l'option de livraison. Les points DHL proches du code postal ou de la ville de livraison sont chargés. Le client peut rechercher un autre code postal ou une autre ville. Les points sont regroupés par type (Packstation, Post Office, Parcel Shop) et triés par distance.

Pour une Packstation, le client doit saisir le DHL Postnummer, son numéro de client DHL de 6 à 12 chiffres, visible dans l'application DHL ou dans son compte DHL. Pour les autres points, il est facultatif. La commande ne peut pas être passée sans point de retrait ni avec un Postnummer invalide. Cette vérification est faite côté serveur, y compris pour le paiement en blocs.

Les résultats de recherche sont mis en cache pendant 12 heures. Une recherche échouée est mise en cache pendant 10 minutes, afin que le paiement n'attende pas DHL à chaque actualisation. Le délai d'expiration de l'API est de 12 secondes.

Le point (ID, type, numéro, nom, adresse) et le Postnummer sont enregistrés dans la commande. Ils sont affichés sur l'écran de commande sous l'adresse de livraison, sur la page de confirmation, dans My account > Orders et dans les e-mails de commande (HTML et texte brut) sous les intitulés DHL pickup location et DHL Postnummer.

Sur l'écran de commande, cliquez sur Edit à côté du point, recherchez par code postal ou ville, choisissez un autre point, modifiez le Postnummer et cliquez sur Save location. Chaque modification ajoute une note à la commande. Si Shipping address est activé, l'adresse de livraison est aussi mise à jour. Rechargez la page pour la voir.

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 > DHL Packstation. 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, ainsi que 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, DHL Packstation n'est pas affichée aux clients au paiement. Les gestionnaires connectés de la boutique la voient toujours, avec la mention (unlicensed — visible to admins only), afin de pouvoir 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

DHL Packstation n'apparaît pas au paiement : vérifiez que la licence est active, que Enable/Disable est activé et que la méthode est ajoutée à la zone du pays du client (ou que Ignore shipping zones est activé et que le pays est autorisé). Vérifiez que la DHL API key est renseignée, qu'au moins un type de point est sélectionné, que le pays de destination a un prix (ou que Other countries est défini), et que les règles de poids, de sous-total et de classe d'expédition ne la masquent pas.

Aucun point ne s'affiche : cliquez sur Test API key. Si DHL refuse la clé (401/403), vérifiez la clé et que votre application dispose de l'API « Location Finder - Unified ». Activez Debug log et ouvrez WooCommerce > Status > Logs, source vfd-dhl-packstation. Vérifiez que la limite de requêtes de votre application DHL n'est pas atteinte.

Aucun point près d'une adresse : augmentez le Search radius (meters) ou le Max results, ou laissez le client rechercher un autre code postal ou une autre ville.

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. 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, ainsi que le cache des points. 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. Les points choisis restent dans les commandes, et les commandes existantes conservent leurs lignes de livraison.

DHL et Packstation sont des marques de leurs propriétaires respectifs. Cette extension n'est ni affiliée à DHL ni approuvée par DHL.