JTL-Wawi
The price checker reads items and prices from JTL-Wawi through the official JTL-Wawi REST API (JTL-Wawi API). It shows the item name and the gross price: the item's net sales price plus the VAT rate that JTL-Wawi calculates for it.
Unlike Subiekt or Optima, the price checker does not connect to the SQL database — it talks to the REST server of your JTL-Wawi installation and logs in with a token issued by JTL-Wawi.
Before you start
- JTL-Wawi with the JTL-Wawi API. The REST server is part of JTL-Wawi (version 1.10 or later recommended). An API instance is created in the JTL-Administrator or with
JTL.Wawi.Rest.exe, and can run as a Windows service. Depending on your JTL contract, the JTL-Wawi API module may have to be booked in the JTL customer centre — check the current terms with JTL. - The API server is running and reachable from the store network. The default port is 5883. Allow incoming connections on this port in the Windows firewall of the server (the JTL-Administrator can create the rule for you).
- The price checker is on the same network as the JTL-Wawi API server (or reaches it over VPN).
- An administrator can log in to JTL-Wawi — the price checker registers itself as an app and the registration must be confirmed in JTL-Wawi.
Address of the JTL-Wawi API
The address consists of the server IP address, the API port and the path /api/eazybusiness/:
https://192.168.1.10:5883/api/eazybusiness/
- Use the IP address of the computer where the JTL-Wawi API runs, not its name.
- Use
http://orhttps://the same way the API instance is set up. With HTTPS the API usually has a self-signed certificate — then uncheck Check SSL certificate (see below). eazybusinessis the name of the JTL-Wawi database. If your company database has a different name, use that name in the path.
You can check the address in a browser on a computer in the same network: https://<address>:5883/swagger should open the API documentation page.
Step-by-step setup
- Open the settings, Source tab.
- Choose JTL-Wawi from the list.
- Fill in Address, App ID and App version (see the table below).
- Press Generate token. A window appears: Confirm app registration in JTL-Wawi (Admin → App registration).
- In JTL-Wawi, open Admin → App-Registrierung (available in the new JTL-Wawi interface). The request from HDWR Price Checker (provider HDWR Global, permission to read items) is waiting there. Confirm it.
- The price checker checks every few seconds whether the registration has been confirmed. After confirmation it fills in the Token field and shows Token generated successfully.
- Check the remaining fields (company, countries, search switches) and press Connection test.
- Save the settings and scan a few items.
| Field | What to enter | Example |
|---|---|---|
| Address | The address of the JTL-Wawi API, see above. | https://192.168.1.10:5883/api/eazybusiness/ |
| App ID | Any name identifying this price checker as an app in JTL-Wawi. Required before generating the token. | hdwr-pricechecker |
| App version | Any version label, required before generating the token. | 1.0 |
| Token | Filled in by Generate token. You can also paste an API key issued in JTL-Wawi for the same App ID. | filled in automatically |
| Check SSL certificate | Leave checked for a trusted certificate; uncheck for a self-signed certificate of the API. | ✓ |
| Search by product code (SKU) | Search by the JTL item number (Artikelnummer). On by default. | ✓ |
| Search by EAN code | Search by the item's GTIN/EAN. Off by default. | ✓ |
| Company ID | The JTL-Wawi company (Firma) whose VAT settings are used. Usually 1. | 1 |
| Departure country (ISO) | Country the goods are sold from — two-letter ISO code. | DE |
| Shipment country (ISO) | Country of the customer — for a store, the same country as the store. | DE |
The token is issued for the given App ID and App version. If you change either of them, JTL-Wawi rejects the token — you will see JTL-Wawi rejected the token. Check the App ID and app version or generate a new token. Then generate the token again and confirm the new registration.
If a token is already filled in, Generate token first asks whether to overwrite it. If the current token works, you do not need a new one.
Price and search
- The screen shows the gross price: the item's net sales price from JTL-Wawi multiplied by the VAT rate, rounded to two decimal places.
- The VAT rate is calculated by JTL-Wawi for the given company, departure country and shipment country — so a German store gets e.g. 19 % or 7 %, depending on the item's tax class. Items with margin taxation (Differenzbesteuerung) have a rate of 0 %, so the net price is shown.
- The price is the item's standard sales price. Customer group prices, price lists and special prices are not used.
- Search by product code (SKU) compares the scanned code with the item number; upper and lower case do not matter.
- Search by EAN code compares the scanned code with the item's GTIN exactly.
- If both switches are off, the app searches by the item number.
Response time
Each scan is a live query to JTL-Wawi, so a price change is visible from the next scan. The JTL-Wawi API takes noticeably longer than a database query — usually a few seconds per scan, because the API returns every item matching the code and the app picks the exact match.
For short codes that appear in many items (e.g. a three-digit number that is also part of other item numbers and names), the app stops searching after about 40 seconds or 500 results and shows Too many results - item not identified. Scan the EAN code or use longer item numbers.
Messages specific to JTL-Wawi
| Message | Cause and solution |
|---|---|
| JTL-Wawi rejected the token. Check the App ID and app version or generate a new token. | The token does not match the App ID or app version, or the registration was removed in JTL-Wawi. Generate a new token. |
| The JTL-Wawi server responded with error … | The address leads to a server, but not to the JTL-Wawi API, e.g. the path /api/eazybusiness/ or the database name is missing. |
| The server certificate is not trusted. … | The API uses a self-signed certificate. Uncheck Check SSL certificate. |
| Cannot connect to … Check the address, the port and that the JTL-Wawi REST API is running. | Wrong IP address or port, the API instance is stopped, or the firewall blocks port 5883. |
| Tax download error | The item was found, but JTL-Wawi did not return a VAT rate — check the company ID and the two country codes. |
| Token generation failed (or a message from JTL-Wawi) | The registration was rejected or JTL-Wawi returned an error. Check the address and that you use the new JTL-Wawi interface for App-Registrierung. |
The general messages are described in Troubleshooting.
Update from the earlier JTL-Wawi version of the app
Some customers received an earlier, JTL-only version of the app. When you install the current version over it, the JTL-Wawi settings (address, App ID, token, countries) are taken over automatically and the price checker keeps working without new configuration. The EAN code under the price stays hidden, as in the earlier version — you can switch it on in the General tab.