VibeFox Frenet for WooCommerce — Aide

Prérequis

WordPress : 5.8 ou ultérieur.

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

PHP : 8.0 ou ultérieur.

Compte Frenet (uniquement pour les cotations en temps réel) : créez un compte gratuit dans le panneau Frenet (painel.frenet.com.br), activez les transporteurs que vous utilisez et copiez votre jeton d'API. Si vous n'utilisez que des tarifs fixes, vous n'avez pas besoin de compte Frenet.

Produits : renseignez le poids et les dimensions pour des tarifs précis. Les produits sans ces données sont cotés comme 0,3 kg et 16 × 11 × 2 cm (le plus petit carton Correios).

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 transférer le dossier vfd_frenet dans /wp-content/plugins/ par FTP.

2. Cliquez sur Activate.

3. Ouvrez les réglages : WooCommerce > Settings > Shipping > VibeFox Frenet, 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 et cliquez sur Activate.

5. Collez le jeton d'API et saisissez le CEP d'origine. Si la devise de votre boutique n'est pas le BRL, saisissez le taux de change du BRL. Vous pouvez aussi ajouter des tarifs fixes et un tarif de secours.

6. Ajoutez VibeFox Frenet à une zone de livraison pour le Brésil 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 Frenet. Ils s'appliquent à toutes les zones de livraison. Lorsque vous ajoutez la méthode à une zone, la fenêtre de la zone ne comporte qu'un seul champ :

Title (zone) : le nom que voit le client pour cette zone. Laissez-le vide pour utiliser le Method title global.

En haut de la page, l'extension affiche des avertissements : absence de jeton d'API (seuls les tarifs fixes sont utilisés, ou la méthode n'est jamais affichée s'il n'y a pas non plus de tarifs fixes), absence de CEP d'origine à 8 chiffres, ou devise de boutique autre que le BRL sans taux de change. À chaque enregistrement des réglages, les cotations en cache sont effacées. Les champs de prix acceptent aussi bien le point que la virgule comme séparateur décimal.

Général

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

Method title : le nom de la méthode de livraison affiché dans le panier et lors du paiement. Une zone peut le remplacer. Par défaut : Frenet.

Cotations Frenet en temps réel

Frenet compare les transporteurs activés dans votre compte Frenet et renvoie leurs prix pour le panier. Les cotations en temps réel ne sont demandées que pour les adresses au Brésil avec un CEP complet à 8 chiffres.

API token : votre jeton d'API Frenet, issu du panneau Frenet. Laissez-le vide pour n'utiliser que des tarifs fixes.

Origin CEP : le code postal (CEP) d'où les colis sont expédiés, par exemple 00000-000. Laissez-le vide pour utiliser le code postal de la boutique, si l'adresse de la boutique est au Brésil. Un CEP ne comportant pas 8 chiffres est signalé à l'enregistrement.

Service to offer : Cheapest service (par défaut) ou Fastest service. Frenet renvoie plusieurs services, et la méthode affiche un seul prix.

BRL exchange rate : Frenet calcule en réaux brésiliens. Si la devise de votre boutique n'est pas le BRL, indiquez la valeur de 1 BRL dans la devise de votre boutique, par exemple 0.16. La cotation et la valeur déclarée de la commande sont converties avec ce taux. Sans lui, les cotations en temps réel ne sont pas utilisées. Inutile si la devise de la boutique est le BRL.

Tarifs fixes

Utilisés lorsqu'il n'y a pas de jeton d'API, pour les pays que Frenet ne dessert pas, et chaque fois que Frenet ne renvoie pas de prix (API indisponible, CEP non desservi).

Price per country : un tableau avec les colonnes Country, Price, XS, S, M, L et XL, avec les prix dans la devise de votre boutique. Cliquez sur + Add country pour ajouter une ligne et sur la croix (×) pour en supprimer une. Les colonnes de taille dépendent du poids du panier : XS jusqu'à 1 kg, S jusqu'à 2 kg, M jusqu'à 3 kg, L jusqu'à 5 kg, XL au-delà de 5 kg. Price est utilisé lorsque la colonne de taille est vide. Un Price de 0 signifie livraison gratuite pour ce pays. Utilisez * Default pour tous les autres pays. Les lignes sans aucun prix sont supprimées à l'enregistrement.

Fallback cost : utilisé lorsque ni Frenet ni le tableau ne fournissent de prix. Laissez-le vide pour masquer la méthode.

Fixed price applies : Per order facture le prix une seule fois. Per item (price × quantity) le multiplie par le nombre d'articles. Cela ne concerne que les tarifs fixes et le tarif de secours. Les cotations Frenet couvrent déjà tout le panier.

Conditions

Minimum weight (kg) : masque la méthode en dessous de ce poids de panier. 0 signifie pas de limite.

Maximum weight (kg) : masque la méthode au-dessus de ce poids de panier. Par défaut : 30. 0 signifie pas de limite.

Minimum order amount : n'affiche la méthode que si le sous-total du panier (après remises, hors taxes) atteint au moins ce montant. Laissez vide pour toujours l'afficher.

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

Free shipping from : le sous-total du panier (après remises, hors taxes) à partir duquel la livraison est gratuite. Laissez vide pour ne jamais offrir la livraison gratuite.

Tax status : Taxable ajoute la taxe WooCommerce au coût de livraison, None ne l'ajoute pas. Les prix Frenet sont les prix finaux du transporteur ; choisissez None si WooCommerce ne doit pas y ajouter de taxe.

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

Disponibilité sans zones de livraison

Ignore shipping zones : propose Frenet pour les pays ci-dessous, même s'il n'a pas été ajouté à une zone de livraison.

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

Avancé

Debug log : consigne chaque demande et réponse de cotation dans WooCommerce > Status > Logs, source vfd-frenet. Les erreurs de l'API sont toujours consignées. Le jeton n'est jamais consigné et le CEP du client est raccourci. Désactivez-le lorsque vous avez terminé.

Remove data on uninstall : lorsqu'il est activé, la suppression de l'extension efface tous les réglages Frenet et les méthodes de zone. La désactivation de l'extension ne supprime jamais les réglages. Les cotations en cache sont toujours supprimées.

Fonctionnement lors du 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 montant minimum de commande et les classes d'expédition exclues. Si la livraison gratuite s'applique, la méthode est affichée avec un prix nul et aucune requête n'est envoyée à Frenet.

Pour une adresse au Brésil avec un CEP complet à 8 chiffres, l'extension envoie à Frenet les CEP d'origine et de destination, chaque article du panier (poids en kg, dimensions en cm, quantité, SKU et catégories), le montant de la commande en BRL et le premier coupon appliqué. Aucune requête n'est faite tant que le CEP est incomplet. Frenet renvoie les services de vos transporteurs activés. Les services en erreur ou sans prix sont ignorés. L'extension retient le service le moins cher ou le plus rapide et convertit le prix dans la devise de votre boutique. Le transporteur, le service et le délai de livraison sont enregistrés avec la ligne de livraison de la commande et affichés sur l'écran de commande de l'administration.

Chaque réponse est mise en cache pendant 1 heure pour le même panier et la même adresse. Une requête échouée, ou un CEP qu'aucun transporteur activé ne dessert, est retenu pendant 10 minutes. Le délai d'attente de l'API est de 10 secondes. Dans ces cas, le client ne voit aucune erreur : le tarif fixe ou le tarif de secours est utilisé, ou la méthode est masquée s'il n'y en a aucun. Pour les adresses hors du Brésil, seuls les tarifs fixes sont utilisés.

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 calcule que les tarifs. Elle ne crée pas d'envois, n'imprime pas d'étiquettes et ne suit pas les colis ; Frenet propose ces fonctions dans son propre panneau. Elle affiche un seul service Frenet par panier, et non plusieurs, et ne propose ni points de retrait ni consignes. Frenet ne fournit de cotations qu'au Brésil ; utilisez les tarifs fixes pour les autres pays.

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 Frenet. 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 à 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 l'emplacement de son domaine. Libérez cet emplacement dans votre compte vibefox.net.

Sans clé active, Frenet n'est pas affiché aux clients lors du 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 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 l'assistance nécessitent un renouvellement. L'état est vérifié à nouveau automatiquement en arrière-plan.

Dépannage

Frenet n'apparaît pas lors du 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é). Consultez les avertissements en haut de la page des réglages, les limites de poids, Minimum order amount et Excluded shipping classes. Causes habituelles : le client n'a pas encore saisi un CEP complet à 8 chiffres et il n'y a pas de tarifs fixes, ou Frenet n'a renvoyé aucun service pour cet itinéraire et il n'existe pas de tarif fixe.

Les cotations en temps réel n'apparaissent pas : activez Debug log, rechargez la page de paiement et ouvrez WooCommerce > Status > Logs, source vfd-frenet. Le motif y figure : jeton refusé (HTTP 401 ou 403), absence de CEP d'origine, absence de taux de change BRL, aucun transporteur activé dans le panneau Frenet, ou les messages des services ignorés.

Ma boutique vend en euros ou en dollars : Frenet répond en BRL. Saisissez le BRL exchange rate (la valeur de 1 BRL dans la devise de votre boutique).

Les tarifs semblent obsolètes après une modification : enregistrez la page des réglages. Cela efface les cotations 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 état connu.

Désinstallation

La désactivation de l'extension conserve tous les réglages et supprime uniquement les cotations en cache. Pour la supprimer, désactivez-la puis supprimez-la sur la page Plugins. La clé de licence et l'état de licence de cette extension, les cotations 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 réinstallation ultérieure. Les commandes existantes conservent leurs lignes de livraison avec le transporteur Frenet.

Frenet est une marque de son propriétaire respectif. Cette extension n'est ni affiliée à Frenet ni approuvée par Frenet.