Apercu des integrations

Eaternity Forecast s'integre a vos systemes de restaurant existants pour collecter automatiquement les donnees de ventes et livrer les previsions. Ce guide explique les options d'integration disponibles et vous aide a choisir la bonne approche.

Options d'integration

1. Partenariat Necta (Recommande)

Ideal pour : Les clients Necta existants

Eaternity Forecast se lance exclusivement avec Necta, notre partenaire strategique de progiciel de gestion integre pour les cuisines professionnelles.

Avantages cles :

• Zero travail d'integration — Connexion preconstruite
• Synchronisation automatique des donnees — Les donnees de ventes circulent de maniere transparente
• Interface native — Les previsions apparaissent dans les outils de planification Necta familiers
• Flux de travail unifie — Pas de changement de systeme pour les equipes de cuisine

Delai de configuration : 1-2 semaines a partir de la demande d'activation

En savoir plus sur l'integration Necta →

2. Integration par interface de programmation personnalisee

Ideal pour : Les operations avec des ressources techniques et des systemes non-Necta

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

Fonctionnalites cles :

• Interface de programmation REST standard — HTTP/JSON aux normes du secteur
• OAuth 2.0 ou cles d'interface de programmation — Authentification securisee
• Previsions en temps reel — Acces aux previsions de maniere programmatique
• Support des webhooks — Recevoir les mises a jour automatiquement

Delai de configuration : 2-6 semaines selon la complexite

Voir le guide d'integration de l'interface de programmation personnalisee →

3. Televersement manuel des donnees

Ideal pour : L'evaluation initiale ou les petites structures

Televersez les donnees de ventes manuellement pour des tests simplifies.

Processus :

• Exportez les ventes depuis votre systeme de caisse chaque semaine
• Televersez le fichier CSV/Excel sur le portail securise
• Recevez les previsions par e-mail/tableau de bord

Delai de configuration : 1 semaine

Limitation : Non adapte pour une utilisation en production a long terme

Voir le guide de configuration rapide →

Architecture d'integration

Apercu du flux de donnees

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

Echange de donnees requis

Sortant (Votre systeme → Forecast)

Donnees de ventes quotidiennes (automatise ou manuel) :

Champs obligatoires :

• Date (AAAA-MM-JJ)
• Nom/ID de l'article
• Quantite vendue
• Periode de service (optionnel mais recommande)

Optionnel mais precieux :

• Prix
• Categorie
• Conditions meteorologiques
• Evenements speciaux

Options de format :

• JSON via interface de programmation REST
• Televersement fichier CSV
• Tableur Excel
• Connexion directe base de donnees (personnalise)

Entrant (Forecast → Votre systeme)

Previsions quotidiennes (livraison automatisee) :

Donnees fournies :

• Date (7 prochains jours)
• Nom/ID de l'article
• Quantite prevue
• Borne inferieure (10e percentile)
• Borne superieure (90e percentile)
• Note de confiance
• Precision historique

Options de livraison :

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

Choisir votre methode d'integration

Matrice de decision

Facteur	Integration Necta	Interface de programmation personnalisee	Televersement manuel
Complexite de configuration	Tres faible	Moyenne-Elevee	Faible
Ressources techniques	Aucune requise	Developpeur necessaire	Competences Excel de base
Niveau d'automatisation	Total	Total (une fois construit)	Manuel
Maintenance continue	Zero	Faible	Moyenne (travail hebdomadaire)
Fraicheur des donnees	Temps reel	Temps reel	Hebdomadaire
Evolutivite	Excellente	Excellente	Limitee
Ideal pour	Clients Necta	Systemes de caisse personnalises	Tests initiaux

Guide de selection de l'integration

Choisissez l'integration Necta si :

• Vous etes un client Necta existant
• Vous voulez la configuration la plus rapide et la plus simple
• Vous preferez zero travail technique
• Vous voulez une integration de flux de travail transparente

Choisissez l'interface de programmation personnalisee si :

• Vous utilisez un autre systeme de progiciel de gestion integre/caisse
• Vous avez des ressources de developpement technique
• Vous avez besoin d'une integration personnalisee avec votre flux de travail
• Vous voulez un controle total sur l'echange de donnees

Choisissez le televersement manuel si :

• Vous evaluez Forecast initialement
• Vous n'avez pas d'acces a l'interface de programmation de votre systeme de caisse
• Vous avez des ressources techniques limitees
• Vous pouvez vous engager a des televersements manuels hebdomadaires

Methodes d'authentification

OAuth 2.0 (Recommande pour l'interface de programmation)

Ideal pour : Acces securise et delegue

Flux :

1. Votre systeme redirige l'utilisateur vers la page d'authentification Eaternity
2. L'utilisateur accorde la permission
3. Eaternity emet un jeton d'acces
4. Votre systeme utilise le jeton pour les requetes a l'interface de programmation

Avantages :

• Securite aux normes du secteur
• Expiration et rafraichissement des jetons
• Permissions specifiques a l'utilisateur
• Journal d'audit des acces

Contactez le support pour l'implementation OAuth 2.0 →

Cles d'interface de programmation

Ideal pour : Integration serveur a serveur

Configuration :

1. Generez une cle d'interface de programmation dans le tableau de bord Forecast
2. Stockez-la de maniere securisee dans votre systeme
3. Incluez-la dans les en-tetes de requete a 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 :

• Implementation simple
• Adapte aux scripts automatises
• Facile a faire tourner/revoquer

Authentification basique

Ideal pour : Developpement et tests uniquement

Non recommande pour la production en raison des limitations de securite.

Formats de donnees

Soumission des donnees de ventes

Format JSON (interface de programmation preferee) :

{
  "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 (Televersement 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

Recuperation des previsions

Format JSON (Reponse 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 systeme

Exigences techniques

Pour l'integration par interface de programmation

Votre systeme doit supporter :

• Requetes HTTPS (TLS 1.2 ou superieur)
• Analyse JSON
• Authentification OAuth 2.0 ou cle d'interface de programmation
• Taches planifiees (cron jobs ou equivalent)

Recommande :

• Capacite de point d'acces webhook
• Journalisation et surveillance des erreurs
• Logique de reessai automatique
• Validation des donnees

Pour le televersement manuel

Votre systeme doit supporter :

• Export CSV ou Excel depuis le systeme de caisse
• Selection de plage de dates pour les exports
• Donnees de transaction au niveau article

Exigences reseau

Acces sortant :

• Point d'acces 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 donnees

Donnees historiques minimales :

• 30 jours de donnees de ventes pour l'entrainement
• Enregistrements quotidiens (pas de lacunes de plus de 2 jours consecutifs)
• Quantites au niveau article (pas seulement le chiffre d'affaires)

Donnees historiques recommandees :

• 90 jours ou plus pour une precision optimale
• Donnees meteorologiques pour la meme periode
• Annotations du calendrier des evenements

Voir le guide de configuration rapide →

Flux de travail d'integration

Phase 1 : Planification (Semaine 1)

Activites :

1. Choisissez la methode d'integration selon la matrice de decision
2. Examinez les exigences techniques pour la methode choisie
3. Assignez les ressources de l'equipe (contact technique, liaison cuisine)
4. Planifiez l'appel de lancement avec l'equipe d'integration Eaternity

Livrables :

• Document de plan d'integration
• Contact technique assigne
• Calendrier convenu

Phase 2 : Configuration (Semaines 2-3)

Activites :

1. Configuration des identifiants — Cles d'interface de programmation ou configuration OAuth
2. Configuration des points d'acces — URLs de l'interface de programmation, cibles des webhooks
3. Mappage des donnees — Faire correspondre vos ID d'articles aux articles Forecast
4. Export des donnees historiques — Preparer le jeu de donnees d'entrainement

Livrables :

• Authentification fonctionnelle
• Donnees de test soumises avec succes
• Donnees historiques importees

Phase 3 : Tests (Semaines 3-4)

Activites :

1. Validation des donnees — Verifier le format et la qualite
2. Tests d'integration — Flux de donnees automatise
3. Tests de prevision — Recevoir et valider les previsions
4. Gestion des erreurs — Tester les scenarios d'echec

Livrables :

• Rapport de qualite des donnees approuve
• Synchronisation automatisee fonctionnelle
• Premieres previsions de test recues

Phase 4 : Entrainement (Semaines 4-5)

Activites :

1. Entrainement du modele — Le reseau de neurones apprend vos tendances
2. Validation de la precision — Comparer a la reference
3. Formation de l'equipe — Le personnel de cuisine apprend a utiliser les previsions
4. Documentation du processus — Documenter votre flux de travail

Livrables :

• Entrainement du modele termine
• References de precision initiales etablies
• Equipe formee sur le systeme

Phase 5 : Production (Semaine 6+)

Activites :

1. Mise en production — Commencer a utiliser les previsions quotidiennement
2. Surveillance — Suivre la precision et les problemes
3. Optimisation — Affiner selon les retours
4. Amelioration continue — Re-entrainement hebdomadaire du modele

Livrables :

• Previsions quotidiennes en utilisation de production
• Surveillance des performances en place
• Boucle de retour etablie

Support d'integration

Ressources disponibles

Documentation :

• Guide d'integration Necta
• Integration de l'interface de programmation personnalisee
• Reference de l'interface de programmation
• Guide de depannage

Support technique :

• E-mail : forecast@eaternity.org
• Delai de reponse : 24 heures pour les questions d'integration
• Support telephonique : Pour les problemes critiques de production

Assistance a l'integration :

• Appels de consultation pour la configuration
• Revue technique du code d'integration
• Validation de la qualite des donnees
• Conseils d'optimisation des performances

Scenarios d'integration courants

Scenario 1 : Chaine de restaurants avec systeme de caisse central

Configuration :

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

Approche recommandee :

• Integration unique par interface de programmation au niveau du systeme de caisse
• Previsions specifiques par site via le parametre location_id
• Mappage partage des articles du menu
• Tableau de bord de gestion central

Delai : 3-4 semaines pour le premier site, 1-2 semaines par site supplementaire

Scenario 2 : Restaurant independant avec Necta

Configuration :

• Site unique
• Necta deja en utilisation
• Responsable de cuisine familier avec Necta

Approche recommandee :

• Activer l'integration Necta-Forecast
• Synchronisation automatique des donnees depuis les donnees Necta existantes
• Previsions visibles dans l'interface de planification Necta

Delai : 1-2 semaines au total

Scenario 3 : Restauration hospitaliere avec progiciel de gestion integre personnalise

Configuration :

• Grande institution avec progiciel de gestion integre personnalise
• Departement informatique disponible
• Menu complexe avec restrictions alimentaires

Approche recommandee :

• Integration par interface de programmation personnalisee par l'equipe informatique
• Mapper les variantes alimentaires aux categories d'articles
• Notifications par webhook pour les previsions quotidiennes
• Integration avec la gestion des stocks

Delai : 4-6 semaines incluant le developpement informatique

Scenario 4 : Cantine universitaire avec systeme de caisse ancien

Configuration :

• Systeme de caisse ancien avec interface de programmation limitee
• Ressources informatiques contraintes
• Effets du calendrier academique

Approche recommandee :

• Export CSV manuel depuis le systeme de caisse (hebdomadaire)
• Televersement via le portail securise
• Livraison des previsions par e-mail
• Migration future vers l'interface de programmation quand les ressources seront disponibles

Delai : 1 semaine pour la configuration du processus manuel

Securite et conformite

Securite des donnees

Transmission :

• Toutes les donnees chiffrees en transit (TLS 1.2+)
• Validation des certificats appliquee
• Pas de HTTP non chiffre autorise

Stockage :

• Donnees chiffrees au repos
• Audits de securite reguliers
• Journalisation et surveillance des acces

Authentification :

• OAuth 2.0 pour l'acces delegue par utilisateur
• Cles d'interface de programmation avec capacite de rotation
• Liste blanche IP disponible

Conformite

Conformite RGPD :

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

Propriete des donnees :

• Vous conservez la pleine propriete de vos donnees de ventes
• Eaternity utilise les donnees uniquement pour vos previsions
• Opt-in pour la contribution a la recherche anonymisee

Confidentialite des donnees

Ce que nous stockons :

• Quantites de ventes historiques
• Informations sur les articles du menu
• Historique des previsions
• Metriques de precision

Ce que nous NE stockons PAS :

• Informations personnelles des clients
• Donnees de cartes de paiement
• Details des transactions individuelles
• Donnees identifiables des clients

Prochaines etapes

Pour commencer

1. Examinez les options d'integration sur cette page
2. Choisissez votre methode d'integration selon vos exigences
3. Lisez le guide detaille pour la methode choisie :
   • Integration Necta
   • Integration de l'interface de programmation personnalisee
4. Contactez-nous pour commencer la configuration : forecast@eaternity.org

Ressources supplementaires

• Guide de configuration rapide — Configuration etape par etape
• Guide de mise en oeuvre — Meilleures pratiques pour les equipes de cuisine
• Reference de l'interface de programmation — Documentation complete de l'interface de programmation
• Depannage — Problemes courants et solutions

Voir aussi

• Integration Necta — Guide de configuration specifique a Necta
• Integration de l'interface de programmation personnalisee — Integration de l'interface de programmation REST
• Depannage — Problemes courants et solutions
• Reference de l'interface de programmation — Documentation complete de l'interface de programmation