Panoramica Integrazioni

Eaternity Forecast si integra con i vostri sistemi ristorante esistenti per raccogliere automaticamente i dati di vendita e consegnare le previsioni. Questa guida spiega le opzioni di integrazione disponibili e vi aiuta a scegliere l'approccio giusto.

Opzioni di Integrazione

1. Partnership Necta (Consigliata)

Ideale per: Clienti Necta ERP esistenti

Eaternity Forecast viene lanciato esclusivamente con Necta, il nostro partner ERP strategico per cucine professionali.

Vantaggi Principali:

• Zero lavoro di integrazione - Connessione pre-costruita
• Sincronizzazione dati automatica - I dati di vendita fluiscono senza interruzioni
• Interfaccia nativa - Le previsioni appaiono negli strumenti di pianificazione Necta familiari
• Flusso di lavoro unificato - Nessun cambio sistema per i team di cucina

Tempo di Configurazione: 1-2 settimane dalla richiesta di attivazione

Approfondisci Integrazione Necta

2. Integrazione API Personalizzata

Ideale per: Operazioni con risorse tecniche e sistemi non-Necta

Collegatevi direttamente tramite la nostra API REST per massima flessibilità.

Funzionalità Principali:

• API REST standard - HTTP/JSON standard di settore
• OAuth 2.0 o chiavi API - Autenticazione sicura
• Previsioni real-time - Accesso previsioni programmatico
• Supporto webhook - Ricezione aggiornamenti automatica

Tempo di Configurazione: 2-6 settimane a seconda della complessità

Vedi Guida Integrazione API Personalizzata

3. Caricamento Dati Manuale

Ideale per: Valutazione iniziale o operazioni più piccole

Caricate i dati di vendita manualmente per test semplificati.

Processo:

• Esportate le vendite dal vostro POS settimanalmente
• Caricate CSV/Excel sul portale sicuro
• Ricevete previsioni via email/pannello di controllo

Tempo di Configurazione: 1 settimana

Limitazione: Non adatto per uso in produzione a lungo termine

Vedi Guida Rapida alla Configurazione

Architettura di Integrazione

Panoramica Flusso Dati

Il Vostro Sistema POS/ERP
        ↓
    [Esportazione Dati Vendite]
        ↓
Eaternity Forecast API
        ↓
  [Elaborazione Rete Neurale]
        ↓
 [Generazione Previsioni Giornaliere]
        ↓
    [Livello di Consegna]
        ↓
Il Vostro Sistema Pianificazione/Pannello di Controllo

Scambio Dati Richiesto

In Uscita (Il Vostro Sistema → Forecast)

Dati Vendite Giornalieri (automatico o manuale):

Campi obbligatori:

• Data (YYYY-MM-DD)
• Nome/ID articolo
• Quantità venduta
• Periodo servizio (opzionale ma consigliato)

Opzionali ma preziosi:

• Prezzo
• Categoria
• Condizioni meteo
• Eventi speciali

Opzioni Formato:

• JSON via API REST
• Caricamento file CSV
• Foglio di calcolo Excel
• Connessione database diretta (personalizzata)

In Entrata (Forecast → Il Vostro Sistema)

Previsioni Giornaliere (consegna automatica):

Dati forniti:

• Data (prossimi 7 giorni)
• Nome/ID articolo
• Quantità prevista
• Limite inferiore (10esimo percentile)
• Limite superiore (90esimo percentile)
• Punteggio confidenza
• Precisione storica

Opzioni di Consegna:

• Endpoint API REST (pull)
• Notifiche webhook (push)
• Report email
• Interfaccia pannello di controllo

Scegliere il Metodo di Integrazione

Matrice Decisionale

Fattore	Integrazione Necta	API Personalizzata	Caricamento Manuale
Complessità Configurazione	Molto Bassa	Media-Alta	Bassa
Risorse Tecniche	Non richieste	Sviluppatore necessario	Competenze Excel base
Livello Automazione	Completa	Completa (una volta costruita)	Manuale
Manutenzione Continua	Zero	Bassa	Media (lavoro settimanale)
Freschezza Dati	Real-time	Real-time	Settimanale
Scalabilità	Eccellente	Eccellente	Limitata
Ideale Per	Clienti Necta	Sistemi POS custom	Test iniziale

Guida alla Selezione Integrazione

Scegliete Integrazione Necta se:

• Siete clienti Necta esistenti
• Volete configurazione più veloce e facile
• Preferite zero lavoro tecnico
• Volete integrazione flusso lavoro senza interruzioni

Scegliete API Personalizzata se:

• Usate un sistema ERP/POS diverso
• Avete risorse di sviluppo tecniche
• Avete bisogno di integrazione personalizzata con il vostro flusso
• Volete controllo completo sullo scambio dati

Scegliete Caricamento Manuale se:

• State valutando Forecast inizialmente
• Non avete accesso API al vostro POS
• Avete risorse tecniche limitate
• Potete impegnarvi in caricamenti manuali settimanali

Metodi di Autenticazione

OAuth 2.0 (Consigliato per API)

Ideale per: Accesso sicuro e delegato

Flusso:

1. Il vostro sistema reindirizza l'utente alla pagina auth Eaternity
2. L'utente concede il permesso
3. Eaternity emette token di accesso
4. Il vostro sistema usa il token per le richieste API

Vantaggi:

• Sicurezza standard di settore
• Scadenza e refresh token
• Permessi specifici per utente
• Audit trail degli accessi

Contattate il supporto per implementazione OAuth 2.0

Chiavi API

Ideale per: Integrazione server-to-server

Configurazione:

1. Generate chiave API nel pannello di controllo Forecast
2. Conservate in modo sicuro nel vostro sistema
3. Includete negli header delle richieste API

Utilizzo:

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

Vantaggi:

• Implementazione semplice
• Adatto per script automatizzati
• Facile da ruotare/revocare

Autenticazione Basic

Ideale per: Solo sviluppo e test

Non consigliata per produzione per limitazioni di sicurezza.

Formati Dati

Invio Dati Vendite

Formato JSON (preferito API):

{
  "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 (Caricamento manuale):

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

Recupero Previsioni

Formato JSON (risposta API):

{
  "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
        }
      ]
    }
  ]
}

Requisiti di Sistema

Requisiti Tecnici

Per Integrazione API

Il Vostro Sistema Deve Supportare:

• Richieste HTTPS (TLS 1.2 o superiore)
• Parsing JSON
• Autenticazione OAuth 2.0 o chiave API
• Task programmati (cron job o equivalente)

Consigliati:

• Capacità endpoint webhook
• Logging e monitoraggio errori
• Logica retry automatica
• Validazione dati

Per Caricamento Manuale

Il Vostro Sistema Deve Supportare:

• Esportazione CSV o Excel dal POS
• Selezione intervallo date per esportazioni
• Dati transazione a livello articolo

Requisiti di Rete

Accesso in Uscita:

• Endpoint API: https://api.eaternity.org
• Porte: 443 (HTTPS)
• Nessuna restrizione proxy sulle chiamate API

Configurazione Firewall:

• Permettere HTTPS in uscita verso *.eaternity.org
• (Opzionale) Permettere webhook in entrata dagli IP Eaternity

Whitelisting IP (se richiesto): Contattate il supporto per gli IP server API Eaternity attuali

Requisiti Dati

Dati Storici Minimi:

• 30 giorni di dati vendite per addestramento
• Record giornalieri (nessun gap maggiore di 2 giorni consecutivi)
• Quantità a livello articolo (non solo fatturato)

Dati Storici Consigliati:

• 90+ giorni per precisione ottimale
• Dati meteo per stesso periodo
• Annotazioni calendario eventi

Vedi Guida Rapida alla Configurazione

Flusso di Lavoro Integrazione

Fase 1: Pianificazione (Settimana 1)

Attività:

1. Scegliere metodo integrazione basato su matrice decisionale
2. Verificare requisiti tecnici per metodo scelto
3. Assegnare risorse team (contatto tecnico, referente cucina)
4. Programmare chiamata kickoff con team integrazione Eaternity

Deliverable:

• Documento piano integrazione
• Contatto tecnico assegnato
• Tempistiche concordate

Fase 2: Configurazione (Settimane 2-3)

Attività:

1. Configurazione credenziali - Chiavi API o configurazione OAuth
2. Configurazione endpoint - URL API, target webhook
3. Mappatura dati - Abbinare i vostri ID articolo agli articoli forecast
4. Esportazione dati storici - Preparare dataset addestramento

Deliverable:

• Autenticazione funzionante
• Dati test inviati con successo
• Dati storici importati

Fase 3: Test (Settimane 3-4)

Attività:

1. Validazione dati - Verificare formato e qualità
2. Test integrazione - Flusso dati automatizzato
3. Test previsioni - Ricevere e validare previsioni
4. Gestione errori - Testare scenari di fallimento

Deliverable:

• Report qualità dati approvato
• Sincronizzazione automatica funzionante
• Prime previsioni di test ricevute

Fase 4: Addestramento (Settimane 4-5)

Attività:

1. Addestramento modello - La rete neurale impara i vostri pattern
2. Validazione precisione - Confronto con baseline
3. Formazione team - Il personale cucina impara a usare le previsioni
4. Documentazione processo - Documentare il vostro flusso

Deliverable:

• Addestramento modello completato
• Benchmark precisione iniziali stabiliti
• Team formato sul sistema

Fase 5: Produzione (Settimana 6+)

Attività:

1. Go-live - Iniziare a usare le previsioni giornalmente
2. Monitoraggio - Tracciare precisione e problemi
3. Ottimizzazione - Affinare basandosi sul feedback
4. Miglioramento continuo - Riaddestramento modello settimanale

Deliverable:

• Previsioni giornaliere in uso produzione
• Monitoraggio prestazioni attivo
• Loop feedback stabilito

Supporto Integrazione

Risorse Disponibili

Documentazione:

• Guida Integrazione Necta
• Integrazione API Personalizzata
• Riferimento API
• Guida Risoluzione Problemi

Supporto Tecnico:

• Email: forecast@eaternity.org
• Tempo risposta: 24 ore per domande integrazione
• Supporto telefonico: Per problemi produzione critici

Assistenza Integrazione:

• Chiamate consulenza configurazione
• Revisione tecnica codice integrazione
• Validazione qualità dati
• Guida ottimizzazione prestazioni

Scenari Integrazione Comuni

Scenario 1: Catena Ristoranti con POS Centrale

Configurazione:

• Sistema POS centrale (Toast, Square, ecc.)
• Location multiple
• Menu standardizzato tra location

Approccio Consigliato:

• Singola integrazione API a livello POS
• Previsioni specifiche per location via parametro location_id
• Mappatura articoli menu condivisa
• Pannello di controllo gestione centrale

Tempistiche: 3-4 settimane per prima location, 1-2 settimane per location aggiuntive

Scenario 2: Ristorante Indipendente con Necta

Configurazione:

• Singola location
• Necta ERP già in uso
• Responsabile cucina familiare con Necta

Approccio Consigliato:

• Attivare integrazione Necta-Forecast
• Sincronizzazione dati automatica da dati Necta esistenti
• Previsioni visibili in interfaccia pianificazione Necta

Tempistiche: 1-2 settimane totali

Scenario 3: Servizio Ristorazione Ospedaliera con ERP Personalizzato

Configurazione:

• Grande istituzione con ERP personalizzato
• Dipartimento IT disponibile
• Menu complesso con restrizioni dietetiche

Approccio Consigliato:

• Integrazione API personalizzata da team IT
• Mappare varianti dietetiche a categorie articoli
• Notifiche webhook per previsioni giornaliere
• Integrazione con gestione inventario

Tempistiche: 4-6 settimane incluso sviluppo IT

Scenario 4: Mensa Universitaria con POS Legacy

Configurazione:

• Sistema POS datato con API limitata
• Risorse IT limitate
• Effetti calendario accademico

Approccio Consigliato:

• Esportazione CSV manuale dal POS (settimanale)
• Caricamento via portale sicuro
• Consegna previsioni via email
• Migrazione futura ad API quando risorse disponibili

Tempistiche: 1 settimana per configurazione processo manuale

Sicurezza e Conformità

Sicurezza Dati

Trasmissione:

• Tutti i dati crittografati in transito (TLS 1.2+)
• Validazione certificato applicata
• Nessun HTTP non crittografato permesso

Storage:

• Dati crittografati a riposo
• Audit sicurezza regolari
• Logging e monitoraggio accessi

Autenticazione:

• OAuth 2.0 per accesso delegato utente
• Chiavi API con capacità rotazione
• Whitelisting IP disponibile

Conformità

Conformità GDPR:

• Accordo trattamento dati disponibile
• Diritto alla cancellazione dati
• Supporto portabilità dati
• Log audit mantenuti

Proprietà Dati:

• Mantenete piena proprietà dei vostri dati vendite
• Eaternity usa i dati solo per le vostre previsioni
• Opt-in per contributo ricerca anonimizzata

Privacy Dati

Cosa Conserviamo:

• Quantità vendite storiche
• Informazioni articoli menu
• Storico previsioni
• Metriche precisione

Cosa NON Conserviamo:

• Informazioni personali ospiti
• Dati carte di pagamento
• Dettagli singole transazioni
• Dati ospiti identificabili

Prossimi Passi

Per Iniziare

1. Revisionate le opzioni di integrazione in questa pagina
2. Scegliete il vostro metodo di integrazione basato sui requisiti
3. Leggete la guida dettagliata per il metodo scelto:
   • Integrazione Necta
   • Integrazione API Personalizzata
4. Contattateci per iniziare la configurazione: forecast@eaternity.org

Risorse Aggiuntive

• Guida Rapida alla Configurazione - Configurazione passo passo
• Guida all'Implementazione - Migliori pratiche per team cucina
• Riferimento API - Documentazione API completa
• Risoluzione Problemi - Problemi comuni e soluzioni

Vedi Anche

• Integrazione Necta - Guida configurazione specifica Necta
• Integrazione API Personalizzata - Integrazione API REST
• Risoluzione Problemi - Problemi comuni e soluzioni
• Riferimento API - Documentazione API completa