Přeskočit na hlavní obsah

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.exe a 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:// nebo https:// 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).
  • eazybusiness je 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​

  1. Otevřete nastavení, karta Source.
  2. V seznamu vyberte JTL-Wawi.
  3. Vyplňte Address, App ID a App version (viz tabulka níže).
  4. Stiskněte Generate token. Zobrazí se okno: Confirm app registration in JTL-Wawi (Admin → App registration).
  5. 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.
  6. Ověřovač cen každých několik sekund kontroluje, zda byla registrace potvrzena. Po potvrzení vyplní pole Token a zobrazí Token generated successfully.
  7. Zkontrolujte ostatní pole (firma, země, přepínače vyhledávání) a stiskněte Connection test.
  8. Uložte nastavení a naskenujte několik položek.
PoleCo zadatPříklad
AddressAdresa JTL-Wawi API, viz výše.https://192.168.1.10:5883/api/eazybusiness/
App IDLibovolný název, který identifikuje tento ověřovač cen jako aplikaci v JTL-Wawi. Povinné před vygenerováním tokenu.hdwr-pricechecker
App versionLibovolné označení verze, povinné před vygenerováním tokenu.1.0
TokenVyplní 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 certificateU 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 codeVyhledávání podle GTIN/EAN položky. Ve výchozím stavu vypnuto.✓
Company IDFirma (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
Po vygenerování tokenu neměňte App ID

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 errorPolož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.

JTL-Wawi — FAQ

Jak se ověřovač cen HDWR připojuje k JTL-Wawi?
Přes oficiální JTL-Wawi REST API, ve výchozím stavu na portu 5883 na adrese ve tvaru https://192.168.1.10:5883/api/eazybusiness/. Ověřovač cen se zaregistruje jako aplikace, administrátor registraci potvrdí v JTL-Wawi v nabídce Admin, App-Registrierung a ověřovač cen dostane token ke čtení položek.
Jakou cenu ověřovač cen z JTL-Wawi zobrazuje?
Cenu brutto: prodejní cenu netto položky navýšenou o sazbu DPH, kterou JTL-Wawi vypočítá pro nastavenou firmu, zemi odeslání a zemi doručení. Ceny pro skupiny zákazníků ani zvláštní ceny se nepoužívají.
Potřebuje ověřovač cen přístup k databázi SQL JTL-Wawi?
Ne. Komunikuje pouze s JTL-Wawi API a žádá jen o oprávnění ke čtení položek. SQL účet není potřeba.
Proč naskenování s JTL-Wawi trvá několik sekund?
JTL-Wawi API prohledá všechny položky odpovídající kódu a vrátí je i s podrobnostmi, což trvá déle než přímý dotaz do databáze. Aplikace si nejdřív vyžádá krátký seznam, takže běžné naskenování trvá několik sekund. Velmi krátké kódy, které odpovídají stovkám položek, skončí hlášením Too many results - item not identified.
Test připojení hlásí chybu certifikátu. Co mám dělat?
JTL-Wawi API obvykle používá certifikát HTTPS podepsaný sám sebou. V nastavení zdroje JTL-Wawi zrušte zaškrtnutí Check SSL certificate a test spusťte znovu.