Skip to main content

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.exe ir 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:// arba https:// taip, kaip nustatyta API instancija. Su HTTPS API paprastai turi savarankiškai pasirašytą sertifikatą — tada nužymėkite Check SSL certificate (žr. toliau).
  • eazybusiness yra 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​

  1. Atidarykite nustatymus, skirtukas Source.
  2. Sąraše pasirinkite JTL-Wawi.
  3. Užpildykite Address, App ID ir App version (žr. lentelę toliau).
  4. Paspauskite Generate token. Atsiranda langas: Confirm app registration in JTL-Wawi (Admin → App registration).
  5. 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ą.
  6. Kainų tikrintuvas kas kelias sekundes tikrina, ar registracija patvirtinta. Po patvirtinimo jis užpildo lauką Token ir parodo Token generated successfully.
  7. Patikrinkite likusius laukus (įmonė, šalys, paieškos jungikliai) ir paspauskite Connection test.
  8. Išsaugokite nustatymus ir nuskaitykite kelias prekes.
LaukasKą įvestiPavyzdys
AddressJTL-Wawi API adresas, žr. aukščiau.https://192.168.1.10:5883/api/eazybusiness/
App IDBet koks pavadinimas, identifikuojantis šį kainų tikrintuvą kaip programėlę JTL-Wawi. Privalomas prieš generuojant žetoną.hdwr-pricechecker
App versionBet koks versijos žymuo, privalomas prieš generuojant žetoną.1.0
TokenUž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 certificatePatikimam 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 codePaieška pagal prekės GTIN/EAN. Numatytai išjungta.✓
Company IDJTL-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
Sugeneravę žetoną, nekeiskite App ID

Ž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šimasPriež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 errorPrekė 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.

JTL-Wawi — DUK

Kaip HDWR kainų tikrintuvas jungiasi prie JTL-Wawi?
Per oficialią JTL-Wawi REST API, numatytai prievadu 5883, adresu, panašiu į https://192.168.1.10:5883/api/eazybusiness/. Kainų tikrintuvas užsiregistruoja kaip programėlė, administratorius ją patvirtina JTL-Wawi meniu Admin, App-Registrierung, o kainų tikrintuvas gauna žetoną prekėms skaityti.
Kokią kainą kainų tikrintuvas rodo iš JTL-Wawi?
Bruto kainą: prekės neto pardavimo kainą su PVM tarifu, kurį JTL-Wawi apskaičiuoja nustatytai įmonei, išsiuntimo šaliai ir pristatymo šaliai. Klientų grupių kainos ir specialiosios kainos nenaudojamos.
Ar kainų tikrintuvui reikia prieigos prie JTL-Wawi SQL duomenų bazės?
Ne. Jis bendrauja tik su JTL-Wawi API ir prašo tik leidimo skaityti prekes. SQL paskyros nereikia.
Kodėl su JTL-Wawi nuskaitymas trunka kelias sekundes?
JTL-Wawi API ieško visų kodą atitinkančių prekių ir grąžina jas su išsamia informacija, o tai trunka ilgiau nei tiesioginė duomenų bazės užklausa. Programėlė pirmiausia prašo trumpo sąrašo, todėl įprastas nuskaitymas trunka kelias sekundes. Labai trumpi kodai, atitinkantys šimtus prekių, baigiasi pranešimu Too many results - item not identified.
Ryšio patikra praneša apie sertifikato klaidą. Ką daryti?
JTL-Wawi API paprastai naudoja savarankiškai pasirašytą HTTPS sertifikatą. JTL-Wawi šaltinio nustatymuose nužymėkite Check SSL certificate ir paleiskite patikrą iš naujo.