Hoppa till huvudinnehåll

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.exe och 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:// eller https:// 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​

  1. Öppna inställningarna, fliken Source.
  2. Välj JTL-Wawi i listan.
  3. Fyll i Address, App ID och App version (se tabellen nedan).
  4. Tryck på Generate token. Ett fönster visas: Confirm app registration in JTL-Wawi (Admin → App registration).
  5. Ö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.
  6. 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.
  7. Kontrollera de övriga fälten (företag, länder, sökreglage) och tryck på Connection test.
  8. Spara inställningarna och skanna några artiklar.
FältVad du angerExempel
AddressAdressen till JTL-Wawi API, se ovan.https://192.168.1.10:5883/api/eazybusiness/
App IDValfritt namn som identifierar den här priskontrollanten som en app i JTL-Wawi. Krävs innan token genereras.hdwr-pricechecker
App versionValfri versionsbeteckning, krävs innan token genereras.1.0
TokenFylls 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 certificateLå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 codeSökning på artikelns GTIN/EAN. Av som standard.✓
Company IDFö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
Ändra inte App ID efter att token har genererats

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​

MeddelandeOrsak 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 errorArtikeln 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.

JTL-Wawi — vanliga frågor

Hur ansluter HDWR:s priskontrollant till JTL-Wawi?
Via det officiella JTL-Wawi REST API, som standard på port 5883 på en adress som https://192.168.1.10:5883/api/eazybusiness/. Priskontrollanten registrerar sig som en app, en administratör bekräftar den i JTL-Wawi under Admin, App-Registrierung, och priskontrollanten får en token för att läsa artiklar.
Vilket pris visar priskontrollanten från JTL-Wawi?
Bruttopriset: artikelns försäljningspris netto plus den momssats som JTL-Wawi beräknar för inställt företag, avsändarland och mottagarland. Kundgruppspriser och specialpriser används inte.
Behöver priskontrollanten åtkomst till JTL-Wawis SQL-databas?
Nej. Den kommunicerar bara med JTL-Wawi API och begär bara behörighet att läsa artiklar. Ingen SQL-inloggning behövs.
Varför tar en skanning några sekunder med JTL-Wawi?
JTL-Wawi API söker igenom alla artiklar som matchar koden och returnerar dem med detaljer, vilket tar längre tid än en direkt databasförfrågan. Appen begär först en kort lista, så en vanlig skanning tar några sekunder. Mycket korta koder som matchar hundratals artiklar slutar med Too many results - item not identified.
Anslutningstestet rapporterar ett certifikatfel. Vad ska jag göra?
JTL-Wawi API använder oftast ett självsignerat HTTPS-certifikat. Avmarkera Check SSL certificate i inställningarna för källan JTL-Wawi och kör testet igen.