VibeFox Delhivery for WooCommerce — Aide

Prérequis

WordPress : 5.8 ou ultérieur.

WooCommerce : 5.0 ou ultérieur, installé et activé. Le plugin refuse de s'activer sans lui.

PHP : 8.0 ou ultérieur.

Jeton API Delhivery (pour les tarifs en temps réel uniquement) : connectez-vous à Delhivery One et ouvrez Settings > API setup. L'article d'aide de Delhivery « API token generation » explique les étapes. Les jetons de test fonctionnent avec l'environnement de staging. Vous avez aussi besoin du code PIN à 6 chiffres de votre point d'enlèvement. Si vous utilisez uniquement les tarifs fixes, vous n'avez pas besoin de jeton.

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 du plugin et cliquez sur Install Now. Vous pouvez aussi envoyer le dossier vfd_delhivery dans /wp-content/plugins/ par FTP.

2. Cliquez sur Activate.

3. Ouvrez les réglages : WooCommerce > Settings > Shipping > VibeFox Delhivery, ou cliquez sur Settings sous le nom du plugin 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. Saisissez le jeton API et votre code PIN d'expédition, choisissez Express ou Surface et Pre-paid ou COD. Si la devise de votre boutique n'est pas l'INR, saisissez le taux de conversion. Vous pouvez aussi saisir des tarifs fixes (voir Configuration).

6. Ajoutez VibeFox Delhivery à une zone de livraison (par exemple Inde) dans WooCommerce > Settings > Shipping > Shipping zones, ou activez Ignore zones et choisissez les pays.

Configuration

Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Shipping > VibeFox Delhivery. 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 que le client voit pour cette zone. Laissez vide pour utiliser le Method title général.

À chaque enregistrement des réglages, les tarifs Delhivery en cache sont effacés. Les prix et montants acceptent « 9.99 » et « 9,99 ».

Général

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

Method title : le nom de la méthode d'expédition affiché au paiement. Par défaut : Delhivery. Une zone peut le remplacer par son propre Title.

Tax status : Taxable ajoute la taxe WooCommerce au coût d'expédition, None ne l'ajoute pas.

Compte API Delhivery (nécessaire uniquement pour les tarifs en temps réel)

Environment : Production (track.delhivery.com) (par défaut) ou Staging / test account (staging-express.delhivery.com). Utilisez Staging uniquement avec un jeton de test Delhivery.

API token : votre jeton API Delhivery. Il est envoyé uniquement dans l'en-tête d'autorisation et n'est jamais écrit dans les journaux.

Origin pincode : le code PIN à 6 chiffres de votre point d'enlèvement ou entrepôt, par exemple 110001.

Tarifs en temps réel

Un tarif en temps réel est demandé pour les destinations en Inde avec un code PIN valide à 6 chiffres, pour un envoi standard (livré).

Shipping mode : le mode de facturation Delhivery utilisé pour le tarif : Express (par défaut) ou Surface.

Payment type : le type de paiement envoyé à Delhivery : Pre-paid (par défaut) ou COD (paiement à la livraison ; Delhivery ajoute ses frais COD). Le plugin ne le change pas selon le mode de paiement choisi par le client.

Rate amount : Delhivery renvoie le montant avec et sans GST.

INR to (store currency) conversion rate : les tarifs Delhivery sont en roupies indiennes. Si la devise de votre boutique n'est pas l'INR, indiquez combien d'unités de votre devise vaut une roupie, par exemple 0.011. Laissé vide, les tarifs en temps réel ne sont pas utilisés, les tarifs fixes s'appliquent et un avertissement s'affiche au-dessus des réglages. Inutile si la devise de votre boutique est l'INR.

Tarifs fixes (utilisés lorsqu'aucun tarif en temps réel n'est disponible)

Les tarifs fixes sont utilisés lorsqu'il n'y a pas encore de jeton ou de code PIN, lorsque la destination est hors d'Inde, lorsque le code PIN n'est pas desservi ou lorsque l'API renvoie une erreur. Ils sont exprimés dans la devise de votre boutique.

Prices per country : un par ligne, au format COUNTRY_CODE:price, par exemple IN:120. Vérifié avant le prix de secours.

Fallback price : utilisé lorsqu'aucun tarif en temps réel ni prix par pays ne s'applique. Laissez vide pour masquer la méthode. 0 signifie gratuit.

Fixed price is charged : Per order facture le prix une seule fois. Per item (price × quantity) le multiplie par le nombre d'articles du panier. Un tarif Delhivery en temps réel s'applique toujours au poids total du colis.

Conditions

Free shipping from : la livraison est gratuite si le sous-total du panier atteint au moins ce montant. Aucune requête n'est envoyée à Delhivery. Laissez vide pour désactiver.

Show from subtotal : affiche la méthode seulement si le sous-total du panier atteint au moins ce montant. Laissez vide pour toujours l'afficher.

Min weight (kg) : le poids minimum du panier pour afficher la méthode. 0 signifie sans limite.

Max weight (kg) : masque la méthode si le panier est plus lourd. Par défaut : 30. 0 signifie sans limite.

Les poids des produits sont convertis en kg à partir de l'unité de poids de votre boutique. Le tarif utilise le poids réel du panier (la somme des poids des produits), sans poids volumétrique ni cartons.

Excluded shipping classes : masque la méthode si un article du panier appartient à l'une de ces classes d'expédition WooCommerce.

Disponibilité sans zones de livraison

Ignore zones : propose Delhivery sans l'ajouter à une zone de livraison, pour les pays indiqués ci-dessous.

Countries : les pays de destination pour ce mode. Laissez vide pour utiliser tous les pays où vous livrez. Utilisé uniquement lorsque Ignore zones est activé.

Avancé

Debug log : journalise les calculs de tarifs dans WooCommerce > Status > Logs, source vfd_delhivery. Les erreurs de l'API sont toujours journalisées, même si cette option est désactivée. Les jetons et les codes PIN complets des clients ne sont jamais journalisés.

Remove data on uninstall : si activé, la suppression du plugin efface tous ses réglages, méthodes de zone et tarifs en cache. Désactiver le plugin ne supprime jamais rien.

Fonctionnement au paiement

Lorsque le client saisit une adresse de livraison, WooCommerce demande un tarif au plugin. Le plugin vérifie d'abord le poids du panier, le sous-total et les classes d'expédition exclues. Si la livraison gratuite s'applique, le client bénéficie de la livraison gratuite et aucune requête n'est envoyée à Delhivery.

Pour une adresse indienne avec un code PIN valide à 6 chiffres, le plugin envoie à Delhivery les codes PIN d'origine et de destination, le poids du panier en grammes, le mode d'expédition et le type de paiement, puis affiche le montant renvoyé converti dans la devise de votre boutique. Chaque réponse est mise en cache pendant 1 heure. Une requête en échec est mise en cache pendant 10 minutes, afin que le paiement n'attende pas Delhivery à chaque actualisation. Le délai d'attente de l'API est de 10 secondes.

S'il n'y a pas de tarif en temps réel, le prix du pays ou le prix de secours est utilisé. S'il n'y en a aucun, la méthode est masquée. Le client ne voit jamais d'erreur de l'API.

La méthode fonctionne sur le paiement classique et sur les blocs Panier et Paiement. Elle est compatible avec le stockage de commandes haute performance de WooCommerce (HPOS).

Le plugin calcule les tarifs et affiche un lien de suivi. Il ne crée ni envois ni lettres de transport, n'imprime pas d'étiquettes, ne demande ni enlèvements ni manifestes, ne vérifie pas la desserte des codes PIN, n'estime pas les dates de livraison, ne synchronise pas les statuts de suivi et ne calcule pas les tarifs internationaux de Delhivery. Hors d'Inde, seuls les tarifs fixes sont utilisés.

Commandes et suivi

Sur l'écran de commande, sous l'adresse de livraison, le bloc Delhivery affiche le mode d'expédition (Express ou Surface) et la source du prix : tarif Delhivery en temps réel, tarif fixe ou seuil de livraison gratuite.

Créez l'envoi dans Delhivery One, puis collez son AWB dans le champ Delhivery AWB / tracking number et enregistrez la commande. Un lien Track on delhivery.com apparaît dans l'administration. Le client voit Delhivery tracking avec un lien sur la page de commande dans Mon compte et dans les e-mails de commande (HTML et texte brut). L'AWB est enregistré avant le statut de la commande : l'e-mail « Commande terminée » contient donc déjà l'AWB si vous terminez la commande dans le même enregistrement.

Clé de licence

Le plugin fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence se trouve en haut de WooCommerce > Settings > Shipping > VibeFox Delhivery. 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, Delhivery 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 le plugin avant d'acheter une clé. Un rappel apparaît sur la page Extensions et sur les pages de WooCommerce. Les commandes existantes ne sont pas touchées.

Lorsqu'une licence expire, le plugin 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

Delhivery 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 zones est activé et que le pays est autorisé). Contrôlez les limites de poids, Show from subtotal et Excluded shipping classes. Sans tarif en temps réel, il faut un prix par pays ou un Fallback price.

Les tarifs en temps réel n'apparaissent pas : vérifiez le jeton API, un Origin pincode valide et, pour une boutique qui n'est pas en INR, le taux de conversion. Le client doit saisir un code PIN indien valide à 6 chiffres. Activez Debug log et ouvrez WooCommerce > Status > Logs, source vfd_delhivery, pour voir les erreurs de l'API, par exemple un code PIN non desservi.

Le GST est facturé deux fois : le montant total de Delhivery inclut déjà le GST. Réglez Rate amount sur Gross amount (excluding GST) ou Tax status sur None.

Tests : utilisez Environment Staging avec un jeton de test Delhivery.

Les tarifs semblent obsolètes après une modification : enregistrez la page des réglages. Cela efface les tarifs Delhivery en cache.

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, le plugin continue de fonctionner avec le dernier statut connu.

Désinstallation

Désactiver le plugin conserve toutes les données. Pour le supprimer, désactivez-le puis supprimez-le sur la page Plugins. La clé de licence et le statut de licence de ce plugin sont toujours supprimés. Les réglages, les méthodes de zone et les tarifs en cache ne sont supprimés que si Remove data on uninstall était activé. Sinon, ils sont conservés pour une future réinstallation. Les numéros AWB restent dans les commandes, et les commandes existantes conservent leurs lignes d'expédition.

Delhivery est une marque commerciale de son propriétaire respectif. Ce plugin n'est ni affilié à Delhivery ni approuvé par Delhivery.