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

Omniva : aucun compte d'API n'est nécessaire. Omniva ne propose pas d'API publique de tarifs. L'API OMX d'Omniva n'est accessible qu'aux clients sous contrat et n'est pas utilisée par cette extension : vous saisissez donc vos propres tarifs (contractuels). Enregistrez les colis dans votre compte professionnel Omniva.

Parcel machine list : l'extension télécharge le fichier ouvert des emplacements Omniva depuis omniva.ee (aucune clé ni contrat requis). Votre serveur doit pouvoir envoyer des requêtes HTTPS sortantes vers www.omniva.ee.

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

2. Cliquez sur Activate.

3. Ouvrez les réglages : WooCommerce > Settings > Shipping > VibeFox Omniva, 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 (voir Clé de licence).

5. Vérifiez les tarifs par pays et par taille de colis, les tailles de colis et la ligne d'état Parcel machine list.

6. Ajoutez VibeFox Omniva à votre zone Estonie, Lettonie et/ou Lituanie 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 Omniva. Ils s'appliquent à toutes les zones d'expédition. Lorsque vous ajoutez le mode à 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 général.

En haut de la page, des avis signalent les problèmes. Un avis rouge apparaît lorsqu'aucun prix n'est défini ou lorsque la liste des points relais n'a pas pu être téléchargée et qu'aucune copie n'est enregistrée ; dans ce cas, le mode n'est pas affiché au paiement. Un avis jaune apparaît lorsque la liste n'a pas pu être mise à jour pour l'instant et que la copie enregistrée est utilisée. Les valeurs illisibles sont signalées après l'enregistrement et ne sont pas sauvegardées.

Général

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

Method title : le nom du mode d'expédition affiché aux clients. Le Title d'un mode de zone le remplace. Par défaut : Omniva parcel machine.

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

Tarifs (dans la devise de votre boutique ; les décimales peuvent s'écrire 3.50 ou 3,50)

Price by parcel size : une ligne pour chacun des pays (Estonie, Lettonie et Lituanie), avec les colonnes S, M, L, XL et Free from. Saisissez le prix de chaque taille de colis Omniva pour le pays de destination. Une cellule vide signifie que cette taille n'est pas proposée pour ce pays : le mode est masqué lorsque le colis en a besoin. 0 signifie gratuit. Free from correspond au total du panier (après remises, tel qu'affiché dans le panier) à partir duquel la livraison vers ce pays est gratuite ; laissez-le vide s'il n'y a pas de livraison gratuite. Tant que vous n'avez pas enregistré vos propres prix, le tableau commence avec 3.50 pour l'Estonie et 4.00 pour la Lettonie et la Lituanie. Lorsque les taxes WooCommerce sont activées, un petit bouton -% à côté de chaque prix retire la TVA de votre pays de boutique du prix saisi (pour les prix que vous connaissez TTC).

Calculation : la façon dont la taille du colis et le prix sont déterminés.

Parcel sizes (cm) : les dimensions maximales de chaque taille, sous la forme Smallest side, Middle side et Largest side. Les dimensions du produit sont triées de la même manière et comparées côte à côte ; les valeurs sont triées à l'enregistrement. Les dimensions du produit sont converties de l'unité de la boutique en cm. Les produits sans dimensions entrent dans la taille S. Si aucune taille ne convient, le mode est masqué. Valeurs par défaut : S 9 x 38 x 64, M 19 x 38 x 64, L 38 x 39 x 64, XL 39 x 64 x 64. Vérifiez-les par rapport aux tailles de colis Omniva actuelles.

Disponibilité

Minimum weight (kg) : masque le mode lorsque le panier est plus léger. Vide ou 0 signifie aucune limite.

Maximum weight (kg) : masque le mode lorsque le panier (ou, avec Per item, un article) est plus lourd. Les points relais Omniva acceptent les colis jusqu'à 30 kg. Par défaut : 30. 0 signifie aucune limite. L'unité de poids de la boutique est convertie en kg.

Minimum cart total : n'affiche le mode qu'à partir de ce total de panier. Laissez vide pour toujours l'afficher.

Excluded shipping classes : masque le mode lorsque le panier contient des produits de ces classes d'expédition WooCommerce.

Ignore shipping zones : propose Omniva pour les pays indiqués ci-dessous sans l'ajouter à une zone. Lorsque l'option est désactivée, les pays sont définis par les zones d'expédition auxquelles le mode est ajouté. Il est recommandé de la laisser désactivée.

Countries (without zones) : les pays de destination pour ce mode. Ce champ n'est utilisé que lorsque Ignore shipping zones est activée. Laissez-le vide pour tous les pays d'expédition. Dans tous les cas, Omniva n'est proposé que là où il dispose de points relais : Estonie, Lettonie et Lituanie.

Points relais

Post offices : propose aussi les bureaux de poste Omniva dans la même liste. Omniva répertorie des bureaux de poste pour l'Estonie. Désactivé par défaut.

City order : affiche d'abord les plus grandes villes (Tallinn, Riga, Vilnius et d'autres), puis le reste par ordre alphabétique. Activé par défaut. Lorsqu'elle est désactivée, les villes sont triées par ordre alphabétique.

Parcel machine list : une ligne d'état indiquant le nombre de points relais par pays (et de bureaux de poste, si activés) ainsi que l'heure du dernier téléchargement depuis omniva.ee. Cliquez sur Update the list now pour télécharger la liste immédiatement ; si omniva.ee ne répond pas, la copie enregistrée est conservée.

Avancé

Debug log : consigne le détail du calcul des prix et de la liste des points relais dans WooCommerce > Status > Logs (source vfd-omniva). Les erreurs, comme une liste de points relais indisponible, sont toujours consignées. Aucune donnée client n'est consignée.

Remove data on uninstall : lorsqu'elle est activée, la suppression de l'extension efface les réglages, les modes de zone et la liste enregistrée des points relais. La désactivation de l'extension ne supprime jamais les réglages. Le point relais enregistré dans les commandes est conservé.

Fonctionnement au paiement

Lorsque le client saisit une adresse de livraison en Estonie, en Lettonie ou en Lituanie, WooCommerce demande un tarif à l'extension. L'extension vérifie le poids du panier, le total minimum et les classes d'expédition exclues, puis détermine la taille du colis à partir des dimensions du produit. Si le colis ne rentre dans aucune taille, si la taille n'a pas de prix pour le pays ou si aucun point relais n'est disponible, le mode est masqué : le client ne voit donc jamais un paiement qui ne peut pas être finalisé. Si le total du panier atteint le Free from du pays, le prix est de 0. La taille du colis est enregistrée sur la ligne d'expédition de la commande sous le nom Omniva parcel size.

La liste des points relais est téléchargée depuis omniva.ee une fois par jour et stockée dans la base de données WordPress, et non dans le dossier de l'extension. Si le téléchargement échoue, la copie enregistrée continue de fonctionner et la tentative suivante a lieu 15 minutes plus tard, afin que le paiement n'attende pas omniva.ee à chaque actualisation. Le délai d'attente du téléchargement est de 15 secondes.

Le mode fonctionne sur le paiement classique et sur les blocs Panier et Paiement. Il est compatible avec WooCommerce High-Performance Order Storage (HPOS). Les prix sont exprimés dans la devise de votre boutique. L'extension ne convertit pas les devises.

L'extension ne demande pas les tarifs Omniva, n'enregistre pas d'envois, n'imprime pas d'étiquettes, ne fait pas appel à un coursier et ne suit pas les colis. Enregistrez les colis dans votre compte professionnel Omniva. La livraison à domicile par coursier ne fait pas partie de ce mode.

Points relais

Lorsque le client sélectionne Omniva, deux listes apparaissent sous le mode : -- Select city -- et -- Select parcel machine --. Seules les villes et les points relais du pays de livraison sont affichés ; lorsque le client change de pays, les listes changent aussi. En Estonie, les villes sont des comtés, Tallinn, Tartu et Pärnu étant listées séparément ; en Lettonie et en Lituanie, ce sont des villes et des communes. La ville de l'adresse d'expédition est présélectionnée lorsqu'elle correspond à une ville de la liste. Chaque point relais est affiché avec son nom et son adresse. Le choix est mémorisé pendant le paiement, il n'est donc pas perdu lorsque la page du paiement se rafraîchit.

Un point relais est obligatoire. Au paiement classique, le client voit Please select an Omniva parcel machine. Au paiement par blocs, Place order est bloqué tant qu'aucun point relais n'est choisi. Dans les deux cas, le serveur vérifie de nouveau le point relais par rapport à la liste ; un identifiant falsifié ou un point relais d'un autre pays est donc refusé.

L'identifiant, le nom, la ville et le pays du point relais sont enregistrés dans la commande. Ils apparaissent sur l'écran de commande sous l'adresse de livraison (avec l'identifiant du point relais), sur la page de confirmation de commande, dans My account > Orders et dans les e-mails de commande (HTML et texte brut) sous le libellé Omniva parcel machine.

Pour modifier le point relais d'une commande, ouvrez la commande dans WooCommerce > Orders, cliquez sur Change à côté du point relais, choisissez une ville et un point relais du pays de livraison de la commande, puis cliquez sur Save parcel machine. Une note de commande enregistre l'ancien et le nouveau point relais.

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 Omniva. 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-le dans votre compte vibefox.net.

Sans clé active, Omniva n'est pas affiché aux clients au paiement. Les gestionnaires de 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. Le statut est vérifié à nouveau automatiquement en arrière-plan.

Dépannage

Omniva n'apparaît pas au paiement : vérifiez que la licence est active, que Enable/Disable est activé, que le pays de livraison est l'Estonie, la Lettonie ou la Lituanie, 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é). Ouvrez la page des réglages : un avis rouge indique si aucun prix n'est défini ou si aucune liste de points relais n'est disponible. Vérifiez aussi les dimensions des produits (un colis plus grand que la taille XL, ou une taille dont la cellule de prix est vide, masque le mode), les limites de poids, le Minimum cart total et les Excluded shipping classes. Avec Debug log activé, WooCommerce > Status > Logs (source vfd-omniva) indique pourquoi le mode a été masqué.

Aucun point relais : la liste n'a pas pu être téléchargée depuis omniva.ee et aucune copie n'est enregistrée. L'extension réessaie toutes les 15 minutes. Cliquez sur Update the list now ; en cas d'échec, vérifiez que votre serveur peut joindre www.omniva.ee et consultez l'erreur dans WooCommerce > Status > Logs.

Un nouveau point relais manque : la liste est mise à jour une fois par jour. Cliquez sur Update the list now pour la télécharger immédiatement.

Le mauvais prix est facturé : le prix dépend de la taille du colis déterminée à partir des dimensions du produit. Vérifiez les dimensions des produits, Calculation et Parcel sizes (cm). Avec Debug log activé, le journal indique la taille retenue et le prix.

Le client ne peut pas passer la commande : un point relais doit être choisi. Si le client voit le message « The Omniva parcel machine list is temporarily unavailable », aucun point relais n'est disponible pour le moment ; voir « Aucun point relais ».

Dans quelle devise sont les prix : dans la devise de votre boutique. L'extension ne convertit pas les devises.

Pour les développeurs : le filtre vfd_omniva_locations_url modifie l'adresse du fichier des emplacements (CSV au format Omniva), et vfd_omniva_countries modifie la liste des pays de destination (par défaut EE, LV, LT).

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

Désinstallation

Désactiver l'extension conserve tous les réglages et la liste enregistrée des points relais. 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 ainsi que les caches sont toujours supprimés. Les réglages, les modes de zone et la liste enregistrée des points relais ne sont supprimés que si Remove data on uninstall était activé. Sinon, ils sont conservés pour une réinstallation ultérieure. Le point relais enregistré dans les commandes n'est jamais supprimé, et les commandes existantes conservent leurs lignes d'expédition.

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