VibeFox Estafeta 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.

Compte DrEnvio (uniquement pour les tarifs en temps réel) : les tarifs Estafeta en temps réel proviennent de DrEnvio, partenaire d'Estafeta au Mexique. Créez un compte sur drenvio.com, activez Estafeta, configurez-y votre adresse d'enlèvement et copiez la clé API depuis le tableau de bord DrEnvio. C'est la même clé que celle utilisée par l'extension officielle DrEnvio. Si vous n'utilisez que vos propres tarifs, vous n'avez pas besoin de compte DrEnvio.

Produits : les produits doivent avoir un poids pour les tarifs en temps réel.

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_estafeta dans /wp-content/plugins/ par FTP.

2. Cliquez sur Activate.

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

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

5. Saisissez la clé API DrEnvio et, si vous le souhaitez, le code postal d'origine. Si la devise de votre boutique n'est pas le MXN, saisissez le MXN exchange rate. Définissez un tarif par pays pour MX ou un coût de repli si le mode doit rester visible lorsque DrEnvio n'a pas de tarif.

6. Ajoutez VibeFox Estafeta à votre zone Mexique dans WooCommerce > Settings > Shipping > Shipping zones, ou activez Ignore shipping zones et choisissez les pays.

Configuration

Tous les réglages se trouvent sur une seule page : WooCommerce > Settings > Shipping > VibeFox Estafeta. 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 au paiement. Laissez vide pour utiliser le Name global.

En haut de la page, l'extension affiche des avertissements : aucune clé API DrEnvio, devise de boutique autre que MXN sans taux de change, ou aucun tarif par pays pour MX et aucun coût de repli (le mode est alors masqué lorsqu'il n'y a pas de tarif en temps réel). À chaque enregistrement des réglages, les tarifs DrEnvio en cache sont effacés. Les champs numériques acceptent un point ou une virgule décimale. Une valeur qui n'est pas un nombre valide est effacée et signalée lors de l'enregistrement.

Général

Enable/Disable : active ou désactive la livraison Estafeta dans toutes les zones à la fois. Par défaut : activé.

Name : le nom du mode de livraison affiché au client au paiement. Par défaut : Estafeta.

Tax status : Taxable permet à WooCommerce d'ajouter la taxe au coût de livraison, None ne l'ajoute pas. Le fait que les tarifs DrEnvio incluent l'IVA dépend de votre compte DrEnvio. S'ils incluent déjà l'IVA, choisissez None. Par défaut : Taxable.

Tarifs en temps réel (API DrEnvio)

Le service Estafeta le moins cher pour l'adresse est proposé. Sans clé, les tarifs de la section suivante sont utilisés.

DrEnvio API key : la clé API de votre tableau de bord DrEnvio.

Origin country : le code pays à deux lettres de l'adresse d'enlèvement. Par défaut : MX. Envoyé uniquement avec le code postal d'origine.

Origin postcode : le code postal à 5 chiffres de l'adresse d'enlèvement. Laissez vide pour utiliser l'adresse d'origine enregistrée dans votre compte DrEnvio. Un code postal qui ne comporte pas 5 chiffres est effacé lors de l'enregistrement.

MXN exchange rate : DrEnvio établit ses devis en pesos mexicains. Nécessaire uniquement si la devise de votre boutique n'est pas le MXN : la valeur de 1 MXN dans la devise de votre boutique, par exemple 0.05. Sans lui, les tarifs en temps réel ne sont pas utilisés.

Tarifs sans tarif en temps réel

Utilisés lorsqu'il n'y a pas de clé API ou que DrEnvio ne renvoie aucun tarif Estafeta (API indisponible, code postal inconnu, aucun code postal saisi pour le moment). Les tarifs sont exprimés dans la devise de votre boutique.

Country prices : un pays de destination par ligne, au format CC:PRICE, par exemple MX:150. Utilisez un point ou une virgule décimale, sans séparateur de milliers. Les parties dans un autre format sont ignorées et signalées lors de l'enregistrement.

Fallback cost : le tarif appliqué lorsqu'il n'y a ni tarif en temps réel ni tarif par pays. Laissez vide pour masquer le mode ; 0 signifie livraison gratuite.

Calculation type : Per order facture le tarif une seule fois. Per item (price x number of items) le multiplie par le nombre d'articles expédiables. Cela s'applique à Country prices et à Fallback cost. Un tarif en temps réel DrEnvio correspond toujours au prix du colis entier.

Conditions

Free shipping from : la livraison est gratuite lorsque le sous-total du panier atteint ce montant. Aucune requête n'est alors envoyée à DrEnvio. Laissez vide pour ne jamais offrir la livraison gratuite.

Minimum subtotal : affiche le mode uniquement lorsque 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 que le mode apparaisse. 0 signifie aucune limite.

Max weight (kg) : le poids maximum du panier. Le mode est masqué s'il est dépassé. Par défaut : 30. 0 signifie aucune limite.

Excluded shipping classes : si un article du panier appartient à l'une de ces classes de livraison WooCommerce, le mode est masqué.

Les poids des produits sont convertis de l'unité de votre boutique en kg.

Disponibilité sans zones de livraison

Ignore shipping zones : proposer le mode pour les pays indiqués ci-dessous, même sans l'ajouter à une zone de livraison.

Countries : les pays de destination pour ce mode. Laissez vide pour tous les pays. Utilisé uniquement lorsque Ignore shipping zones est activé.

Avancé

Debug log : enregistre les requêtes API et le calcul des tarifs dans WooCommerce > Status > Logs, source vfd-estafeta. Les erreurs de l'API sont toujours enregistrées. La clé API et les adresses des clients ne sont jamais enregistrées.

Remove data on uninstall : lorsqu'il est activé, la suppression de l'extension efface tous ses réglages et les méthodes de zone. La désactivation de l'extension ne supprime jamais rien.

Fonctionnement au paiement

Lorsque le client saisit une adresse de livraison, WooCommerce demande un tarif à l'extension. L'extension vérifie d'abord le poids du panier, le sous-total minimum et les classes de livraison exclues. Si la livraison gratuite s'applique, le mode est affiché avec un prix nul et aucune requête n'est envoyée à DrEnvio.

Sinon, l'extension envoie à DrEnvio le pays et le code postal de destination, le poids du panier, le nombre d'articles et le sous-total, ainsi que le code postal d'origine si vous en avez défini un. Les codes postaux mexicains doivent comporter 5 chiffres ; tant que le client n'en saisit pas un, aucune requête n'est envoyée. DrEnvio renvoie les devis de tous les transporteurs de votre compte. L'extension n'utilise que les devis Estafeta, ignore les tarifs nuls, retient le moins cher et le convertit dans la devise de votre boutique. Le service Estafeta et le délai de livraison sont enregistrés avec la ligne de livraison de la commande et affichés sur l'écran d'administration de la commande.

Chaque réponse est mise en cache pendant 1 heure. Une requête échouée ou un trajet sans tarif Estafeta est mémorisé pendant 5 minutes, afin qu'une API lente ou défaillante ne ralentisse jamais chaque mise à jour du paiement. Le délai d'attente de l'API est de 12 secondes. Dans ces cas, le client ne voit aucune erreur : le tarif par pays ou le coût de repli est utilisé, ou le mode est masqué si aucun des deux n'est défini.

Le mode fonctionne sur le paiement classique et sur les blocs Panier et Paiement. Il est compatible avec le stockage des commandes haute performance de WooCommerce (HPOS).

L'extension calcule uniquement des tarifs. Elle ne crée pas d'envois, n'imprime pas d'étiquettes (guías) et ne suit pas les colis ; créez l'envoi dans votre compte DrEnvio ou Estafeta. Le client ne peut pas choisir un service Estafeta précis ni un bureau Estafeta, et les taux de change ne sont pas mis à jour automatiquement.

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 Estafeta. 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 l'emplacement dans votre compte vibefox.net.

Sans clé active, Estafeta 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 des 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. Le statut est vérifié à nouveau automatiquement en arrière-plan.

Dépannage

Estafeta 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 avis en haut de la page des réglages, les limites de poids, Minimum subtotal et Excluded shipping classes. Sans clé API, ou lorsque DrEnvio n'a pas de tarif Estafeta, le mode a besoin d'un tarif par pays pour la destination ou d'un coût de repli.

Les tarifs en temps réel n'apparaissent pas : activez Debug log, rechargez le paiement et ouvrez WooCommerce > Status > Logs, source vfd-estafeta. Le journal indique la raison : aucune clé API, aucun taux de change pour une boutique qui n'est pas en MXN, un code postal absent ou invalide, une clé API refusée (HTTP 401 ou 403), ou aucun tarif Estafeta pour ce trajet.

Le prix inclut-il l'IVA ? Cela dépend de votre compte DrEnvio. Si les tarifs DrEnvio incluent déjà l'IVA, réglez Tax status sur None.

Les tarifs semblent obsolètes après une modification : enregistrez la page des réglages. Cela efface les tarifs DrEnvio 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, puis 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 et efface seulement le cache des tarifs. Pour la supprimer, désactivez-la puis supprimez-la sur la page Plugins. La clé de licence et le statut de licence de cette extension, les tarifs en cache et les anciens fichiers journaux sont toujours supprimés. 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 future réinstallation. Les commandes ne sont jamais modifiées, et les commandes existantes conservent leurs lignes de livraison.

Estafeta et DrEnvio sont des marques déposées de leurs propriétaires respectifs. Cette extension n'est ni affiliée ni approuvée par Estafeta ou DrEnvio.