VibeFox GLS ParcelShop for PrestaShop — Aide

Prérequis

PrestaShop : 8.0 à 9.x. La sélection du point relais fonctionne dans les thèmes Classic et Hummingbird.

PHP : 8.0 ou ultérieur. Le module refuse de s'installer sur les anciennes versions de PHP.

GLS : le module n'utilise ni ne nécessite de compte GLS ni de clé d'API. La carte des points relais est publique. Vous avez besoin d'un contrat avec GLS pour expédier les colis vers les points relais choisis.

Clé de licence VibeFox : achetée sur vibefox.net. Une clé fonctionne sur un seul domaine.

Installation

1. Dans le back office, allez dans Modules > Module Manager et cliquez sur Upload a module. Choisissez le fichier ZIP du module.

2. Une fois le téléversement terminé, cliquez sur Configure, ou retrouvez plus tard VibeFox GLS ParcelShop dans la liste des modules et cliquez sur Configure.

3. Saisissez votre clé de licence VibeFox dans License key, dans le bloc de licence en haut de la page Configure, puis cliquez sur Activate (voir Clé de licence).

4. Définissez vos tarifs : au moins une ligne de Country prices (par exemple * Default) ou un Fallback cost (voir Configuration), puis cliquez sur Save.

À l'installation, le module crée le transporteur GLS ParcelShop avec le texte de délai de livraison Delivery to a GLS ParcelShop of your choice. Le transporteur est affecté à tous les groupes de clients et aux zones des pays de la carte GLS (dans une boutique standard, en général Europe et Europe (non-EU)). Vous pouvez modifier les zones, les groupes de clients, le délai de livraison et le logo dans Shipping > Carriers. N'y définissez pas de prix : le prix provient toujours du module.

Configuration

Tous les réglages se trouvent sur la page du module : Modules > Module Manager > VibeFox GLS ParcelShop > Configure. Chaque section a son propre bouton Save, qui enregistre la page entière.

Les avertissements en haut de la page signalent les problèmes de configuration : le transporteur est introuvable, l'unité de poids de la boutique n'est pas reconnue par le module (définissez kg, g, lb ou oz dans International > Localization, Local units), aucun prix n'est défini, ou certains ou tous les Countries (ignore zones mode) sélectionnés ne sont pas couverts par la carte GLS. Un nombre invalide ou négatif est refusé avec un message qui nomme le champ, et sa valeur précédente est conservée. Les autres champs sont tout de même enregistrés.

General

La section liste les pays couverts par la carte GLS. Le transporteur n'est pas proposé pour les autres pays de destination.

Enable/Disable : active ou désactive GLS ParcelShop. C'est le même interrupteur que le statut du transporteur dans Shipping > Carriers.

Name : le nom du mode de livraison affiché au client (le nom du transporteur). Par défaut : GLS ParcelShop. Obligatoire, 64 caractères maximum.

Tax status : la règle de taxe du transporteur. None signifie que la livraison n'est pas taxée. Choisissez une règle de taxe pour rendre la livraison taxable.

Prices

Les prix se saisissent dans la devise par défaut de votre boutique, hors taxes. Les décimales peuvent utiliser une virgule ou un point (4,99 ou 4.99). Le prix est affiché au client dans la devise du panier.

Calculation type : la manière dont le prix est appliqué.

Country prices : un tableau avec une ligne par pays de destination. Cliquez sur Add country pour ajouter une ligne et sur l'icône de corbeille pour en supprimer une. Chaque ligne comporte un Country, un Price et cinq 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. La colonne correspondant au poids du panier est utilisée. Une colonne de poids laissée à 0 utilise la colonne Price. La ligne * Default sert pour les pays qui n'ont pas de ligne propre. Les nouvelles lignes commencent avec * Default et 0 dans chaque colonne, et une ligne dont tous les prix sont à 0 donne une livraison gratuite. Choisissez donc le pays et renseignez les prix avant d'enregistrer. Si une valeur du tableau n'est pas un nombre valide, le tableau entier n'est pas enregistré et le message indique les valeurs incorrectes.

Fallback cost : le prix utilisé lorsque le tableau n'a pas de ligne pour le pays de destination et pas de ligne * Default. Laissez le champ vide pour masquer le transporteur pour ces pays.

Free shipping from : le sous-total du panier (après remises, hors taxes) à partir duquel la livraison GLS ParcelShop est gratuite. Laissez le champ vide si la livraison n'est jamais gratuite.

Availability

Minimum weight (kg) : masque le transporteur 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) : masque le transporteur lorsque le panier pèse plus. Par défaut : 20. Les points relais GLS acceptent en général des colis jusqu'à 20 kg, vérifiez donc votre contrat GLS. Vide ou 0 signifie aucune limite. Si le minimum est supérieur au maximum, les deux poids sont refusés avec un message et les valeurs précédentes sont conservées.

Minimum cart subtotal : ne propose le transporteur que lorsque le sous-total du panier (après remises, hors taxes) atteint ce montant. Laissez le champ vide s'il n'y a pas de minimum.

Ignore shipping zones : lorsqu'elle est activée, le transporteur est lié à toutes les zones, y compris les zones désactivées, et proposé pour les pays sélectionnés ci-dessous, même s'ils ne font pas partie de ses zones. Les zones créées ultérieurement sont également liées. Lorsque vous la désactivez, le transporteur retrouve les zones qu'il avait auparavant et n'est proposé que dans celles-ci. Par défaut : désactivée.

Countries (ignore zones mode) : les pays de destination pour ce mode. Laissez le champ vide pour utiliser tous les pays de la carte GLS. Les pays non couverts par la carte GLS sont ignorés. Ce champ n'est utilisé que lorsque Ignore shipping zones est activée.

Advanced

Debug log : écrit les calculs de tarifs et les choix de points relais dans logs/vfd_glps_debug.log.php, dans le dossier du module. Le fichier ne peut pas être ouvert depuis le web. Les erreurs sont toujours enregistrées. Aucune donnée personnelle du client n'est enregistrée. Désactivez le journal lorsque vous avez terminé.

Log : affiche la taille et les dernières entrées du journal de débogage. Cliquez sur Clear log pour le vider.

Remove data on uninstall : lorsqu'elle est activée, la désinstallation du module supprime les réglages, le transporteur et le journal. Lorsqu'elle est désactivée, tout est conservé pour une réinstallation. Le point relais enregistré dans les commandes est toujours conservé.

Fonctionnement au moment du paiement

Lorsque PrestaShop affiche l'étape de livraison, il demande au module le prix de GLS ParcelShop. Seuls les produits physiques comptent : les produits virtuels n'ajoutent pas de poids et ne sont pas inclus dans le sous-total du panier. Le module vérifie d'abord les conditions : le pays de livraison est couvert par la carte GLS (et sélectionné dans Countries (ignore zones mode) lorsque ce mode est activé), le poids du panier et le sous-total minimum du panier. Si le sous-total du panier atteint Free shipping from, la livraison est gratuite. Sinon, le prix est repris dans la ligne du pays (ou la ligne * Default) et dans la colonne de poids, ou dans Fallback cost. Si aucun prix n'est trouvé, le transporteur est masqué.

Lorsque le client sélectionne GLS ParcelShop, un encadré GLS ParcelShop avec un bouton Select GLS ParcelShop apparaît sous le transporteur. Il ouvre la carte officielle des points relais GLS pour le pays de livraison. Une fois un point relais choisi, son nom et son adresse s'affichent et le bouton devient Change ParcelShop. Le choix est enregistré dans le panier et il reste en place lorsque l'étape de livraison se met à jour ou que la page est rechargée. Si l'adresse de livraison passe dans un autre pays, le client doit choisir de nouveau un point relais.

Lorsque le client clique sur Continue à l'étape de livraison, le module vérifie qu'un point relais a été choisi et qu'il se trouve dans le pays de livraison. Sinon, le client voit Please select a GLS ParcelShop. ou The selected GLS ParcelShop is not in your shipping country. Please choose a ParcelShop again. et reste à l'étape de livraison. Si le point relais ne peut pas être enregistré, le client voit The ParcelShop could not be saved. Please try again. Si le script de la carte GLS ne peut pas être chargé, le client voit un message lui demandant de recharger la page ou de choisir un autre mode de livraison.

La carte GLS s'exécute dans le navigateur du client. Au moment du paiement, le module charge le script de la carte depuis map.gls-croatia.com, et la carte charge les données des points relais ainsi que les tuiles de la carte depuis GLS. GLS reçoit les données habituelles de la requête du visiteur (adresse IP, navigateur). Rien n'est envoyé de votre serveur vers GLS.

Si vous modifiez le transporteur dans Shipping > Carriers après qu'il a reçu des commandes, PrestaShop l'enregistre comme une nouvelle version du transporteur. Le module suit automatiquement la nouvelle version.

Le module ne récupère pas de tarifs GLS en direct, ne crée pas d'envois GLS, n'imprime pas d'étiquettes et ne suit pas les colis. Il ne dispose pas de liste des points relais sur votre serveur, il ne peut donc pas vérifier l'identifiant du point relais auprès de GLS. Transmettez l'identifiant du point relais de la commande à GLS de la manière habituelle (MyGLS, votre logiciel GLS ou un autre module).

Points relais

Lorsque la commande est passée, le point relais du panier est enregistré avec la commande : son identifiant, son nom avec l'adresse et son pays. Il ne change plus avec le panier.

Page de commande dans l'administration : un bloc GLS ParcelShop affiche le nom et l'adresse du point relais, avec le ParcelShop ID et le pays. Si une commande GLS ParcelShop n'a pas de point relais, le bloc affiche No ParcelShop was selected for this order.

Pages client : le point relais est affiché sur la page de confirmation de la commande et sur la page de détail de la commande dans le compte client.

E-mails : le point relais est ajouté au nom du transporteur dans l'e-mail de confirmation de commande envoyé au client. L'e-mail de nouvelle commande destiné au marchand (module Mail alerts) comprend également l'identifiant du point relais.

Clé de licence

Le module fonctionne avec une clé de licence VibeFox obtenue sur vibefox.net. Le bloc de licence License — VibeFox GLS ParcelShop est le premier bloc de Modules > Module Manager > VibeFox GLS ParcelShop > Configure, au-dessus des réglages. Saisissez la clé dans License key puis cliquez sur Activate. Ensuite, le bloc affiche la clé masquée, le statut (par exemple la date jusqu'à laquelle la licence est active et votre domaine) ainsi que les boutons Check now pour vérifier à nouveau le statut, Change key pour saisir une autre clé et Remove key pour supprimer la clé de cette boutique. En dessous figurent la ligne Product: presta-shipping-gls-parcelshop et le lien Manage licenses and domains in your account, qui ouvre votre compte vibefox.net. Seuls les employés disposant de l'autorisation Configure pour le module peuvent modifier la clé. Les textes du bloc suivent la langue du back-office (l'anglais et le russe sont inclus).

Si la clé n'est pas acceptée, le bloc indique la raison, par exemple Key not found, This key belongs to another product, Domain limit reached ou License expired on suivi d'une date. Après un changement d'adresse de la boutique, ou après avoir libéré un emplacement de domaine dans votre compte, cliquez sur Check now. Si le serveur de licences est injoignable, le module continue de fonctionner avec le dernier statut connu.

Une clé fonctionne sur un seul domaine : le domaine de la boutique principale, y compris dans une configuration multiboutique. Retirer la clé de la boutique ne libère pas son emplacement de domaine. Libérez l'emplacement dans votre compte vibefox.net.

Sans clé active, le transporteur GLS ParcelShop n'est pas affiché aux clients au moment du paiement et aucun tarif n'est calculé. La vitrine PrestaShop ne sait pas que vous êtes connecté au back-office : le transporteur est donc masqué aussi pour vous. Vous pouvez configurer le module avant d'acheter une clé, mais vous ne pouvez pas le tester au moment du paiement. Un rappel apparaît dans Modules > Module Manager, sur l'onglet Alerts. Les commandes existantes ne sont pas affectées.

Lorsqu'une licence expire, le module continue de fonctionner, mais les mises à jour et l'assistance nécessitent un renouvellement. Le statut est vérifié à nouveau automatiquement pendant votre travail dans le back-office : une fois par jour pendant les 14 premiers jours après la saisie de la clé, puis une fois par semaine. Aucune tâche cron n'est nécessaire. La désinstallation ou la réinitialisation du module supprime toujours la clé de licence et le statut de la licence.

Dépannage

GLS ParcelShop n'apparaît pas au moment du paiement : vérifiez que la licence est active et que Enable/Disable est activé. Dans Shipping > Carriers, vérifiez que le transporteur couvre la zone du pays du client et le groupe du client (ou activez Ignore shipping zones et vérifiez Countries (ignore zones mode)). Vérifiez que le pays de destination fait partie des pays de la carte GLS et qu'il a un prix (une ligne de pays, la ligne * Default ou Fallback cost). Vérifiez les limites de poids et le Minimum cart subtotal. Les produits peuvent aussi être limités à certains transporteurs sur la fiche produit. Activez le Debug log et consultez le champ Log pour voir la raison.

La carte ne s'ouvre pas : le client voit "The GLS ParcelShop map could not be loaded..." lorsque le script GLS est bloqué, par exemple par un bloqueur de publicités ou de confidentialité, une politique de sécurité du contenu (CSP) ou une panne de GLS. Autorisez map.gls-croatia.com dans votre politique de sécurité du contenu.

La livraison est gratuite pour un pays par erreur : vérifiez la ligne de ce pays dans Country prices. Une ligne dont le Price et toutes les colonnes de poids sont à 0 donne une livraison gratuite.

Le tableau ou un champ n'a pas été enregistré : une valeur n'est pas un nombre valide. Le message en haut de la page indique la valeur concernée. Utilisez des chiffres avec une virgule ou un point comme séparateur décimal.

La page indique que le transporteur GLS ParcelShop est introuvable : le transporteur a été supprimé dans Shipping > Carriers. Réinitialisez le module dans Modules > Module Manager pour le recréer. La réinitialisation (Reset) conserve le statut d'un transporteur existant : un transporteur désactivé reste désactivé.

Une commande n'a pas de point relais et le journal indique que le point relais du panier est déjà enregistré dans une autre commande : un panier a donné deux commandes. La première commande conserve le point relais. Transmettez la seconde commande à GLS manuellement.

Désinstallation

Allez dans Modules > Module Manager, ouvrez le menu à côté de VibeFox GLS ParcelShop et choisissez Uninstall. La clé de licence et le statut de la licence sont toujours supprimés.Si Remove data on uninstall est activée, le transporteur est supprimé (les commandes conservent leur historique), et les réglages, le journal ainsi que les points relais des paniers sans commande sont supprimés. Si elle est désactivée, le transporteur est seulement désactivé et tous les réglages sont conservés. Réinstaller le module rend au transporteur conservé son statut précédent. Le point relais enregistré dans les commandes est toujours conservé.

GLS est une marque déposée de son propriétaire respectif. Ce module n'est ni affilié à GLS ni approuvé par GLS.