Visión general de integraciones

Eaternity Forecast se integra con vuestros sistemas de restaurante existentes para recopilar automáticamente datos de ventas y entregar predicciones. Esta guía explica las opciones de integración disponibles y os ayuda a elegir el enfoque adecuado.

Opciones de integración

1. Asociación con Necta (Recomendada)

Ideal para: Clientes existentes del sistema de planificación de recursos empresariales Necta

Eaternity Forecast se lanza exclusivamente con Necta, nuestro socio estratégico de planificación de recursos empresariales para cocinas profesionales.

Beneficios clave:

✅ Cero trabajo de integración — Conexión preconstruida
✅ Sincronización automática de datos — Los datos de ventas fluyen sin problemas
✅ Interfaz nativa — Las predicciones aparecen en las herramientas de planificación familiares de Necta
✅ Flujo de trabajo unificado — Sin cambio de sistema para los equipos de cocina

Tiempo de configuración: 1-2 semanas desde la solicitud de activación

Más información sobre la integración con Necta →

2. Integración de interfaz de programación de aplicaciones personalizada

Ideal para: Operaciones con recursos técnicos y sistemas que no son Necta

Conectaos directamente a través de nuestra interfaz de programación de aplicaciones REST para total flexibilidad.

Funcionalidades clave:

✅ Interfaz de programación de aplicaciones REST estándar — HTTP/JSON estándar de la industria
✅ OAuth 2.0 o claves de interfaz de programación de aplicaciones — Autenticación segura
✅ Predicciones en tiempo real — Acceso a pronósticos de forma programática
✅ Soporte de ganchos web — Recibid actualizaciones automáticamente

Tiempo de configuración: 2-6 semanas dependiendo de la complejidad

Ver guía de integración de interfaz de programación de aplicaciones personalizada →

3. Carga manual de datos

Ideal para: Evaluación inicial u operaciones más pequeñas

Cargad datos de ventas manualmente para pruebas simplificadas.

Proceso:

Exportad ventas desde vuestro punto de venta semanalmente
Cargad CSV/Excel al portal seguro
Recibid predicciones vía correo electrónico/panel de control

Tiempo de configuración: 1 semana

Limitación: No apto para uso en producción a largo plazo

Ved la guía de configuración rápida →

Arquitectura de integración

Visión general del flujo de datos

Vuestro sistema de punto de venta/planificación de recursos empresariales
        ↓
    [Exportación de datos de ventas]
        ↓
Interfaz de programación de aplicaciones de Eaternity Forecast
        ↓
  [Procesamiento de red neuronal]
        ↓
 [Predicciones diarias generadas]
        ↓
    [Capa de entrega]
        ↓
Vuestro sistema de planificación/Panel de control

Intercambio de datos requerido

Saliente (Vuestro sistema → Forecast)

Datos de ventas diarios (automatizado o manual):

Campos requeridos:

Fecha (AAAA-MM-DD)
Nombre/ID del artículo
Cantidad vendida
Período de servicio (opcional pero recomendado)

Opcionales pero valiosos:

Precio
Categoría
Condiciones meteorológicas
Eventos especiales

Opciones de formato:

JSON vía interfaz de programación de aplicaciones REST
Carga de archivo CSV
Hoja de cálculo Excel
Conexión directa a base de datos (personalizado)

Entrante (Forecast → Vuestro sistema)

Predicciones diarias (entrega automatizada):

Datos proporcionados:

Fecha (próximos 7 días)
Nombre/ID del artículo
Cantidad predicha
Límite inferior (percentil 10)
Límite superior (percentil 90)
Puntuación de confianza
Precisión histórica

Opciones de entrega:

Puntos finales de interfaz de programación de aplicaciones REST (pull)
Notificaciones de ganchos web (push)
Informes por correo electrónico
Interfaz del panel de control

Elegir vuestro método de integración

Matriz de decisión

Factor	Integración Necta	Interfaz de programación de aplicaciones personalizada	Carga manual
Complejidad de configuración	Muy baja	Media-Alta	Baja
Recursos técnicos	No requeridos	Desarrollador necesario	Conocimientos básicos de Excel
Nivel de automatización	Completo	Completo (una vez construido)	Manual
Mantenimiento continuo	Cero	Bajo	Medio (trabajo semanal)
Frescura de datos	Tiempo real	Tiempo real	Semanal
Escalabilidad	Excelente	Excelente	Limitada
Ideal para	Clientes de Necta	Sistemas de punto de venta personalizados	Pruebas iniciales

Guía de selección de integración

Elegid la integración con Necta si:

✅ Sois cliente existente de Necta
✅ Queréis la configuración más rápida y fácil
✅ Preferís cero trabajo técnico
✅ Queréis integración fluida en el flujo de trabajo

Elegid la interfaz de programación de aplicaciones personalizada si:

✅ Usáis un sistema de planificación de recursos empresariales/punto de venta diferente
✅ Tenéis recursos de desarrollo técnico
✅ Necesitáis integración personalizada con vuestro flujo de trabajo
✅ Queréis control total sobre el intercambio de datos

Elegid la carga manual si:

✅ Estáis evaluando Forecast inicialmente
✅ No tenéis acceso a la interfaz de programación de aplicaciones de vuestro punto de venta
✅ Tenéis recursos técnicos limitados
✅ Podéis comprometeros a cargas manuales semanales

Métodos de autenticación

OAuth 2.0 (Recomendado para interfaz de programación de aplicaciones)

Ideal para: Acceso delegado seguro

Flujo:

Vuestro sistema redirige al usuario a la página de autenticación de Eaternity
El usuario concede permiso
Eaternity emite un token de acceso
Vuestro sistema usa el token para solicitudes a la interfaz de programación de aplicaciones

Beneficios:

Seguridad estándar de la industria
Expiración y renovación de tokens
Permisos específicos de usuario
Registro de auditoría de acceso

Contactad con soporte para implementación de OAuth 2.0 →

Claves de interfaz de programación de aplicaciones

Ideal para: Integración servidor a servidor

Configuración:

Generar clave de interfaz de programación de aplicaciones en el panel de control de Forecast
Almacenar de forma segura en vuestro sistema
Incluir en las cabeceras de solicitud de la interfaz de programación de aplicaciones

Uso:

curl -X GET "https://api.eaternity.org/v1/forecast/predictions?date=2024-01-20" \
  -H "Authorization: Bearer your_api_key_here"

Beneficios:

Implementación simple
Adecuado para scripts automatizados
Fácil de rotar/revocar

Autenticación básica

Ideal para: Solo desarrollo y pruebas

No recomendado para producción debido a limitaciones de seguridad.

Formatos de datos

Envío de datos de ventas

Formato JSON (preferido para interfaz de programación de aplicaciones):

{
  "kitchen_id": "your_kitchen_id",
  "date": "2024-01-19",
  "service_periods": [
    {
      "period": "lunch",
      "items": [
        {
          "item_id": "pasta_carbonara",
          "name": "Pasta Carbonara",
          "quantity_sold": 52,
          "price": 14.50,
          "category": "Main Course"
        },
        {
          "item_id": "caesar_salad",
          "name": "Caesar Salad",
          "quantity_sold": 31,
          "price": 9.00,
          "category": "Starter"
        }
      ]
    }
  ]
}

Formato CSV (carga manual):

date,item_id,item_name,quantity_sold,service_period,price,category
2024-01-19,pasta_carbonara,Pasta Carbonara,52,lunch,14.50,Main Course
2024-01-19,caesar_salad,Caesar Salad,31,lunch,9.00,Starter
2024-01-19,grilled_salmon,Grilled Salmon,28,lunch,18.50,Main Course

Recuperación de predicciones

Formato JSON (respuesta de interfaz de programación de aplicaciones):

{
  "kitchen_id": "your_kitchen_id",
  "generated_at": "2024-01-20T03:15:42Z",
  "predictions": [
    {
      "date": "2024-01-20",
      "day_of_week": "Saturday",
      "items": [
        {
          "item_id": "pasta_carbonara",
          "name": "Pasta Carbonara",
          "predicted_quantity": 52,
          "confidence_interval": {
            "lower": 48,
            "upper": 56
          },
          "confidence_score": 0.92,
          "accuracy_last_30_days": 94.2
        }
      ]
    }
  ]
}

Requisitos del sistema

Requisitos técnicos

Para integración de interfaz de programación de aplicaciones

Vuestro sistema debe soportar:

Solicitudes HTTPS (TLS 1.2 o superior)
Análisis JSON
Autenticación OAuth 2.0 o clave de interfaz de programación de aplicaciones
Tareas programadas (trabajos cron o equivalente)

Recomendado:

Capacidad de punto final de ganchos web
Registro y monitorización de errores
Lógica de reintento automático
Validación de datos

Para carga manual

Vuestro sistema debe soportar:

Exportación CSV o Excel desde el punto de venta
Selección de rango de fechas para exportaciones
Datos de transacciones a nivel de artículo

Requisitos de red

Acceso saliente:

Punto final de interfaz de programación de aplicaciones: https://api.eaternity.org
Puertos: 443 (HTTPS)
Sin restricciones de proxy en llamadas a la interfaz de programación de aplicaciones

Configuración de cortafuegos:

Permitir HTTPS saliente a *.eaternity.org
(Opcional) Permitir ganchos web entrantes desde IPs de Eaternity

Lista blanca de IPs (si es necesario): Contactad con soporte para las IPs actuales del servidor de interfaz de programación de aplicaciones de Eaternity

Requisitos de datos

Datos históricos mínimos:

30 días de datos de ventas para entrenamiento
Registros diarios (sin lagunas de más de 2 días consecutivos)
Cantidades a nivel de artículo (no solo ingresos)

Datos históricos recomendados:

Más de 90 días para precisión óptima
Datos meteorológicos del mismo período
Anotaciones del calendario de eventos

Ved la guía de configuración rápida →

Flujo de trabajo de integración

Fase 1: Planificación (Semana 1)

Actividades:

Elegir método de integración según la matriz de decisión
Revisar requisitos técnicos para vuestro método elegido
Asignar recursos del equipo (contacto técnico, enlace de cocina)
Programar llamada de inicio con el equipo de integración de Eaternity

Entregables:

Documento del plan de integración
Contacto técnico asignado
Cronograma acordado

Fase 2: Configuración (Semana 2-3)

Actividades:

Configuración de credenciales — Claves de interfaz de programación de aplicaciones o configuración de OAuth
Configuración de puntos finales — URLs de interfaz de programación de aplicaciones, objetivos de ganchos web
Mapeo de datos — Hacer coincidir vuestros IDs de artículos con los artículos de pronóstico
Exportación de datos históricos — Preparar conjunto de datos de entrenamiento

Entregables:

Autenticación funcionando
Datos de prueba enviados con éxito
Datos históricos importados

Fase 3: Pruebas (Semana 3-4)

Actividades:

Validación de datos — Verificar formato y calidad
Pruebas de integración — Flujo de datos automatizado
Pruebas de predicción — Recibir y validar pronósticos
Manejo de errores — Probar escenarios de fallo

Entregables:

Informe de calidad de datos aprobado
Sincronización automatizada funcionando
Primeras predicciones de prueba recibidas

Fase 4: Entrenamiento (Semana 4-5)

Actividades:

Entrenamiento del modelo — La red neuronal aprende vuestros patrones
Validación de precisión — Comparar con línea base
Formación del equipo — El personal de cocina aprende a usar predicciones
Documentación del proceso — Documentar vuestro flujo de trabajo

Entregables:

Entrenamiento del modelo completo
Puntos de referencia de precisión inicial establecidos
Equipo formado en el sistema

Fase 5: Producción (Semana 6+)

Actividades:

Puesta en marcha — Comenzar a usar predicciones diariamente
Monitorización — Rastrear precisión y problemas
Optimización — Refinar según comentarios
Mejora continua — Reentrenamiento semanal del modelo

Entregables:

Predicciones diarias en uso de producción
Monitorización de rendimiento implementada
Bucle de comentarios establecido

Soporte de integración

Recursos disponibles

Documentación:

Soporte técnico:

Correo electrónico: forecast@eaternity.org
Tiempo de respuesta: 24 horas para preguntas de integración
Soporte telefónico: Para problemas críticos de producción

Asistencia de integración:

Llamadas de consulta de configuración
Revisión técnica del código de integración
Validación de calidad de datos
Orientación para optimización de rendimiento

Escenarios de integración comunes

Escenario 1: Cadena de restaurantes con punto de venta central

Configuración:

Sistema de punto de venta central (Toast, Square, etc.)
Múltiples ubicaciones
Menú estandarizado entre ubicaciones

Enfoque recomendado:

Integración de interfaz de programación de aplicaciones única a nivel de punto de venta
Predicciones específicas por ubicación vía parámetro location_id
Mapeo de artículos del menú compartido
Panel de control de gestión central

Cronograma: 3-4 semanas para la primera ubicación, 1-2 semanas por ubicación adicional

Escenario 2: Restaurante independiente con Necta

Configuración:

Ubicación única
Planificación de recursos empresariales Necta ya en uso
Gerente de cocina familiarizado con Necta

Enfoque recomendado:

Activar integración Necta-Forecast
Sincronización automática de datos desde datos existentes de Necta
Predicciones visibles en la interfaz de planificación de Necta

Cronograma: 1-2 semanas en total

Escenario 3: Servicio de alimentación hospitalario con planificación de recursos empresariales personalizado

Configuración:

Gran institución con planificación de recursos empresariales personalizado
Departamento de informática disponible
Menú complejo con restricciones dietéticas

Enfoque recomendado:

Integración de interfaz de programación de aplicaciones personalizada por el equipo de informática
Mapear variantes dietéticas a categorías de artículos
Notificaciones de ganchos web para predicciones diarias
Integración con gestión de inventario

Cronograma: 4-6 semanas incluyendo desarrollo de informática

Escenario 4: Comedor universitario con punto de venta heredado

Configuración:

Sistema de punto de venta antiguo con interfaz de programación de aplicaciones limitada
Recursos de informática limitados
Efectos del calendario académico

Enfoque recomendado:

Exportación manual de CSV desde el punto de venta (semanal)
Carga a través del portal seguro
Entrega de predicciones por correo electrónico
Futura migración a interfaz de programación de aplicaciones cuando haya recursos disponibles

Cronograma: 1 semana para configuración del proceso manual

Seguridad y cumplimiento

Seguridad de datos

Transmisión:

Todos los datos cifrados en tránsito (TLS 1.2+)
Validación de certificados obligatoria
HTTP sin cifrar no permitido

Almacenamiento:

Datos cifrados en reposo
Auditorías de seguridad regulares
Registro y monitorización de acceso

Autenticación:

OAuth 2.0 para acceso delegado por usuario
Claves de interfaz de programación de aplicaciones con capacidad de rotación
Lista blanca de IPs disponible

Cumplimiento

Cumplimiento del RGPD:

Acuerdo de procesamiento de datos disponible
Derecho a la eliminación de datos
Soporte de portabilidad de datos
Registros de auditoría mantenidos

Propiedad de datos:

Conserváis la propiedad total de vuestros datos de ventas
Eaternity usa los datos solo para vuestras predicciones
Opt-in para contribución a investigación anonimizada

Privacidad de datos

Lo que almacenamos:

Cantidades de ventas históricas
Información de artículos del menú
Historial de predicciones
Métricas de precisión

Lo que NO almacenamos:

Información personal de clientes
Datos de tarjetas de pago
Detalles de transacciones individuales
Datos identificables de clientes

Próximos pasos

Empezar

Revisar opciones de integración en esta página
Elegir vuestro método de integración según requisitos
Leer la guía detallada para vuestro método elegido:
- Integración con Necta
- Integración de interfaz de programación de aplicaciones personalizada
Contactadnos para comenzar la configuración: forecast@eaternity.org

Recursos adicionales

Guía de configuración rápida — Configuración paso a paso
Guía de implementación — Mejores prácticas para equipos de cocina
Referencia de la interfaz de programación de aplicaciones — Documentación completa de la interfaz de programación de aplicaciones
Resolución de problemas — Problemas comunes y soluciones

Ved también

Integración con Necta — Guía de configuración específica de Necta
Integración de interfaz de programación de aplicaciones personalizada — Integración de interfaz de programación de aplicaciones REST
Resolución de problemas — Problemas comunes y soluciones
Referencia de la interfaz de programación de aplicaciones — Documentación completa de la interfaz de programación de aplicaciones

Opciones de integración​

1. Asociación con Necta (Recomendada)​

2. Integración de interfaz de programación de aplicaciones personalizada​

3. Carga manual de datos​

Arquitectura de integración​

Visión general del flujo de datos​

Intercambio de datos requerido​

Saliente (Vuestro sistema → Forecast)​

Entrante (Forecast → Vuestro sistema)​

Elegir vuestro método de integración​

Matriz de decisión​

Guía de selección de integración​

Métodos de autenticación​

OAuth 2.0 (Recomendado para interfaz de programación de aplicaciones)​

Claves de interfaz de programación de aplicaciones​

Autenticación básica​

Formatos de datos​

Envío de datos de ventas​

Recuperación de predicciones​

Requisitos del sistema​

Requisitos técnicos​

Para integración de interfaz de programación de aplicaciones​

Para carga manual​

Requisitos de red​

Requisitos de datos​

Flujo de trabajo de integración​

Fase 1: Planificación (Semana 1)​

Fase 2: Configuración (Semana 2-3)​

Fase 3: Pruebas (Semana 3-4)​

Fase 4: Entrenamiento (Semana 4-5)​

Fase 5: Producción (Semana 6+)​

Soporte de integración​

Recursos disponibles​

Escenarios de integración comunes​

Escenario 1: Cadena de restaurantes con punto de venta central​

Escenario 2: Restaurante independiente con Necta​

Escenario 3: Servicio de alimentación hospitalario con planificación de recursos empresariales personalizado​

Escenario 4: Comedor universitario con punto de venta heredado​

Seguridad y cumplimiento​

Seguridad de datos​

Cumplimiento​

Privacidad de datos​

Próximos pasos​

Empezar​

Recursos adicionales​

Ved también​

Opciones de integración

1. Asociación con Necta (Recomendada)

2. Integración de interfaz de programación de aplicaciones personalizada

3. Carga manual de datos

Arquitectura de integración

Visión general del flujo de datos

Intercambio de datos requerido

Saliente (Vuestro sistema → Forecast)

Entrante (Forecast → Vuestro sistema)

Elegir vuestro método de integración

Matriz de decisión

Guía de selección de integración

Métodos de autenticación

OAuth 2.0 (Recomendado para interfaz de programación de aplicaciones)

Claves de interfaz de programación de aplicaciones

Autenticación básica

Formatos de datos

Envío de datos de ventas

Recuperación de predicciones

Requisitos del sistema

Requisitos técnicos

Para integración de interfaz de programación de aplicaciones

Para carga manual

Requisitos de red

Requisitos de datos

Flujo de trabajo de integración

Fase 1: Planificación (Semana 1)

Fase 2: Configuración (Semana 2-3)

Fase 3: Pruebas (Semana 3-4)

Fase 4: Entrenamiento (Semana 4-5)

Fase 5: Producción (Semana 6+)

Soporte de integración

Recursos disponibles

Escenarios de integración comunes

Escenario 1: Cadena de restaurantes con punto de venta central

Escenario 2: Restaurante independiente con Necta

Escenario 3: Servicio de alimentación hospitalario con planificación de recursos empresariales personalizado

Escenario 4: Comedor universitario con punto de venta heredado

Seguridad y cumplimiento

Seguridad de datos

Cumplimiento

Privacidad de datos

Próximos pasos

Empezar

Recursos adicionales

Ved también