JTL-Wawi
Verificatorul de preț citește articolele și prețurile din JTL-Wawi prin JTL-Wawi REST API oficial (JTL-Wawi API). Afișează denumirea articolului și prețul brut: prețul de vânzare net al articolului plus cota de TVA pe care JTL-Wawi o calculează pentru el.
Spre deosebire de Subiekt sau Optima, verificatorul de preț nu se conectează la baza de date SQL — comunică cu serverul REST al instalării tale JTL-Wawi și se autentifică cu un token emis de JTL-Wawi.
Înainte de a începe
- JTL-Wawi cu JTL-Wawi API. Serverul REST face parte din JTL-Wawi (recomandat: versiunea 1.10 sau mai nouă). O instanță API se creează în JTL-Administrator sau cu
JTL.Wawi.Rest.exeși poate rula ca serviciu Windows. În funcție de contractul tău cu JTL, este posibil ca modulul JTL-Wawi API să trebuiască rezervat în centrul pentru clienți JTL — verifică condițiile actuale la JTL. - Serverul API rulează și este accesibil din rețeaua magazinului. Portul implicit este 5883. Permite conexiunile de intrare pe acest port în firewall-ul Windows al serverului (JTL-Administrator poate crea regula pentru tine).
- Verificatorul de preț este în aceeași rețea cu serverul JTL-Wawi API (sau ajunge la el prin VPN).
- Un administrator se poate autentifica în JTL-Wawi — verificatorul de preț se înregistrează ca aplicație, iar înregistrarea trebuie confirmată în JTL-Wawi.
Adresa JTL-Wawi API
Adresa este formată din adresa IP a serverului, portul API și calea /api/eazybusiness/:
https://192.168.1.10:5883/api/eazybusiness/
- Folosește adresa IP a calculatorului pe care rulează JTL-Wawi API, nu numele lui.
- Folosește
http://sauhttps://la fel cum este configurată instanța API. Cu HTTPS, API-ul are de obicei un certificat autosemnat — atunci debifează Check SSL certificate (vezi mai jos). eazybusinesseste numele bazei de date JTL-Wawi. Dacă baza de date a firmei tale are alt nume, folosește acel nume în cale.
Poți verifica adresa într-un browser, pe un calculator din aceeași rețea: https://<address>:5883/swagger ar trebui să deschidă pagina de documentație a API-ului.
Configurare pas cu pas
- Deschide setările, fila Source.
- Alege JTL-Wawi din listă.
- Completează Address, App ID și App version (vezi tabelul de mai jos).
- Apasă Generate token. Apare o fereastră: Confirm app registration in JTL-Wawi (Admin → App registration).
- În JTL-Wawi, deschide Admin → App-Registrierung (disponibil în noua interfață JTL-Wawi). Acolo așteaptă cererea de la HDWR Price Checker (furnizor HDWR Global, permisiune de citire a articolelor). Confirm-o.
- Verificatorul de preț verifică la fiecare câteva secunde dacă înregistrarea a fost confirmată. După confirmare, completează câmpul Token și afișează Token generated successfully.
- Verifică celelalte câmpuri (firma, țările, comutatoarele de căutare) și apasă Connection test.
- Salvează setările și scanează câteva articole.
| Câmp | Ce introduci | Exemplu |
|---|---|---|
| Address | Adresa JTL-Wawi API, vezi mai sus. | https://192.168.1.10:5883/api/eazybusiness/ |
| App ID | Orice nume care identifică acest verificator de preț ca aplicație în JTL-Wawi. Obligatoriu înainte de generarea tokenului. | hdwr-pricechecker |
| App version | Orice etichetă de versiune, obligatorie înainte de generarea tokenului. | 1.0 |
| Token | Se completează prin Generate token. Poți lipi și o cheie API emisă în JTL-Wawi pentru același App ID. | se completează automat |
| Check SSL certificate | Lasă bifat pentru un certificat de încredere; debifează pentru un certificat autosemnat al API-ului. | ✓ |
| Search by product code (SKU) | Căutare după numărul articolului JTL (Artikelnummer). Activat implicit. | ✓ |
| Search by EAN code | Căutare după GTIN/EAN al articolului. Dezactivat implicit. | ✓ |
| Company ID | Firma (Firma) din JTL-Wawi ale cărei setări de TVA sunt folosite. De obicei 1. | 1 |
| Departure country (ISO) | Țara din care se vând mărfurile — cod ISO din două litere. | DE |
| Shipment country (ISO) | Țara clientului — pentru un magazin, aceeași țară în care se află magazinul. | DE |
Tokenul este emis pentru App ID și App version introduse. Dacă modifici oricare dintre ele, JTL-Wawi respinge tokenul — vei vedea JTL-Wawi rejected the token. Check the App ID and app version or generate a new token. Atunci generează din nou tokenul și confirmă noua înregistrare.
Dacă un token este deja completat, Generate token întreabă mai întâi dacă să îl suprascrie. Dacă tokenul actual funcționează, nu ai nevoie de unul nou.
Preț și căutare
- Ecranul afișează prețul brut: prețul de vânzare net al articolului din JTL-Wawi înmulțit cu cota de TVA și rotunjit la două zecimale.
- Cota de TVA este calculată de JTL-Wawi pentru firma, țara de expediere și țara de livrare introduse — astfel, un magazin din Germania primește de exemplu 19 % sau 7 %, în funcție de clasa fiscală a articolului. Articolele cu regim special de impozitare a marjei (Differenzbesteuerung) au cota 0 %, deci se afișează prețul net.
- Prețul este prețul de vânzare standard al articolului. Prețurile pe grupe de clienți, listele de prețuri și prețurile speciale nu sunt folosite.
- Search by product code (SKU) compară codul scanat cu numărul articolului; literele mari și mici nu contează.
- Search by EAN code compară codul scanat exact cu GTIN-ul articolului.
- Dacă ambele comutatoare sunt dezactivate, aplicația caută după numărul articolului.
Timpul de răspuns
Fiecare scanare este o interogare directă către JTL-Wawi, deci o modificare de preț este vizibilă de la următoarea scanare. JTL-Wawi API răspunde vizibil mai lent decât o interogare a bazei de date — de obicei câteva secunde pe scanare, deoarece API-ul returnează toate articolele care corespund codului, iar aplicația alege potrivirea exactă.
Pentru codurile scurte care apar în multe articole (de exemplu un număr de trei cifre care face parte și din alte numere și denumiri de articole), aplicația oprește căutarea după aproximativ 40 de secunde sau 500 de rezultate și afișează Too many results - item not identified. Scanează codul EAN sau folosește numere de articol mai lungi.
Mesaje specifice JTL-Wawi
| Mesaj | Cauză și soluție |
|---|---|
| JTL-Wawi rejected the token. Check the App ID and app version or generate a new token. | Tokenul nu corespunde App ID-ului sau versiunii aplicației, ori înregistrarea a fost eliminată în JTL-Wawi. Generează un token nou. |
| The JTL-Wawi server responded with error … | Adresa duce la un server, dar nu la JTL-Wawi API, de exemplu lipsește calea /api/eazybusiness/ sau numele bazei de date. |
| The server certificate is not trusted. … | API-ul folosește un certificat autosemnat. Debifează Check SSL certificate. |
| Cannot connect to … Check the address, the port and that the JTL-Wawi REST API is running. | Adresă IP sau port greșit, instanța API este oprită sau firewall-ul blochează portul 5883. |
| Tax download error | Articolul a fost găsit, dar JTL-Wawi nu a returnat o cotă de TVA — verifică ID-ul firmei și cele două coduri de țară. |
| Token generation failed (sau un mesaj de la JTL-Wawi) | Înregistrarea a fost respinsă sau JTL-Wawi a returnat o eroare. Verifică adresa și dacă folosești noua interfață JTL-Wawi pentru App-Registrierung. |
Mesajele generale sunt descrise în Depanare.
Actualizare de la versiunea anterioară a aplicației pentru JTL-Wawi
Unii clienți au primit o versiune anterioară a aplicației, destinată doar pentru JTL. Când instalezi versiunea actuală peste ea, setările JTL-Wawi (adresa, App ID, tokenul, țările) sunt preluate automat, iar verificatorul de preț funcționează în continuare fără o nouă configurare. Codul EAN de sub preț rămâne ascuns, ca în versiunea anterioară — îl poți activa în fila General.