Aperçu des intégrations

Eaternity Forecast s'intègre à vos systèmes de restaurant existants pour collecter automatiquement les données de ventes et livrer les prévisions. Ce guide explique les options d'intégration disponibles et vous aide à choisir la bonne approche.

Options d'intégration

1. Partenariat Necta (Recommandé)

Idéal pour : Les clients Necta existants

Eaternity Forecast se lancé exclusivement avec Necta, notre partenaire stratégique de progiciel de gestion intégré pour les cuisines professionnelles.

Avantages clés :

• Zéro travail d'intégration — Connexion preconstruite
• Synchronisation automatique des données — Les données de ventes circulent de manière transparente
• Interface native — Les prévisions apparaissent dans les outils de planification Necta familiers
• Flux de travail unifié — Pas de changement de système pour les équipes de cuisine

Délai de configuration : 1-2 semaines à partir de la demande d'activation

En savoir plus sur l'intégration Necta →

2. Intégration par interface de programmation personnalisée

Idéal pour : Les opérations avec des ressources techniques et des systèmes non-Necta

Connectez-vous directement via notre interface de programmation REST pour une flexibilite totale.

Fonctionnalités clés :

• Interface de programmation REST standard — HTTP/JSON aux normes du secteur
• OAuth 2.0 ou clés d'interface de programmation — Authentification sécurisée
• Prévisions en temps réel — Accès aux prévisions de manière programmatique
• Support des webhooks — Recevoir les mises à jour automatiquement

Délai de configuration : 2-6 semaines selon la complexité

Voir le guide d'intégration de l'interface de programmation personnalisée →

3. Téléversement manuel des données

Idéal pour : L'évaluation initiale ou les petites structures

Téléversez les données de ventes manuellement pour des tests simplifies.

Processus :

• Exportez les ventes depuis votre système de caisse chaque semaine
• Téléversez le fichier CSV/Excel sur le portail sécurisé
• Recevez les prévisions par e-mail/tableau de bord

Délai de configuration : 1 semaine

Limitation : Non adapté pour une utilisation en production à long terme

Voir le guide de configuration rapide →

Architecture d'intégration

Aperçu du flux de données

Votre systeme de caisse/progiciel de gestion integre
        ↓
    [Export des donnees de ventes]
        ↓
Interface de programmation Eaternity Forecast
        ↓
  [Traitement par reseau de neurones]
        ↓
 [Previsions quotidiennes generees]
        ↓
    [Couche de livraison]
        ↓
Votre systeme de planification/Tableau de bord

Échange de données requis

Sortant (Votre système → Forecast)

Données de ventes quotidiennes (automatise ou manuel) :

Champs obligatoires :

• Date (AAAA-MM-JJ)
• Nom/ID de l'article
• Quantité vendue
• Période de service (optionnel mais recommandé)

Optionnel mais precieux :

• Prix
• Catégorie
• Conditions météorologiques
• Événements spéciaux

Options de format :

• JSON via interface de programmation REST
• Téléversement fichier CSV
• Tableur Excel
• Connexion directe base de données (personnalisé)

Entrant (Forecast → Votre système)

Prévisions quotidiennes (livraison automatisée) :

Données fournies :

• Date (7 prochains jours)
• Nom/ID de l'article
• Quantité prévue
• Borne inférieure (10e percentile)
• Borne supérieure (90e percentile)
• Note de confiance
• Précision historique

Options de livraison :

• Points d'accès de l'interface de programmation REST (pull)
• Notifications par webhook (push)
• Rapports par e-mail
• Interface du tableau de bord

Choisir votre méthode d'intégration

Matrice de décision

Facteur	Intégration Necta	Interface de programmation personnalisée	Téléversement manuel
Complexité de configuration	Très faible	Moyenne-Élevée	Faible
Ressources techniques	Aucune requise	Développeur nécessaire	Competences Excel de base
Niveau d'automatisation	Total	Total (une fois construit)	Manuel
Maintenance continue	Zéro	Faible	Moyenne (travail hebdomadaire)
Fraîcheur des données	Temps réel	Temps réel	Hebdomadaire
Évolutivité	Excellente	Excellente	Limitée
Idéal pour	Clients Necta	Systèmes de caisse personnalisés	Tests initiaux

Guide de sélection de l'intégration

Choisissez l'intégration Necta si :

• Vous êtes un client Necta existant
• Vous voulez la configuration la plus rapide et la plus simple
• Vous preferez zéro travail technique
• Vous voulez une intégration de flux de travail transparente

Choisissez l'interface de programmation personnalisée si :

• Vous utilisez un autre système de progiciel de gestion intégré/caisse
• Vous avez des ressources de développement technique
• Vous avez besoin d'une intégration personnalisée avec votre flux de travail
• Vous voulez un controle total sur l'échange de données

Choisissez le téléversement manuel si :

• Vous évaluez Forecast initialement
• Vous n'avez pas d'accès à l'interface de programmation de votre système de caisse
• Vous avez des ressources techniques limitées
• Vous pouvez vous engager à des téléversements manuels hebdomadaires

Méthodes d'authentification

OAuth 2.0 (Recommandé pour l'interface de programmation)

Idéal pour : Accès sécurisé et delegue

Flux :

1. Votre système redirige l'utilisateur vers la page d'authentification Eaternity
2. L'utilisateur accorde la permission
3. Eaternity emet un jeton d'accès
4. Votre système utilise le jeton pour les requêtes à l'interface de programmation

Avantages :

• Sécurité aux normes du secteur
• Expiration et rafraîchissement des jetons
• Permissions spécifiques à l'utilisateur
• Journal d'audit des accès

Contactez le support pour l'implémentation OAuth 2.0 →

Clés d'interface de programmation

Idéal pour : Intégration serveur à serveur

Configuration :

1. Generez une clé d'interface de programmation dans le tableau de bord Forecast
2. Stockez-la de manière sécurisée dans votre système
3. Incluez-la dans les en-têtes de requête à l'interface de programmation

Utilisation :

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

Avantages :

• Implémentation simple
• Adapté aux scripts automatises
• Facile à faire tourner/revoquer

Authentification basique

Idéal pour : Développement et tests uniquement

Non recommandé pour la production en raison des limitations de sécurité.

Formats de données

Soumission des données de ventes

Format JSON (interface de programmation préférée) :

{
  "kitchen_id": "votre_id_cuisine",
  "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"
        }
      ]
    }
  ]
}

Format CSV (Téléversement manuel) :

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

Récupération des prévisions

Format JSON (Réponse de l'interface de programmation) :

{
  "kitchen_id": "votre_id_cuisine",
  "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
        }
      ]
    }
  ]
}

Exigences système

Exigences techniques

Pour l'intégration par interface de programmation

Votre système doit supporter :

• Requêtes HTTPS (TLS 1.2 ou supérieur)
• Analyse JSON
• Authentification OAuth 2.0 ou clé d'interface de programmation
• Taches planifiées (cron jobs ou équivalent)

Recommande :

• Capacité de point d'accès webhook
• Journalisation et surveillance des erreurs
• Logique de reessai automatique
• Validation des données

Pour le téléversement manuel

Votre système doit supporter :

• Export CSV ou Excel depuis le système de caisse
• Sélection de plage de dates pour les exports
• Données de transaction au niveau article

Exigences réseau

Accès sortant :

• Point d'accès de l'interface de programmation : https://api.eaternity.org
• Ports : 443 (HTTPS)
• Pas de restrictions proxy sur les appels a l'interface de programmation

Configuration du pare-feu :

• Autoriser HTTPS sortant vers *.eaternity.org
• (Optionnel) Autoriser les webhooks entrants depuis les IP Eaternity

Liste blanche IP (si requise) : Contactez le support pour les IP actuelles des serveurs de l'interface de programmation Eaternity

Exigences de données

Données historiques minimales :

• 30 jours de données de ventes pour l'entrainement
• Enregistrements quotidiens (pas de lacunes de plus de 2 jours consecutifs)
• Quantités au niveau article (pas seulement le chiffre d'affaires)

Données historiques recommandées :

• 90 jours ou plus pour une précision optimale
• Données météorologiques pour la même période
• Annotations du calendrier des événements

Voir le guide de configuration rapide →

Flux de travail d'intégration

Phase 1 : Planification (Semaine 1)

Activités :

1. Choisissez la méthode d'intégration selon la matrice de décision
2. Examinez les exigences techniques pour la méthode choisie
3. Assignez les ressources de l'équipe (contact technique, liaison cuisine)
4. Planifiez l'appel de lancement avec l'équipe d'intégration Eaternity

Livrables :

• Document de plan d'intégration
• Contact technique assigne
• Calendrier convenu

Phase 2 : Configuration (Semaines 2-3)

Activités :

1. Configuration des identifiants — Clés d'interface de programmation ou configuration OAuth
2. Configuration des points d'accès — URLs de l'interface de programmation, cibles des webhooks
3. Mappage des données — Faire correspondre vos ID d'articles aux articles Forecast
4. Export des données historiques — Préparer le jeu de données d'entrainement

Livrables :

• Authentification fonctionnelle
• Données de test soumises avec succes
• Données historiques importées

Phase 3 : Tests (Semaines 3-4)

Activités :

1. Validation des données — Vérifier le format et la qualité
2. Tests d'intégration — Flux de données automatise
3. Tests de prévision — Recevoir et valider les prévisions
4. Gestion des erreurs — Tester les scénarios d'échec

Livrables :

• Rapport de qualité des données approuve
• Synchronisation automatisée fonctionnelle
• Premières prévisions de test reçues

Phase 4 : Entrainement (Semaines 4-5)

Activités :

1. Entrainement du modèle — Le réseau de neurones apprend vos tendances
2. Validation de la précision — Comparer a la référence
3. Formation de l'équipe — Le personnel de cuisine apprend a utiliser les prévisions
4. Documentation du processus — Documenter votre flux de travail

Livrables :

• Entrainement du modèle terminé
• Références de précision initiales établies
• Équipe formée sur le système

Phase 5 : Production (Semaine 6+)

Activites :

1. Mise en production — Commencer a utiliser les prévisions quotidiennement
2. Surveillance — Suivre la précision et les problèmes
3. Optimisation — Affiner selon les retours
4. Amélioration continue — Re-entrainement hebdomadaire du modèle

Livrables :

• Prévisions quotidiennes en utilisation de production
• Surveillance des performances en place
• Boucle de retour établie

Support d'intégration

Ressources disponibles

Documentation :

• Guide d'intégration Necta
• Intégration de l'interface de programmation personnalisée
• Référence de l'interface de programmation
• Guide de dépannage

Support technique :

• E-mail : forecast@eaternity.org
• Délai de réponse : 24 heures pour les questions d'intégration
• Support telephonique : Pour les problèmes critiques de production

Assistance a l'intégration :

• Appels de consultation pour la configuration
• Revue technique du code d'intégration
• Validation de la qualité des données
• Conseils d'optimisation des performances

Scénarios d'intégration courants

Scénario 1 : Chaîne de restaurants avec système de caisse central

Configuration :

• Système de caisse central (Toast, Square, etc.)
• Sites multiples
• Menu standardise sur tous les sites

Approche recommandée :

• Intégration unique par interface de programmation au niveau du système de caisse
• Prévisions spécifiques par site via le paramètre location_id
• Mappage partage des articles du menu
• Tableau de bord de gestion central

Délai : 3-4 semaines pour le premier site, 1-2 semaines par site supplémentaire

Scénario 2 : Restaurant indépendant avec Necta

Configuration :

• Site unique
• Necta déjà en utilisation
• Responsable de cuisine familier avec Necta

Approche recommandée :

• Activer l'intégration Necta-Forecast
• Synchronisation automatique des données depuis les données Necta existantes
• Prévisions visibles dans l'interface de planification Necta

Délai : 1-2 semaines au total

Scénario 3 : Restauration hospitaliere avec progiciel de gestion intégré personnalisé

Configuration :

• Grande institution avec progiciel de gestion intégré personnalisé
• Departement informatique disponible
• Menu complexe avec restrictions alimentaires

Approche recommandée :

• Intégration par interface de programmation personnalisée par l'équipe informatique
• Mapper les variantes alimentaires aux catégories d'articles
• Notifications par webhook pour les prévisions quotidiennes
• Intégration avec la gestion des stocks

Délai : 4-6 semaines incluant le développement informatique

Scénario 4 : Cantine universitaire avec système de caisse ancien

Configuration :

• Système de caisse ancien avec interface de programmation limitée
• Ressources informatiques contraintes
• Effets du calendrier académique

Approche recommandée :

• Export CSV manuel depuis le système de caisse (hebdomadaire)
• Téléversement via le portail securise
• Livraison des prévisions par e-mail
• Migration future vers l'interface de programmation quand les ressources seront disponibles

Délai : 1 semaine pour la configuration du processus manuel

Sécurité et conformité

Sécurité des données

Transmission :

• Toutes les données chiffrees en transit (TLS 1.2+)
• Validation des certificats appliquée
• Pas de HTTP non chiffre autorise

Stockage :

• Données chiffrees au repos
• Audits de sécurité réguliers
• Journalisation et surveillance des accès

Authentification :

• OAuth 2.0 pour l'accès delegue par utilisateur
• Clés d'interface de programmation avec capacité de rotation
• Liste blanche IP disponible

Conformité

Conformité RGPD :

• Accord de traitement des données disponible
• Droit a la suppression des données
• Support de portabilite des données
• Journaux d'audit maintenus

Propriété des données :

• Vous conservez la pleine propriété de vos données de ventes
• Eaternity utilise les données uniquement pour vos prévisions
• Opt-in pour la contribution a la recherche anonymisee

Confidentialite des données

Ce que nous stockons :

• Quantités de ventes historiques
• Informations sur les articles du menu
• Historique des prévisions
• Métriques de précision

Ce que nous NE stockons PAS :

• Informations personnelles des clients
• Données de cartes de paiement
• Détails des transactions individuelles
• Données identifiables des clients

Prochaines étapes

Pour commencer

1. Examinez les options d'intégration sur cette page
2. Choisissez votre méthode d'intégration selon vos exigences
3. Lisez le guide détaillé pour la méthode choisie :
   • Intégration Necta
   • Intégration de l'interface de programmation personnalisée
4. Contactez-nous pour commencer la configuration : forecast@eaternity.org

Ressources supplémentaires

• Guide de configuration rapide — Configuration étape par étape
• Guide de mise en oeuvre — Meilleures pratiques pour les équipes de cuisine
• Référence de l'interface de programmation — Documentation complete de l'interface de programmation
• Dépannage — Problèmes courants et solutions

Voir aussi

• Intégration Necta — Guide de configuration spécifique a Necta
• Intégration de l'interface de programmation personnalisée — Intégration de l'interface de programmation REST
• Dépannage — Problèmes courants et solutions
• Référence de l'interface de programmation — Documentation complete de l'interface de programmation