Saltar al contenido principal

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.exe y 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:// o https:// 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).
  • eazybusiness es 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​

  1. Abra los ajustes, pestaña Source.
  2. Elija JTL-Wawi en la lista.
  3. Rellene Address, App ID y App version (véase la tabla siguiente).
  4. Pulse Generate token. Aparece una ventana: Confirm app registration in JTL-Wawi (Admin → App registration).
  5. 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.
  6. 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.
  7. Revise los demás campos (empresa, países, interruptores de búsqueda) y pulse Connection test.
  8. Guarde los ajustes y escanee unos cuantos artículos.
CampoQué introducirEjemplo
AddressLa dirección de la JTL-Wawi API, véase más arriba.https://192.168.1.10:5883/api/eazybusiness/
App IDCualquier nombre que identifique este lector de precios como aplicación en JTL-Wawi. Obligatorio antes de generar el token.hdwr-pricechecker
App versionCualquier etiqueta de versión, obligatoria antes de generar el token.1.0
TokenLo 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 certificateDé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 codeBúsqueda por el GTIN/EAN del artículo. Desactivado de forma predeterminada.✓
Company IDLa 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
No cambie el App ID después de generar el token

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​

MensajeCausa 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 errorEl 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.

JTL-Wawi — preguntas frecuentes

¿Cómo se conecta el lector de precios HDWR a JTL-Wawi?
A través de la API REST oficial de JTL-Wawi, de forma predeterminada en el puerto 5883, en una dirección como https://192.168.1.10:5883/api/eazybusiness/. El lector de precios se registra como aplicación, un administrador lo confirma en JTL-Wawi en Admin, App-Registrierung, y el lector de precios recibe un token para leer artículos.
¿Qué precio de JTL-Wawi muestra el lector de precios?
El precio bruto: el precio de venta neto del artículo más el tipo de IVA que JTL-Wawi calcula para la empresa, el país de origen y el país de envío configurados. No se utilizan los precios por grupo de clientes ni los precios especiales.
¿Necesita el lector de precios acceso a la base de datos SQL de JTL-Wawi?
No. Solo se comunica con la JTL-Wawi API y solo solicita permiso para leer artículos. No se necesita ningún usuario SQL.
¿Por qué un escaneo tarda unos segundos con JTL-Wawi?
La JTL-Wawi API busca todos los artículos que coinciden con el código y los devuelve con sus datos, lo que tarda más que una consulta directa a la base de datos. La aplicación pide primero una lista corta, por lo que un escaneo típico dura unos segundos. Los códigos muy cortos que coinciden con cientos de artículos terminan con Too many results - item not identified.
La prueba de conexión indica un error de certificado. ¿Qué debo hacer?
La JTL-Wawi API suele utilizar un certificado HTTPS autofirmado. Desmarque Check SSL certificate en los ajustes del origen JTL-Wawi y repita la prueba.