Zum Hauptinhalt springen

Integrationsüberblick

Eaternity Forecast integriert sich mit Ihren bestehenden Restaurantsystemen, um Verkaufsdaten automatisch zu erfassen und Prognosen zu liefern. Dieser Leitfaden erklärt verfügbare Integrationsoptionen und hilft Ihnen, den richtigen Ansatz zu wählen.

Integrationsoptionen​

1. Necta-Partnerschaft (Empfohlen)​

Am besten für: Bestehende Necta ERP-Kunden

Eaternity Forecast startet exklusiv mit Necta, unserem strategischen ERP-Partner für professionelle Küchen.

Hauptvorteile:

  • ✅ Keine Integrationsarbeit — Vorgefertigte Verbindung
  • ✅ Automatische Datensynchronisation — Verkaufsdaten fliessen nahtlos
  • ✅ Native Oberfläche — Prognosen erscheinen in vertrauten Necta-Planungstools
  • ✅ Einheitlicher Workflow — Kein Systemwechsel für Küchenteams

Einrichtungszeit: 1-2 Wochen ab Aktivierungsanfrage

Mehr über Necta-Integration erfahren →

2. Benutzerdefinierte API-Integration​

Am besten für: Betriebe mit technischen Ressourcen und Nicht-Necta-Systemen

Direkte Verbindung über unsere REST-API für volle Flexibilität.

Hauptfunktionen:

  • ✅ Standard REST-API — Branchenuebliches HTTP/JSON
  • ✅ OAuth 2.0 oder API-Schlüssel — Sichere Authentifizierung
  • ✅ Echtzeit-Prognosen — Programmgesteuert auf Vorhersagen zugreifen
  • ✅ Webhook-Unterstützung — Updates automatisch empfangen

Einrichtungszeit: 2-6 Wochen je nach Komplexität

Leitfaden zur benutzerdefinierten API-Integration anzeigen →

3. Manueller Datenupload​

Am besten für: Erste Evaluierung oder kleinere Betriebe

Verkaufsdaten manuell hochladen für vereinfachtes Testen.

Prozess:

  • Verkäufe wöchentlich aus Ihrem POS exportieren
  • CSV/Excel auf sicheres Portal hochladen
  • Prognosen per E-Mail/Dashboard erhalten

Einrichtungszeit: 1 Woche

Einschränkung: Nicht geeignet für langfristigen Produktionseinsatz

Siehe Kurzanleitung zur Einrichtung →

Integrationsarchitektur​

Datenfluss-Überblick​

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

Erforderlicher Datenaustausch​

Ausgehend (Ihr System → Forecast)​

Tägliche 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 über REST-API
  • CSV-Dateiupload
  • Excel-Tabelle
  • Direkte Datenbankverbindung (individuell)

Eingehend (Forecast → Ihr System)​

Tägliche Prognosen (automatisierte Zustellung):

Bereitgestellte Daten:

  • Datum (nächste 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-Oberfläche

Wahl Ihrer Integrationsmethode​

Entscheidungsmatrix​

FaktorNecta-IntegrationBenutzerdefinierte APIManueller Upload
EinrichtungskomplexitätSehr niedrigMittel-HochNiedrig
Technische RessourcenKeine erforderlichEntwickler erforderlichGrundlegende Excel-Kenntnisse
AutomatisierungsgradVollständigVollständig (nach Erstellung)Manuell
Laufende WartungNullNiedrigMittel (wöchentliche Arbeit)
DatenaktualitätEchtzeitEchtzeitWöchentlich
SkalierbarkeitAusgezeichnetAusgezeichnetBegrenzt
Am besten fürNecta-KundenIndividuelle POS-SystemeErste Tests

Integrations-Auswahlleitfaden​

Wählen Sie Necta-Integration wenn:

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

Wählen Sie benutzerdefinierte API wenn:

  • ✅ Sie ein anderes ERP/POS-System nutzen
  • ✅ Sie technische Entwicklungsressourcen haben
  • ✅ Sie individuelle Integration mit Ihrem Workflow benötigen
  • ✅ Sie volle Kontrolle über Datenaustausch wuenschen

Wählen Sie manuellen Upload wenn:

  • ✅ Sie Forecast anfänglich evaluieren
  • ✅ Sie keinen API-Zugriff auf Ihr POS haben
  • ✅ Sie begrenzte technische Ressourcen haben
  • ✅ Sie sich zu wöchentlichen manuellen Uploads verpflichten können

Authentifizierungsmethoden​

OAuth 2.0 (Empfohlen für API)​

Am besten für: 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 für API-Anfragen

Vorteile:

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

Support für OAuth 2.0-Implementierung kontaktieren →

API-Schlüssel​

Am besten für: Server-zu-Server-Integration

Einrichtung:

  1. API-Schlüssel 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 für automatisierte Skripte
  • Einfach zu rotieren/widerrufen

Basis-Authentifizierung​

Am besten für: Nur Entwicklung und Tests

Nicht empfohlen für Produktion wegen Sicherheitseinschränkungen.

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​

Für API-Integration​

Ihr System muss unterstützen:

  • HTTPS-Anfragen (TLS 1.2 oder höher)
  • JSON-Parsing
  • OAuth 2.0 oder API-Schlüssel-Authentifizierung
  • Geplante Aufgaben (Cron-Jobs oder Äquivalent)

Empfohlen:

  • Webhook-Endpunkt-Fähigkeit
  • Fehlerprotokollierung und -überwachung
  • Automatische Wiederholungslogik
  • Datenvalidierung

Für manuellen Upload​

Ihr System muss unterstützen:

  • CSV- oder Excel-Export aus POS
  • Datumsbereichsauswahl für Exporte
  • Transaktionsdaten auf Artikelebene

Netzwerkanforderungen​

Ausgehender Zugriff:

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

Firewall-Konfiguration:

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

IP-Whitelisting (falls erforderlich): Support kontaktieren für aktuelle Eaternity API-Server-IPs

Datenanforderungen​

Mindest-historische Daten:

  • 30 Tage Verkaufsdaten für Training
  • Tägliche Aufzeichnungen (keine Lücken >2 aufeinanderfolgende Tage)
  • Mengen auf Artikelebene (nicht nur Umsatz)

Empfohlene historische Daten:

  • 90+ Tage für optimale Genauigkeit
  • Wetterdaten für denselben Zeitraum
  • Veranstaltungskalender-Anmerkungen

Siehe Kurzanleitung zur Einrichtung →

Integrations-Workflow​

Phase 1: Planung (Woche 1)​

Aktivitäten:

  1. Integrationsmethode wählen basierend auf Entscheidungsmatrix
  2. Technische Anforderungen prüfen für gewählte Methode
  3. Teamressourcen zuweisen (technischer Kontakt, Küchenverbindung)
  4. Kickoff-Gespräch planen mit Eaternity-Integrationsteam

Ergebnisse:

  • Integrationsplan-Dokument
  • Technischer Kontakt zugewiesen
  • Zeitplan vereinbart

Phase 2: Einrichtung (Woche 2-3)​

Aktivitäten:

  1. Anmeldedaten-Setup — API-Schlüssel 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)​

Aktivitäten:

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

Ergebnisse:

  • Datenqualitätsbericht genehmigt
  • Automatische Synchronisation funktioniert
  • Erste Testprognosen erhalten

Phase 4: Training (Woche 4-5)​

Aktivitäten:

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

Ergebnisse:

  • Modelltraining abgeschlossen
  • Anfängliche Genauigkeits-Benchmarks etabliert
  • Team im System geschult

Phase 5: Produktion (Woche 6+)​

Aktivitäten:

  1. Go-Live — Prognosen täglich nutzen
  2. Überwachung — Genauigkeit und Probleme verfolgen
  3. Optimierung — Basierend auf Feedback verfeinern
  4. Kontinuierliche Verbesserung — Woechentliches Modell-Neutraining

Ergebnisse:

  • Tägliche Prognosen in Produktionseinsatz
  • Leistungsüberwachung eingerichtet
  • Feedback-Schleife etabliert

Integrations-Support​

Verfügbare Ressourcen​

Dokumentation:

Technischer Support:

  • E-Mail: forecast@eaternity.org
  • Antwortzeit: 24 Stunden für Integrationsfragen
  • Telefonsupport: Für kritische Produktionsprobleme

Integrationsunterstützung:

  • Setup-Beratungsgespräche
  • Technische Überprüfung des Integrationscodes
  • Datenqualitaets-Validierung
  • Leistungsoptimierungs-Anleitung

Häufige Integrationsszenarien​

Szenario 1: Restaurantkette mit zentralem POS​

Setup:

  • Zentrales POS-System (Toast, Square, usw.)
  • Mehrere Standorte
  • Standardisiertes Menü über Standorte

Empfohlener Ansatz:

  • Einzelne API-Integration auf POS-Ebene
  • Standortspezifische Prognosen über location_id-Parameter
  • Gemeinsames Menüpunkt-Mapping
  • Zentrales Management-Dashboard

Zeitplan: 3-4 Wochen für ersten Standort, 1-2 Wochen pro zusätzlichem Standort

Szenario 2: Unabhängiges Restaurant mit Necta​

Setup:

  • Einzelner Standort
  • Necta ERP bereits im Einsatz
  • Küchenleiter mit Necta vertraut

Empfohlener Ansatz:

  • Necta-Forecast-Integration aktivieren
  • Automatische Datensynchronisation aus bestehenden Necta-Daten
  • Prognosen in Necta-Planungsoberfläche sichtbar

Zeitplan: 1-2 Wochen gesamt

Szenario 3: Krankenhausverpflegung mit individuellem ERP​

Setup:

  • Grosse Einrichtung mit individuellem ERP
  • IT-Abteilung verfügbar
  • Komplexes Menü mit Ernährungseinschränkungen

Empfohlener Ansatz:

  • Benutzerdefinierte API-Integration durch IT-Team
  • Ernährungsvarianten auf Artikelkategorien mappen
  • Webhook-Benachrichtigungen für tägliche Prognosen
  • Integration mit Lagerverwaltung

Zeitplan: 4-6 Wochen inklusive IT-Entwicklung

Szenario 4: Universitätsmensa mit Legacy-POS​

Setup:

  • Älteres POS-System mit begrenzter API
  • IT-Ressourcen beschränkt
  • Akademische Kalendereffekte

Empfohlener Ansatz:

  • Manueller CSV-Export aus POS (wöchentlich)
  • Upload über sicheres Portal
  • E-Mail-Zustellung von Prognosen
  • Zukünftige Migration zu API wenn Ressourcen verfügbar

Zeitplan: 1 Woche für manuellen Prozess-Setup

Sicherheit und Compliance​

Datensicherheit​

Übertragung:

  • Alle Daten verschlüsselt bei Übertragung (TLS 1.2+)
  • Zertifikatsvalidierung erzwungen
  • Kein unverschlüsseltes HTTP erlaubt

Speicherung:

  • Daten verschlüsselt im Ruhezustand
  • Regelmässige Sicherheitsaudits
  • Zugriffsprotokollierung und -überwachung

Authentifizierung:

  • OAuth 2.0 für benutzerdelegierten Zugriff
  • API-Schlüssel mit Rotationsfähigkeit
  • IP-Whitelisting verfügbar

Compliance​

DSGVO-Compliance:

  • Datenverarbeitungsvertrag verfügbar
  • Recht auf Datenlöschung
  • Datenportabilitäts-Unterstützung
  • Audit-Logs geführt

Dateneigentum:

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

Datenschutz​

Was wir speichern:

  • Historische Verkaufsmengen
  • Menüpunkt-Informationen
  • Prognosehistorie
  • Genauigkeitsmetriken

Was wir NICHT speichern:

  • Persönliche Gästeinformationen
  • Zahlungskartendaten
  • Einzelne Transaktionsdetails
  • Identifizierbare Gastedaten

Nächste Schritte​

Erste Schritte​

  1. Integrationsoptionen prüfen auf dieser Seite
  2. Ihre Integrationsmethode wählen basierend auf Anforderungen
  3. Detaillierten Leitfaden lesen für gewählte Methode:
  4. Kontaktieren Sie uns für Setup-Start: forecast@eaternity.org

Zusätzliche Ressourcen​

Siehe auch​