JTL-Wawi
Priskontrollanten läser artiklar och priser från JTL-Wawi via det officiella JTL-Wawi REST API (JTL-Wawi API). Den visar artikelns namn och bruttopriset: artikelns försäljningspris netto plus den momssats som JTL-Wawi beräknar för den.
Till skillnad från Subiekt eller Optima ansluter priskontrollanten inte till SQL-databasen — den kommunicerar med REST-servern i din JTL-Wawi-installation och loggar in med en token som JTL-Wawi utfärdar.
Innan du börjar
- JTL-Wawi med JTL-Wawi API. REST-servern ingår i JTL-Wawi (version 1.10 eller senare rekommenderas). En API-instans skapas i JTL-Administrator eller med
JTL.Wawi.Rest.exeoch kan köras som en Windows-tjänst. Beroende på ditt avtal med JTL kan modulen JTL-Wawi API behöva bokas i JTL:s kundcenter — kontrollera gällande villkor med JTL. - API-servern körs och kan nås från butiksnätet. Standardporten är 5883. Tillåt inkommande anslutningar på den porten i serverns Windows-brandvägg (JTL-Administrator kan skapa regeln åt dig).
- Priskontrollanten finns i samma nätverk som JTL-Wawi API-servern (eller når den via VPN).
- En administratör kan logga in i JTL-Wawi — priskontrollanten registrerar sig som en app och registreringen måste bekräftas i JTL-Wawi.
Adressen till JTL-Wawi API
Adressen består av serverns IP-adress, API-porten och sökvägen /api/eazybusiness/:
https://192.168.1.10:5883/api/eazybusiness/
- Ange IP-adressen till datorn där JTL-Wawi API körs, inte dess namn.
- Använd
http://ellerhttps://på samma sätt som API-instansen är konfigurerad. Med HTTPS har API:et oftast ett självsignerat certifikat — avmarkera då Check SSL certificate (se nedan). eazybusinessär namnet på JTL-Wawi-databasen. Om din företagsdatabas har ett annat namn använder du det namnet i sökvägen.
Du kan kontrollera adressen i en webbläsare på en dator i samma nätverk: https://<address>:5883/swagger ska öppna API:ets dokumentationssida.
Steg-för-steg-konfiguration
- Öppna inställningarna, fliken Source.
- Välj JTL-Wawi i listan.
- Fyll i Address, App ID och App version (se tabellen nedan).
- Tryck på Generate token. Ett fönster visas: Confirm app registration in JTL-Wawi (Admin → App registration).
- Öppna Admin → App-Registrierung i JTL-Wawi (finns i det nya JTL-Wawi-gränssnittet). Där väntar förfrågan från HDWR Price Checker (leverantör HDWR Global, behörighet att läsa artiklar). Bekräfta den.
- Priskontrollanten kontrollerar med några sekunders mellanrum om registreringen har bekräftats. Efter bekräftelsen fyller den i fältet Token och visar Token generated successfully.
- Kontrollera de övriga fälten (företag, länder, sökreglage) och tryck på Connection test.
- Spara inställningarna och skanna några artiklar.
| Fält | Vad du anger | Exempel |
|---|---|---|
| Address | Adressen till JTL-Wawi API, se ovan. | https://192.168.1.10:5883/api/eazybusiness/ |
| App ID | Valfritt namn som identifierar den här priskontrollanten som en app i JTL-Wawi. Krävs innan token genereras. | hdwr-pricechecker |
| App version | Valfri versionsbeteckning, krävs innan token genereras. | 1.0 |
| Token | Fylls i med Generate token. Du kan också klistra in en API-nyckel som utfärdats i JTL-Wawi för samma App ID. | fylls i automatiskt |
| Check SSL certificate | Låt den vara markerad för ett betrott certifikat; avmarkera för ett självsignerat certifikat på API:et. | ✓ |
| Search by product code (SKU) | Sökning på JTL:s artikelnummer (Artikelnummer). På som standard. | ✓ |
| Search by EAN code | Sökning på artikelns GTIN/EAN. Av som standard. | ✓ |
| Company ID | Företaget (Firma) i JTL-Wawi vars momsinställningar används. Oftast 1. | 1 |
| Departure country (ISO) | Landet varorna säljs från — tvåbokstavs ISO-kod. | DE |
| Shipment country (ISO) | Kundens land — för en butik samma land som butiken ligger i. | DE |
Token utfärdas för angivet App ID och App version. Om du ändrar något av dem avvisar JTL-Wawi token — du ser JTL-Wawi rejected the token. Check the App ID and app version or generate a new token. Generera då token igen och bekräfta den nya registreringen.
Om en token redan är ifylld frågar Generate token först om den ska skrivas över. Om den nuvarande token fungerar behöver du ingen ny.
Pris och sökning
- Skärmen visar bruttopriset: artikelns försäljningspris netto från JTL-Wawi multiplicerat med momssatsen och avrundat till två decimaler.
- Momssatsen beräknas av JTL-Wawi för angivet företag, avsändarland och mottagarland — en tysk butik får alltså t.ex. 19 % eller 7 % beroende på artikelns skatteklass. Artiklar med vinstmarginalbeskattning (Differenzbesteuerung) har satsen 0 %, så nettopriset visas.
- Priset är artikelns standardförsäljningspris. Kundgruppspriser, prislistor och specialpriser används inte.
- Search by product code (SKU) jämför den skannade koden med artikelnumret; versaler och gemener spelar ingen roll.
- Search by EAN code jämför den skannade koden exakt med artikelns GTIN.
- Om båda reglagen är avstängda söker appen på artikelnumret.
Svarstid
Varje skanning är en direkt förfrågan till JTL-Wawi, så en prisändring syns redan vid nästa skanning. JTL-Wawi API svarar märkbart långsammare än en databasförfrågan — oftast några sekunder per skanning, eftersom API:et returnerar alla artiklar som matchar koden och appen väljer ut den exakta träffen.
För korta koder som förekommer i många artiklar (t.ex. ett tresiffrigt nummer som också ingår i andra artikelnummer och namn) avbryter appen sökningen efter cirka 40 sekunder eller 500 resultat och visar Too many results - item not identified. Skanna EAN-koden eller använd längre artikelnummer.
Meddelanden som gäller JTL-Wawi
| Meddelande | Orsak och lösning |
|---|---|
| JTL-Wawi rejected the token. Check the App ID and app version or generate a new token. | Token stämmer inte med App ID eller appversionen, eller så har registreringen tagits bort i JTL-Wawi. Generera en ny token. |
| The JTL-Wawi server responded with error … | Adressen leder till en server, men inte till JTL-Wawi API, t.ex. saknas sökvägen /api/eazybusiness/ eller databasnamnet. |
| The server certificate is not trusted. … | API:et använder ett självsignerat certifikat. Avmarkera Check SSL certificate. |
| Cannot connect to … Check the address, the port and that the JTL-Wawi REST API is running. | Fel IP-adress eller port, API-instansen är stoppad eller brandväggen blockerar port 5883. |
| Tax download error | Artikeln hittades, men JTL-Wawi returnerade ingen momssats — kontrollera företags-ID och de två landskoderna. |
| Token generation failed (eller ett meddelande från JTL-Wawi) | Registreringen avvisades eller JTL-Wawi returnerade ett fel. Kontrollera adressen och att du använder det nya JTL-Wawi-gränssnittet för App-Registrierung. |
De allmänna meddelandena beskrivs i Felsökning.
Uppdatering från den tidigare JTL-Wawi-versionen av appen
Vissa kunder fick en tidigare version av appen som bara var avsedd för JTL. När du installerar den aktuella versionen ovanpå den förs JTL-Wawi-inställningarna (adress, App ID, token, länder) över automatiskt och priskontrollanten fortsätter att fungera utan ny konfiguration. EAN-koden under priset förblir dold, som i den tidigare versionen — du kan slå på den på fliken General.