JTL-Wawi
El lector de precios lee los artículos y los precios de JTL-Wawi a través de la API REST oficial de JTL-Wawi (JTL-Wawi API). Muestra el nombre del artículo y el precio bruto: el precio de venta neto del artículo más el tipo de IVA que JTL-Wawi calcula para él.
A diferencia de Subiekt u Optima, el lector de precios no se conecta a la base de datos SQL: se comunica con el servidor REST de su instalación de JTL-Wawi e inicia sesión con un token emitido por JTL-Wawi.
Antes de empezar
- JTL-Wawi con la JTL-Wawi API. El servidor REST forma parte de JTL-Wawi (se recomienda la versión 1.10 o posterior). La instancia de la API se crea en el JTL-Administrator o con
JTL.Wawi.Rest.exey puede funcionar como servicio de Windows. Según su contrato con JTL, es posible que tenga que contratar el módulo JTL-Wawi API en el centro de clientes de JTL (JTL-Kundencenter); consulte las condiciones vigentes con JTL. - El servidor de la API está en marcha y es accesible desde la red de la tienda. El puerto predeterminado es el 5883. Permita las conexiones entrantes en este puerto en el firewall de Windows del servidor (el JTL-Administrator puede crear la regla por usted).
- El lector de precios está en la misma red que el servidor de la JTL-Wawi API (o accede a él por VPN).
- Un administrador puede iniciar sesión en JTL-Wawi: el lector de precios se registra como aplicación y el registro debe confirmarse en JTL-Wawi.
Dirección de la JTL-Wawi API
La dirección se compone de la dirección IP del servidor, el puerto de la API y la ruta /api/eazybusiness/:
https://192.168.1.10:5883/api/eazybusiness/
- Utilice la dirección IP del equipo en el que funciona la JTL-Wawi API, no su nombre.
- Utilice
http://ohttps://según cómo esté configurada la instancia de la API. Con HTTPS la API suele tener un certificado autofirmado; en ese caso desmarque Check SSL certificate (véase más abajo). eazybusinesses el nombre de la base de datos de JTL-Wawi. Si la base de datos de su empresa tiene otro nombre, utilícelo en la ruta.
Puede comprobar la dirección en un navegador desde un equipo de la misma red: https://<dirección>:5883/swagger debería abrir la página de documentación de la API.
Configuración paso a paso
- Abra los ajustes, pestaña Source.
- Elija JTL-Wawi en la lista.
- Rellene Address, App ID y App version (véase la tabla siguiente).
- Pulse Generate token. Aparece una ventana: Confirm app registration in JTL-Wawi (Admin → App registration).
- En JTL-Wawi, abra Admin → App-Registrierung (disponible en la nueva interfaz de JTL-Wawi). Allí espera la solicitud de HDWR Price Checker (proveedor HDWR Global, permiso de lectura de artículos). Confírmela.
- El lector de precios comprueba cada pocos segundos si el registro se ha confirmado. Tras la confirmación rellena el campo Token y muestra Token generated successfully.
- Revise los demás campos (empresa, países, interruptores de búsqueda) y pulse Connection test.
- Guarde los ajustes y escanee unos cuantos artículos.
| Campo | Qué introducir | Ejemplo |
|---|---|---|
| Address | La dirección de la JTL-Wawi API, véase más arriba. | https://192.168.1.10:5883/api/eazybusiness/ |
| App ID | Cualquier nombre que identifique este lector de precios como aplicación en JTL-Wawi. Obligatorio antes de generar el token. | hdwr-pricechecker |
| App version | Cualquier etiqueta de versión, obligatoria antes de generar el token. | 1.0 |
| Token | Lo rellena Generate token. También puede pegar una clave de API emitida en JTL-Wawi para el mismo App ID. | se rellena automáticamente |
| Check SSL certificate | Déjelo marcado con un certificado de confianza; desmárquelo con un certificado autofirmado de la API. | ✓ |
| Search by product code (SKU) | Búsqueda por el número de artículo de JTL (Artikelnummer). Activado de forma predeterminada. | ✓ |
| Search by EAN code | Búsqueda por el GTIN/EAN del artículo. Desactivado de forma predeterminada. | ✓ |
| Company ID | La empresa de JTL-Wawi (Firma) cuya configuración de IVA se utiliza. Normalmente 1. | 1 |
| Departure country (ISO) | País desde el que se venden las mercancías: código ISO de dos letras. | DE |
| Shipment country (ISO) | País del cliente; en una tienda, el mismo país que el de la tienda. | DE |
El token se emite para el App ID y la App version indicados. Si cambia cualquiera de ellos, JTL-Wawi rechaza el token y verá JTL-Wawi rejected the token. Check the App ID and app version or generate a new token. En ese caso, genere de nuevo el token y confirme el nuevo registro.
Si ya hay un token, Generate token pregunta primero si desea sobrescribirlo. Si el token actual funciona, no necesita uno nuevo.
Precio y búsqueda
- La pantalla muestra el precio bruto: el precio de venta neto del artículo en JTL-Wawi multiplicado por el tipo de IVA y redondeado a dos decimales.
- El tipo de IVA lo calcula JTL-Wawi para la empresa, el país de origen y el país de envío indicados; así, una tienda en Alemania obtiene p. ej. el 19 % o el 7 %, según la clase fiscal del artículo. Los artículos con régimen de margen (Differenzbesteuerung) tienen un tipo del 0 %, por lo que se muestra el precio neto.
- El precio es el precio de venta estándar del artículo. No se utilizan los precios por grupo de clientes (Kundengruppenpreise), las listas de precios ni los precios especiales (Sonderpreise).
- Search by product code (SKU) compara el código escaneado con el número de artículo; no se distingue entre mayúsculas y minúsculas.
- Search by EAN code compara el código escaneado exactamente con el GTIN del artículo.
- Si ambos interruptores están desactivados, la aplicación busca por el número de artículo.
Tiempo de respuesta
Cada escaneo es una consulta en vivo a JTL-Wawi, de modo que un cambio de precio se ve desde el siguiente escaneo. La JTL-Wawi API tarda bastante más que una consulta a la base de datos, normalmente unos segundos por escaneo, porque la API devuelve todos los artículos que coinciden con el código y la aplicación elige la coincidencia exacta.
Con códigos cortos que aparecen en muchos artículos (p. ej. un número de tres cifras que también forma parte de otros números de artículo y nombres), la aplicación deja de buscar al cabo de unos 40 segundos o 500 resultados y muestra Too many results - item not identified. Escanee el código EAN o utilice números de artículo más largos.
Mensajes específicos de JTL-Wawi
| Mensaje | Causa y solución |
|---|---|
| JTL-Wawi rejected the token. Check the App ID and app version or generate a new token. | El token no coincide con el App ID o la versión de la aplicación, o el registro se eliminó en JTL-Wawi. Genere un token nuevo. |
| The JTL-Wawi server responded with error … | La dirección lleva a un servidor, pero no a la JTL-Wawi API; p. ej. falta la ruta /api/eazybusiness/ o el nombre de la base de datos. |
| The server certificate is not trusted. … | La API utiliza un certificado autofirmado. Desmarque Check SSL certificate. |
| Cannot connect to … Check the address, the port and that the JTL-Wawi REST API is running. | Dirección IP o puerto incorrectos, la instancia de la API está detenida o el firewall bloquea el puerto 5883. |
| Tax download error | El artículo se ha encontrado, pero JTL-Wawi no ha devuelto el tipo de IVA: compruebe el ID de empresa y los dos códigos de país. |
| Token generation failed (o un mensaje de JTL-Wawi) | El registro se ha rechazado o JTL-Wawi ha devuelto un error. Compruebe la dirección y que utiliza la nueva interfaz de JTL-Wawi para la App-Registrierung. |
Los mensajes generales se describen en Solución de problemas.
Actualización desde la versión anterior de la aplicación para JTL-Wawi
Algunos clientes recibieron una versión anterior de la aplicación, exclusiva para JTL. Al instalar la versión actual sobre ella, los ajustes de JTL-Wawi (dirección, App ID, token, países) se transfieren automáticamente y el lector de precios sigue funcionando sin necesidad de configurarlo de nuevo. El código EAN bajo el precio permanece oculto, como en la versión anterior; puede activarlo en la pestaña General.