Integration entreprise

Ce guide decrit le processus complet d'integration pour les deploiements Gastro en entreprise. Concu pour les operations multi-sites, les traiteurs d'entreprise et la restauration collective disposant de systemes de gestion ou de caisse existants.

Calendrier d'integration

Une integration entreprise typique prend 2-3 semaines du lancement a la mise en service :

Semaine 1        Semaine 2        Semaine 3
├─────────────┼─────────────┼─────────────┤
Lancement     Integration   Formation     Mise en service
│             │             │             │
├─ Planif.    ├─ Technique  ├─ Chef       ├─ Go-Live
├─ Decouverte ├─ Mapping    ├─ Direction  ├─ Suivi
└─ Config     └─ Tests      └─ Support    └─ Optimisation

Phase 1 : Lancement et planification (Semaine 1)

Atelier de lancement

Duree : 2-3 heures

Participants :

• Sponsor executif (decideur)
• Responsable de cuisine ou chef executif
• Contact technique informatique
• Responsable marketing/communication
• Gestionnaire de succes client Eaternity

Ordre du jour :

1. Objectifs du projet (30 minutes)

   • Definir les indicateurs de succes (ex. "20 % de reduction des emissions en 6 mois")
   • Fixer les cibles d'indicateurs cles et la cadence de reporting
   • Aligner les attentes des parties prenantes

2. Decouverte technique (60 minutes)

   • Examiner les systemes actuels (gestion, caisse, gestion de recettes)
   • Identifier les sources et formats de donnees
   • Discuter de l'architecture d'integration
   • Evaluer la qualite et l'exhaustivite des donnees

3. Planification operationnelle (45 minutes)

   • Cartographier les flux de travail en cuisine
   • Identifier les besoins de gestion du changement
   • Planifier les sessions de formation des chefs
   • Definir la strategie de communication convives

4. Calendrier du projet (15 minutes)

   • Confirmer les jalons et echeances
   • Attribuer les responsabilites
   • Planifier les sessions de suivi

Livrables :

• Charte de projet avec objectifs et indicateurs cles
• Plan d'integration technique
• Calendrier de formation et communication

Decouverte et evaluation

Suite au lancement, l'equipe Eaternity realise :

Audit des systemes :

• Documenter les logiciels existants (versions, configurations)
• Examiner les exports de donnees et la documentation API
• Evaluer la qualite des donnees (exhaustivite, exactitude, formatage)
• Identifier les points d'integration et dependances

Revue de la base de recettes :

• Exporter des donnees de recettes echantillon
• Analyser les conventions de nommage des ingredients
• Identifier les entrees problematiques ou ambigues
• Estimer l'effort de correspondance des references produits

Entretiens avec les parties prenantes :

• Chefs : Flux de planification des menus, schemas de saisonnalite
• Achats : Donnees fournisseurs, informations sur les origines
• Informatique : Infrastructure, securite, modele de support
• Communications : Directives de marque, messages de durabilite

Evaluation des risques :

• Risques techniques (compatibilite API, volume de donnees)
• Risques operationnels (resistance du personnel, changements de flux)
• Risques de donnees (informations manquantes, problemes de qualite)
• Strategies d'attenuation pour chacun

Configuration du compte

Pendant que la decouverte progresse, Eaternity provisionne :

• Environnement de production - L'instance Gastro de votre organisation
• Identifiants API - Cles d'acces production et test
• Comptes utilisateurs - Niveaux d'acces admin, chef et lecture seule
• Canal Slack - Support et communication dedies
• Depot documentaire - Espace de travail partage pour les artefacts du projet

Phase 2 : Integration technique (Semaine 2)

Architecture d'integration

Choisissez l'architecture adaptee a vos besoins :

Option 1 : Integration partenaire logiciel

Si vous utilisez des systemes pris en charge (SAP, Delegate, Matilda) :

Votre gestion/caisse → Connecteur partenaire → API Gastro → BDD resultats
                                                         ↓
                                              Rapports + Etiquettes menu

Avantages :

• Integration preconstruite et testee
• Mise en oeuvre en 1-2 semaines
• Support continu du partenaire logiciel

Option 2 : Integration API personnalisee

Pour les systemes proprietaires ou non pris en charge :

Votre systeme → Middleware personnalise → API Gastro → Votre systeme
                                                     ↓
                                          Affichage resultats

Avantages :

• Controle total du flux de donnees
• Implementation flexible
• Integration directe avec les outils internes

Option 3 : Approche hybride

Combinez processus automatises et manuels :

Recettes a fort volume → API → Notation automatique
Articles speciaux/saisonniers → Application web → Saisie manuelle

Avantages :

• Meilleur des deux mondes
• Investissement initial reduit
• Mise a l'echelle progressive

Correspondance des donnees

Faites correspondre votre base de produits aux ingredients Gastro :

Etape 1 : Exporter vos donnees

Extrayez de votre systeme :

• References ou identifiants produits
• Noms/descriptions des produits
• Formulations des recettes actuelles
• Unite de mesure
• (Optionnel) Fournisseur, origine, certification biologique

Exemple d'export CSV :

SKU,Nom_Produit,Categorie,UDM
10234,Boeuf hache Bio,Viande,kg
10567,Spaghetti Nr. 5 Barilla,Pates,kg
20891,Tomates pelees Bio,Legumes,kg

Etape 2 : Correspondance des ingredients

L'equipe Eaternity effectue la correspondance initiale :

1. Correspondance automatique - L'algorithme fait correspondre ~60-70 % des articles
2. Revue manuelle - Examen expert des cas ambigus
3. Validation client - Votre equipe confirme les correspondances
4. Identification des lacunes - Signalement des entrees manquantes en base

Defis de correspondance et solutions :

Defi	Exemple	Solution
Produits de marque specifique	"Spaghetti Barilla #5"	Correspondre au generique "Pates, ble, seches"
Produits prepares	"Sauce curry prete a l'emploi"	Decomposer en ingredients de base
Noms regionaux	"Courgettes" (FR) vs "Zucchini"	Utiliser la correspondance par synonymes
Grades de qualite	"Boeuf USDA Prime"	Correspondre au standard "Boeuf" + modificateur

Etape 3 : Creer la table de correspondance

Construisez une table de recherche pour la conversion automatique :

{
  "sku_mappings": [
    {
      "sku": "10234",
      "product_name": "Boeuf hache Bio",
      "eaternity_ingredient_id": "ing_beef_ground_organic_ch",
      "default_origin": "Suisse",
      "organic": true,
      "unit_conversion": {
        "from": "kg",
        "to": "g",
        "factor": 1000
      }
    },
    {
      "sku": "10567",
      "product_name": "Spaghetti Nr. 5 Barilla",
      "eaternity_ingredient_id": "ing_pasta_wheat_dried",
      "default_origin": "Italie",
      "organic": false,
      "unit_conversion": {
        "from": "kg",
        "to": "g",
        "factor": 1000
      }
    }
  ]
}

En savoir plus sur la correspondance des references →

Developpement de l'integration

Semaine 2, Jours 1-3 : Developpement

Eaternity ou votre equipe de developpement construit l'integration :

1. Authentification - Implementation de la gestion des cles API
2. Extraction des donnees - Recuperation des recettes de votre systeme
3. Transformation - Conversion au format API Gastro via la table de correspondance
4. Appels API - Envoi des recettes pour notation (traitement par lots)
5. Gestion des reponses - Analyse des resultats et stockage des notes
6. Gestion des erreurs - Logique de retry, journalisation, alertes

Exemple de code d'integration (Python) :

import requests
import logging

class GastroIntegration:
    def __init__(self, api_key, mapping_table):
        self.api_key = api_key
        self.base_url = "https://api.eaternity.org/v1"
        self.mapping = mapping_table

    def fetch_recipes_from_erp(self):
        """
        Recuperer les recettes de votre systeme de gestion.
        L'implementation depend de votre systeme specifique.
        """
        # Votre appel API gestion ici
        recipes = erp_client.get_active_recipes()
        return recipes

    def transform_recipe(self, erp_recipe):
        """
        Transformer le format de recette gestion au format API Gastro.
        """
        ingredients = []
        for item in erp_recipe['items']:
            # Recherche dans la table de correspondance
            mapping = self.mapping.get(item['sku'])
            if mapping:
                ingredients.append({
                    'name': mapping['eaternity_ingredient_id'],
                    'quantity': item['quantity'] * mapping['unit_conversion']['factor'],
                    'unit': mapping['unit_conversion']['to'],
                    'origin': mapping.get('default_origin'),
                    'organic': mapping.get('organic', False)
                })
            else:
                logging.warning(f"Pas de correspondance pour la reference {item['sku']}")

        return {
            'name': erp_recipe['name'],
            'servings': erp_recipe['servings'],
            'ingredients': ingredients
        }

    def score_recipe(self, recipe):
        """
        Envoyer la recette a l'API Gastro pour notation.
        """
        url = f"{self.base_url}/recipes/score"
        headers = {
            'Authorization': f'Bearer {self.api_key}',
            'Content-Type': 'application/json'
        }

        response = requests.post(url, headers=headers, json={'recipe': recipe})
        response.raise_for_status()
        return response.json()

    def process_all_recipes(self):
        """
        Flux de travail principal d'integration.
        """
        recipes = self.fetch_recipes_from_erp()
        results = []

        for erp_recipe in recipes:
            try:
                gastro_recipe = self.transform_recipe(erp_recipe)
                score = self.score_recipe(gastro_recipe)
                results.append({
                    'recipe_id': erp_recipe['id'],
                    'scores': score
                })
                # Mise a jour de la gestion avec les notes
                erp_client.update_recipe_scores(erp_recipe['id'], score)

            except Exception as e:
                logging.error(f"Erreur de traitement de {erp_recipe['name']}: {e}")

        return results

Semaine 2, Jours 4-5 : Tests

Phase de tests comprehensifs :

1. Tests unitaires - Fonctions et transformations individuelles
2. Tests d'integration - Flux de donnees de bout en bout
3. Tests de performance - Vitesse et debit du traitement par lots
4. Tests de cas limites - Donnees manquantes, erreurs, recettes inhabituelles

Liste de controle des tests :

• L'authentification fonctionne en test et production
• La transformation des recettes gere tous les types de references
• Le traitement par lots se termine dans le temps attendu
• La gestion des erreurs journalise et reessaie correctement
• Les resultats sont stockes correctement dans votre systeme
• Pas de perte ou corruption de donnees pendant le transfert

Validation de l'integration

Avant la mise en service, validez avec des donnees reelles :

Validation echantillon (50 recettes) :

1. Selectionnez 50 recettes diverses (entrees, plats, desserts, boissons)
2. Traitez via l'integration
3. Examinez les notes pour exactitude et coherence
4. L'equipe de chefs valide la correspondance des ingredients
5. Iterez sur la table de correspondance selon les besoins

Criteres d'acceptation :

• ✅ 95%+ de precision de correspondance des ingredients
• Notes calculees en < 5 secondes par recette
• ✅ Zero erreur critique dans les executions de test
• ✅ Equipe de chefs approuve les resultats

Phase 3 : Formation et accompagnement (Semaine 3)

Atelier de formation des chefs

Duree : Demi-journee (4 heures)

Participants : Responsables de cuisine, chefs executifs, planificateurs de menus

Session 1 : Comprendre les notes (90 minutes)

1. Bases de la notation (30 min)

   • Que mesurent les notes climatiques ?
   • Comment les notations sont-elles calculees (echelle A-E) ?
   • Qu'est-ce que le perimetre "du berceau a la cuisine" ?

2. Notation pratique (45 min)

   • Se connecter a l'application Gastro
   • Noter 3-5 recettes de votre menu
   • Interpreter les resultats et ventilations
   • Comparer les variantes de recettes

3. Questions-reponses et discussion (15 min)

   • Repondre aux preoccupations et questions
   • Clarifier la methodologie

Session 2 : Guide du Chef (90 minutes)

1. Strategies de reduction d'empreinte (45 min)

   • Substitutions de proteines vegetales
   • Approvisionnement en produits de saison
   • Optimisation de l'origine et du transport
   • Ingredients certifies (biologique, regeneratif)

2. Exercice d'optimisation de recettes (45 min)

   • Selectionnez 3 plats a forte empreinte de votre menu
   • Appliquez les strategies du guide
   • Calculez les nouvelles notes
   • Discutez de la faisabilite et de l'acceptation des convives

Voir le Guide du Chef complet →

Pause (30 minutes)

Session 3 : Integration au flux de travail (60 minutes)

1. Planification des menus avec Gastro (30 min)

   • Comment verifier les notes pendant la planification
   • Fixer des objectifs climatiques pour les menus
   • Equilibrer l'empreinte sur les periodes de repas

2. Communication et marketing (30 min)

   • Utiliser l'Eaternity Award pour la promotion
   • Conception et placement des etiquettes de menu
   • Codes QR pour informations d'empreinte detaillees
   • Idees de campagnes et reseaux sociaux

Livrables :

• Equipe de chefs formee et confiante avec Gastro
• 3 recettes optimisees pretes pour les tests
• Plan d'action pour le deploiement du menu

Formation de la direction

Duree : 90 minutes

Participants : Responsables operations, responsables durabilite, dirigeants

Sujets :

1. Suivi des indicateurs cles (30 min)

   • Lecture des rapports mensuels
   • Comprehension de l'analyse des tendances
   • Interpretation de la comparaison avec les pairs
   • Definition d'objectifs d'amelioration

2. Eaternity Award (20 min)

   • Criteres de certification 5/5 (top 20 %)
   • Visuels et supports marketing du prix
   • Strategies de communication convives
   • Etudes de cas d'autres organisations

3. Reporting et gouvernance (40 min)

   • Generation automatique de rapports mensuels
   • Creation de rapports personnalises pour les parties prenantes
   • Integration aux indicateurs cles de durabilite
   • Modeles de reporting pour le conseil d'administration

Formation informatique/support

Duree : 2 heures

Participants : Equipe informatique, administrateurs systemes

Sujets :

1. Architecture systeme (30 min)

   • Apercu de l'integration et flux de donnees
   • Surveillance et journalisation
   • Gestion des erreurs et alertes

2. Depannage (45 min)

   • Problemes courants et resolutions
   • Procedures d'escalade du support
   • Acces au support Eaternity via Slack
   • Fenetres de maintenance et mises a jour

3. Fonctionnalites avancees (45 min)

   • Limites de debit API et optimisation
   • Configuration des webhooks pour les mises a jour
   • Generation de rapports personnalises
   • Export de donnees et analyses

Phase 4 : Lancement et deploiement (Semaine 3-4)

Lancement pilote

Commencez par un deploiement limite :

Site/menu pilote :

1. Selectionnez 1-2 cuisines pilotes ou periodes de repas
2. Activez l'etiquetage des menus respectueux du climat
3. Formez le personnel de service a la communication convives
4. Surveillez les retours et questions des convives

Indicateurs a suivre :

• Taux de selection des plats (respectueux du climat vs forte empreinte)
• Questions et retours des convives
• Effets sur le flux de travail en cuisine
• Performance technique du systeme

Duree : 1-2 semaines

Lancement complet

Deployez sur tous les sites :

Liste de controle de lancement :

• Toutes les recettes notees et notations attribuees
• Integration fonctionnant correctement (surveillance quotidienne)
• Equipes de cuisine formees et confiantes
• Etiquettes de menu concues et imprimees
• Codes QR generes et testes
• Campagne marketing preparee
• Annonce RP (si applicable)
• Communications internes envoyees

Activites du jour de lancement :

1. Technique : Surveiller l'integration pour les erreurs/problemes
2. Operations : Les responsables de cuisine verifient l'affichage des notes
3. Communications : Reseaux sociaux et RP en ligne
4. Support : Couverture de support supplementaire pour les questions

Support post-lancement

Semaine 1 apres lancement :

• Points quotidiens avec les equipes de cuisine
• Surveillance des indicateurs de performance technique
• Traitement des problemes sous 4 heures de delai
• Collecte des retours et suggestions

Mois 1 apres lancement :

• Appels de revue hebdomadaires
• Generation et revue du premier rapport mensuel
• Identification des opportunites d'optimisation
• Planification des ameliorations de phase suivante

En continu :

• Appels de revue des rapports mensuels
• Revues d'activite trimestrielles
• Support d'optimisation continue
• Mises a jour de la base de donnees et recalculs

Tarification

Pour les informations tarifaires actuelles, consultez la page Tarifs.

Indicateurs de succes

Suivez ces indicateurs cles pour mesurer le succes du programme :

Indicateurs operationnels

Couverture des recettes :

• Cible : 100 % des plats du menu actif notes sous 1 mois
• Mesure : Nombre de recettes notees / Total des recettes actives

Qualite des donnees :

• Cible : 95%+ de precision de correspondance des ingredients
• Mesure : Ingredients correctement correspondus / Total des ingredients

Disponibilite du systeme :

• Cible : 99,5 % de disponibilite API
• Mesure : Appels API reussis / Total des appels API

Indicateurs environnementaux

Note climatique moyenne :

• Cible : 10 % de reduction dans les 6 premiers mois, 20 % sur 12 mois
• Mesure : Moyenne eq. CO₂ par plat mois apres mois

Pourcentage de plats respectueux du climat :

• Cible : 30 % du menu atteint la note E (top 20 %)
• Mesure : Plats notes E / Total des plats

Certifications Eaternity Award :

• Cible : 10+ plats certifies dans les 3 premiers mois
• Mesure : Nombre de plats primes 5/5

Indicateurs business

Taux de selection des convives :

• Cible : 20-30 % d'augmentation des commandes de plats respectueux du climat
• Mesure : Commandes de plats notes E avant/apres etiquetage

Effet marketing :

• Cible : 5 % d'augmentation des convives motives par la durabilite
• Mesure : Enquetes convives, engagement reseaux sociaux

Neutralite des couts :

• Cible : Pas d'augmentation du pourcentage de cout alimentaire
• Mesure : % cout alimentaire avant/apres optimisation

Defis courants et solutions

Defi 1 : Precision de correspondance des ingredients

Symptome : Nombreux ingredients non reconnus ou mal apparies

Causes profondes :

• Noms de produits specifiques aux marques
• Variations de langage regionales
• Produits prepares/de commodite
• Ingredients de specialite inhabituels

Solutions :

1. Creer une table de correspondance detaillee avec reference → identifiant ingredient
2. Travailler avec Eaternity pour ajouter les ingredients manquants (48h pour Entreprise)
3. Utiliser des termes generiques au lieu de noms de marque
4. Decomposer les produits de commodite en ingredients de base

Defi 2 : Resistance du personnel

Symptome : Chefs reticents a utiliser le systeme ou changer les recettes

Causes profondes :

• Peur de contraintes sur le menu
• Manque de comprehension de la methodologie
• Preoccupation sur l'acceptation des convives
• Perception de charge de travail supplementaire

Solutions :

1. Presenter comme un outil d'autonomisation, pas une contrainte
2. Impliquer les chefs tot dans le lancement et la planification
3. Montrer les gains rapides de substitutions simples
4. Celebrer les succes avec l'Eaternity Award
5. Fournir une formation des chefs mettant l'accent sur la saveur et la satisfaction des convives

Defi 3 : Problemes de qualite des donnees

Symptome : Notes inexactes dues a des donnees manquantes/incorrectes

Causes profondes :

• Formulations de recettes incompletes
• Informations sur l'origine manquantes
• Recettes obsoletes dans la base
• Unites ou quantites incorrectes

Solutions :

1. Auditer la base de recettes avant l'integration
2. Standardiser les formats de recettes et les exigences
3. Verifications regulieres de qualite des donnees (revues mensuelles)
4. Signaler et corriger les problemes dans l'application Gastro

Defi 4 : Problemes techniques d'integration

Symptome : Erreurs API, performances lentes, echecs de synchronisation des donnees

Causes profondes :

• Limite de debit depassee
• Tailles de lots trop importantes
• Connectivite reseau
• Erreurs d'authentification

Solutions :

1. Implementer un traitement par lots correct (50-100 recettes max)
2. Ajouter une logique de retry avec backoff exponentiel
3. Surveiller les limites de debit dans les en-tetes de reponse
4. Utiliser l'environnement de test pour les tests
5. Contacter le support Eaternity pour optimisation

Prochaines etapes apres l'integration

Mois 2-3 : Phase d'optimisation

Domaines d'action :

1. Optimisation des recettes - Reduire systematiquement les plats a forte empreinte
2. Planification de menu saisonnier - Tirer parti de la saisonnalite pour des notes plus basses
3. Collaboration avec les fournisseurs - Travailler avec les achats sur les donnees d'origine
4. Engagement des convives - Lancer des campagnes marketing

Mois 4-6 : Phase de mise a l'echelle

Domaines d'action :

1. Sites supplementaires - Deployer sur toutes les cuisines
2. Fonctionnalites avancees - Regles de calcul personnalisees, donnees specifiques aux fournisseurs
3. Automatisation du reporting - Integration d'outils BI
4. Maximisation des prix - Amener plus de plats a la note E

Mois 7-12 : Phase de maturite

Domaines d'action :

1. Amelioration continue - Suivre les tendances et fixer de nouveaux objectifs
2. Innovation - Tester de nouvelles recettes et ingredients a faible empreinte
3. Leadership d'opinion - Partager les histoires de succes publiquement
4. Plaidoyer - Influencer les pratiques des fournisseurs et du secteur

Ressources de support

Canal Slack dedie

Les clients entreprise recoivent :

• Acces direct aux ingenieurs support Eaternity
• Delai de reponse de 4 heures pendant les heures ouvrables
• Alertes proactives sur les problemes systeme
• Notifications de mise a jour de la base de donnees

Revues d'activite trimestrielles

Appels de revue tous les 3 mois :

• Performance par rapport aux indicateurs cles
• Opportunites d'optimisation des menus
• Feuille de route des fonctionnalites et versions a venir
• Partage des meilleures pratiques

Base de connaissances

Acces a :

• Documentation complete (ce site)
• Tutoriels video et webinaires
• Etudes de cas d'organisations similaires
• Exemples de code d'integration

Services professionnels

Support a la demande pour :

• Conseil en optimisation de recettes
• Developpement de campagnes marketing
• Developpement de fonctionnalites personnalisees
• Sessions de formation supplementaires

Questions frequentes

Combien de temps avant de voir des resultats ?

La plupart des organisations voient un effet mesurable dans les 1-2 mois :

• Immediat : Notes de reference et identification des plats a forte empreinte
• Semaine 4 : Premieres recettes optimisees lancees
• Mois 2 : 10-15 % de reduction moyenne des emissions
• Mois 6 : 20-25 % de reduction avec optimisation systematique

Pouvons-nous personnaliser l'integration ?

Oui - Les clients entreprise peuvent :

• Ajouter des regles de calcul personnalisees pour des fournisseurs specifiques
• Creer des modeles de rapports specifiques a l'organisation
• Integrer avec des outils BI (Tableau, Power BI, etc.)
• Developper des flux de travail personnalises dans l'application web

Que faire si notre gestion/caisse n'est pas un partenaire liste ?

Deux options :

1. Integration API personnalisee - Construire avec notre API REST (contactez les ventes pour tarifs)
2. Flux de travail CSV manuel - Export de votre systeme, import dans Gastro

La plupart des systemes modernes peuvent etre integres via developpement API personnalise.

Comment gerer les changements de recettes ?

L'integration recalcule automatiquement lorsque les recettes changent. Les notes historiques sont conservees pour l'analyse des tendances.

Pouvons-nous obtenir des donnees specifiques aux fournisseurs ?

Oui - Les clients entreprise peuvent :

1. Telecharger les rapports ACV des fournisseurs (si disponibles)
2. Travailler avec Eaternity pour creer des regles de calcul specifiques aux fournisseurs
3. Utiliser des remplacements d'origine pour les schemas d'approvisionnement connus

Quelle formation est incluse ?

L'integration standard comprend :

• Atelier demi-journee pour les chefs
• 90 minutes de formation direction
• 2 heures de formation informatique/support

Formation supplementaire disponible en services professionnels.

Comment gerer les ingredients manquants ?

Le support entreprise ajoute les ingredients manquants sous 48 heures. Fournissez :

• Nom et description de l'ingredient
• Origine et methode de production typiques
• Toutes donnees ACV ou specifications produit disponibles

Documentation connexe

• Demarrage rapide API - Guide d'integration developpeur
• Correspondance des references - Bonnes pratiques de correspondance
• Partenaires logiciels - Integrations preconstruites
• Rapports mensuels - Suivi et reporting des indicateurs cles
• Guide du Chef - Strategies d'optimisation de recettes