Skip to main content

JTL-Wawi

Kontrolér cien číta položky a ceny z JTL-Wawi cez oficiálne JTL-Wawi REST API (JTL-Wawi API). Zobrazuje názov položky a cenu brutto: predajnú cenu netto položky navýšenú o sadzbu DPH, ktorú pre ňu vypočíta JTL-Wawi.

Na rozdiel od programov Subiekt alebo Optima sa kontrolér cien nepripája k databáze SQL — komunikuje so serverom REST vašej inštalácie JTL-Wawi a prihlasuje sa tokenom, ktorý vydá JTL-Wawi.

Predtým, než začnete​

  • JTL-Wawi s JTL-Wawi API. Server REST je súčasťou JTL-Wawi (odporúčame verziu 1.10 alebo novšiu). Inštancia API sa zakladá v JTL-Administrator alebo pomocou JTL.Wawi.Rest.exe a môže bežať ako služba Windows. Podľa vašej zmluvy s JTL môže byť potrebné objednať modul JTL-Wawi API v zákazníckom centre JTL — aktuálne podmienky si overte v JTL.
  • Server API beží a je dostupný zo siete predajne. Predvolený port je 5883. Vo Windows firewalle servera povoľte prichádzajúce pripojenia na tomto porte (pravidlo za vás môže vytvoriť JTL-Administrator).
  • Kontrolér cien je v rovnakej sieti ako server JTL-Wawi API (alebo sa k nemu dostane cez VPN).
  • Administrátor sa môže prihlásiť do JTL-Wawi — kontrolér cien sa registruje ako aplikácia a registráciu je potrebné potvrdiť v JTL-Wawi.

Adresa JTL-Wawi API​

Adresa sa skladá z IP adresy servera, portu API a cesty /api/eazybusiness/:

https://192.168.1.10:5883/api/eazybusiness/
  • Zadajte IP adresu počítača, na ktorom JTL-Wawi API beží, nie jeho názov.
  • Použite http:// alebo https:// podľa toho, ako je inštancia API nastavená. Pri HTTPS má API zvyčajne certifikát podpísaný sám sebou — vtedy zrušte začiarknutie Check SSL certificate (pozri nižšie).
  • eazybusiness je názov databázy JTL-Wawi. Ak má vaša firemná databáza iný názov, použite v ceste ten.

Adresu si môžete overiť v prehliadači na počítači v rovnakej sieti: https://<address>:5883/swagger by mala otvoriť stránku s dokumentáciou API.

Nastavenie krok za krokom​

  1. Otvorte nastavenia, karta Source.
  2. V zozname vyberte JTL-Wawi.
  3. Vyplňte Address, App ID a App version (pozri tabuľku nižšie).
  4. Stlačte Generate token. Zobrazí sa okno: Confirm app registration in JTL-Wawi (Admin → App registration).
  5. V JTL-Wawi otvorte Admin → App-Registrierung (k dispozícii v novom rozhraní JTL-Wawi). Čaká tam žiadosť od HDWR Price Checker (poskytovateľ HDWR Global, oprávnenie na čítanie položiek). Potvrďte ju.
  6. Kontrolér cien každých niekoľko sekúnd kontroluje, či bola registrácia potvrdená. Po potvrdení vyplní pole Token a zobrazí Token generated successfully.
  7. Skontrolujte ostatné polia (firma, krajiny, prepínače vyhľadávania) a stlačte Connection test.
  8. Uložte nastavenia a naskenujte niekoľko položiek.
PoleČo zadaťPríklad
AddressAdresa JTL-Wawi API, pozri vyššie.https://192.168.1.10:5883/api/eazybusiness/
App IDĽubovoľný názov, ktorý identifikuje tento kontrolér cien ako aplikáciu v JTL-Wawi. Povinné pred vygenerovaním tokenu.hdwr-pricechecker
App versionĽubovoľné označenie verzie, povinné pred vygenerovaním tokenu.1.0
TokenVyplní sa tlačidlom Generate token. Môžete sem vložiť aj kľúč API vydaný v JTL-Wawi pre rovnaké App ID.vyplní sa automaticky
Check SSL certificatePri dôveryhodnom certifikáte nechajte začiarknuté; pri certifikáte API podpísanom samým sebou začiarknutie zrušte.✓
Search by product code (SKU)Vyhľadávanie podľa čísla položky JTL (Artikelnummer). Predvolene zapnuté.✓
Search by EAN codeVyhľadávanie podľa GTIN/EAN položky. Predvolene vypnuté.✓
Company IDFirma (Firma) v JTL-Wawi, ktorej nastavenia DPH sa použijú. Zvyčajne 1.1
Departure country (ISO)Krajina, z ktorej sa tovar predáva — dvojpísmenový kód ISO.DE
Shipment country (ISO)Krajina zákazníka — pri predajni rovnaká krajina, v ktorej je predajňa.DE
Po vygenerovaní tokenu nemeňte App ID

Token sa vydáva pre zadané App ID a App version. Ak zmeníte ktorúkoľvek z týchto hodnôt, JTL-Wawi token odmietne — uvidíte JTL-Wawi rejected the token. Check the App ID and app version or generate a new token. Vtedy token vygenerujte znova a potvrďte novú registráciu.

Ak je token už vyplnený, Generate token sa najprv opýta, či ho prepísať. Ak súčasný token funguje, nový nepotrebujete.

Cena a vyhľadávanie​

  • Na obrazovke je cena brutto: predajná cena netto položky z JTL-Wawi vynásobená sadzbou DPH a zaokrúhlená na dve desatinné miesta.
  • Sadzbu DPH vypočíta JTL-Wawi pre zadanú firmu, krajinu odoslania a krajinu doručenia — nemecká predajňa tak dostane napr. 19 % alebo 7 % podľa daňovej triedy položky. Položky s osobitnou úpravou zdaňovania prirážky (Differenzbesteuerung) majú sadzbu 0 %, takže sa zobrazí cena netto.
  • Cena je štandardná predajná cena položky. Ceny pre skupiny zákazníkov, cenníky ani špeciálne ceny sa nepoužívajú.
  • Search by product code (SKU) porovnáva naskenovaný kód s číslom položky; na veľkosti písmen nezáleží.
  • Search by EAN code porovnáva naskenovaný kód presne s GTIN položky.
  • Ak sú oba prepínače vypnuté, aplikácia vyhľadáva podľa čísla položky.

Čas odozvy​

Každé naskenovanie je živý dopyt do JTL-Wawi, takže zmena ceny je vidieť od ďalšieho naskenovania. JTL-Wawi API odpovedá citeľne pomalšie než dopyt do databázy — zvyčajne niekoľko sekúnd na jedno naskenovanie, pretože API vracia všetky položky zodpovedajúce kódu a aplikácia z nich vyberie presnú zhodu.

Pri krátkych kódoch, ktoré sa vyskytujú v mnohých položkách (napr. trojmiestne číslo, ktoré je zároveň súčasťou iných čísel a názvov položiek), aplikácia po približne 40 sekundách alebo 500 výsledkoch vyhľadávanie ukončí a zobrazí Too many results - item not identified. Naskenujte kód EAN alebo používajte dlhšie čísla položiek.

Hlásenia špecifické pre JTL-Wawi​

HláseniePríčina a riešenie
JTL-Wawi rejected the token. Check the App ID and app version or generate a new token.Token nezodpovedá App ID alebo verzii aplikácie, alebo bola registrácia v JTL-Wawi odstránená. Vygenerujte nový token.
The JTL-Wawi server responded with error …Adresa vedie na server, ale nie na JTL-Wawi API, napr. chýba cesta /api/eazybusiness/ alebo názov databázy.
The server certificate is not trusted. …API používa certifikát podpísaný sám sebou. Zrušte začiarknutie Check SSL certificate.
Cannot connect to … Check the address, the port and that the JTL-Wawi REST API is running.Nesprávna IP adresa alebo port, inštancia API je zastavená alebo firewall blokuje port 5883.
Tax download errorPoložka bola nájdená, ale JTL-Wawi nevrátilo sadzbu DPH — skontrolujte ID firmy a oba kódy krajín.
Token generation failed (alebo hlásenie z JTL-Wawi)Registrácia bola zamietnutá alebo JTL-Wawi vrátilo chybu. Skontrolujte adresu a to, či pre App-Registrierung používate nové rozhranie JTL-Wawi.

Všeobecné hlásenia opisuje stránka Riešenie problémov.

Aktualizácia zo staršej verzie aplikácie pre JTL-Wawi​

Niektorí zákazníci dostali staršiu verziu aplikácie určenú len pre JTL. Keď cez ňu nainštalujete aktuálnu verziu, nastavenia JTL-Wawi (adresa, App ID, token, krajiny) sa prevezmú automaticky a kontrolér cien funguje ďalej bez novej konfigurácie. Kód EAN pod cenou zostane skrytý ako v staršej verzii — zapnúť ho môžete na karte General.

JTL-Wawi — FAQ

Ako sa kontrolér cien HDWR pripája k JTL-Wawi?
Cez oficiálne JTL-Wawi REST API, predvolene na porte 5883 na adrese v tvare https://192.168.1.10:5883/api/eazybusiness/. Kontrolér cien sa zaregistruje ako aplikácia, administrátor registráciu potvrdí v JTL-Wawi v ponuke Admin, App-Registrierung a kontrolér cien dostane token na čítanie položiek.
Akú cenu kontrolér cien z JTL-Wawi zobrazuje?
Cenu brutto: predajnú cenu netto položky navýšenú o sadzbu DPH, ktorú JTL-Wawi vypočíta pre nastavenú firmu, krajinu odoslania a krajinu doručenia. Ceny pre skupiny zákazníkov ani špeciálne ceny sa nepoužívajú.
Potrebuje kontrolér cien prístup k databáze SQL JTL-Wawi?
Nie. Komunikuje iba s JTL-Wawi API a žiada len o oprávnenie na čítanie položiek. SQL účet nie je potrebný.
Prečo naskenovanie s JTL-Wawi trvá niekoľko sekúnd?
JTL-Wawi API prehľadá všetky položky zodpovedajúce kódu a vráti ich aj s podrobnosťami, čo trvá dlhšie než priamy dopyt do databázy. Aplikácia si najprv vyžiada krátky zoznam, takže bežné naskenovanie trvá niekoľko sekúnd. Veľmi krátke kódy, ktoré zodpovedajú stovkám položiek, skončia hlásením Too many results - item not identified.
Test pripojenia hlási chybu certifikátu. Čo mám robiť?
JTL-Wawi API zvyčajne používa certifikát HTTPS podpísaný sám sebou. V nastaveniach zdroja JTL-Wawi zrušte začiarknutie Check SSL certificate a test spustite znova.