Sur cette page
Avant de commencer
Lightspeed fournit une clé API et un secret API depuis les paramètres de votre propre boutique, et le secret ne s'affiche que lorsque vous le demandez. Il vous faut un accès aux paramètres développeur de la boutique, et vous devez savoir dans quelle langue tourne votre boutique, car e-tailize la demande dans la connexion.
Étapes
- Ouvrez une session dans Lightspeed et allez dans "Settings", puis "Store Settings", puis "Developers".
- Cliquez sur "New API key".
- Donnez un nom à la clé, par exemple le nom de l'intégration, et cliquez sur "Save".
- Cochez les droits que vous accordez et cliquez sur "Save". La clé s'affiche alors sous "DETAILS".
- Cliquez sur "Show" pour afficher le secret API et copiez les deux valeurs.
- Dans e-tailize, ouvrez "Settings", cliquez sur "Connections", cliquez sur "New connection" sur la page "API connections" et choisissez "CMS".
- Cliquez sur le logo Lightspeed et nommez la connexion.
- Renseignez "Store url" avec l'adresse de votre boutique, de la forme
https://yourshop.webshopapp.com/. - Renseignez le code de langue à 2 lettres de votre boutique, par exemple NL, EN ou DE, puis collez la clé dans "API key" et le secret dans "API secret".
- Cliquez sur "Advanced settings", au-dessus du formulaire, pour régler l'expédition des commandes qu'e-tailize transmet à Lightspeed. La boîte de dialogue "Configure connection" s'ouvre. Passez directement à la dernière étape si vous ne voulez pas de règles d'expédition.
- Cochez "Set PostNL as shipment method". Les champs des règles d'expédition apparaissent.
- Renseignez "Set minimum free shipping amount". Une commande supérieure à cette valeur est transmise sans frais de port, une commande égale ou inférieure en reçoit.
- Ouvrez "Select country", tapez dans le champ "Search..." et choisissez le pays concerné par la règle.
- Renseignez "Set shipping price" pour ce pays.
- Cliquez sur "Add". Le pays et son prix s'ajoutent à la liste sous les champs. Faites de même pour chaque pays vers lequel vous expédiez.
- Cliquez sur "Proceed" pour fermer la boîte de dialogue.
- Cliquez sur "Test & save connection".
Ce qui se passe ensuite
Lightspeed est une connexion pour les commandes, le stock et le suivi de colis entre votre boutique, e-tailize et les marketplaces sur lesquelles vous vendez. C'est vous qui choisissez lesquels de ces flux tournent, sur "Stock & order configuration" sous "Fulfillment". L'import de produits depuis Lightspeed n'est pas pris en charge : quand une connexion enregistrée est sélectionnée, vous voyez bien un bouton "Import products" à côté de "Test & save connection", mais il n'a aucun effet.
Avec les règles d'expédition activées, une commande transmise par e-tailize part avec PostNL comme mode d'expédition, et le prix du pays de l'adresse de livraison est réparti sur les lignes de la commande. Un pays absent de la liste ne reçoit pas de frais de port.
Problèmes fréquents
Passez en revue dans l'ordre les causes connues d'un test refusé. Utilisez l'URL par défaut de votre boutique Lightspeed : un domaine personnalisé n'est pas l'adresse à renseigner ici. Vérifiez que "API key" et "API secret" forment la paire actuelle, car une clé régénérée rend fausse la paire enregistrée auparavant. Un champ "Shop primary language (two letter abbreviation)" vide renvoie "'Shop Language' must not be empty.". Enfin, l'API Lightspeed eCom nécessite un abonnement Advanced ou Professional : avec un abonnement inférieur, la connexion échoue malgré des identifiants qui semblent corrects.
Le champ de langue attend l'abréviation à 2 lettres de la langue principale de votre boutique, pas un pays. Une boutique qui vend en plusieurs langues a tout de même une seule langue principale dans Lightspeed.
"Proceed" avec "Set PostNL as shipment method" coché et une liste vide affiche le message rouge "Atleast one country with shipping price should be added". Choisissez d'abord un pays, renseignez son prix et cliquez sur "Add". "Add" ne fait rien tant qu'aucun pays n'est choisi ou que le prix est encore à 0, et refuse un pays qui figure déjà dans la liste.
Questions fréquentes
Où retrouver le secret API ?
Sous "DETAILS" de la clé que vous avez créée, derrière "Show". S'il n'est plus disponible, créez une nouvelle clé et enregistrez de nouveau la connexion avec la nouvelle paire.
De quels droits la clé a besoin ?
Lecture et écriture, au minimum sur les catégories produits, clients, commandes, paramètres et suivi. L'application l'indique aussi derrière l'icône d'information à côté de "Configure connection", sous "How to connect with Lightspeed".
Et si je laisse vide le montant de livraison gratuite ?
Chaque commande transmise reçoit alors les frais de port de son pays, car il n'y a aucun seuil à dépasser. Renseignez ce montant quand les commandes à partir d'une certaine valeur doivent partir sans frais de port.
Comment désactiver de nouveau les règles d'expédition ?
Décochez "Set PostNL as shipment method" dans "Configure connection", cliquez sur "Proceed", puis sur "Test & save connection". Le montant et la liste des pays sont effacés en même temps.
Cet article vous a aidé ?