JTL-Wawi
Kainų tikrintuvas nuskaito prekes ir kainas iš JTL-Wawi per oficialią JTL-Wawi REST API (JTL-Wawi API). Jis rodo prekės pavadinimą ir bruto kainą: prekės neto pardavimo kainą su PVM tarifu, kurį jai apskaičiuoja JTL-Wawi.
Kitaip nei su Subiekt ar Optima, kainų tikrintuvas nesijungia prie SQL duomenų bazės — jis bendrauja su jūsų JTL-Wawi diegimo REST serveriu ir prisijungia JTL-Wawi išduotu žetonu (token).
Prieš pradedant
- JTL-Wawi su JTL-Wawi API. REST serveris yra JTL-Wawi dalis (rekomenduojama 1.10 ar naujesnė versija). API instancija sukuriama JTL-Administrator arba su
JTL.Wawi.Rest.exeir gali veikti kaip „Windows“ paslauga. Priklausomai nuo jūsų sutarties su JTL, modulį JTL-Wawi API gali tekti užsisakyti JTL klientų centre — galiojančias sąlygas pasitikslinkite JTL. - API serveris veikia ir yra pasiekiamas iš parduotuvės tinklo. Numatytasis prievadas yra 5883. Serverio „Windows“ ugniasienėje leiskite gaunamus ryšius šiuo prievadu (taisyklę už jus gali sukurti JTL-Administrator).
- Kainų tikrintuvas yra tame pačiame tinkle kaip JTL-Wawi API serveris (arba jį pasiekia per VPN).
- Administratorius gali prisijungti prie JTL-Wawi — kainų tikrintuvas užsiregistruoja kaip programėlė, o registraciją reikia patvirtinti JTL-Wawi.
JTL-Wawi API adresas
Adresą sudaro serverio IP adresas, API prievadas ir kelias /api/eazybusiness/:
https://192.168.1.10:5883/api/eazybusiness/
- Naudokite kompiuterio, kuriame veikia JTL-Wawi API, IP adresą, o ne jo pavadinimą.
- Naudokite
http://arbahttps://taip, kaip nustatyta API instancija. Su HTTPS API paprastai turi savarankiškai pasirašytą sertifikatą — tada nužymėkite Check SSL certificate (žr. toliau). eazybusinessyra JTL-Wawi duomenų bazės pavadinimas. Jei jūsų įmonės duomenų bazė vadinasi kitaip, kelyje naudokite tą pavadinimą.
Adresą galite patikrinti naršyklėje kompiuteryje tame pačiame tinkle: https://<address>:5883/swagger turėtų atidaryti API dokumentacijos puslapį.
Nustatymas žingsnis po žingsnio
- Atidarykite nustatymus, skirtukas Source.
- Sąraše pasirinkite JTL-Wawi.
- Užpildykite Address, App ID ir App version (žr. lentelę toliau).
- Paspauskite Generate token. Atsiranda langas: Confirm app registration in JTL-Wawi (Admin → App registration).
- JTL-Wawi atidarykite Admin → App-Registrierung (pasiekiama naujojoje JTL-Wawi sąsajoje). Ten laukia HDWR Price Checker užklausa (tiekėjas HDWR Global, leidimas skaityti prekes). Patvirtinkite ją.
- Kainų tikrintuvas kas kelias sekundes tikrina, ar registracija patvirtinta. Po patvirtinimo jis užpildo lauką Token ir parodo Token generated successfully.
- Patikrinkite likusius laukus (įmonė, šalys, paieškos jungikliai) ir paspauskite Connection test.
- Išsaugokite nustatymus ir nuskaitykite kelias prekes.
| Laukas | Ką įvesti | Pavyzdys |
|---|---|---|
| Address | JTL-Wawi API adresas, žr. aukščiau. | https://192.168.1.10:5883/api/eazybusiness/ |
| App ID | Bet koks pavadinimas, identifikuojantis šį kainų tikrintuvą kaip programėlę JTL-Wawi. Privalomas prieš generuojant žetoną. | hdwr-pricechecker |
| App version | Bet koks versijos žymuo, privalomas prieš generuojant žetoną. | 1.0 |
| Token | Užpildomas mygtuku Generate token. Taip pat galite įklijuoti JTL-Wawi išduotą API raktą tam pačiam App ID. | užpildoma automatiškai |
| Check SSL certificate | Patikimam sertifikatui palikite pažymėtą; savarankiškai pasirašytam API sertifikatui nužymėkite. | ✓ |
| Search by product code (SKU) | Paieška pagal JTL prekės numerį (Artikelnummer). Numatytai įjungta. | ✓ |
| Search by EAN code | Paieška pagal prekės GTIN/EAN. Numatytai išjungta. | ✓ |
| Company ID | JTL-Wawi įmonė (Firma), kurios PVM nustatymai naudojami. Paprastai 1. | 1 |
| Departure country (ISO) | Šalis, iš kurios parduodamos prekės — dviejų raidžių ISO kodas. | DE |
| Shipment country (ISO) | Pirkėjo šalis — parduotuvei ta pati šalis, kurioje yra parduotuvė. | DE |
Žetonas išduodamas nurodytam App ID ir App version. Jei pakeisite bet kurį iš jų, JTL-Wawi žetoną atmes — pamatysite JTL-Wawi rejected the token. Check the App ID and app version or generate a new token. Tada sugeneruokite žetoną iš naujo ir patvirtinkite naują registraciją.
Jei žetonas jau įvestas, Generate token pirmiausia paklausia, ar jį perrašyti. Jei dabartinis žetonas veikia, naujo nereikia.
Kaina ir paieška
- Ekrane rodoma bruto kaina: prekės neto pardavimo kaina iš JTL-Wawi, padauginta iš PVM tarifo ir suapvalinta iki dviejų skaičių po kablelio.
- PVM tarifą JTL-Wawi apskaičiuoja nurodytai įmonei, išsiuntimo šaliai ir pristatymo šaliai — taigi Vokietijos parduotuvė gauna, pvz., 19 % arba 7 %, priklausomai nuo prekės mokesčių klasės. Prekėms, apmokestinamoms pagal maržos schemą (Differenzbesteuerung), tarifas yra 0 %, todėl rodoma neto kaina.
- Kaina yra standartinė prekės pardavimo kaina. Klientų grupių kainos, kainoraščiai ir specialiosios kainos nenaudojamos.
- Search by product code (SKU) palygina nuskaitytą kodą su prekės numeriu; didžiosios ir mažosios raidės nesvarbu.
- Search by EAN code palygina nuskaitytą kodą su prekės GTIN tiksliai.
- Jei abu jungikliai išjungti, programėlė ieško pagal prekės numerį.
Atsako laikas
Kiekvienas nuskaitymas yra tiesioginė užklausa į JTL-Wawi, todėl kainos pasikeitimas matomas jau nuo kito nuskaitymo. JTL-Wawi API atsako pastebimai lėčiau nei duomenų bazės užklausa — paprastai kelias sekundes vienam nuskaitymui, nes API grąžina visas kodą atitinkančias prekes, o programėlė iš jų išrenka tikslų atitikmenį.
Trumpiems kodams, kurie pasitaiko daugelyje prekių (pvz., triženklis skaičius, kuris yra ir kitų prekių numerių bei pavadinimų dalis), programėlė maždaug po 40 sekundžių arba 500 rezultatų nutraukia paiešką ir parodo Too many results - item not identified. Nuskaitykite EAN kodą arba naudokite ilgesnius prekių numerius.
JTL-Wawi būdingi pranešimai
| Pranešimas | Priežastis ir sprendimas |
|---|---|
| JTL-Wawi rejected the token. Check the App ID and app version or generate a new token. | Žetonas neatitinka App ID arba programėlės versijos, arba registracija JTL-Wawi buvo pašalinta. Sugeneruokite naują žetoną. |
| The JTL-Wawi server responded with error … | Adresas veda į serverį, bet ne į JTL-Wawi API, pvz., trūksta kelio /api/eazybusiness/ arba duomenų bazės pavadinimo. |
| The server certificate is not trusted. … | API naudoja savarankiškai pasirašytą sertifikatą. Nužymėkite Check SSL certificate. |
| Cannot connect to … Check the address, the port and that the JTL-Wawi REST API is running. | Neteisingas IP adresas arba prievadas, API instancija sustabdyta arba ugniasienė blokuoja prievadą 5883. |
| Tax download error | Prekė rasta, bet JTL-Wawi negrąžino PVM tarifo — patikrinkite įmonės ID ir abu šalių kodus. |
| Token generation failed (arba JTL-Wawi pranešimas) | Registracija atmesta arba JTL-Wawi grąžino klaidą. Patikrinkite adresą ir ar App-Registrierung atliekate naujojoje JTL-Wawi sąsajoje. |
Bendrieji pranešimai aprašyti skyriuje Trikčių šalinimas.
Atnaujinimas iš ankstesnės JTL-Wawi programėlės versijos
Kai kurie klientai gavo ankstesnę, tik JTL skirtą programėlės versiją. Kai ant jos įdiegiate dabartinę versiją, JTL-Wawi nustatymai (adresas, App ID, žetonas, šalys) perimami automatiškai ir kainų tikrintuvas veikia toliau be naujos konfigūracijos. EAN kodas po kaina lieka paslėptas, kaip ankstesnėje versijoje — jį galite įjungti skirtuke General.