VibeFox 99Minutos for WooCommerce — Aide

Prérequis

WordPress : 5.8 ou ultérieur.

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

PHP : 8.0 ou ultérieur.

Clé API 99minutos (pour le contrôle de couverture uniquement) : obtenez-la auprès de votre responsable de compte 99minutos ou sur le portail développeurs 99minutos (developers.99minutos.com). Les clés sandbox et production sont différentes. Si vous utilisez uniquement la matrice de prix, vous n'avez pas besoin de clé API.

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

2. Cliquez sur Activate.

3. Ouvrez les réglages : WooCommerce > Settings > Shipping > VibeFox 99Minutos, ou cliquez sur Settings sous le nom du plugin 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. Renseignez la Price matrix (au moins une ligne, par exemple « * Default ») et, si vous le souhaitez, la clé API et le mode de contrôle de couverture (voir la section « Configuration »).

6. Ajoutez VibeFox 99Minutos à une zone d'expédition dans WooCommerce > Settings > Shipping > Shipping zones qui couvre le Mexique, la Colombie, le Chili ou le Pérou.

Configuration

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

Method title (zone): le nom que voient les clients dans cette zone. Laissez le champ vide pour utiliser le Method title général.

Lors de l'enregistrement des réglages, la page vous avertit si la matrice de prix est vide ou si un mode de contrôle de couverture est choisi sans clé API.

Général

Enable/Disable: active 99Minutos dans toutes les zones d'expédition en une fois. Le mode doit aussi être ajouté à une zone d'expédition qui couvre le Mexique, la Colombie, le Chili ou le Pérou. Par défaut : activé.

Method title: le nom du mode de livraison affiché au client lors du paiement. Une zone peut le remplacer. Par défaut : 99Minutos.

Tax status: Taxable ajoute la taxe WooCommerce aux frais de port, None ne l'ajoute pas.

API 99minutos (contrôle de couverture) (facultatif)

L'API sert uniquement à vérifier si 99minutos livre au code postal du client. Le prix provient toujours de la matrice.

Coverage check: si et comment le code postal est contrôlé.

Avec un contrôle de couverture, le mode de livraison n'apparaît qu'après la saisie d'un code postal par le client. Les résultats sont mis en cache : couvert pendant 6 heures, non couvert pendant 30 minutes, erreur API pendant 5 minutes. Seul le code postal est envoyé à 99minutos.

API key: votre clé API 99minutos, envoyée comme jeton Bearer au point de terminaison de contrôle de couverture de 99minutos. Obligatoire lorsque le contrôle de couverture est activé. Le champ est masqué.

Environment: Sandbox (test) (par défaut) ou Production. Sandbox et production utilisent des clés API différentes : choisissez l'environnement qui correspond à votre clé.

Tarifs

Les prix sont exprimés dans la devise de votre boutique et utilisés tels qu'ils sont saisis, sans conversion.

Price matrix: un tableau de pays de destination et de prix. Cliquez sur + Add country pour ajouter une ligne et sur la croix pour en supprimer une. Chaque ligne comporte un Country, un Base price et des prix pour les tailles XS (jusqu'à 1 kg), S (jusqu'à 2 kg), M (jusqu'à 3 kg), L (jusqu'à 5 kg) et XL (plus de 5 kg). Un prix de taille vide ou égal à 0 revient au Base price. La ligne * Default s'applique aux pays sans ligne propre. Le point et la virgule sont tous deux acceptés comme séparateur décimal ; les prix négatifs sont enregistrés comme 0. Tant que la matrice ne contient pas au moins une ligne, le mode de livraison n'est pas affiché au paiement.

Calculation: Per order — size by the total cart weight (par défaut) facture un seul prix selon la taille du colis de l'ensemble du panier. Per item — each unit priced by its own weight applique à chaque unité le prix correspondant à la taille de son propre poids, puis additionne les montants.

Free shipping: active la livraison gratuite à partir d'un sous-total du panier.

Free shipping from: le sous-total du panier (après remises, hors taxes) à partir duquel le tarif est de 0. Utilisé uniquement si Free shipping est activé.

Restrictions

Min weight (kg): masque le mode de livraison si le panier est plus léger. 0 signifie aucune limite. Les poids des produits sont convertis depuis l'unité de poids de votre boutique.

Max weight (kg): masque le mode de livraison si le panier est plus lourd. Par défaut : 25. 0 signifie aucune limite.

Minimum subtotal: n'affiche le mode de livraison que si le sous-total du panier (après remises, hors taxes) atteint au moins ce montant. Laissez vide pour l'afficher toujours.

Excluded shipping classes: masque le mode de livraison si un article du panier appartient à l'une de ces classes d'expédition WooCommerce.

Restrict countries: ne propose le mode de livraison que pour les pays ci-dessous. C'est un filtre supplémentaire, en plus des zones d'expédition : le mode doit toujours être ajouté à une zone. Utile lorsqu'une zone couvre plusieurs pays.

Countries: choix des pays 99minutos (Mexique, Colombie, Chili, Pérou). Utilisé uniquement si Restrict countries est activé. Laissez vide pour autoriser tous les pays 99minutos.

Avancé

Debug log: consigne les calculs de tarifs dans WooCommerce > Status > Logs (source « vfd-99minutos »). Les erreurs API sont consignées même lorsque cette option est désactivée. Les clés API ainsi que les noms et adresses des clients ne sont jamais consignés.

Remove data on uninstall: si cette option est activée, la suppression du plugin efface ses réglages et son cache de couverture. La désactivation ne supprime rien. Les modes de livraison des zones et les commandes sont conservés dans tous les cas.

Fonctionnement au paiement

Le mode de livraison n'est proposé que si le pays de livraison est le Mexique, la Colombie, le Chili ou le Pérou (et s'il figure dans la liste Countries lorsque Restrict countries est activé). Lorsque le client saisit une adresse de livraison, le plugin vérifie les limites de poids du panier, Minimum subtotal et Excluded shipping classes.

Si un mode de contrôle de couverture est activé, le plugin interroge ensuite l'API 99minutos pour savoir si le code postal est couvert. Le délai d'attente de la requête est de 10 secondes et la réponse est mise en cache, si bien que le même code postal ne déclenche pas de nouvelle requête. Les erreurs API ne sont jamais affichées au client : en mode Strict, le mode de livraison est masqué ; en mode Soft, le prix de la matrice est utilisé. La livraison gratuite ne contourne pas le contrôle de couverture.

Le prix provient de la ligne de la matrice correspondant au pays de livraison, ou de la ligne * Default. Si aucune des deux n'existe, le mode de livraison est masqué. Si Free shipping est activé et que le sous-total du panier atteint Free shipping from, le tarif est de 0.

Le mode de livraison fonctionne au paiement classique ainsi que dans les blocs Panier et Paiement. Il est compatible avec WooCommerce High-Performance Order Storage (HPOS).

Le plugin ne récupère pas de tarifs en temps réel auprès de 99minutos : les prix proviennent toujours de votre matrice. Il ne crée ni envois ni commandes dans 99minutos, n'imprime pas d'étiquettes (guides), ne suit pas les colis, ne propose pas de points de retrait Punto99 et ne gère pas le paiement à la livraison. Créez vos envois dans votre compte 99minutos comme d'habitude.

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 99Minutos. 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 l'emplacement du domaine. Libérez-le dans votre compte vibefox.net.

Sans clé active, 99Minutos 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 Plugins et sur les pages WooCommerce. Les commandes existantes ne sont pas affectées.

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

Dépannage

99Minutos n'apparaît pas au paiement : vérifiez que la licence est active, que Enable/Disable est activé et que le mode de livraison est ajouté à la zone de l'adresse du client. Le pays de livraison doit être le Mexique, la Colombie, le Chili ou le Pérou. Vérifiez que la Price matrix contient une ligne pour ce pays ou une ligne * Default, puis contrôlez les limites de poids, Minimum subtotal, Excluded shipping classes et Restrict countries.

Le mode de livraison n'apparaît qu'après la saisie d'un code postal : c'est normal avec un contrôle de couverture. En mode Strict, il n'apparaît que si l'API confirme la couverture.

Le mode de livraison est toujours masqué en mode Strict : activez Debug log, rechargez le paiement et ouvrez WooCommerce > Status > Logs (source « vfd-99minutos »). Une erreur HTTP 401 ou 403 signifie que la clé API a été rejetée : vérifiez la clé et la correspondance avec Environment (les clés sandbox et production diffèrent). Utilisez le mode Soft si les clients doivent malgré tout obtenir le prix de la matrice lorsque l'API est indisponible.

Le prix n'est pas celui attendu : vérifiez Calculation (par commande ou par article), les poids des produits et l'unité de poids de votre boutique. Un prix de taille vide ou égal à 0 revient au Base price.

Autres pays : les développeurs peuvent modifier la liste des pays pris en charge avec le filtre vfd_99m_supported_countries.

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

Désinstallation

La désactivation du 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 et le cache de couverture ne sont supprimés que si Remove data on uninstall était activé. Sinon, ils sont conservés pour une future réinstallation. Les modes de livraison des zones d'expédition et les commandes existantes sont conservés.

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