JTL-Wawi
Ověřovač cen čte položky a ceny z JTL-Wawi přes oficiální JTL-Wawi REST API (JTL-Wawi API). Zobrazuje název položky a cenu brutto: prodejní cenu netto položky navýšenou o sazbu DPH, kterou pro ni vypočítá JTL-Wawi.
Na rozdíl od programů Subiekt nebo Optima se ověřovač cen nepřipojuje k databázi SQL — komunikuje se serverem REST vaší instalace JTL-Wawi a přihlašuje se tokenem, který vydá JTL-Wawi.
Než začnete
- JTL-Wawi s JTL-Wawi API. Server REST je součástí JTL-Wawi (doporučujeme verzi 1.10 nebo novější). Instance API se zakládá v JTL-Administrator nebo pomocí
JTL.Wawi.Rest.exea může běžet jako služba Windows. Podle vaší smlouvy s JTL může být nutné objednat modul JTL-Wawi API v zákaznickém centru JTL — aktuální podmínky ověřte u JTL. - Server API běží a je dostupný ze sítě prodejny. Výchozí port je 5883. Ve Windows firewallu serveru povolte příchozí připojení na tomto portu (pravidlo za vás může vytvořit JTL-Administrator).
- Ověřovač cen je ve stejné síti jako server JTL-Wawi API (nebo se k němu dostane přes VPN).
- Administrátor se může přihlásit do JTL-Wawi — ověřovač cen se registruje jako aplikace a registraci je nutné potvrdit v JTL-Wawi.
Adresa JTL-Wawi API
Adresa se skládá z IP adresy serveru, portu API a cesty /api/eazybusiness/:
https://192.168.1.10:5883/api/eazybusiness/
- Zadejte IP adresu počítače, na kterém JTL-Wawi API běží, ne jeho název.
- Použijte
http://nebohttps://podle toho, jak je instance API nastavená. U HTTPS má API obvykle certifikát podepsaný sám sebou — pak zrušte zaškrtnutí Check SSL certificate (viz níže). eazybusinessje název databáze JTL-Wawi. Pokud má vaše firemní databáze jiný název, použijte v cestě ten.
Adresu si můžete ověřit v prohlížeči na počítači ve stejné síti: https://<address>:5883/swagger by měla otevřít stránku s dokumentací API.
Nastavení krok za krokem
- Otevřete nastavení, karta Source.
- V seznamu vyberte JTL-Wawi.
- Vyplňte Address, App ID a App version (viz tabulka níže).
- Stiskněte Generate token. Zobrazí se okno: Confirm app registration in JTL-Wawi (Admin → App registration).
- V JTL-Wawi otevřete Admin → App-Registrierung (k dispozici v novém rozhraní JTL-Wawi). Čeká tam žádost od HDWR Price Checker (poskytovatel HDWR Global, oprávnění ke čtení položek). Potvrďte ji.
- Ověřovač cen každých několik sekund kontroluje, zda byla registrace potvrzena. Po potvrzení vyplní pole Token a zobrazí Token generated successfully.
- Zkontrolujte ostatní pole (firma, země, přepínače vyhledávání) a stiskněte Connection test.
- Uložte nastavení a naskenujte několik položek.
| Pole | Co zadat | Příklad |
|---|---|---|
| Address | Adresa JTL-Wawi API, viz výše. | https://192.168.1.10:5883/api/eazybusiness/ |
| App ID | Libovolný název, který identifikuje tento ověřovač cen jako aplikaci v JTL-Wawi. Povinné před vygenerováním tokenu. | hdwr-pricechecker |
| App version | Libovolné označení verze, povinné před vygenerováním tokenu. | 1.0 |
| Token | Vyplní se tlačítkem Generate token. Můžete sem také vložit klíč API vydaný v JTL-Wawi pro stejné App ID. | vyplní se automaticky |
| Check SSL certificate | U důvěryhodného certifikátu nechte zaškrtnuté; u certifikátu API podepsaného sám sebou zaškrtnutí zrušte. | ✓ |
| Search by product code (SKU) | Vyhledávání podle čísla položky JTL (Artikelnummer). Ve výchozím stavu zapnuto. | ✓ |
| Search by EAN code | Vyhledávání podle GTIN/EAN položky. Ve výchozím stavu vypnuto. | ✓ |
| Company ID | Firma (Firma) v JTL-Wawi, jejíž nastavení DPH se použije. Obvykle 1. | 1 |
| Departure country (ISO) | Země, ze které se zboží prodává — dvoupísmenný kód ISO. | DE |
| Shipment country (ISO) | Země zákazníka — u prodejny stejná země, ve které prodejna je. | DE |
Token se vydává pro zadané App ID a App version. Pokud kteroukoli z těchto hodnot změníte, JTL-Wawi token odmítne — uvidíte JTL-Wawi rejected the token. Check the App ID and app version or generate a new token. Pak token vygenerujte znovu a potvrďte novou registraci.
Pokud je token už vyplněný, Generate token se nejdřív zeptá, zda ho přepsat. Pokud současný token funguje, nový nepotřebujete.
Cena a vyhledávání
- Na obrazovce je cena brutto: prodejní cena netto položky z JTL-Wawi vynásobená sazbou DPH a zaokrouhlená na dvě desetinná místa.
- Sazbu DPH vypočítá JTL-Wawi pro zadanou firmu, zemi odeslání a zemi doručení — německá prodejna tak dostane např. 19 % nebo 7 % podle daňové třídy položky. Položky se zdaněním marže (Differenzbesteuerung) mají sazbu 0 %, takže se zobrazí cena netto.
- Cena je standardní prodejní cena položky. Ceny pro skupiny zákazníků, ceníky ani zvláštní ceny se nepoužívají.
- Search by product code (SKU) porovnává naskenovaný kód s číslem položky; na velikosti písmen nezáleží.
- Search by EAN code porovnává naskenovaný kód přesně s GTIN položky.
- Pokud jsou oba přepínače vypnuté, aplikace vyhledává podle čísla položky.
Doba odezvy
Každé naskenování je živý dotaz do JTL-Wawi, takže změna ceny je vidět od dalšího naskenování. JTL-Wawi API odpovídá znatelně pomaleji než dotaz do databáze — obvykle několik sekund na jedno naskenování, protože API vrací všechny položky odpovídající kódu a aplikace z nich vybere přesnou shodu.
U krátkých kódů, které se vyskytují v mnoha položkách (např. trojmístné číslo, které je zároveň součástí jiných čísel a názvů položek), aplikace po zhruba 40 sekundách nebo 500 výsledcích hledání ukončí a zobrazí Too many results - item not identified. Naskenujte kód EAN nebo používejte delší čísla položek.
Hlášení specifická pro JTL-Wawi
| Hlášení | Příčina a řešení |
|---|---|
| JTL-Wawi rejected the token. Check the App ID and app version or generate a new token. | Token neodpovídá App ID nebo verzi aplikace, nebo byla registrace v JTL-Wawi odstraněna. Vygenerujte nový token. |
| The JTL-Wawi server responded with error … | Adresa vede na server, ale ne na JTL-Wawi API, např. chybí cesta /api/eazybusiness/ nebo název databáze. |
| The server certificate is not trusted. … | API používá certifikát podepsaný sám sebou. Zrušte zaškrtnutí Check SSL certificate. |
| Cannot connect to … Check the address, the port and that the JTL-Wawi REST API is running. | Chybná IP adresa nebo port, instance API je zastavená nebo firewall blokuje port 5883. |
| Tax download error | Položka byla nalezena, ale JTL-Wawi nevrátilo sazbu DPH — zkontrolujte ID firmy a oba kódy zemí. |
| Token generation failed (nebo hlášení z JTL-Wawi) | Registrace byla zamítnuta nebo JTL-Wawi vrátilo chybu. Zkontrolujte adresu a to, že pro App-Registrierung používáte nové rozhraní JTL-Wawi. |
Obecná hlášení popisuje stránka Řešení problémů.
Aktualizace z dřívější verze aplikace pro JTL-Wawi
Někteří zákazníci dostali dřívější verzi aplikace určenou jen pro JTL. Když přes ni nainstalujete aktuální verzi, nastavení JTL-Wawi (adresa, App ID, token, země) se převezmou automaticky a ověřovač cen funguje dál bez nové konfigurace. Kód EAN pod cenou zůstane skrytý jako v dřívější verzi — zapnout ho můžete na kartě General.