JTL-Wawi
De prijsscanner leest artikelen en prijzen uit JTL-Wawi via de officiële JTL-Wawi REST API (JTL-Wawi API). Hij toont de artikelnaam en de brutoprijs: de netto verkoopprijs van het artikel plus het btw-tarief dat JTL-Wawi ervoor berekent.
Anders dan bij Subiekt of Optima maakt de prijsscanner geen verbinding met de SQL-database — hij communiceert met de REST-server van uw JTL-Wawi-installatie en meldt zich aan met een token dat JTL-Wawi uitgeeft.
Voordat u begint
- JTL-Wawi met de JTL-Wawi API. De REST-server maakt deel uit van JTL-Wawi (versie 1.10 of nieuwer aanbevolen). Een API-instantie maakt u aan in de JTL-Administrator of met
JTL.Wawi.Rest.exe, en kan als Windows-service draaien. Afhankelijk van uw JTL-contract moet de module JTL-Wawi API mogelijk worden geboekt in het JTL-klantencentrum (JTL-Kundencenter) — controleer de actuele voorwaarden bij JTL. - De API-server draait en is bereikbaar vanuit het winkelnetwerk. De standaardpoort is 5883. Sta inkomende verbindingen op deze poort toe in de Windows-firewall van de server (de JTL-Administrator kan de regel voor u aanmaken).
- De prijsscanner zit in hetzelfde netwerk als de JTL-Wawi API-server (of bereikt die via VPN).
- Een beheerder kan zich aanmelden bij JTL-Wawi — de prijsscanner registreert zich als app en die registratie moet in JTL-Wawi worden bevestigd.
Adres van de JTL-Wawi API
Het adres bestaat uit het IP-adres van de server, de API-poort en het pad /api/eazybusiness/:
https://192.168.1.10:5883/api/eazybusiness/
- Gebruik het IP-adres van de computer waarop de JTL-Wawi API draait, niet de naam.
- Gebruik
http://ofhttps://, net zoals de API-instantie is ingesteld. Bij HTTPS heeft de API meestal een zelfondertekend certificaat — vink dan Check SSL certificate uit (zie hieronder). eazybusinessis de naam van de JTL-Wawi-database. Heeft de database van uw bedrijf een andere naam, gebruik dan die naam in het pad.
U kunt het adres controleren in een browser op een computer in hetzelfde netwerk: https://<adres>:5883/swagger moet de documentatiepagina van de API openen.
Stapsgewijze instelling
- Open de instellingen, tabblad Source.
- Kies JTL-Wawi in de lijst.
- Vul Address, App ID en App version in (zie de tabel hieronder).
- Druk op Generate token. Er verschijnt een venster: Confirm app registration in JTL-Wawi (Admin → App registration).
- Open in JTL-Wawi Admin → App-Registrierung (beschikbaar in de nieuwe JTL-Wawi-interface). Daar wacht het verzoek van HDWR Price Checker (aanbieder HDWR Global, recht om artikelen te lezen). Bevestig het.
- De prijsscanner controleert om de paar seconden of de registratie is bevestigd. Na bevestiging vult hij het veld Token in en toont Token generated successfully.
- Controleer de overige velden (bedrijf, landen, zoekschakelaars) en druk op Connection test.
- Sla de instellingen op en scan een paar artikelen.
| Veld | Wat in te vullen | Voorbeeld |
|---|---|---|
| Address | Het adres van de JTL-Wawi API, zie hierboven. | https://192.168.1.10:5883/api/eazybusiness/ |
| App ID | Een willekeurige naam die deze prijsscanner als app in JTL-Wawi identificeert. Verplicht vóór het genereren van het token. | hdwr-pricechecker |
| App version | Een willekeurig versielabel, verplicht vóór het genereren van het token. | 1.0 |
| Token | Wordt ingevuld door Generate token. U kunt ook een API-sleutel plakken die in JTL-Wawi voor dezelfde App ID is uitgegeven. | automatisch ingevuld |
| Check SSL certificate | Laat aangevinkt bij een vertrouwd certificaat; vink uit bij een zelfondertekend certificaat van de API. | ✓ |
| Search by product code (SKU) | Zoeken op het JTL-artikelnummer (Artikelnummer). Standaard aan. | ✓ |
| Search by EAN code | Zoeken op de GTIN/EAN van het artikel. Standaard uit. | ✓ |
| Company ID | Het JTL-Wawi-bedrijf (Firma) waarvan de btw-instellingen worden gebruikt. Meestal 1. | 1 |
| Departure country (ISO) | Land van waaruit de goederen worden verkocht — ISO-code van twee letters. | DE |
| Shipment country (ISO) | Land van de klant — voor een winkel hetzelfde land als dat van de winkel. | DE |
Het token wordt uitgegeven voor de opgegeven App ID en App version. Wijzigt u een van beide, dan weigert JTL-Wawi het token — u ziet dan JTL-Wawi rejected the token. Check the App ID and app version or generate a new token. Genereer in dat geval opnieuw een token en bevestig de nieuwe registratie.
Is er al een token ingevuld, dan vraagt Generate token eerst of het moet worden overschreven. Werkt het huidige token, dan hebt u geen nieuw nodig.
Prijs en zoeken
- Het scherm toont de brutoprijs: de netto verkoopprijs van het artikel uit JTL-Wawi vermenigvuldigd met het btw-tarief, afgerond op twee decimalen.
- Het btw-tarief wordt door JTL-Wawi berekend voor het opgegeven bedrijf, land van vertrek en land van verzending — een Duitse winkel krijgt dus bijv. 19 % of 7 %, afhankelijk van de belastingklasse van het artikel. Artikelen met de margeregeling (Differenzbesteuerung) hebben een tarief van 0 %, dus wordt de nettoprijs getoond.
- De prijs is de standaardverkoopprijs van het artikel. Klantgroepprijzen (Kundengruppenpreise), prijslijsten en speciale prijzen (Sonderpreise) worden niet gebruikt.
- Search by product code (SKU) vergelijkt de gescande code met het artikelnummer; hoofdletters en kleine letters maken niet uit.
- Search by EAN code vergelijkt de gescande code exact met de GTIN van het artikel.
- Staan beide schakelaars uit, dan zoekt de app op het artikelnummer.
Reactietijd
Elke scan is een live opvraging bij JTL-Wawi, dus een prijswijziging is vanaf de volgende scan zichtbaar. De JTL-Wawi API reageert merkbaar trager dan een databasequery — meestal enkele seconden per scan, omdat de API alle artikelen teruggeeft die bij de code passen en de app daaruit de exacte overeenkomst kiest.
Bij korte codes die in veel artikelen voorkomen (bijv. een getal van drie cijfers dat ook deel uitmaakt van andere artikelnummers en -namen) stopt de app na ongeveer 40 seconden of 500 resultaten met zoeken en toont Too many results - item not identified. Scan de EAN-code of gebruik langere artikelnummers.
Meldingen specifiek voor JTL-Wawi
| Melding | Oorzaak en oplossing |
|---|---|
| JTL-Wawi rejected the token. Check the App ID and app version or generate a new token. | Het token past niet bij de App ID of de app-versie, of de registratie is in JTL-Wawi verwijderd. Genereer een nieuw token. |
| The JTL-Wawi server responded with error … | Het adres leidt naar een server, maar niet naar de JTL-Wawi API — bijv. het pad /api/eazybusiness/ of de databasenaam ontbreekt. |
| The server certificate is not trusted. … | De API gebruikt een zelfondertekend certificaat. Vink Check SSL certificate uit. |
| Cannot connect to … Check the address, the port and that the JTL-Wawi REST API is running. | Verkeerd IP-adres of verkeerde poort, de API-instantie is gestopt of de firewall blokkeert poort 5883. |
| Tax download error | Het artikel is gevonden, maar JTL-Wawi gaf geen btw-tarief terug — controleer de bedrijfs-ID en de twee landcodes. |
| Token generation failed (of een melding van JTL-Wawi) | De registratie is geweigerd of JTL-Wawi gaf een fout terug. Controleer het adres en of u voor de App-Registrierung de nieuwe JTL-Wawi-interface gebruikt. |
De algemene meldingen staan beschreven in Probleemoplossing.
Update vanaf de eerdere JTL-Wawi-versie van de app
Sommige klanten hebben een eerdere versie van de app gekregen die alleen voor JTL bedoeld was. Installeert u de huidige versie daaroverheen, dan worden de JTL-Wawi-instellingen (adres, App ID, token, landen) automatisch overgenomen en blijft de prijsscanner werken zonder nieuwe configuratie. De EAN-code onder de prijs blijft verborgen, zoals in de eerdere versie — u kunt hem inschakelen op het tabblad General.