VibeFox Sameday Easybox 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.

Nom d'utilisateur et mot de passe API Sameday : l'accès à l'API fait partie d'un compte professionnel Sameday en Roumanie, en Hongrie ou en Bulgarie. Demandez à votre gestionnaire de compte Sameday ou à l'équipe d'intégration Sameday. Les identifiants sont souvent les mêmes que ceux du portail eAWB (eawb.sameday.ro, .hu ou .bg). Pour l'API de démonstration, Sameday fournit des identifiants de test distincts. Sans nom d'utilisateur et mot de passe API, le mode de livraison n'est pas proposé, car le client ne pourrait pas choisir de casier.

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

2. Cliquez sur Activate.

3. Ouvrez les réglages : WooCommerce > Settings > Shipping > VibeFox Sameday Easybox, ou cliquez sur Settings sous le nom de l'extension 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. Saisissez votre API username et votre API password Sameday, choisissez le Sameday country et enregistrez. La page doit afficher « Connected to Sameday ... easybox lockers ». Pickup point et Easybox service sont renseignés à partir de votre compte.

6. Définissez vos tarifs : Exchange rate of the estimate si la devise de votre boutique diffère de la devise Sameday, et une ligne Country prices (par exemple * Default) ou un Fallback cost.

7. Ajoutez VibeFox Sameday Easybox à la zone de livraison de votre pays Sameday dans WooCommerce > Settings > Shipping > Shipping zones, ou activez Ignore shipping zones.

Configuration

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

Title (zone) : le nom que voient les clients dans cette zone. Laissez-le vide pour utiliser le Name général.

Au-dessus des réglages, la page affiche l'état de la connexion : l'hôte Sameday, le nombre de casiers easybox et la date de mise à jour de la liste, ou le fait que Sameday a rejeté le nom d'utilisateur ou le mot de passe. Elle indique aussi les problèmes de configuration, par exemple l'absence d'identifiants, de tarif ou de taux de change pour l'estimation.

Tous les tarifs et limites acceptent la virgule ou le point comme séparateur décimal (4,99 ou 4.99). Un nombre non valide est refusé avec un message.

Général

Enable/Disable : active ou désactive le mode de livraison dans toutes les zones à la fois.

Name : le nom du mode de livraison affiché au client. Une zone peut le remplacer par son propre Title. Default : Sameday easybox.

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

Compte Sameday (API)

À l'enregistrement, l'extension se connecte à Sameday et charge vos services, vos points de collecte et la liste des casiers easybox. La liste est actualisée chaque jour.

API username : votre nom d'utilisateur API Sameday.

API password : votre mot de passe API Sameday. Si Sameday le rejette, il n'est pas réessayé pendant 10 minutes.

Sameday country : le pays de votre compte Sameday : Romania (api.sameday.ro) (par défaut), Hungary (api.sameday.hu) ou Bulgaria (api.sameday.bg). Ses casiers sont proposés, et le mode de livraison n'est affiché que pour ce pays de destination.

Test mode : utilise l'API de démonstration Sameday avec des identifiants de démonstration.

Tarifs

L'ordre d'utilisation est le suivant : l'estimation Sameday (lorsque Pickup point et Easybox service sont renseignés), puis la grille tarifaire par pays, puis les frais de repli. Les tarifs de la grille se saisissent dans la devise de la boutique.

Pickup point : votre point de collecte Sameday, où Sameday récupère les colis. Après une connexion réussie, il s'agit d'une liste des points de collecte de votre compte, et le point par défaut est choisi automatiquement. Nécessaire pour l'estimation Sameday. Choisissez - not set (price table only) - pour n'utiliser que la grille tarifaire.

Easybox service : le service Sameday pour la livraison en easybox, généralement « Locker NextDay » (code LN), choisi automatiquement. Nécessaire pour l'estimation Sameday.

Exchange rate of the estimate : Sameday établit ses estimations dans la devise de votre pays Sameday : RON, HUF ou BGN (EUR pour les boutiques bulgares qui vendent en euros). Si votre boutique vend dans une autre devise, saisissez la valeur de 1 unité de la devise Sameday dans la devise de votre boutique, par exemple 0.20. Sans cette valeur, l'estimation n'est pas utilisée et la grille tarifaire s'applique. Le lev et l'euro sont convertis automatiquement au taux fixe.

Table price : Per order facture le tarif une seule fois. Per item (price x quantity) le multiplie par le nombre d'articles expédiables. Cela s'applique au tarif de la grille et aux frais de repli. L'estimation Sameday porte toujours sur le colis entier.

Country prices : un tarif par pays de destination et par poids de colis. Cliquez sur + Add country pour ajouter une ligne et sur la croix pour en supprimer une. Chaque ligne comporte une colonne Price et des colonnes de poids : XS jusqu'à 1 kg, S 1–2 kg, M 2–3 kg, L 3–5 kg et XL au-delà de 5 kg. Une colonne de poids laissée à 0 utilise la colonne Price. La ligne * Default s'applique aux pays qui n'ont pas de ligne propre. Une nouvelle ligne commence comme * Default avec tous les tarifs à 0, ce qui signifie livraison gratuite. Choisissez le pays et saisissez les tarifs avant d'enregistrer, ou supprimez la ligne. Si un même pays figure sur deux lignes, seule la première est conservée à l'enregistrement. Si une cellule n'est pas un nombre valide, la grille n'est pas enregistrée.

Fallback cost : utilisé lorsqu'il n'y a pas d'estimation Sameday et que la grille par pays ne comporte pas de ligne pour la destination. Laissez-le vide pour ne pas proposer le mode de livraison dans ce cas.

Free shipping from : le sous-total du panier (après remises, hors taxes) à partir duquel la livraison en easybox est gratuite. Cela ne s'applique que lorsqu'un tarif est trouvé : une ligne de pays, la ligne * Default ou les frais de repli (dans ce cas aucune estimation n'est demandée), ou l'estimation Sameday. Laissez vide pour ne jamais proposer la livraison gratuite.

Disponibilité

Minimum weight (kg) : masque le mode de livraison lorsque le panier pèse moins. Le poids est converti depuis l'unité de poids de votre boutique. Vide ou 0 signifie aucune limite.

Maximum weight (kg) : les colis plus lourds que cette valeur ne se voient pas proposer la livraison en easybox. Default : 30. Vérifiez la limite de votre contrat Sameday et les dimensions des casiers easybox. Vide ou 0 signifie aucune limite.

Minimum cart subtotal : ne propose le mode de livraison que lorsque le sous-total du panier (après remises, hors taxes) atteint ce montant.

Excluded shipping classes : masque le mode de livraison lorsque le panier contient un produit appartenant à l'une de ces classes de livraison WooCommerce.

Ignore shipping zones : lorsqu'elle est activée, le mode de livraison est proposé pour les pays sélectionnés ci-dessous, même s'il n'a pas été ajouté à la zone de livraison correspondante. Lorsqu'elle est désactivée, il n'est proposé que dans les zones auxquelles il a été ajouté.

Countries (ignore zones mode) : les pays de destination pour ce mode. Laissez vide pour utiliser le pays Sameday. Les pays autres que le pays Sameday sont ignorés. Ce champ n'est utilisé que lorsque Ignore shipping zones est activée.

Avancé

Debug log : enregistre les calculs de tarifs, les appels API et les choix de casiers dans WooCommerce > Status > Logs (source « vfd-sameday-easybox »). Les erreurs API sont toujours journalisées. Aucun mot de passe, jeton ni donnée personnelle du client n'est journalisé. Désactivez le journal lorsque vous avez terminé.

Remove data on uninstall : lorsqu'elle est activée, la suppression de l'extension supprime les réglages et les instances de zone de ce mode de livraison. La désactivation de l'extension ne supprime jamais rien. Le casier enregistré dans les commandes est toujours conservé.

Fonctionnement au paiement

Lorsque le client saisit une adresse de livraison, WooCommerce demande un tarif à l'extension. L'extension vérifie les conditions : pays de livraison de votre compte Sameday, identifiants API et liste de casiers exploitable, poids du panier, sous-total minimum du panier et classes de livraison exclues. Elle cherche ensuite un tarif : l'estimation Sameday, la grille par pays, les frais de repli. S'il n'y a pas de tarif, le mode de livraison est masqué. Si la livraison gratuite s'applique, le client voit le mode de livraison sans frais.

Sinon, l'extension demande une estimation à Sameday, une fois que le client a saisi une ville et un département. Elle envoie votre point de collecte et votre service, le poids du colis ainsi que l'adresse, la ville, le département et le code postal du client. Aucun nom, e-mail ni numéro de téléphone n'est envoyé. Bucarest est envoyée comme « Sector 1 », comme dans l'extension officielle Sameday. L'estimation est convertie dans la devise de votre boutique. S'il n'y a pas d'estimation (non configurée, pas encore de ville ou de département, erreur, pas de taux de change), le tarif provient de la grille par pays, puis des frais de repli. S'il n'y a pas de tarif, le mode de livraison est masqué.

Les problèmes Sameday ne bloquent jamais le paiement. L'estimation est mise en cache pendant 1 heure. Une erreur est mise en cache pendant 10 minutes. Après un dépassement de délai ou une erreur serveur, aucune estimation n'est demandée pendant 5 minutes. Les requêtes expirent après 15 secondes. La liste des casiers est lue depuis votre serveur, et non depuis Sameday, pendant le paiement.

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

L'extension ne crée pas d'AWB (envois), n'imprime pas d'étiquettes, ne suit pas les colis et ne gère pas le paiement à la livraison. Elle ne propose pas de livraison à domicile par coursier ni de widget de carte Sameday. Créez l'AWB dans le portail eAWB de Sameday ou dans votre outil habituel, avec l'identifiant du casier affiché sur la commande.

Choix du casier

Lorsque le client sélectionne le mode de livraison, un bloc easybox locker apparaît en dessous avec deux listes : - Select city - et - Select easybox locker -. La ville du client est présélectionnée si elle dispose de casiers. Chaque casier affiche son nom et son adresse. Le choix est mémorisé lorsque le paiement se met à jour ou lorsque la page est rechargée.

Le casier est obligatoire. Sans casier, le paiement s'arrête avec le message « Please choose a Sameday easybox locker. ». Le serveur vérifie que le casier choisi figure dans la liste, sur le paiement classique comme sur le paiement par blocs. Un identifiant de casier falsifié ou supprimé est refusé avec le message « The selected easybox locker is not available any more. Please choose another easybox locker. ». Le nom et l'adresse enregistrés avec la commande proviennent de la liste, et non du navigateur.

Écran de commande de l'administration : Sameday easybox locker avec le nom et l'adresse ainsi que le Locker ID pour l'AWB Sameday, sous l'adresse de livraison. Si une commande easybox n'a pas de casier, l'écran indique « No easybox locker was selected for this order. ».

Page de remerciement et détail de la commande : Sameday easybox locker : avec le nom et l'adresse.

E-mails de commande : le nom et l'adresse du casier dans les e-mails HTML et texte. Les e-mails d'administration incluent aussi le Locker ID.

Dans la base de données, le casier est enregistré dans les métadonnées de commande _vfd_sdeb_locker_id (l'identifiant du casier Sameday pour l'AWB) et _vfd_sdeb_locker_name (nom et adresse).

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

Sans clé active, Sameday easybox n'est pas affiché aux clients au moment du paiement. Les gestionnaires de la boutique connectés le voient toujours, avec la mention (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 Plugins 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. L'état est vérifié à nouveau automatiquement en arrière-plan.

Dépannage

Sameday easybox n'apparaît pas au paiement : vérifiez que la licence est active, que Enable/Disable est activé, que le nom d'utilisateur et le mot de passe API sont saisis et que la page des réglages indique « Connected to Sameday », et que le pays de destination est le pays de votre compte Sameday. Vérifiez qu'un tarif est disponible (estimation Sameday, ligne de pays, ligne * Default ou Fallback cost), les limites de poids et de sous-total, Excluded shipping classes, et que le mode de livraison est ajouté à la zone correspondante (ou que Ignore shipping zones est activée). Activez Debug log pour voir la raison dans WooCommerce > Status > Logs.

Sameday a rejeté le nom d'utilisateur ou le mot de passe API : vérifiez-les et enregistrez à nouveau. Les identifiants de démonstration ne fonctionnent que lorsque Test mode est activé, les identifiants de production uniquement lorsqu'il est désactivé. En attendant, la liste de casiers enregistrée est proposée, s'il en existe une, et l'estimation Sameday n'est pas utilisée.

Le tarif vient de ma grille, et non de Sameday : l'estimation nécessite un Pickup point, le Easybox service et, lorsque la devise de votre boutique diffère de la devise Sameday, le Exchange rate of the estimate. Elle n'est demandée qu'après que le client a saisi une ville et un département. Lorsque Sameday est injoignable ou renvoie une erreur, la grille ou les frais de repli sont utilisés ; la raison figure dans le journal.

La liste des casiers est ancienne ou absente : enregistrez les réglages. La liste est chargée à nouveau lorsqu'elle est vide, lorsqu'elle a plus d'une heure ou lorsque le dernier chargement a échoué. Si une actualisation échoue, la liste précédente est utilisée et l'état l'indique.

La livraison est gratuite par erreur : vérifiez les lignes de Country prices dont le Price est 0, en particulier une ligne * Default ajoutée avec + Add country et laissée incomplète.

Casiers transfrontaliers : les développeurs peuvent ajouter des pays de destination avec le filtre vfd_sdeb_countries. La liste des casiers est toujours celle de votre compte.

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 état connu.

Désinstallation

La désactivation de l'extension conserve toutes les données et arrête seulement l'actualisation quotidienne de la liste des casiers. 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 sont toujours supprimés, ainsi que la liste de casiers enregistrée, le résultat de la vérification du compte et tous les caches. Les réglages et les méthodes de zone ne sont supprimés que si Remove data on uninstall était activée. Sinon, ils sont conservés pour une réinstallation ultérieure. Les commandes existantes conservent leurs lignes de livraison et le casier enregistré.

Sameday et easybox sont des marques de leurs propriétaires respectifs. Cette extension n'est pas affiliée à Sameday et n'est pas approuvée par Sameday.