JTL-Wawi
Il lettore di prezzi legge articoli e prezzi da JTL-Wawi tramite la REST API ufficiale di JTL-Wawi (JTL-Wawi API). Mostra il nome dell'articolo e il prezzo lordo: il prezzo di vendita netto dell'articolo più l'aliquota IVA che JTL-Wawi calcola per esso.
A differenza di Subiekt od Optima, il lettore di prezzi non si collega al database SQL: comunica con il server REST della tua installazione di JTL-Wawi e accede con un token rilasciato da JTL-Wawi.
Prima di iniziare
- JTL-Wawi con la JTL-Wawi API. Il server REST fa parte di JTL-Wawi (si consiglia la versione 1.10 o successiva). L'istanza dell'API si crea nel JTL-Administrator o con
JTL.Wawi.Rest.exee può funzionare come servizio Windows. A seconda del tuo contratto con JTL, potrebbe essere necessario attivare il modulo JTL-Wawi API nel centro clienti JTL (JTL-Kundencenter): verifica le condizioni attuali con JTL. - Il server dell'API è in esecuzione ed è raggiungibile dalla rete del negozio. La porta predefinita è la 5883. Consenti le connessioni in entrata su questa porta nel firewall di Windows del server (il JTL-Administrator può creare la regola per te).
- Il lettore di prezzi è nella stessa rete del server della JTL-Wawi API (oppure lo raggiunge tramite VPN).
- Un amministratore può accedere a JTL-Wawi: il lettore di prezzi si registra come app e la registrazione deve essere confermata in JTL-Wawi.
Indirizzo della JTL-Wawi API
L'indirizzo è composto dall'indirizzo IP del server, dalla porta dell'API e dal percorso /api/eazybusiness/:
https://192.168.1.10:5883/api/eazybusiness/
- Usa l'indirizzo IP del computer su cui funziona la JTL-Wawi API, non il suo nome.
- Usa
http://ohttps://a seconda di come è configurata l'istanza dell'API. Con HTTPS l'API ha di solito un certificato autofirmato: in questo caso togli la spunta da Check SSL certificate (vedi sotto). eazybusinessè il nome del database di JTL-Wawi. Se il database della tua azienda ha un nome diverso, usa quel nome nel percorso.
Puoi verificare l'indirizzo in un browser su un computer della stessa rete: https://<indirizzo>:5883/swagger dovrebbe aprire la pagina di documentazione dell'API.
Configurazione passo passo
- Apri le impostazioni, scheda Source.
- Scegli JTL-Wawi dall'elenco.
- Compila Address, App ID e App version (vedi la tabella sotto).
- Premi Generate token. Compare una finestra: Confirm app registration in JTL-Wawi (Admin → App registration).
- In JTL-Wawi apri Admin → App-Registrierung (disponibile nella nuova interfaccia di JTL-Wawi). Lì è in attesa la richiesta di HDWR Price Checker (fornitore HDWR Global, autorizzazione alla lettura degli articoli). Confermala.
- Il lettore di prezzi controlla ogni pochi secondi se la registrazione è stata confermata. Dopo la conferma compila il campo Token e mostra Token generated successfully.
- Controlla gli altri campi (azienda, paesi, interruttori di ricerca) e premi Connection test.
- Salva le impostazioni e scansiona alcuni articoli.
| Campo | Cosa inserire | Esempio |
|---|---|---|
| Address | L'indirizzo della JTL-Wawi API, vedi sopra. | https://192.168.1.10:5883/api/eazybusiness/ |
| App ID | Un nome qualsiasi che identifichi questo lettore di prezzi come app in JTL-Wawi. Obbligatorio prima di generare il token. | hdwr-pricechecker |
| App version | Un'etichetta di versione qualsiasi, obbligatoria prima di generare il token. | 1.0 |
| Token | Compilato da Generate token. Puoi anche incollare una chiave API rilasciata in JTL-Wawi per lo stesso App ID. | compilato automaticamente |
| Check SSL certificate | Lascia la spunta con un certificato attendibile; toglila con un certificato autofirmato dell'API. | ✓ |
| Search by product code (SKU) | Ricerca per numero articolo JTL (Artikelnummer). Attiva per impostazione predefinita. | ✓ |
| Search by EAN code | Ricerca per GTIN/EAN dell'articolo. Disattiva per impostazione predefinita. | ✓ |
| Company ID | L'azienda di JTL-Wawi (Firma) di cui si usano le impostazioni IVA. Di solito 1. | 1 |
| Departure country (ISO) | Paese da cui vengono vendute le merci: codice ISO di due lettere. | DE |
| Shipment country (ISO) | Paese del cliente; per un negozio, lo stesso paese del negozio. | DE |
Il token viene rilasciato per l'App ID e l'App version indicati. Se modifichi uno dei due, JTL-Wawi rifiuta il token e compare JTL-Wawi rejected the token. Check the App ID and app version or generate a new token. In questo caso genera di nuovo il token e conferma la nuova registrazione.
Se un token è già presente, Generate token chiede prima se sovrascriverlo. Se il token attuale funziona, non te ne serve uno nuovo.
Prezzo e ricerca
- Lo schermo mostra il prezzo lordo: il prezzo di vendita netto dell'articolo in JTL-Wawi moltiplicato per l'aliquota IVA e arrotondato a due decimali.
- L'aliquota IVA viene calcolata da JTL-Wawi per l'azienda, il paese di partenza e il paese di spedizione indicati: un negozio in Germania ottiene ad es. il 19 % o il 7 %, a seconda della classe fiscale dell'articolo. Gli articoli con regime del margine (Differenzbesteuerung) hanno un'aliquota dello 0 %, quindi viene mostrato il prezzo netto.
- Il prezzo è il prezzo di vendita standard dell'articolo. Non vengono usati i prezzi per gruppo di clienti (Kundengruppenpreise), i listini né i prezzi speciali (Sonderpreise).
- Search by product code (SKU) confronta il codice scansionato con il numero articolo; maiuscole e minuscole non contano.
- Search by EAN code confronta il codice scansionato esattamente con il GTIN dell'articolo.
- Se entrambi gli interruttori sono disattivati, l'app cerca per numero articolo.
Tempo di risposta
Ogni scansione è una query in tempo reale a JTL-Wawi, quindi una modifica di prezzo è visibile dalla scansione successiva. La JTL-Wawi API impiega sensibilmente più tempo di una query al database, di solito alcuni secondi per scansione, perché l'API restituisce tutti gli articoli corrispondenti al codice e l'app sceglie la corrispondenza esatta.
Con codici brevi presenti in molti articoli (ad es. un numero di tre cifre che fa parte anche di altri numeri articolo e nomi), l'app interrompe la ricerca dopo circa 40 secondi o 500 risultati e mostra Too many results - item not identified. Scansiona il codice EAN o usa numeri articolo più lunghi.
Messaggi specifici di JTL-Wawi
| Messaggio | Causa e soluzione |
|---|---|
| JTL-Wawi rejected the token. Check the App ID and app version or generate a new token. | Il token non corrisponde all'App ID o alla versione dell'app, oppure la registrazione è stata rimossa in JTL-Wawi. Genera un nuovo token. |
| The JTL-Wawi server responded with error … | L'indirizzo porta a un server, ma non alla JTL-Wawi API: ad es. manca il percorso /api/eazybusiness/ o il nome del database. |
| The server certificate is not trusted. … | L'API usa un certificato autofirmato. Togli la spunta da Check SSL certificate. |
| Cannot connect to … Check the address, the port and that the JTL-Wawi REST API is running. | Indirizzo IP o porta errati, l'istanza dell'API è ferma oppure il firewall blocca la porta 5883. |
| Tax download error | L'articolo è stato trovato, ma JTL-Wawi non ha restituito l'aliquota IVA: controlla l'ID azienda e i due codici paese. |
| Token generation failed (o un messaggio di JTL-Wawi) | La registrazione è stata rifiutata o JTL-Wawi ha restituito un errore. Controlla l'indirizzo e di usare la nuova interfaccia di JTL-Wawi per l'App-Registrierung. |
I messaggi generali sono descritti in Risoluzione dei problemi.
Aggiornamento dalla versione precedente dell'app per JTL-Wawi
Alcuni clienti hanno ricevuto una versione precedente dell'app, dedicata solo a JTL. Installando la versione attuale sopra di essa, le impostazioni di JTL-Wawi (indirizzo, App ID, token, paesi) vengono riprese automaticamente e il lettore di prezzi continua a funzionare senza una nuova configurazione. Il codice EAN sotto il prezzo resta nascosto, come nella versione precedente: puoi attivarlo nella scheda General.