Integrationsueberblick

Eaternity Forecast integriert sich mit Ihren bestehenden Restaurantsystemen, um Verkaufsdaten automatisch zu erfassen und Prognosen zu liefern. Dieser Leitfaden erklaert verfuegbare Integrationsoptionen und hilft Ihnen, den richtigen Ansatz zu waehlen.

Integrationsoptionen

1. Necta-Partnerschaft (Empfohlen)

Am besten fuer: Bestehende Necta ERP-Kunden

Eaternity Forecast startet exklusiv mit Necta, unserem strategischen ERP-Partner fuer professionelle Kuechen.

Hauptvorteile:

• ✅ Keine Integrationsarbeit — Vorgefertigte Verbindung
• ✅ Automatische Datensynchronisation — Verkaufsdaten fliessen nahtlos
• ✅ Native Oberflaeche — Prognosen erscheinen in vertrauten Necta-Planungstools
• ✅ Einheitlicher Workflow — Kein Systemwechsel fuer Kuechenteams

Einrichtungszeit: 1-2 Wochen ab Aktivierungsanfrage

Mehr ueber Necta-Integration erfahren →

2. Benutzerdefinierte API-Integration

Am besten fuer: Betriebe mit technischen Ressourcen und Nicht-Necta-Systemen

Direkte Verbindung ueber unsere REST-API fuer volle Flexibilitaet.

Hauptfunktionen:

• ✅ Standard REST-API — Branchenuebliches HTTP/JSON
• ✅ OAuth 2.0 oder API-Schluessel — Sichere Authentifizierung
• ✅ Echtzeit-Prognosen — Programmgesteuert auf Vorhersagen zugreifen
• ✅ Webhook-Unterstuetzung — Updates automatisch empfangen

Einrichtungszeit: 2-6 Wochen je nach Komplexitaet

Leitfaden zur benutzerdefinierten API-Integration anzeigen →

3. Manueller Datenupload

Am besten fuer: Erste Evaluierung oder kleinere Betriebe

Verkaufsdaten manuell hochladen fuer vereinfachtes Testen.

Prozess:

• Verkaeufe woechentlich aus Ihrem POS exportieren
• CSV/Excel auf sicheres Portal hochladen
• Prognosen per E-Mail/Dashboard erhalten

Einrichtungszeit: 1 Woche

Einschraenkung: Nicht geeignet fuer langfristigen Produktionseinsatz

Siehe Kurzanleitung zur Einrichtung →

Integrationsarchitektur

Datenfluss-Ueberblick

Ihr POS/ERP-System
        ↓
    [Verkaufsdatenexport]
        ↓
Eaternity Forecast API
        ↓
  [Neuronale Netzwerk-Verarbeitung]
        ↓
 [Taegliche Prognosen generiert]
        ↓
    [Zustellungsschicht]
        ↓
Ihr Planungssystem/Dashboard

Erforderlicher Datenaustausch

Ausgehend (Ihr System → Forecast)

Taegliche Verkaufsdaten (automatisiert oder manuell):

Erforderliche Felder:

• Datum (YYYY-MM-DD)
• Artikelname/ID
• Verkaufte Menge
• Servicezeitraum (optional aber empfohlen)

Optional aber wertvoll:

• Preis
• Kategorie
• Wetterbedingungen
• Besondere Ereignisse

Formatoptionen:

• JSON ueber REST-API
• CSV-Dateiupload
• Excel-Tabelle
• Direkte Datenbankverbindung (individuell)

Eingehend (Forecast → Ihr System)

Taegliche Prognosen (automatisierte Zustellung):

Bereitgestellte Daten:

• Datum (naechste 7 Tage)
• Artikelname/ID
• Prognostizierte Menge
• Untere Grenze (10. Perzentil)
• Obere Grenze (90. Perzentil)
• Konfidenzwert
• Historische Genauigkeit

Zustelloptionen:

• REST-API-Endpunkte (Pull)
• Webhook-Benachrichtigungen (Push)
• E-Mail-Berichte
• Dashboard-Oberflaeche

Wahl Ihrer Integrationsmethode

Entscheidungsmatrix

Faktor	Necta-Integration	Benutzerdefinierte API	Manueller Upload
Einrichtungskomplexitaet	Sehr niedrig	Mittel-Hoch	Niedrig
Technische Ressourcen	Keine erforderlich	Entwickler erforderlich	Grundlegende Excel-Kenntnisse
Automatisierungsgrad	Vollstaendig	Vollstaendig (nach Erstellung)	Manuell
Laufende Wartung	Null	Niedrig	Mittel (woechentliche Arbeit)
Datenaktualitaet	Echtzeit	Echtzeit	Woechentlich
Skalierbarkeit	Ausgezeichnet	Ausgezeichnet	Begrenzt
Am besten fuer	Necta-Kunden	Individuelle POS-Systeme	Erste Tests

Integrations-Auswahlleitfaden

Waehlen Sie Necta-Integration wenn:

• ✅ Sie bestehender Necta-Kunde sind
• ✅ Sie schnellste, einfachste Einrichtung wuenschen
• ✅ Sie keine technische Arbeit bevorzugen
• ✅ Sie nahtlose Workflow-Integration wuenschen

Waehlen Sie benutzerdefinierte API wenn:

• ✅ Sie ein anderes ERP/POS-System nutzen
• ✅ Sie technische Entwicklungsressourcen haben
• ✅ Sie individuelle Integration mit Ihrem Workflow benoetigen
• ✅ Sie volle Kontrolle ueber Datenaustausch wuenschen

Waehlen Sie manuellen Upload wenn:

• ✅ Sie Forecast anfaenglich evaluieren
• ✅ Sie keinen API-Zugriff auf Ihr POS haben
• ✅ Sie begrenzte technische Ressourcen haben
• ✅ Sie sich zu woechentlichen manuellen Uploads verpflichten koennen

Authentifizierungsmethoden

OAuth 2.0 (Empfohlen fuer API)

Am besten fuer: Sicheren, delegierten Zugriff

Ablauf:

1. Ihr System leitet Benutzer zu Eaternity-Auth-Seite weiter
2. Benutzer erteilt Berechtigung
3. Eaternity stellt Zugriffstoken aus
4. Ihr System verwendet Token fuer API-Anfragen

Vorteile:

• Branchenuebliche Sicherheit
• Token-Ablauf und -Erneuerung
• Benutzerspezifische Berechtigungen
• Audit-Trail des Zugriffs

Support fuer OAuth 2.0-Implementierung kontaktieren →

API-Schluessel

Am besten fuer: Server-zu-Server-Integration

Einrichtung:

1. API-Schluessel im Forecast-Dashboard generieren
2. Sicher in Ihrem System speichern
3. In API-Anfrage-Header einschliessen

Verwendung:

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

Vorteile:

• Einfache Implementierung
• Geeignet fuer automatisierte Skripte
• Einfach zu rotieren/widerrufen

Basis-Authentifizierung

Am besten fuer: Nur Entwicklung und Tests

Nicht empfohlen fuer Produktion wegen Sicherheitseinschraenkungen.

Datenformate

Verkaufsdaten-Einreichung

JSON-Format (API bevorzugt):

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

CSV-Format (Manueller Upload):

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

Prognoseabruf

JSON-Format (API-Antwort):

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

Systemanforderungen

Technische Anforderungen

Fuer API-Integration

Ihr System muss unterstuetzen:

• HTTPS-Anfragen (TLS 1.2 oder hoeher)
• JSON-Parsing
• OAuth 2.0 oder API-Schluessel-Authentifizierung
• Geplante Aufgaben (Cron-Jobs oder Aequivalent)

Empfohlen:

• Webhook-Endpunkt-Faehigkeit
• Fehlerprotokollierung und -ueberwachung
• Automatische Wiederholungslogik
• Datenvalidierung

Fuer manuellen Upload

Ihr System muss unterstuetzen:

• CSV- oder Excel-Export aus POS
• Datumsbereichsauswahl fuer Exporte
• Transaktionsdaten auf Artikelebene

Netzwerkanforderungen

Ausgehender Zugriff:

• API-Endpunkt: https://api.eaternity.org
• Ports: 443 (HTTPS)
• Keine Proxy-Einschraenkungen bei API-Aufrufen

Firewall-Konfiguration:

• Ausgehenden HTTPS zu *.eaternity.org erlauben
• (Optional) Eingehende Webhooks von Eaternity-IPs erlauben

IP-Whitelisting (falls erforderlich): Support kontaktieren fuer aktuelle Eaternity API-Server-IPs

Datenanforderungen

Mindest-historische Daten:

• 30 Tage Verkaufsdaten fuer Training
• Taegliche Aufzeichnungen (keine Luecken >2 aufeinanderfolgende Tage)
• Mengen auf Artikelebene (nicht nur Umsatz)

Empfohlene historische Daten:

• 90+ Tage fuer optimale Genauigkeit
• Wetterdaten fuer denselben Zeitraum
• Veranstaltungskalender-Anmerkungen

Siehe Kurzanleitung zur Einrichtung →

Integrations-Workflow

Phase 1: Planung (Woche 1)

Aktivitaeten:

1. Integrationsmethode waehlen basierend auf Entscheidungsmatrix
2. Technische Anforderungen pruefen fuer gewaehlte Methode
3. Teamressourcen zuweisen (technischer Kontakt, Kuechenverbindung)
4. Kickoff-Gespraech planen mit Eaternity-Integrationsteam

Ergebnisse:

• Integrationsplan-Dokument
• Technischer Kontakt zugewiesen
• Zeitplan vereinbart

Phase 2: Einrichtung (Woche 2-3)

Aktivitaeten:

1. Anmeldedaten-Setup — API-Schluessel oder OAuth-Konfiguration
2. Endpunkt-Konfiguration — API-URLs, Webhook-Ziele
3. Daten-Mapping — Ihre Artikel-IDs mit Forecast-Artikeln abgleichen
4. Historischer Datenexport — Trainingsdatensatz vorbereiten

Ergebnisse:

• Authentifizierung funktioniert
• Testdaten erfolgreich eingereicht
• Historische Daten importiert

Phase 3: Testen (Woche 3-4)

Aktivitaeten:

1. Datenvalidierung — Format und Qualitaet verifizieren
2. Integrationstest — Automatisierter Datenfluss
3. Prognosetest — Vorhersagen empfangen und validieren
4. Fehlerbehandlung — Fehlerszenarien testen

Ergebnisse:

• Datenqualitaetsbericht genehmigt
• Automatische Synchronisation funktioniert
• Erste Testprognosen erhalten

Phase 4: Training (Woche 4-5)

Aktivitaeten:

1. Modelltraining — Neuronales Netzwerk lernt Ihre Muster
2. Genauigkeitsvalidierung — Mit Basislinie vergleichen
3. Teamschulung — Kuechenpersonal lernt Prognosen zu nutzen
4. Prozessdokumentation — Ihren Workflow dokumentieren

Ergebnisse:

• Modelltraining abgeschlossen
• Anfaengliche Genauigkeits-Benchmarks etabliert
• Team im System geschult

Phase 5: Produktion (Woche 6+)

Aktivitaeten:

1. Go-Live — Prognosen taeglich nutzen
2. Ueberwachung — Genauigkeit und Probleme verfolgen
3. Optimierung — Basierend auf Feedback verfeinern
4. Kontinuierliche Verbesserung — Woechentliches Modell-Neutraining

Ergebnisse:

• Taegliche Prognosen in Produktionseinsatz
• Leistungsueberwachung eingerichtet
• Feedback-Schleife etabliert

Integrations-Support

Verfuegbare Ressourcen

Dokumentation:

• Necta-Integrationsleitfaden
• Benutzerdefinierte API-Integration
• API-Referenz
• Fehlerbehebungsleitfaden

Technischer Support:

• E-Mail: forecast@eaternity.org
• Antwortzeit: 24 Stunden fuer Integrationsfragen
• Telefonsupport: Fuer kritische Produktionsprobleme

Integrationsunterstuetzung:

• Setup-Beratungsgespraeche
• Technische Ueberpruefung des Integrationscodes
• Datenqualitaets-Validierung
• Leistungsoptimierungs-Anleitung

Haeufige Integrationsszenarien

Szenario 1: Restaurantkette mit zentralem POS

Setup:

• Zentrales POS-System (Toast, Square, usw.)
• Mehrere Standorte
• Standardisiertes Menue ueber Standorte

Empfohlener Ansatz:

• Einzelne API-Integration auf POS-Ebene
• Standortspezifische Prognosen ueber location_id-Parameter
• Gemeinsames Menuepunkt-Mapping
• Zentrales Management-Dashboard

Zeitplan: 3-4 Wochen fuer ersten Standort, 1-2 Wochen pro zusaetzlichem Standort

Szenario 2: Unabhaengiges Restaurant mit Necta

Setup:

• Einzelner Standort
• Necta ERP bereits im Einsatz
• Kuechenleiter mit Necta vertraut

Empfohlener Ansatz:

• Necta-Forecast-Integration aktivieren
• Automatische Datensynchronisation aus bestehenden Necta-Daten
• Prognosen in Necta-Planungsoberflaeche sichtbar

Zeitplan: 1-2 Wochen gesamt

Szenario 3: Krankenhausverpflegung mit individuellem ERP

Setup:

• Grosse Einrichtung mit individuellem ERP
• IT-Abteilung verfuegbar
• Komplexes Menue mit Ernaehrungseinschraenkungen

Empfohlener Ansatz:

• Benutzerdefinierte API-Integration durch IT-Team
• Ernaehrungsvarianten auf Artikelkategorien mappen
• Webhook-Benachrichtigungen fuer taegliche Prognosen
• Integration mit Lagerverwaltung

Zeitplan: 4-6 Wochen inklusive IT-Entwicklung

Szenario 4: Universitaetsmensa mit Legacy-POS

Setup:

• Aelteres POS-System mit begrenzter API
• IT-Ressourcen beschraenkt
• Akademische Kalendereffekte

Empfohlener Ansatz:

• Manueller CSV-Export aus POS (woechentlich)
• Upload ueber sicheres Portal
• E-Mail-Zustellung von Prognosen
• Zukuenftige Migration zu API wenn Ressourcen verfuegbar

Zeitplan: 1 Woche fuer manuellen Prozess-Setup

Sicherheit und Compliance

Datensicherheit

Uebertragung:

• Alle Daten verschluesselt bei Uebertragung (TLS 1.2+)
• Zertifikatsvalidierung erzwungen
• Kein unverschluesseltes HTTP erlaubt

Speicherung:

• Daten verschluesselt im Ruhezustand
• Regelmaessige Sicherheitsaudits
• Zugriffsprotokollierung und -ueberwachung

Authentifizierung:

• OAuth 2.0 fuer benutzerdelegierten Zugriff
• API-Schluessel mit Rotationsfaehigkeit
• IP-Whitelisting verfuegbar

Compliance

DSGVO-Compliance:

• Datenverarbeitungsvertrag verfuegbar
• Recht auf Datenloeschung
• Datenportabilitaets-Unterstuetzung
• Audit-Logs gefuehrt

Dateneigentum:

• Sie behalten volle Eigentumsrechte an Ihren Verkaufsdaten
• Eaternity nutzt Daten nur fuer Ihre Prognosen
• Opt-in fuer anonymisierten Forschungsbeitrag

Datenschutz

Was wir speichern:

• Historische Verkaufsmengen
• Menuepunkt-Informationen
• Prognosehistorie
• Genauigkeitsmetriken

Was wir NICHT speichern:

• Persoenliche Gaesteinformationen
• Zahlungskartendaten
• Einzelne Transaktionsdetails
• Identifizierbare Gastedaten

Naechste Schritte

Erste Schritte

1. Integrationsoptionen pruefen auf dieser Seite
2. Ihre Integrationsmethode waehlen basierend auf Anforderungen
3. Detaillierten Leitfaden lesen fuer gewaehlte Methode:
   • Necta-Integration
   • Benutzerdefinierte API-Integration
4. Kontaktieren Sie uns fuer Setup-Start: forecast@eaternity.org

Zusaetzliche Ressourcen

• Kurzanleitung zur Einrichtung — Schritt-fuer-Schritt-Einrichtung
• Implementierungsleitfaden — Bewaehrte Methoden fuer Kuechenteams
• API-Referenz — Vollstaendige API-Dokumentation
• Fehlerbehebung — Haeufige Probleme und Loesungen

Siehe auch

• Necta-Integration — Necta-spezifischer Einrichtungsleitfaden
• Benutzerdefinierte API-Integration — REST-API-Integration
• Fehlerbehebung — Haeufige Probleme und Loesungen
• API-Referenz — Vollstaendige API-Dokumentation