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.exea 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://alebohttps://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). eazybusinessje 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
- Otvorte nastavenia, karta Source.
- V zozname vyberte JTL-Wawi.
- Vyplňte Address, App ID a App version (pozri tabuľku nižšie).
- Stlačte Generate token. Zobrazí sa okno: Confirm app registration in JTL-Wawi (Admin → App registration).
- 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.
- 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.
- Skontrolujte ostatné polia (firma, krajiny, prepínače vyhľadávania) a stlačte Connection test.
- Uložte nastavenia a naskenujte niekoľko položiek.
| Pole | Čo zadať | Príklad |
|---|---|---|
| Address | Adresa 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 |
| Token | Vyplní 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 certificate | Pri 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 code | Vyhľadávanie podľa GTIN/EAN položky. Predvolene vypnuté. | ✓ |
| Company ID | Firma (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 |
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ásenie | Príč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 error | Polož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.