¿Cómo integrarse con la API de Zelty?

Zelty es una solución digital innovadora de caja, toma de pedidos y gestión, diseñada desde el principio para digitalizar restaurantes multisede. Si tu producto da servicio al sector de la hostelería, integrarte con Zelty permite automatizaciones potentes para tus usuarios.

Integrar tu producto con la API de Zelty te permite:

Automatizar la sincronización de los datos de pedidos y los informes de ventas
Sincronizar la información de clientes y los registros de pagos entre plataformas
Minimizar la introducción manual de datos y reducir errores
Habilitar analítica en tiempo real y seguimiento del rendimiento

Esta guía cubre todo lo que necesitas saber para poner en marcha tu integración con Zelty, las mejores prácticas y casos de uso reales apoyados en la Unified POS API de Chift.

¿Qué es la API de Zelty?

Zelty ofrece una API REST construida sobre principios modernos para dar servicio a restaurantes, cafeterías y establecimientos de restauración de toda Europa. La API está diseñada específicamente para operaciones de TPV basadas en iPad y se apoya en una arquitectura de microservicios y serverless para garantizar fiabilidad y escalabilidad.

Base técnica:

Arquitectura RESTful con respuestas en JSON
Autenticación mediante API Key (basada en token)

La API de Zelty cubre un amplio abanico de datos operativos de restaurante:

Products & Categories: gestión de la carta y seguimiento del inventario
Orders & Order Lines: histórico completo de transacciones con detalle línea a línea
Customers/Contacts: datos de los comensales para sistemas de fidelización y CRM
Payments: registros de transacciones para conciliación e informes
Locations: soporte multisede para cadenas y franquicias
Closures: resúmenes financieros de cierre de turno y de jornada
Sales Reports: datos analíticos para monitorizar el rendimiento

Lo que hace a Zelty especialmente potente es su foco en el sector de la hostelería. A diferencia de los sistemas de TPV genéricos, Zelty entiende los flujos de trabajo propios de un restaurante y expone estos datos a través de endpoints de API limpios y bien estructurados.

Ejemplos de casos de uso de Zelty

Sincronización de pedidos

Las plataformas de contabilidad pueden recuperar los datos de pedidos y enviar automáticamente las transacciones diarias a los sistemas posteriores, como las herramientas de contabilidad o de reporting financiero, eliminando las exportaciones y conciliaciones manuales.

Controlar los niveles de stock

‍Los sistemas ERP pueden ahora monitorizar los platos de la carta y sus niveles de stock, marcando como no disponibles aquellos cuyos ingredientes se estén agotando. Esto evita que los clientes pidan productos que no se pueden servir y ayuda a gestionar el inventario de forma eficaz.

‍

Seguimiento por punto de venta

Las herramientas de reporting pueden recuperar los datos de ubicación de los establecimientos para estructurar las ventas por sede y monitorizar el rendimiento en toda la red de restaurantes.

Cómo configurar tu integración con la API de Zelty

Configurar una integración con la API de Zelty requiere credenciales de acceso facilitadas por Zelty.

Para crear una integración:

Debes obtener una API key de Zelty
La autenticación se realiza mediante autenticación por API key basada en token
Las API keys deben permanecer confidenciales y nunca deben compartirse públicamente ni incrustarse en aplicaciones del lado del cliente

Una vez autenticada, tu aplicación puede empezar a consumir los endpoints de Zelty pertinentes según tu caso de uso.

Primeros pasos con tu integración de la API de Zelty

Para empezar a integrarte con la API de Zelty:

Solicita a Zelty el acceso a la API y las credenciales
Define qué datos necesitas (pedidos, productos, pagos, informes, etc.)
Implementa una autenticación segura usando la API key
Desarrolla la lógica de sincronización de datos (en tiempo real o programada)
Gestiona los errores, los reintentos y la coherencia de los datos

Aunque la API es amigable para los desarrolladores, gestionar la normalización de los datos, el mantenimiento y la escalabilidad en varios sistemas de TPV puede volverse complejo muy rápido.

Nuestras recomendaciones para integrarte con Zelty

Estas son algunas buenas prácticas para garantizar una integración con Zelty fiable y segura:

Protege correctamente las API keys
Almacena las API keys de forma segura, restringe el acceso y rótalas periódicamente para reducir los riesgos de seguridad.
Respeta los límites de tasa e implementa resiliencia
Aunque no hay límites de tasa oficiales documentados, implementa siempre lógica de reintentos, estrategias de backoff y una gestión de errores elegante.
Usa la caché con criterio
Cachea los datos estáticos o semiestáticos (como los productos o las categorías) para reducir llamadas innecesarias a la API y mejorar el rendimiento.
Normaliza tu modelo de datos desde el principio
Los datos de Zelty deberían mapearse a un modelo interno coherente para simplificar las integraciones posteriores y la analítica.

¿Por qué usar la Unified pos API de Chift para conectar Zelty?

Integrarse directamente con Zelty es solo una parte del reto. Mantener varias integraciones de TPV con distintos proveedores resulta costoso y consume mucho tiempo.

Con la Unified POS API de Chift, puedes:

Conectarte a Zelty y a otros sistemas de TPV a través de una única API
Acceder a datos de TPV normalizados y estandarizados
Reducir el esfuerzo de desarrollo y mantenimiento
Escalar más rápido en varios mercados y con varios proveedores de TPV
Centrarte en tu producto en lugar de en las particularidades de cada TPV

Chift se encarga de la fragmentación técnica para que tú no tengas que hacerlo.

Preguntas frecuentes sobre la integración con la API de Zelty

¿Cómo empiezo con Zelty?

Para empezar, necesitas solicitar el acceso a la API a Zelty y obtener una API key. A partir de ahí, puedes crear una integración directa o usar la Unified POS API de Chift para conectarte más rápido y a escala.

¿Cuáles son los límites de tasa de la API de Zelty?

Zelty no documenta públicamente límites de tasa específicos para su API.