Aller au contenu principal

JTL-Wawi

La borne lit les articles et les prix de JTL-Wawi via l'API REST officielle de JTL-Wawi (JTL-Wawi API). Elle affiche le nom de l'article et le prix TTC : le prix de vente net de l'article, majoré du taux de TVA que JTL-Wawi calcule pour celui-ci.

Contrairement à Subiekt ou Optima, la borne ne se connecte pas à la base de données SQL : elle communique avec le serveur REST de votre installation JTL-Wawi et s'authentifie avec un token délivré par JTL-Wawi.

Avant de commencer​

  • JTL-Wawi avec l'API JTL-Wawi. Le serveur REST fait partie de JTL-Wawi (version 1.10 ou ultérieure recommandée). Une instance d'API se crée dans le JTL-Administrator ou avec JTL.Wawi.Rest.exe, et peut fonctionner comme service Windows. Selon votre contrat JTL, le module JTL-Wawi API peut devoir être souscrit dans l'espace client JTL (JTL-Kundencenter) — vérifiez les conditions actuelles auprès de JTL.
  • Le serveur de l'API est démarré et accessible depuis le réseau du magasin. Le port par défaut est 5883. Autorisez les connexions entrantes sur ce port dans le pare-feu Windows du serveur (le JTL-Administrator peut créer la règle pour vous).
  • La borne se trouve sur le même réseau que le serveur de l'API JTL-Wawi (ou l'atteint via un VPN).
  • Un administrateur peut se connecter à JTL-Wawi — la borne s'enregistre comme application, et cet enregistrement doit être confirmé dans JTL-Wawi.

Adresse de l'API JTL-Wawi​

L'adresse se compose de l'adresse IP du serveur, du port de l'API et du chemin /api/eazybusiness/ :

https://192.168.1.10:5883/api/eazybusiness/
  • Utilisez l'adresse IP de l'ordinateur sur lequel tourne l'API JTL-Wawi, pas son nom.
  • Utilisez http:// ou https:// selon la configuration de l'instance d'API. En HTTPS, l'API a généralement un certificat auto-signé — décochez alors Check SSL certificate (voir ci-dessous).
  • eazybusiness est le nom de la base de données JTL-Wawi. Si la base de votre société porte un autre nom, utilisez ce nom dans le chemin.

Vous pouvez vérifier l'adresse dans un navigateur sur un ordinateur du même réseau : https://<adresse>:5883/swagger doit ouvrir la page de documentation de l'API.

Configuration pas à pas​

  1. Ouvrez les paramètres, onglet Source.
  2. Choisissez JTL-Wawi dans la liste.
  3. Remplissez Address, App ID et App version (voir le tableau ci-dessous).
  4. Appuyez sur Generate token. Une fenêtre s'affiche : Confirm app registration in JTL-Wawi (Admin → App registration).
  5. Dans JTL-Wawi, ouvrez Admin → App-Registrierung (disponible dans la nouvelle interface de JTL-Wawi). La demande de HDWR Price Checker (fournisseur HDWR Global, droit de lecture des articles) y attend. Confirmez-la.
  6. La borne vérifie toutes les quelques secondes si l'enregistrement a été confirmé. Après confirmation, elle remplit le champ Token et affiche Token generated successfully.
  7. Vérifiez les autres champs (société, pays, options de recherche) et appuyez sur Connection test.
  8. Enregistrez les paramètres et scannez quelques articles.
ChampQue saisirExemple
AddressL'adresse de l'API JTL-Wawi, voir ci-dessus.https://192.168.1.10:5883/api/eazybusiness/
App IDUn nom quelconque identifiant cette borne comme application dans JTL-Wawi. Obligatoire avant de générer le token.hdwr-pricechecker
App versionUn libellé de version quelconque, obligatoire avant de générer le token.1.0
TokenRempli par Generate token. Vous pouvez aussi coller une clé API délivrée dans JTL-Wawi pour le même App ID.rempli automatiquement
Check SSL certificateLaissez coché pour un certificat de confiance ; décochez pour un certificat auto-signé de l'API.✓
Search by product code (SKU)Recherche par numéro d'article JTL (Artikelnummer). Activé par défaut.✓
Search by EAN codeRecherche par GTIN/EAN de l'article. Désactivé par défaut.✓
Company IDLa société JTL-Wawi (Firma) dont les paramètres de TVA sont utilisés. En général 1.1
Departure country (ISO)Pays depuis lequel les marchandises sont vendues — code ISO à deux lettres.DE
Shipment country (ISO)Pays du client — pour un magasin, le même pays que celui du magasin.DE
Ne modifiez pas l'App ID après avoir généré le token

Le token est délivré pour l'App ID et l'App version indiqués. Si vous modifiez l'un des deux, JTL-Wawi refuse le token — vous verrez JTL-Wawi rejected the token. Check the App ID and app version or generate a new token. Générez alors un nouveau token et confirmez le nouvel enregistrement.

Si un token est déjà renseigné, Generate token demande d'abord s'il faut le remplacer. Si le token actuel fonctionne, vous n'avez pas besoin d'en générer un nouveau.

Prix et recherche​

  • L'écran affiche le prix TTC : le prix de vente net de l'article dans JTL-Wawi multiplié par le taux de TVA, arrondi à deux décimales.
  • Le taux de TVA est calculé par JTL-Wawi pour la société, le pays de départ et le pays d'expédition indiqués — un magasin allemand obtient ainsi par ex. 19 % ou 7 %, selon la classe fiscale de l'article. Les articles soumis au régime de la marge (Differenzbesteuerung) ont un taux de 0 % ; c'est donc le prix net qui s'affiche.
  • Le prix est le prix de vente standard de l'article. Les prix par groupe de clients (Kundengruppenpreise), les listes de prix et les prix spéciaux (Sonderpreise) ne sont pas utilisés.
  • Search by product code (SKU) compare le code scanné avec le numéro d'article, sans tenir compte des majuscules et minuscules.
  • Search by EAN code compare le code scanné exactement avec le GTIN de l'article.
  • Si les deux options sont désactivées, l'application recherche par numéro d'article.

Temps de réponse​

Chaque scan est une requête en direct vers JTL-Wawi : un changement de prix est donc visible dès le scan suivant. L'API JTL-Wawi répond nettement plus lentement qu'une requête en base de données — en général quelques secondes par scan, car l'API renvoie tous les articles correspondant au code et l'application sélectionne la correspondance exacte.

Pour les codes courts présents dans de nombreux articles (par ex. un nombre à trois chiffres qui fait aussi partie d'autres numéros et noms d'articles), l'application arrête la recherche après environ 40 secondes ou 500 résultats et affiche Too many results - item not identified. Scannez le code EAN ou utilisez des numéros d'article plus longs.

Messages propres à JTL-Wawi​

MessageCause et solution
JTL-Wawi rejected the token. Check the App ID and app version or generate a new token.Le token ne correspond pas à l'App ID ou à la version de l'application, ou l'enregistrement a été supprimé dans JTL-Wawi. Générez un nouveau token.
The JTL-Wawi server responded with error …L'adresse mène à un serveur, mais pas à l'API JTL-Wawi — par ex. le chemin /api/eazybusiness/ ou le nom de la base de données manque.
The server certificate is not trusted. …L'API utilise un certificat auto-signé. Décochez Check SSL certificate.
Cannot connect to … Check the address, the port and that the JTL-Wawi REST API is running.Adresse IP ou port erroné, instance d'API arrêtée, ou pare-feu bloquant le port 5883.
Tax download errorL'article a été trouvé, mais JTL-Wawi n'a pas renvoyé de taux de TVA — vérifiez l'ID de société et les deux codes pays.
Token generation failed (ou un message de JTL-Wawi)L'enregistrement a été refusé ou JTL-Wawi a renvoyé une erreur. Vérifiez l'adresse et que vous utilisez bien la nouvelle interface de JTL-Wawi pour l'App-Registrierung.

Les messages généraux sont décrits dans Dépannage.

Mise à jour depuis l'ancienne version JTL-Wawi de l'application​

Certains clients ont reçu une version antérieure de l'application, réservée à JTL. Lorsque vous installez la version actuelle par-dessus, les paramètres JTL-Wawi (adresse, App ID, token, pays) sont repris automatiquement et la borne continue de fonctionner sans nouvelle configuration. Le code EAN sous le prix reste masqué, comme dans l'ancienne version — vous pouvez l'activer dans l'onglet General.

JTL-Wawi — FAQ

Comment la borne HDWR se connecte-t-elle à JTL-Wawi ?
Via l'API REST officielle de JTL-Wawi, par défaut sur le port 5883, à une adresse du type https://192.168.1.10:5883/api/eazybusiness/. La borne s'enregistre comme application, un administrateur la confirme dans JTL-Wawi sous Admin, App-Registrierung, et la borne reçoit un token pour lire les articles.
Quel prix de JTL-Wawi la borne affiche-t-elle ?
Le prix TTC : le prix de vente net de l'article majoré du taux de TVA que JTL-Wawi calcule pour la société, le pays de départ et le pays d'expédition définis. Les prix par groupe de clients et les prix spéciaux ne sont pas utilisés.
La borne a-t-elle besoin d'accéder à la base de données SQL de JTL-Wawi ?
Non. Elle communique uniquement avec l'API JTL-Wawi et ne demande que le droit de lire les articles. Aucun identifiant SQL n'est nécessaire.
Pourquoi un scan prend-il quelques secondes avec JTL-Wawi ?
L'API JTL-Wawi recherche tous les articles correspondant au code et les renvoie avec leurs détails, ce qui prend plus de temps qu'une requête directe en base de données. L'application demande d'abord une liste courte, si bien qu'un scan typique prend quelques secondes. Les codes très courts correspondant à des centaines d'articles se terminent par Too many results - item not identified.
Le test de connexion signale une erreur de certificat. Que faire ?
L'API JTL-Wawi utilise généralement un certificat HTTPS auto-signé. Décochez Check SSL certificate dans les paramètres de la source JTL-Wawi et relancez le test.