Intégration entreprise

Ce guide décrit le processus complet d'intégration pour les deploiements Gastro en entreprise. Conçu pour les opérations multi-sites, les traiteurs d'entreprise et la restauration collective disposant de systèmes de gestion ou de caisse existants.

Calendrier d'intégration

Une intégration entreprise typique prend 2-3 semaines du lancement à 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

Durée : 2-3 heures

Participants :

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

Ordre du jour :

1. Objectifs du projet (30 minutes)

   • Définir les indicateurs de succes (ex. "20 % de réduction des émissions en 6 mois")
   • Fixer les cibles d'indicateurs clés et la cadence de reporting
   • Aligner les attentes des parties prenantes

2. Découverte technique (60 minutes)

   • Examiner les systèmes actuels (gestion, caisse, gestion de recettes)
   • Identifier les sources et formats de données
   • Discuter de l'architecture d'intégration
   • Évaluer la qualité et l'exhaustivite des données

3. Planification opérationnelle (45 minutes)

   • Cartographier les flux de travail en cuisine
   • Identifier les besoins de gestion du changement
   • Planifier les sessions de formation des chefs
   • Définir la stratégie de communication convives

4. Calendrier du projet (15 minutes)

   • Confirmer les jalons et echeances
   • Attribuer les responsabilités
   • Planifier les sessions de suivi

Livrables :

• Charte de projet avec objectifs et indicateurs clés
• Plan d'intégration technique
• Calendrier de formation et communication

Découverte et évaluation

Suite au lancement, l'équipe Eaternity réalise :

Audit des systèmes :

• Documenter les logiciels existants (versions, configurations)
• Examiner les exports de données et la documentation API
• Évaluer la qualité des données (exhaustivite, exactitude, formatage)
• Identifier les points d'intégration et dépendances

Revue de la base de recettes :

• Exporter des données de recettes echantillon
• Analyser les conventions de nommage des ingrédients
• Identifier les entrées problématiques ou ambigues
• Estimer l'effort de correspondance des références produits

Entretiens avec les parties prenantes :

• Chefs : Flux de planification des menus, schémas de saisonnalité
• Achats : Données fournisseurs, informations sur les origines
• Informatique : Infrastructure, sécurité, modèle de support
• Communications : Directives de marque, messages de durabilité

Évaluation des risques :

• Risques techniques (compatibilité API, volume de données)
• Risques opérationnels (resistance du personnel, changements de flux)
• Risques de données (informations manquantes, problèmes de qualité)
• Stratégies d'attenuation pour chacun

Configuration du compte

Pendant que la découverte progresse, Eaternity provisionne :

• Environnement de production - L'instance Gastro de votre organisation
• Identifiants API - Clés d'accès production et test
• Comptes utilisateurs - Niveaux d'accès admin, chef et lecture seule
• Canal Slack - Support et communication dédiés
• Dépôt documentaire - Espace de travail partage pour les artefacts du projet

Phase 2 : Intégration technique (Semaine 2)

Architecture d'intégration

Choisissez l'architecture adaptee à vos besoins :

Option 1 : Intégration partenaire logiciel

Si vous utilisez des systèmes pris en charge (SAP, Delegate, Matilda) :

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

Avantages :

• Intégration preconstruite et testée
• Mise en oeuvre en 1-2 semaines
• Support continu du partenaire logiciel

Option 2 : Intégration API personnalisée

Pour les systèmes propriétaires ou non pris en charge :

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

Avantages :

• Controle total du flux de données
• Implémentation flexible
• Intégration 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 réduit
• Mise à l'échelle progressive

Correspondance des données

Faites correspondre votre base de produits aux ingrédients Gastro :

Étape 1 : Exporter vos données

Extrayez de votre système :

• Références ou identifiants produits
• Noms/descriptions des produits
• Formulations des recettes actuelles
• Unité 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

Étape 2 : Correspondance des ingrédients

L'équipe 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 équipe confirmé les correspondances
4. Identification des lacunes - Signalement des entrées manquantes en base

Défis de correspondance et solutions :

Défi	Exemple	Solution
Produits de marque spécifique	"Spaghetti Barilla #5"	Correspondre au générique "Pâtes, ble, séchés"
Produits préparés	"Sauce curry prête à l'emploi"	Decomposer en ingrédients de base
Noms régionaux	"Courgettes" (FR) vs "Zucchini"	Utiliser la correspondance par synonymes
Grades de qualité	"Boeuf USDA Prime"	Correspondre au standard "Boeuf" + modificateur

Étape 3 : Créer 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 références →

Développement de l'intégration

Semaine 2, Jours 1-3 : Développement

Eaternity ou votre équipe de développement construit l'intégration :

1. Authentification - Implémentation de la gestion des clés API
2. Extraction des données - Récupération des recettes de votre système
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 réponses - Analyse des résultats et stockage des notes
6. Gestion des erreurs - Logique de retry, journalisation, alertes

Exemple de code d'intégration (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'intégration - Flux de données de bout en bout
3. Tests de performance - Vitesse et débit du traitement par lots
4. Tests de cas limites - Données manquantes, erreurs, recettes inhabituelles

Liste de controle des tests :

• L'authentification fonctionne en test et production
• La transformation des recettes gère tous les types de références
• Le traitement par lots se termine dans le temps attendu
• La gestion des erreurs journalise et reessaie correctement
• Les résultats sont stockés correctement dans votre système
• Pas de perte ou corruption de données pendant le transfert

Validation de l'intégration

Avant la mise en service, validez avec des données réelles :

Validation echantillon (50 recettes) :

1. Sélectionnez 50 recettes diverses (entrées, plats, desserts, boissons)
2. Traitez via l'intégration
3. Examinez les notes pour exactitude et cohérence
4. L'équipe de chefs valide la correspondance des ingrédients
5. Iterez sur la table de correspondance selon les besoins

Critères d'acceptation :

• ✅ 95%+ de précision de correspondance des ingrédients
• Notes calculées en < 5 secondes par recette
• ✅ Zéro erreur critique dans les executions de test
• ✅ Équipe de chefs approuve les résultats

Phase 3 : Formation et accompagnement (Semaine 3)

Atelier de formation des chefs

Durée : Demi-journée (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 calculées (échelle A-E) ?
   • Qu'est-ce que le périmètre "du berceau a la cuisine" ?

2. Notation pratique (45 min)

   • Se connecter a l'application Gastro
   • Noter 3-5 recettes de votre menu
   • Interpréter les résultats et ventilations
   • Comparer les variantes de recettes

3. Questions-réponses et discussion (15 min)

   • Répondre aux preoccupations et questions
   • Clarifier la méthodologie

Session 2 : Guide du Chef (90 minutes)

1. Stratégies de réduction d'empreinte (45 min)

   • Substitutions de protéines végétales
   • Approvisionnement en produits de saison
   • Optimisation de l'origine et du transport
   • Ingrédients certifies (biologique, regeneratif)

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

   • Sélectionnez 3 plats a forte empreinte de votre menu
   • Appliquez les stratégies du guide
   • Calculez les nouvelles notes
   • Discutez de la faisabilité et de l'acceptation des convives

Voir le Guide du Chef complet →

Pause (30 minutes)

Session 3 : Intégration au flux de travail (60 minutes)

1. Planification des menus avec Gastro (30 min)

   • Comment vérifier les notes pendant la planification
   • Fixer des objectifs climatiques pour les menus
   • Equilibrer l'empreinte sur les périodes de repas

2. Communication et marketing (30 min)

   • Utiliser l'Eaternity Award pour la promotion
   • Conception et placement des étiquettes de menu
   • Codes QR pour informations d'empreinte détaillées
   • Idées de campagnes et réseaux sociaux

Livrables :

• Équipe de chefs formée et confiante avec Gastro
• 3 recettes optimisées pretes pour les tests
• Plan d'action pour le déploiement du menu

Formation de la direction

Durée : 90 minutes

Participants : Responsables opérations, responsables durabilité, dirigeants

Sujets :

1. Suivi des indicateurs clés (30 min)

   • Lecture des rapports mensuels
   • Comprehension de l'analyse des tendances
   • Interprétation de la comparaison avec les pairs
   • Définition d'objectifs d'amélioration

2. Eaternity Award (20 min)

   • Critere du prix : note CO2 'A' (respectueux du climat)
   • Communiquer le prix aux convives
   • Stratégies de communication convives
   • Études de cas d'autres organisations

3. Reporting et gouvernance (40 min)

   • Génération automatique de rapports mensuels
   • Création de rapports personnalisés pour les parties prenantes
   • Intégration aux indicateurs clés de durabilité
   • Modèles de reporting pour le conseil d'administration

Formation informatique/support

Durée : 2 heures

Participants : Équipe informatique, administrateurs systèmes

Sujets :

1. Architecture système (30 min)

   • Aperçu de l'intégration et flux de données
   • Surveillance et journalisation
   • Gestion des erreurs et alertes

2. Dépannage (45 min)

   • Problèmes courants et resolutions
   • Procedures d'escalade du support
   • Accès au support Eaternity via Slack
   • Fenetres de maintenance et mises a jour

3. Fonctionnalités avancées (45 min)

   • Limites de débit API et optimisation
   • Configuration des webhooks pour les mises a jour
   • Génération de rapports personnalisés
   • Export de données et analyses

Phase 4 : Lancement et déploiement (Semaine 3-4)

Lancement pilote

Commencez par un déploiement limite :

Site/menu pilote :

1. Sélectionnez 1-2 cuisines pilotes ou périodes de repas
2. Activez l'étiquetage 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 sélection des plats (respectueux du climat vs forte empreinte)
• Questions et retours des convives
• Effets sur le flux de travail en cuisine
• Performance technique du système

Durée : 1-2 semaines

Lancement complet

Deployez sur tous les sites :

Liste de controle de lancement :

• Toutes les recettes notees et notations attribuées
• Intégration fonctionnant correctement (surveillance quotidienne)
• Équipes de cuisine formees et confiantes
• Étiquettes de menu concues et imprimees
• Codes QR générés et testes
• Campagne marketing préparée
• Annonce RP (si applicable)
• Communications internes envoyees

Activités du jour de lancement :

1. Technique : Surveiller l'intégration pour les erreurs/problèmes
2. Opérations : Les responsables de cuisine verifient l'affichage des notes
3. Communications : Réseaux sociaux et RP en ligne
4. Support : Couverture de support supplémentaire pour les questions

Support post-lancement

Semaine 1 après lancement :

• Points quotidiens avec les équipes de cuisine
• Surveillance des indicateurs de performance technique
• Traitement des problèmes sous 4 heures de délai
• Collecte des retours et suggestions

Mois 1 après lancement :

• Appels de revue hebdomadaires
• Génération et revue du premier rapport mensuel
• Identification des opportunités d'optimisation
• Planification des améliorations de phase suivante

En continu :

• Appels de revue des rapports mensuels
• Revues d'activité trimestrielles
• Support d'optimisation continue
• Mises a jour de la base de données et recalculs

Tarification

Pour les informations tarifaires actuelles, consultez la page Tarifs.

Indicateurs de succes

Suivez ces indicateurs clés pour mesurer le succes du programme :

Indicateurs opérationnels

Couverture des recettes :

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

Qualité des données :

• Cible : 95%+ de précision de correspondance des ingrédients
• Mesure : Ingrédients correctement correspondus / Total des ingrédients

Disponibilité du système :

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

Indicateurs environnementaux

Note climatique moyenne :

• Cible : 10 % de réduction dans les 6 premiers mois, 20 % sur 12 mois
• Mesure : Moyenne éq. CO₂ par plat mois après mois

Pourcentage de plats respectueux du climat :

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

Plats Eaternity Award :

• Cible : 10+ plats avec note CO2 'A' dans les 3 premiers mois
• Mesure : Nombre de plats avec note CO2 'A'

Indicateurs business

Taux de sélection des convives :

• Cible : 20-30 % d'augmentation des commandes de plats respectueux du climat
• Mesure : Commandes de plats notes A avant/après étiquetage

Effet marketing :

• Cible : 5 % d'augmentation des convives motives par la durabilité
• Mesure : Enquêtes convives, engagement réseaux sociaux

Neutralite des couts :

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

Défis courants et solutions

Défi 1 : Précision de correspondance des ingrédients

Symptome : Nombreux ingrédients non reconnus ou mal apparies

Causes profondes :

• Noms de produits spécifiques aux marques
• Variations de langage régionales
• Produits préparés/de commodité
• Ingrédients de spécialité inhabituels

Solutions :

1. Créer une table de correspondance détaillée avec référence → identifiant ingrédient
2. Travailler avec Eaternity pour ajouter les ingrédients manquants (48h pour Entreprise)
3. Utiliser des termes génériques au lieu de noms de marque
4. Decomposer les produits de commodité en ingrédients de base

Défi 2 : Resistance du personnel

Symptome : Chefs reticents a utiliser le système ou changer les recettes

Causes profondes :

• Peur de contraintes sur le menu
• Manque de comprehension de la méthodologie
• Preoccupation sur l'acceptation des convives
• Perception de charge de travail supplémentaire

Solutions :

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

Défi 3 : Problèmes de qualité des données

Symptome : Notes inexactes dues a des données manquantes/incorrectes

Causes profondes :

• Formulations de recettes incompletes
• Informations sur l'origine manquantes
• Recettes obsoletes dans la base
• Unités ou quantités incorrectes

Solutions :

1. Auditer la base de recettes avant l'intégration
2. Standardiser les formats de recettes et les exigences
3. Vérifications régulières de qualité des données (revues mensuelles)
4. Signaler et corriger les problèmes dans l'application Gastro

Défi 4 : Problèmes techniques d'intégration

Symptome : Erreurs API, performances lentes, echecs de synchronisation des données

Causes profondes :

• Limite de débit depassee
• Tailles de lots trop importantes
• Connectivite réseau
• 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 débit dans les en-têtes de réponse
4. Utiliser l'environnement de test pour les tests
5. Contacter le support Eaternity pour optimisation

Prochaines étapes après l'intégration

Mois 2-3 : Phase d'optimisation

Domaines d'action :

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

Mois 4-6 : Phase de mise a l'échelle

Domaines d'action :

1. Sites supplémentaires - Deployer sur toutes les cuisines
2. Fonctionnalités avancées - Règles de calcul personnalisées, données spécifiques aux fournisseurs
3. Automatisation du reporting - Intégration d'outils BI
4. Maximisation des prix - Amener plus de plats a la note A

Mois 7-12 : Phase de maturite

Domaines d'action :

1. Amélioration continue - Suivre les tendances et fixer de nouveaux objectifs
2. Innovation - Tester de nouvelles recettes et ingrédients 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 reçoivent :

• Accès direct aux ingenieurs support Eaternity
• Délai de réponse de 4 heures pendant les heures ouvrables
• Alertes proactives sur les problèmes système
• Notifications de mise a jour de la base de données

Revues d'activité trimestrielles

Appels de revue tous les 3 mois :

• Performance par rapport aux indicateurs clés
• Opportunités d'optimisation des menus
• Feuille de route des fonctionnalités et versions a venir
• Partage des meilleures pratiques

Base de connaissances

Accès a :

• Documentation complete (ce site)
• Tutoriels video et webinaires
• Études de cas d'organisations similaires
• Exemples de code d'intégration

Services professionnels

Support a la demande pour :

• Conseil en optimisation de recettes
• Développement de campagnes marketing
• Développement de fonctionnalités personnalisées
• Sessions de formation supplémentaires

Questions fréquentes

Combien de temps avant de voir des résultats ?

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

• Immédiat : Notes de référence et identification des plats a forte empreinte
• Semaine 4 : Premières recettes optimisées lancees
• Mois 2 : 10-15 % de réduction moyenne des émissions
• Mois 6 : 20-25 % de réduction avec optimisation systématique

Pouvons-nous personnaliser l'intégration ?

Oui - Les clients entreprise peuvent :

• Ajouter des règles de calcul personnalisées pour des fournisseurs spécifiques
• Créer des modèles de rapports spécifiques a l'organisation
• Intégrer avec des outils BI (Tableau, Power BI, etc.)
• Développer des flux de travail personnalisés dans l'application web

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

Deux options :

1. Intégration API personnalisée - Construire avec notre API REST (contactez les ventes pour tarifs)
2. Flux de travail CSV manuel - Export de votre système, import dans Gastro

La plupart des systèmes modernes peuvent être intégrés via développement API personnalisé.

Comment gérer les changements de recettes ?

L'intégration recalculé automatiquement lorsque les recettes changent. Les notes historiques sont conservees pour l'analyse des tendances.

Pouvons-nous obtenir des données spécifiques aux fournisseurs ?

Oui - Les clients entreprise peuvent :

1. Télécharger les rapports ACV des fournisseurs (si disponibles)
2. Travailler avec Eaternity pour créer des règles de calcul spécifiques aux fournisseurs
3. Utiliser des remplacements d'origine pour les schémas d'approvisionnement connus

Quelle formation est incluse ?

L'intégration standard comprend :

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

Formation supplémentaire disponible en services professionnels.

Comment gérer les ingrédients manquants ?

Le support entreprise ajoute les ingrédients manquants sous 48 heures. Fournissez :

• Nom et description de l'ingrédient
• Origine et méthode de production typiques
• Toutes données ACV ou spécifications produit disponibles

Documentation connexe

• Démarrage rapide API - Guide d'intégration développeur
• Correspondance des références - Bonnes pratiques de correspondance
• Partenaires logiciels - Intégrations preconstruites
• Rapports mensuels - Suivi et reporting des indicateurs clés
• Guide du Chef - Stratégies d'optimisation de recettes