Passa al contenuto principale

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.exe e 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:// o https:// 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​

  1. Apri le impostazioni, scheda Source.
  2. Scegli JTL-Wawi dall'elenco.
  3. Compila Address, App ID e App version (vedi la tabella sotto).
  4. Premi Generate token. Compare una finestra: Confirm app registration in JTL-Wawi (Admin → App registration).
  5. 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.
  6. 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.
  7. Controlla gli altri campi (azienda, paesi, interruttori di ricerca) e premi Connection test.
  8. Salva le impostazioni e scansiona alcuni articoli.
CampoCosa inserireEsempio
AddressL'indirizzo della JTL-Wawi API, vedi sopra.https://192.168.1.10:5883/api/eazybusiness/
App IDUn nome qualsiasi che identifichi questo lettore di prezzi come app in JTL-Wawi. Obbligatorio prima di generare il token.hdwr-pricechecker
App versionUn'etichetta di versione qualsiasi, obbligatoria prima di generare il token.1.0
TokenCompilato da Generate token. Puoi anche incollare una chiave API rilasciata in JTL-Wawi per lo stesso App ID.compilato automaticamente
Check SSL certificateLascia 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 codeRicerca per GTIN/EAN dell'articolo. Disattiva per impostazione predefinita.✓
Company IDL'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
Non modificare l'App ID dopo aver generato il token

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​

MessaggioCausa 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 errorL'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.

JTL-Wawi — FAQ

Come si collega il lettore di prezzi HDWR a JTL-Wawi?
Tramite la REST API ufficiale di JTL-Wawi, per impostazione predefinita sulla porta 5883, a un indirizzo come https://192.168.1.10:5883/api/eazybusiness/. Il lettore di prezzi si registra come app, un amministratore la conferma in JTL-Wawi in Admin, App-Registrierung, e il lettore riceve un token per leggere gli articoli.
Quale prezzo di JTL-Wawi mostra il lettore di prezzi?
Il prezzo lordo: il prezzo di vendita netto dell'articolo più l'aliquota IVA che JTL-Wawi calcola per l'azienda, il paese di partenza e il paese di spedizione impostati. I prezzi per gruppo di clienti e i prezzi speciali non vengono usati.
Il lettore di prezzi ha bisogno dell'accesso al database SQL di JTL-Wawi?
No. Comunica solo con la JTL-Wawi API e chiede solo l'autorizzazione a leggere gli articoli. Non serve alcun login SQL.
Perché con JTL-Wawi una scansione richiede alcuni secondi?
La JTL-Wawi API cerca tutti gli articoli corrispondenti al codice e li restituisce con i loro dati, il che richiede più tempo di una query diretta al database. L'app chiede prima un elenco breve, quindi una scansione tipica dura alcuni secondi. I codici molto brevi che corrispondono a centinaia di articoli terminano con Too many results - item not identified.
Il test di connessione segnala un errore di certificato. Cosa devo fare?
La JTL-Wawi API usa di solito un certificato HTTPS autofirmato. Togli la spunta da Check SSL certificate nelle impostazioni della fonte JTL-Wawi ed esegui di nuovo il test.