VibeFox PostNord 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.
Clé API PostNord (pour le sélecteur de point de service): créez un compte gratuit sur developer.postnord.com, ajoutez une application et copiez sa clé API. Sans clé, la méthode fonctionne toujours, mais les clients ne peuvent pas choisir de point de service.
Contrat PostNord: pour expédier des colis, il vous faut votre contrat client PostNord habituel, par exemple MyPack Collect ou MyPack Home.
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_postnord dans /wp-content/plugins/ par FTP.
2. Cliquez sur Activate.
3. Ouvrez les réglages : WooCommerce > Settings > Shipping > VibeFox PostNord, ou cliquez sur Settings sous le nom de l'extension sur la page Extensions.
4. Saisissez votre clé de licence VibeFox dans le bloc de licence en haut de la page et cliquez sur Activate.
5. Collez la API key PostNord, choisissez votre Agreement country et renseignez les Country prices (voir Configuration).
6. Ajoutez VibeFox PostNord aux zones de livraison de la Suède, du Danemark, de la Norvège ou de la Finlande dans WooCommerce > Settings > Shipping > Shipping zones. Dans les réglages de la méthode, définissez son Title et son Delivery type. Ou activez Ignore shipping zones.
Configuration
Tous les réglages, sauf le titre et le type de livraison, se trouvent sur une seule page : WooCommerce > Settings > Shipping > VibeFox PostNord. Ils s'appliquent à toutes les zones de livraison. Lorsque vous ajoutez la méthode à une zone, la fenêtre de la zone comporte deux champs :
Title (zone): le nom de cette option au paiement, par exemple « PostNord MyPack Collect ». Laissez-le vide pour utiliser le Name général.
Delivery type (zone): Same as global setting (par défaut), Service point / parcel locker ou Home delivery. Ajoutez deux méthodes PostNord à une zone pour proposer les deux.
Au-dessus des réglages, la page signale l'absence de clé API ou de tarif. À chaque enregistrement des réglages, les listes de points de service en cache sont vidées.
Général
Enable/Disable: lorsque la case est décochée, la méthode est masquée partout, y compris dans les zones de livraison.
Name: le nom de la méthode de livraison affiché au paiement. Une méthode de zone peut le remplacer par son propre Title. Par défaut : PostNord.
Delivery type: la valeur par défaut de toutes les méthodes PostNord ; chaque méthode de zone peut choisir la sienne.
Tax status: Taxable ajoute la taxe WooCommerce au coût de livraison, None ne l'ajoute pas.
API PostNord (sélecteur de point de service)
API key: la clé API de votre application sur developer.postnord.com. Elle n'est envoyée à PostNord que depuis votre serveur, jamais au navigateur, et n'est jamais journalisée.
Test mode: utilise l'environnement de test PostNord (atapi2.postnord.com). Réservé aux clés émises pour l'environnement de test.
Agreement country: le pays de votre contrat client PostNord : Suède, Danemark, Norvège ou Finlande. Il détermine les points de service proposés. Same as the delivery country (par défaut) utilise le pays du client.
Tarifs
Les tarifs sont exprimés dans la devise de la boutique. PostNord ne propose pas d'API publique de tarifs : vous définissez donc vos propres tarifs, généralement ceux de votre contrat PostNord. L'ordre est le suivant : d'abord la grille par pays, puis le tarif de secours ; la livraison gratuite ne s'applique que là où l'un de ces deux éléments donne un tarif.
Calculation type: Per order facture le tarif une seule fois. Per item (price × number of items) le multiplie par le nombre d'articles du panier.
Country prices: un tarif par pays de destination et par poids du panier. Cliquez sur + Add country pour ajouter une ligne, et sur la croix pour en supprimer une. Chaque ligne comporte un Price et des colonnes de poids : XS jusqu'à 1 kg, S jusqu'à 2 kg, M jusqu'à 3 kg, L jusqu'à 5 kg et XL au-delà de 5 kg. Une colonne de poids à 0 utilise la colonne Price. Le pays * All other countries couvre tous les pays sans ligne propre. Décimales avec une virgule ou un point (9,99 ou 9.99). Une nouvelle ligne commence avec * All other countries et tous les tarifs à 0, ce qui signifie livraison gratuite. Choisissez le pays et saisissez les tarifs avant d'enregistrer, ou supprimez la ligne. Une cellule qui n'est pas un nombre est enregistrée à 0, avec un message.
Fallback cost: utilisé lorsque la grille par pays n'a pas de ligne pour la destination ni de ligne *. Laissez vide pour masquer la méthode pour ces pays.
Free shipping from: le sous-total du panier (après remises, hors taxes) à partir duquel PostNord est gratuit. Il s'applique uniquement là où un tarif est défini : une ligne de pays, la ligne * ou le tarif de secours. Laissez vide pour ne jamais proposer la livraison gratuite.
Disponibilité
Min weight (kg): masque la méthode lorsque le panier pèse moins. Les poids des produits sont convertis depuis l'unité de poids de votre boutique. 0 signifie aucune limite.
Max weight (kg): masque la méthode lorsque le panier pèse plus. Par défaut : 30. 0 signifie aucune limite. Vérifiez la limite de poids de votre service PostNord : les consignes acceptent moins que les points de service.
Minimum subtotal: n'affiche la méthode que si le sous-total du panier atteint ce montant. Laissez vide pour l'afficher toujours.
Disabled shipping classes: masque la méthode lorsque le panier contient un produit appartenant à l'une de ces classes de livraison WooCommerce.
Ignore shipping zones: lorsqu'elle est activée, PostNord est proposé pour les pays indiqués ci-dessous avec les réglages généraux, même s'il n'est pas ajouté à une zone de livraison. Lorsqu'elle est désactivée, uniquement dans les zones de livraison auxquelles vous l'avez ajouté.
Countries (Ignore shipping zones): les pays de destination pour ce mode. Laissez vide pour utiliser tous les pays de livraison. Ce champ n'est utilisé que lorsque Ignore shipping zones est activée.
Les montants et les poids acceptent la virgule ou le point. Un nombre invalide n'est pas enregistré, avec un message.
Avancé
Debug log: écrit les calculs de tarifs et les appels API dans WooCommerce > Status > Logs (source « vfd-postnord »). Les erreurs de l'API sont toujours journalisées. La clé API n'est jamais journalisée. Désactivez le journal une fois terminé.
Remove data on uninstall: lorsqu'elle est activée, la suppression de l'extension efface les réglages PostNord et les méthodes de zone. La désactivation ne supprime jamais les réglages. Les points de service enregistrés dans les commandes sont toujours conservés.
Fonctionnement au paiement
Lorsque le client saisit une adresse de livraison, WooCommerce demande un tarif à l'extension. L'extension vérifie les conditions : poids du panier, sous-total minimal et classes de livraison désactivées. Le tarif provient de la grille par pays, puis du tarif de secours. S'il n'existe aucun tarif, la méthode est masquée. Si la livraison gratuite s'applique, le client voit la méthode sans frais.
Pour une méthode à point de service et une adresse de livraison en Suède, au Danemark, en Norvège ou en Finlande, votre serveur demande à l'API Business Location de PostNord les points de service les plus proches du code postal de livraison. Il envoie le pays et le code postal de livraison, ainsi que le pays du contrat. Le délai d'attente de l'API est de 10 secondes. Les listes sont mises en cache pendant 6 heures par code postal, et les réponses « aucun point » pendant 1 heure. Les erreurs de l'API sont mises en cache pendant 5 minutes, afin qu'une panne de PostNord ne ralentisse pas chaque mise à jour du paiement.
Pour les autres destinations, la méthode peut toujours être proposée avec vos tarifs, sans sélecteur.
La méthode fonctionne au paiement classique ainsi que dans les blocs Panier et Paiement. Elle est compatible avec WooCommerce High-Performance Order Storage (HPOS).
L'extension ne demande pas de tarifs PostNord en direct et ne crée pas d'étiquettes d'expédition, ne réserve pas d'envois (EDI), ne fournit pas de numéros de suivi et n'envoie pas d'e-mails de suivi. Il n'y a pas de vue carte. Utilisez PostNord Portal, Skicka Direkt Business ou une extension d'étiquettes pour les envois ; l'identifiant du point de service enregistré est ce dont ces outils ont besoin.
Points de retrait
Lorsque le client sélectionne une méthode à point de service, une liste PostNord service point apparaît en dessous, avec les points les plus proches, regroupés par ville avec la distance. Avant la saisie d'un code postal, le client voit le message « Enter your postcode to choose a PostNord service point. ». Le choix est conservé lors des mises à jour du paiement.
Lorsque la liste est chargée, un point est obligatoire. Sans choix, le paiement s'arrête avec « Please select a PostNord service point. ». Le point choisi est vérifié côté serveur par rapport à la liste, au paiement classique comme au paiement par blocs.
Le sélecteur ne bloque jamais une vente. Si la liste ne peut pas être chargée (pas encore de clé API, API PostNord indisponible, aucun point près du code postal), le client voit une remarque et peut quand même passer la commande. PostNord livre alors au point de service le plus proche de l'adresse.
Écran de commande de l'administration : PostNord service point avec le nom, l'adresse et le Service point ID, sous l'adresse de livraison. Si aucun point n'a été choisi, il est indiqué « not selected — PostNord delivers to the service point nearest to the shipping address ».
Page de remerciement et vue de commande dans Mon compte : PostNord service point: avec le nom et l'adresse.
E-mails de commande : le nom, l'adresse et l'identifiant du point dans les e-mails HTML et en texte brut.
En base de données, le point est enregistré dans les métadonnées de commande _vfd_ptnd_servicepoint_id, _vfd_ptnd_servicepoint_name et _vfd_ptnd_servicepoint_address.
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 PostNord. Collez la clé dans License key et cliquez sur Activate. Le bloc affiche l'état, par exemple la date jusqu'à laquelle la licence est active et votre domaine. Utilisez Check now pour vérifier de nouveau l'état, 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 l'emplacement depuis votre compte vibefox.net.
Sans clé active, PostNord n'est pas affiché aux clients au paiement. Les gestionnaires de la boutique connectés 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 Extensions 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. L'état est vérifié à nouveau automatiquement en arrière-plan.
Dépannage
PostNord 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 qu'un tarif est défini pour le pays (ligne du pays, ligne * ou Fallback cost), les limites de poids, Minimum subtotal et Disabled shipping classes.
Le sélecteur indique que les points de service ne peuvent pas être chargés : vérifiez la API key et le réglage Test mode. Une clé de production ne fonctionne pas avec l'environnement de test, et inversement. Activez le Debug log et consultez WooCommerce > Status > Logs, source « vfd-postnord ». La commande peut tout de même être passée ; PostNord livre alors au point de service le plus proche.
Points de service inattendus : vérifiez le Agreement country. Il détermine les points de service proposés.
La livraison est gratuite par erreur : vérifiez les Country prices pour les lignes avec un Price de 0, surtout une ligne * ajoutée avec + Add country et laissée vide, et vérifiez Free shipping from.
Le bloc de licence affiche une erreur : suivez le message du 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 état connu.
Désinstallation
La désactivation de l'extension conserve tous les réglages et supprime seulement les listes de points de service en cache. Pour la retirer, désactivez-la puis supprimez-la sur la page Plugins. La clé de licence et l'état de licence de cette extension sont toujours supprimés, ainsi que les listes de points de service en cache. Les réglages et les méthodes de zone ne sont supprimés que si Remove data on uninstall était activé. Sinon, ils restent en place pour une réinstallation ultérieure. Les commandes existantes conservent leurs lignes de livraison et le point de service enregistré.
PostNord est une marque appartenant à son titulaire respectif. Cette extension n'est ni affiliée à PostNord ni approuvée par PostNord.