| Pos. | Libellé | Format | Couleur |
|---|
Génération de synthèse
Historique des générations
| Lot | Fiche | Type | Lignes | Demandeur | Statut | Durée | Date | Actions |
|---|
Aucune génération.
Fiches CEE
| Numéro | Libellé | Code prestation | Modèle PP | Modèle PM | Auto | Actions |
|---|
Aucune fiche configurée.
Configuration analyse PDF
PDF modèle
Uploadez un PDF type pour cette fiche. Il servira de référence pour tester les patterns d'extraction.
Patterns d'extraction
Définissez les textes à rechercher dans le PDF et le label associé pour le mapping ($PDF.label).
| Texte à chercher | Label (mapping) | Position valeur | Actions |
|---|
Aucun pattern configuré.
Résultats du test
| Label | Valeur extraite |
|---|
Codes Prestation
| Code | Libellé | Formulaires Kizeo | Actions |
|---|
Aucun code prestation.
Formulaires Kizeo
| Type | Form ID | Date début | Date fin | Champ ref mission | Champ ref lot | Champ prise RDV | Champ réalisable / concl. | Champ relecture | Actions |
|---|
Paramétrage des valeurs de champs Kizeo Liste & Choix
| Champ Kizeo | Correspondances | Actions |
|---|
Aucune correspondance configurée.
Modèles
| Nom | Type | Colonnes | Fiches | Actions |
|---|
Aucun modèle.
▼ Format de sortie
▼ Mapping
| Pos. | Libellé | Source | Valeur source | Si # = Oui | Valid. |
|---|
▼ Compteurs synthèse
| Compteur | Colonne | Opérateur | Valeur | Conditions OR |
|---|
Tokens API publique
Gérez les tokens d'accès à l'API publique. La documentation Swagger est disponible à /public-api/docs.
| Nom | Préfixe | Créé par | Créé le | Expire le | Dernière utilisation | Statut | Actions |
|---|
Aucun token créé.
KPI
Lancer une analyse
Historique des analyses KPI
| Nom | Clients | Fiches | Période | Missions | Statut | Date | Actions |
|---|
Aucune analyse KPI.
Mappings KPI
| Nom | Modèle | Type | Actions |
|---|
Mapping KPI
Seuls les modèles non rattachés à un autre mapping (principal ou secondaire) peuvent être ajoutés.
Paramètres globaux
Le fichier commande est lu dans l'outil de pilotage ; ce dossier SharePoint ne sert qu'en repli si le lot n'y a pas de fichier. Le système y cherche d'abord {ref_lot}.json.gz (format produit par l'app Intégrations) puis, à défaut, {ref_lot}.xlsx.
Sert à récupérer les taux réglementaires depuis l'outil Intégrations (source unique). La valeur est masquée après enregistrement. Voir l'onglet Taux régl.
Utilisé pour lire les lots, missions, fichiers commande et rapports PDF, et pour déposer les synthèses dans Pilotage CEE. La valeur est masquée après enregistrement.
Guide
Utilisation
Connexion et session
La connexion passe par votre compte Microsoft (Spekty). Si vous êtes déjà connecté à Microsoft, elle est automatique : aucun mot de passe ni choix de compte n'est demandé.
- Session expirée en cours d'utilisation : l'outil se reconnecte tout seul (écran « Connexion… » le temps de l'aller-retour Microsoft) et vous ramène sur la page où vous étiez. Aucun message d'erreur ne s'affiche ; l'action en cours est simplement à refaire.
- Si Microsoft demande vos identifiants (session Microsoft fermée), connectez-vous : vous revenez ensuite sur la même page.
- Téléchargement (Excel, PDF, aperçu, export KPI, template) avec une session expirée : même reconnexion, puis le fichier se télécharge.
- Si la connexion échoue juste après une tentative, l'outil ne relance pas en boucle : il affiche « La connexion Microsoft n'a pas abouti » avec un bouton Se reconnecter.
- Déconnexion (menu utilisateur) : vous restez déconnecté, sans reconnexion automatique dans cet onglet ; le bouton Se reconnecter permet de revenir.
- Vue mini (menu utilisateur, juste au-dessus de Déconnexion) : cochée, la barre de menus ne garde que Génération. Le réglage est enregistré pour vous seul et vous suit d'un poste à l'autre ; décochez pour retrouver tous les menus. Vos droits ne changent pas.
Saisir une date
Toutes les dates se saisissent au format jj/mm/aaaa, quelle que soit la langue du navigateur. Les barres se posent seules (« 03022025 » donne 03/02/2025) ; « 3/2/25 » ou « 03.02.2025 » sont aussi acceptés. L'icône calendrier, dans le champ, ouvre le calendrier du navigateur. Une date impossible (31/02/2025…) reste affichée en rouge et n'est pas prise en compte.
Lancer une synthèse
Mode standard (par lot)
- Accéder à l'onglet Génération.
- Saisir la référence du lot dans le champ prévu (minimum 12 caractères, commençant par une date au format
YYYYMMDD, ex :20260303-07-DIVERS-INS-EDF). - Cliquer sur Générer.
La coche « Enregistrer dans l'outil de pilotage » est activée par défaut et se réactive à chaque rechargement de la page : toute synthèse doit normalement être déposée automatiquement. La décocher demande une confirmation ; elle ne vaut que pour les générations lancées depuis la page en cours.
Le type PP/PM est déterminé automatiquement depuis les informations du lot dans l'outil de pilotage. La fiche CEE est toujours celle du lot (champ « Fiche CEE ») : elle n'est jamais déduite de la référence. Si ce champ est vide, la génération s'arrête avec le message « Fiche CEE non renseignée sur le lot » (sauf en mode Générique, où ce n'est pas bloquant).
Le traitement se lance en arrière-plan. Une barre de progression indique l'avancement en temps réel. La durée affichée correspond au temps de traitement effectif (hors éventuelle validation manuelle).
Mode 100% (par missions)
- Activer le toggle Mode 100%.
- Saisir la liste des références de mission (une par ligne).
- Sélectionner la fiche CEE concernée (seules les fiches éligibles 100% sont proposées).
- Choisir le type PP/PM (en mode 100%, ce choix est manuel).
- Optionnellement, renseigner un nom de fichier de sortie personnalisé.
- Cliquer sur Générer.
En mode 100%, les missions sont recherchées directement par leur référence dans Kizeo, avec fallback sur les formulaires archivés si nécessaire. Seules les missions relues, avec RDV validé, non bloquées et réalisables sont retenues.
Découpage P5/P6 automatique (100%) : la date d'engagement de chaque mission est lue sur sa commande individuelle dans l'outil de pilotage (champ Date_engagement, jour en heure de Paris). Si les missions couvrent les deux périodes (P5 = engagement avant le 01/01/2026, P6 = à partir du 01/01/2026), deux synthèses sont lancées automatiquement, sans rien cocher, avec les fichiers suffixés -P5 / -P6 (badge P5/P6 dans l'historique). Une seule période : synthèse unique, comme avant. Si les deux périodes sont présentes mais qu'une mission n'a pas de date d'engagement lisible, la génération est bloquée avec la liste des missions concernées (les missions « Annulé » sont ignorées). Si aucune date n'a pu être lue, une synthèse unique est produite avec un avertissement. S'applique aussi à l'API (appel depuis l'outil de pilotage).
PNCEE (client DGEC, plusieurs lots)
La coche PNCEE regroupe plusieurs lots DGEC dans un seul Excel : saisie des références (une par ligne), puis du nom du fichier au lancement. Détail dans la section Synthèses PNCEE (client DGEC).
Multi-formulaires Kizeo
Le toggle Multi-formulaires Kizeo permet de rechercher les missions dans tous les formulaires Kizeo configurés pour le code prestation, et pas uniquement dans le formulaire en vigueur selon la date d'intégration du lot. Cela inclut les formulaires d'inspection et CPC.
Cette option est utile dans de rares cas où des missions ont été saisies dans un ancien formulaire. Elle est désactivée par défaut car elle augmente le temps de traitement. Elle n'est pas disponible en mode 100% (qui recherche déjà dans tous les formulaires) ni via l'API publique (VBA).
Générique
La coche Générique (à côté de « Multi-formulaires Kizeo ») remplace le modèle de synthèse normalement utilisé (celui de la fiche ou de sa version) par le modèle nommé « Générique PP » ou « Générique PM », selon que le lot est PP ou PM. Tout le reste est inchangé : fiche, code prestation, formulaires Kizeo, validations, compteurs, PDF et dépôt.
La fiche n'a pas besoin d'être configurée dans l'outil : si la fiche du lot est inconnue de l'outil ou si le champ « Fiche CEE » du lot est vide, la synthèse est produite quand même, avec le code prestation déduit de la référence du lot (ses formulaires Kizeo et correspondances doivent, eux, être configurés). Le numéro de fiche du lot sert alors seulement au nom des fichiers. Dans ce cas, la validation est celle d'une fiche automatique sans analyse des rapports PDF, et un avertissement le signale.
En mode Générique, la validation applique les mêmes exceptions qu'une fiche avec lecture du PDF : une mission non relue dans Kizeo (Mission réalisable = O, Relecture = Non) ou présente dans Kizeo mais non réalisée ne bloque pas la génération. Les autres contrôles (doublons, RdV KO, CPC non relus) restent inchangés.
Une fois la synthèse générée en mode Générique, le bouton Modifier PDF de l'historique permet de corriger les compteurs et de regénérer le PDF (comme pour une fiche non automatique), y compris quand la fiche n'est pas configurée.
Le modèle est retrouvé par son nom (sans tenir compte des majuscules ni des accents). Il ne doit en exister qu'un par type ; s'il y en a plusieurs, le premier créé est pris. Si aucun modèle « Générique PP/PM » n'existe, la génération s'arrête avec un message explicite. Un avertissement rappelle dans l'historique quel modèle a été utilisé, et un badge Générique apparaît à côté de la référence du lot. Combinable avec Multi-formulaires, Découpage P5/P6 et Synthèse Excel partielle ; non disponible en mode 100%, en TotalEnergies ni via l'API publique (VBA).
Découpage P5/P6
Le toggle Découpage P5/P6 produit deux synthèses distinctes pour un même lot, séparées par la date d'engagement des opérations : P5 pour les opérations engagées avant le 1er janvier 2026, P6 pour celles engagées le 1er janvier 2026 ou après.
Au lancement, une fenêtre demande de choisir la colonne du fichier commande contenant la date d'engagement (seules les colonnes dont le libellé contient « Date » sont proposées). Deux jobs indépendants sont alors créés (un P5, un P6), chacun avec ses propres étapes de validation, sa page KPI et son dépôt dans l'outil de pilotage.
Les fichiers générés portent le même nom que d'habitude avec le suffixe -P5 ou -P6 avant l'extension (ex. Synthèse-… BAR-TH-171-P5.pdf). Si toutes les opérations tombent du même côté, seule la synthèse correspondante est produite (un message le signale). Si une opération n'a pas de date d'engagement exploitable dans la colonne choisie, le découpage est bloqué avec la liste des opérations concernées. Option désactivée par défaut, disponible uniquement dans l'interface (pas en mode 100% ni via l'API VBA).
Synthèse Excel partielle
Le toggle Synthèse Excel partielle produit un fichier Excel ne contenant que les missions au statut « Terminé » dans l'outil de pilotage. Aucun PDF n'est généré.
- Les missions qui ne sont pas « Terminé » dans l'outil de pilotage sont exclues ; elles ne bloquent donc pas la génération (pas de contrôle « mission non réalisée / non relue » sur ces missions).
- La validation Kizeo est non bloquante (avertissements seulement) : on obtient toujours l'Excel des missions Terminé.
- Pour une fiche en mode analyse PDF, les colonnes issues du rapport PDF sont remplies (extraction faite pour les missions Terminé), mais aucun fichier PDF n'est produit et il n'y a pas de validation PDF ni de page KPI.
- Le fichier porte le suffixe
-partielavant l'extension (ex.Synthèse-… BAR-TH-171-partiel.xlsx). - Si aucune mission n'est « Terminé », la génération échoue avec un message explicite.
Option désactivée par défaut, disponible uniquement dans l'interface (pas en mode 100% ni via l'API VBA), et incompatible avec le découpage P5/P6 (les deux cases s'excluent).
TotalEnergies (cumul multi-lots)
Le toggle TotalEnergies produit des synthèses cumulant plusieurs lots d'un même client. On choisit un type puis on saisit les références des lots à intégrer :
- Murs : jusqu'à 4 lots (BAR-EN-102 PP/PM, BAT-EN-102 PP/PM).
- Combles et planchers : jusqu'à 8 lots (BAR/BAT-EN-101 et 103, PP/PM) — les CP/PL/CO sont cumulables ensemble.
- Autres (1 seule fiche : PAC, chaudière biomasse, etc.) : jusqu'à 2 lots (PP, PM).
Résultat : 2 fichiers Excel (un PP, un PM) cumulant les opérations des lots correspondants (côté vide ignoré) + un PDF de synthèse combiné (une colonne par fiche, cumul multi-lots ; nécessite que les 3 templates te_mu / te_combles / te_autres soient uploadés dans Templates PDF), avec une page KPI par fiche si le client est activé KPI. Tous les lots doivent être du même client (sinon erreur), et une vérification bloquante contrôle la cohérence fiche + PP/PM de chaque lot. Au lancement, une fenêtre demande le numéro de lot client (nommage : Synthèse-<n° lot client> <XXX> PP.xlsx / PM.xlsx et … .pdf, où XXX = le numéro de fiche complet s'il n'y en a qu'une, sinon un code court 102 / 101-103…). Les fiches concernées suivent les mêmes règles de validation que les synthèses classiques (bloquant sur fiche auto).
Combinable avec la Synthèse Excel partielle (chaque lot filtré aux missions « Terminé », Excel seuls suffixés -partiel, pas de PDF combiné). Interface uniquement ; incompatible avec le découpage P5/P6, le mode 100% et Multi-formulaires Kizeo.
Sans erreur (admin)
La coche Sans erreur (à côté de « Multi-formulaires Kizeo », visible et utilisable par les administrateurs uniquement) transforme les erreurs bloquantes de validation — dédoublonnage Kizeo non résolvable, incohérence de statut (RdV KO / non réalisée), mission encore Planifié, mission non relue — en avertissements au lieu de bloquer la génération. Un avertissement explicite est ajouté à l'historique quand le mode est actif. Interface uniquement (jamais via l'API) ; sans effet si l'utilisateur n'est pas administrateur.
Dépôt automatique dans l'outil de pilotage
La coche « Enregistrer dans l'outil de pilotage » dépose automatiquement les fichiers Excel et PDF générés dans Pilotage CEE à la fin du traitement. Elle n'est pas mémorisée : elle est toujours activée au chargement de la page, et la décocher demande une confirmation (valable seulement pour les générations lancées depuis la page en cours). Lorsque la synthèse est lancée via l'API (VBA), le dépôt est toujours activé. Plus aucun fichier n'est déposé sur SharePoint.
Annulation
Un bouton d'annulation est disponible tant que le job est en cours (running) ou en attente de validation (pending_review, pending_pdf_review). Seul le créateur du job ou un administrateur peut annuler.
Étapes du pipeline
| % | Étape |
|---|---|
| 5% | Lecture des infos du lot dans l'outil de pilotage + détermination PP/PM |
| 10% | Identification de la fiche CEE et résolution de version |
| 20% | Téléchargement du fichier commande (outil de pilotage ; repli sur le dossier SharePoint configuré — .json.gz prioritaire, sinon .xlsx) |
| 30% | Récupération données Kizeo (inspection + CPC en parallèle) |
| 35% | Validation des données (doublons, missions non relues, RdV KO) |
| 40% | Extraction des rapports PDF (si activée sur la fiche) |
| 55% | Application du mapping (valeurs brutes + formules itératives) |
| 60% | Validation des champs PDF → pause pending_pdf_review si erreurs |
| 65% | Calcul des compteurs statistiques |
| 70% | Génération du fichier Excel |
| 80% | Validation compteurs → pause pending_review si mode manuel |
| 85% | Génération du PDF de synthèse |
| 95% | Finalisation + dépôt dans l'outil de pilotage (si activé) |
| 100% | Terminé |
Comprendre les statuts
| Statut | Signification |
|---|---|
pending | En file d'attente, pas encore démarré. |
running | En cours de traitement. La barre de progression se met à jour automatiquement. |
pending_pdf_review | En attente de validation manuelle des données extraites du PDF. Un bouton Valider apparaît dans l'historique. |
pending_review | En attente de validation manuelle des compteurs statistiques. Un bouton Valider apparaît dans l'historique. |
completed | Terminé avec succès. Les boutons de téléchargement (Excel, PDF) et de dépôt dans l'outil de pilotage sont disponibles. |
error | Échec. Cliquer sur l'icône ❌ pour afficher le détail de l'erreur (texte sélectionnable). |
cancelled | Annulé manuellement par l'utilisateur. |
Les icônes ❌ (erreur) et ⚠️ (warning) sont cliquables : elles ouvrent une modale avec le message complet, dans laquelle le texte est sélectionnable pour faciliter le copier-coller.
La durée affichée correspond au temps de traitement réel. Si le job passe en validation manuelle, le chronomètre se fige et ne reprend pas après la validation.
Validation manuelle
Validation des compteurs (pending_review)
Ce cas survient lorsque la fiche est en mode manuel (champ "automatique" décoché sur la fiche CEE). L'outil calcule les compteurs mais attend votre confirmation avant de générer le PDF.
- Cliquer sur le bouton Valider dans l'historique.
- Une modale s'ouvre avec les compteurs pré-remplis. Vérifier et corriger si nécessaire.
- Les éventuels warnings (différence entre compteurs du lot dans l'outil de pilotage et synthèse) sont affichés en haut de la modale.
- Cliquer sur Confirmer et générer le PDF.
Validation des données PDF (pending_pdf_review)
Ce cas survient lorsque l'extraction automatique des rapports PDF a détecté des anomalies. Voici les différents cas qui déclenchent une validation manuelle :
Cas déclencheurs
- PDF absent : le rapport PDF d'une mission terminée n'a pas été trouvé dans l'outil de pilotage. Tous les champs PDF de cette mission sont à renseigner manuellement.
- Valeur vide : un champ PDF est vide après extraction (pattern non trouvé dans le PDF, ou cellule vide). Si la colonne est conditionnelle (ex : "Si #A = Oui") et que la condition n'est pas remplie, le vide est considéré normal et ne déclenche pas d'erreur.
- Validation entier échouée : la valeur extraite n'est pas un entier valide. Si le texte contient exactement un nombre entier, il est extrait automatiquement. Sinon (0 ou 2+ nombres trouvés) → validation manuelle.
- Validation décimal échouée : même logique que pour les entiers, avec support des virgules et points décimaux.
- Liste de valeurs non respectée : la valeur extraite ne correspond à aucune des valeurs autorisées. Cela arrive notamment après un smart cleaning ambigu (2+ valeurs trouvées dans le texte extrait, voir section Validation de données).
Interface de correction
- Cliquer sur le bouton Valider dans l'historique.
- Une modale en vue partagée s'ouvre : formulaire à gauche, PDF à droite.
- Pour chaque erreur, la ligne concernée est identifiée (lettre A, B, C...), avec le nom de la colonne (coloré selon l'en-tête) et la valeur actuelle.
- Selon le type de validation :
- Liste de valeurs : sélectionner la bonne valeur dans la liste déroulante.
- Entier / Décimal : saisir la valeur correcte.
- Sans validation (champ vide) : saisir librement la valeur.
- Utiliser les boutons Précédent / Suivant pour naviguer entre les erreurs.
- Le PDF est automatiquement positionné sur le terme de recherche correspondant pour faciliter la vérification.
- Une fois toutes les corrections effectuées, cliquer sur Valider les corrections.
Après validation, le mapping est recalculé avec les valeurs corrigées (les formules référençant $PDF. sont réévaluées), puis l'Excel et le PDF sont générés.
Forcer la saisie
Si la colonne du mapping a l'option Saisie libre auth. cochée (voir Éditeur de modèles), une coche Forcer la saisie apparaît sous le champ de correction. Quand elle est activée, un champ libre (bordure orange) remplace le champ normal et permet de saisir n'importe quelle valeur, même si elle ne respecte pas la contrainte configurée (hors liste déroulante, texte non numérique pour un entier/décimal...). La valeur forcée ne peut pas être vide. Cette valeur finit telle quelle dans la case correspondante du fichier Excel. À utiliser avec précaution car elle court-circuite la validation de données configurée sur le modèle.
Par défaut, aucun mapping n'a cette option activée : l'administrateur doit explicitement l'autoriser par colonne dans l'éditeur de modèles.
Téléchargement et dépôt dans l'outil de pilotage
Téléchargement
Une fois le job terminé (completed), plusieurs boutons apparaissent dans l'historique :
- Excel (icône verte) : télécharge le fichier de synthèse Excel.
- PDF (icône rouge) : télécharge le PDF de synthèse.
- Excel source PDF (icône PDF rouge +
Xnoir) : télécharge le template Excel rempli qui a servi à générer le PDF, avant conversion. Utile pour debug si une cellule du PDF est cassée — on ouvre la source pour voir la valeur exacte sans rejouer la génération. - PDF ⟳ (relancer la conversion) (icône PDF rouge + flèche circulaire) : apparaît à la place des boutons Télécharger/Visualiser PDF lorsque la conversion PDF a échoué (LibreOffice, ou Microsoft Graph en secours, qui renvoie régulièrement des erreurs transitoires 502 ou coupe le téléchargement). Dans ce cas, l'Excel de synthèse reste disponible et le job est marqué terminé avec un avertissement. Le bouton relance uniquement la conversion PDF (sans refaire la lecture outil de pilotage/Kizeo ni le calcul) ; le PDF est alors déposé automatiquement s'il aboutit.
Recherche
Le champ de recherche au-dessus de la liste filtre par référence de lot, fiche CEE, ou demandeur (texte partiel, insensible à la casse). Une synthèse PNCEE est aussi trouvée par la référence de l'un de ses lots (et pas seulement par son nom de fichier).
Dépôt dans l'outil de pilotage
- Automatique : si la coche « Enregistrer dans l'outil de pilotage » est active (ou lancement via API), les fichiers sont déposés automatiquement à la fin du traitement.
- Manuel : un bouton de dépôt (pastille bleu marine) apparaît dans l'historique pour les jobs non encore déposés. Cliquer dessus pour déposer les fichiers.
Les fichiers sont déposés dans Pilotage CEE (catégorie « synthèse ») : sur le lot, sur chacun des lots pour TotalEnergies / PNCEE, sur la Synthèse 100% en mode 100%. Plus aucun dépôt SharePoint.
Utilisation via VBA (Excel)
Configuration dans le fichier VBA
Cinq constantes à renseigner en haut du module SynthesesAPI :
BASE_URL: URL de l'outil (ex :https://syntheses.spekty.fr).API_TOKEN: token API généré dans l'onglet Tokens API de l'outil.API_USER: identifiant affiché dans l'historique (email de l'utilisateur).TIMEOUT_MS: timeout en millisecondes (défaut 360000 = 6 min).POLL_SEC: intervalle de polling en secondes (défaut 3).
Lancement (asynchrone, multi-jobs)
- Appeler la macro
GenererEtSauver("20260303-07-DIVERS-INS-EDF")avec la référence du lot. - La requête est envoyée à l'API en mode asynchrone. Plusieurs générations peuvent tourner en même temps.
- Un polling automatique (toutes les 3 secondes) vérifie l'état de chaque requête. La barre de statut Excel affiche le nombre de synthèses en cours.
- À la fin de chaque requête :
- Succès (
completed) : une MsgBox confirme la génération et le dépôt dans l'outil de pilotage. Les éventuels warnings sont affichés. - Autre statut (erreur, validation requise...) : une MsgBox affiche le message d'erreur et propose d'ouvrir l'outil dans le navigateur.
- Succès (
Le dépôt dans l'outil de pilotage est toujours activé lors d'un lancement via l'API (endpoint with-sharepoint, nom historique : plus aucun dépôt SharePoint).
Propriété du job
Le champ API_USER est envoyé comme créateur du job. L'utilisateur peut ensuite annuler ses propres jobs et accéder aux validations depuis l'interface web.
Règles de validation
Lors de chaque génération, les données Kizeo sont validées automatiquement. Tous les blocages sont détectés en une seule passe et listés dans le message d'erreur.
Missions annulées
Les missions dont le statut dans l'outil de pilotage est Annulé sont automatiquement exclues de la synthèse. Un warning non bloquant indique le nombre de missions exclues et leurs références.
Missions planifiées
Une mission du lot encore au statut Planifié dans l'outil de pilotage (contrôle pas encore réalisé) est bloquante, quel que soit son état dans Kizeo, y compris pour une fiche avec lecture du PDF ou en mode Générique. Elle devient un simple avertissement avec l'option Sans erreur, pour une fiche en validation manuelle, en synthèse Excel partielle (seules les missions « Terminé » sont gardées) et en synthèse 100 %.
Inspection (non-CPC)
Saisies lues
Seules les saisies du formulaire de contrôle sur site avec prise_de_rdv = "RDV" sont récupérées (casse et espaces ignorés) : les autres (RI, BND, FN, PI, vide…) sont ignorées. Une mission sans saisie « RDV » est donc absente de Kizeo pour la synthèse : son statut et le motif du problème de RdV viennent de l'outil de pilotage ($PIL.Statut, $PIL.PB_RDV). Le formulaire CPC (contrôle par contact) est lu en entier.
Doublons Kizeo
- 1 seule avec
mission_realisable = "O"→ retenue - 2+ avec
mission_realisable = "O"→ doublon bloquant - Sinon → la plus récente (
create_time)
Mission non relue
mission_realisable = "O" ET relecture = "Non"
→ bloquant
RdV KO
prise_de_rdv = "RDV" ET mission_realisable vide
→ vérification du statut de la mission dans l'outil de pilotage :
RdV KO→ code déduit automatiquement :- Contient "refus" →
RI(Refus d'intervention) - Contient "non disponible" →
BND(Bénéficiaire non disponible) - Contient "faux num" →
FN(Faux numéro) - Autre →
BI(Bénéficiaire injoignable)
- Contient "refus" →
En cours/Echantillonné/Non pris en compte/ mission non trouvée →PI(Planification impossible)Planifié→ signalée une seule fois par la règle « Missions planifiées »- Autre statut → bloquant
CPC
Doublons Kizeo
- 1 seule avec
prise_de_rdv = "RDV"→ retenue - 2+ avec
prise_de_rdv = "RDV"et toutesconclusion = "Satisfaisant"→ 1ere retenue automatiquement - 2+ avec
prise_de_rdv = "RDV"sinon → doublon bloquant - Sinon → 1ere entree
Mission non relue
prise_de_rdv = "RDV" ET conclusion = "Non satisfaisant"
ET relecture = "Non"
→ bloquant
Compteurs du lot
Les compteurs du lot (nombre de lignes, contrôles réalisés, contrôles CPC) sont lus dans l'outil de pilotage. Si le nombre de contrôles sur la synthèse diffère du compteur du lot, un warning est affiché. Exception : si la différence s'explique par des missions modifiées sur Kizeo dans les 2 dernières minutes (données récentes pas encore prises en compte dans les compteurs du lot), le warning est supprimé.
Cas particulier : RES-EC-104
La fiche RES-EC-104 (Rénovation d'éclairage) bénéficie d'un traitement spécifique lors de la génération Excel.
Éclatement multi-cadres A
Lorsque la cellule Ref Emmy (position 3) contient N séparateurs | , la ligne est automatiquement éclatée en N+1 lignes (une par cadre A).
- Les cellules contenant exactement
Nséparateurs|sont découpées : chaque partie va dans sa ligne. - Les autres cellules (aucun séparateur, ou nombre différent) sont dupliquées telles quelles sur chaque ligne.
Cas particulier "Nombre de luminaires"
Si le modèle contient une ou plusieurs colonnes dont l'en-tête commence par Nombre de luminaires :
- Les valeurs numériques sans séparateur sont préfixées
"Total sur l'opération : X"sur chaque ligne éclatée. - Les lignes éclatées sont colorées en alternance (jaune, violet, vert) pour distinguer visuellement les opérations multi-cadres.
- Les cellules "Nombre de luminaires" sur les lignes éclatées sont mises en surbrillance pour signaler qu'elles doivent être complétées.
- Warning : "Certaines opérations ont été éclatées en plusieurs cadres A. Veuillez vérifier et compléter manuellement le nombre de luminaires installés."
Modèle sans colonne "Nombre de luminaires"
Si aucune colonne d'en-tête ne commence par Nombre de luminaires :
- Pas de coloration des lignes éclatées.
- Pas de préfixe
"Total sur l'opération : X". - Warning simplifié : "Certaines opérations ont été éclatées en plusieurs cadres A".
Configuration
La colonne déclencheuse est la position 3 (Ref Emmy). Aucune autre configuration : les colonnes à éclater et les colonnes "Nombre de luminaires" sont auto-détectées.
Règles spécifiques par client
Client EDF
Pour les lots dont le client est EDF (toutes déclinaisons — la parenthèse est ignorée : EDF (Marché des Particuliers), EDF (Marché des Professionnels), etc.), deux adaptations sont appliquées automatiquement au fichier Excel :
- Ligne de tirets : une ligne contenant un tiret (
-) dans chaque colonne ayant un en-tête est ajoutée avant la ligne d'en-tête. - Pourcentages en valeur brute : les colonnes au format "Pourcentage" sortent en nombre brut (ex :
75, affiché75,00) au lieu du format pourcentage classique (75%).
Clients « Engie DGP » et « Dalkia »
Pour les lots dont le nom du client commence par Engie DGP ou Dalkia (avec ou sans suite, ex : Engie DGP (…), Dalkia … ; insensible à la casse), l'adaptation suivante est appliquée :
- Ligne vide : une ligne de cases vides (encadrées, sans tiret) est ajoutée avant la ligne d'en-tête, dans chaque colonne ayant un en-tête.
Ces règles s'appliquent à toutes les fiches, y compris après une étape de validation manuelle (PDF ou compteurs). Elles n'impactent pas le calcul des compteurs statistiques.
Administration
Fiches CEE
Les fiches CEE sont gérées dans l'onglet Fiches. Chaque fiche représente un type d'opération CEE (ex : BAR-TH-171, RES-EC-104).
Champs principaux
- Numéro : identifiant unique de la fiche (ex :
BAR-TH-171). - Libellé : description lisible.
- Code prestation : associe la fiche à un code prestation pour la résolution automatique depuis la référence de lot.
- Modèle PP / PM : modèle de synthèse à utiliser pour chaque type (particuliers / professionnels).
- Modèle PP 100% / PM 100% : modèles dédiés aux synthèses 100% (si éligible).
- Modèle PNCEE et Code presta PNCEE (client DGEC) : modèle de synthèse de Contrôle PNCEE (seuls les modèles de type
PNCEEsont proposés) et code prestation propre à cette synthèse. Les deux sont facultatifs et peuvent aussi être posés sur chaque version (voir plus bas). Détail dans la section Synthèses PNCEE (client DGEC). - Automatique : si coché, les compteurs sont validés automatiquement sans intervention. Si décoché, le job passe en
pending_reviewpour validation manuelle. - Analyse PDF : si coché, les rapports PDF des missions sont téléchargés depuis l'outil de pilotage et analysés pour en extraire des données (voir section Extraction PDF).
- Éligible 100% : si coché, la fiche est disponible pour les synthèses en mode 100%.
- ⚠ Configuration non terminée : à cocher tant que la fiche n'est pas pleinement configurée (mapping incomplet, fiche en cours de mise au point, modèle en test...). La fiche apparaît alors en surbrillance jaune avec un picto ⚠ dans la liste, et toute synthèse générée sur cette fiche ajoute un avertissement (visible dans l'historique et dans le champ
warningsde la réponse API publique) : « La configuration de la synthèse pour cette fiche n'est pas terminée. Vérifier le contenu des fichiers générés. » À décocher quand la fiche est validée.
Versions de fiches
Chaque fiche peut avoir plusieurs versions (code prestation + modèle PP/PM propres), sélectionnées automatiquement selon une date de référence : la date d'engagement (issue du fichier commande) ou la date de prise en compte / d'intégration (déduite de la référence du lot).
Sélection à deux critères : une version peut porter un 2ᵉ critère facultatif (un second couple type de date + « dès le »). Elle ne s'applique alors que si ses deux critères sont satisfaits (ex. engagement ≥ 2025-01-01 ET prise en compte ≥ 2026-10-01). Entre plusieurs versions applicables, celle qui a le plus de critères l'emporte (la plus spécifique), puis à égalité la date la plus récente. Cela permet une matrice (ex. code prestation selon la prise en compte, modèle selon engagement × prise en compte). Les versions à un seul critère fonctionnent exactement comme avant.
Modèle PNCEE / Code presta PNCEE par version : chaque version peut porter ses propres Modèle PNCEE et Code presta PNCEE (facultatifs). Quand la version retenue en renseigne un, sa valeur prend le pas sur celle de la fiche ; sinon c'est la valeur de la fiche qui s'applique. Ils s'affichent en violet (« PNCEE : … ») dans la liste des fiches, sur la ligne de la fiche et sur celle de chaque version.
Avertissement de cohérence : si le code prestation rattaché au Modèle PNCEE choisi diffère du Code presta PNCEE choisi (sur la fiche ou sur une version), un message orange le signale sous les listes. Il est non bloquant : l'enregistrement reste possible.
Résolution automatique
Lors de la génération, la fiche est toujours celle du lot dans l'outil de pilotage (champ « Fiche CEE ») : elle n'est jamais déduite de la référence.
Clients (donneurs d'ordre)
L'onglet Clients permet de gérer une liste de clients (donneurs d'ordre).
Saisie
Le nom d'un client doit correspondre exactement au champ Client du lot dans l'outil de pilotage, tel quel, parenthèse comprise (ex : EDF (Marché des Particuliers)). Sensible à la casse, espaces inclus.
Synthèse avec KPI
Si la coche Synthèse avec KPI est activée, toute synthèse PDF générée pour un lot dont le client correspond à ce nom recevra une 2e page « KPI », à condition que le modèle de synthèse de la fiche ait un mapping KPI configuré (page Mappings KPI). La 2e page contient :
- Le nombre de contrôles réalisés dans le lot
- Un camembert avec la répartition des conclusions (Satisfaisant / Non satisfaisant / Non vérifiable)
- Un camembert avec les points Non satisfaisants observés sur les missions du lot
Si le client n'est pas dans la liste OU n'est pas marqué « Synthèse avec KPI » OU si le modèle n'a pas de mapping KPI rattaché (principal ou secondaire) → pas de 2e page (synthèse PDF inchangée).
Modèles secondaires d'un Mapping KPI
Un mapping KPI est rattaché à un modèle principal (celui qui définit la structure des références de colonnes utilisées dans les points KPI). Mais on peut aussi déclarer des modèles secondaires dans l'éditeur de mapping (page Mappings KPI) — typiquement le modèle PM jumeau du PP.
Cas d'usage : les champs Kizeo sont identiques entre PP et PM, donc le paramétrage KPI est strictement le même. Plutôt que de dupliquer le mapping pour le PM, on liste simplement le modèle PM comme secondaire. Au moment de générer la synthèse d'un lot PM : si le modèle PM est listé comme secondaire d'un KpiMapping, le pipeline relance une 2e passe d'évaluation interne avec le modèle principal (PP) pour produire les compteurs KPI compatibles. Coût : ~1-2 s de calcul supplémentaire, invisible pour l'utilisateur.
Sur la page Fiches CEE, un petit picto histogramme à côté du numéro indique la couverture KPI :
- Vert : tous les modèles rattachés à la fiche (principaux PP/PM + 100% + versions) sont rattachés à un mapping KPI.
- Jaune : certains modèles seulement ont une couverture KPI.
- Pas de picto : aucun mapping KPI ne couvre les modèles de cette fiche.
Modèles de synthèse
Les modèles définissent la structure du fichier Excel de synthèse. Ils sont gérés dans l'onglet Modèles.
Colonnes de sortie
Chaque modèle contient une liste ordonnée de colonnes. Pour chaque colonne :
- Position : numéro de la colonne dans l'Excel (A=0, B=1...). Laisser vide pour une colonne intermédiaire (calcul interne, non affichée).
- Label : en-tête de la colonne dans l'Excel.
- Format :
texte(défaut),nombre,entier, etc. Détermine le formatage dans l'Excel. - Couleur en-tête : couleur de fond de l'en-tête (format
#RRGGBB).
Colonnes intermédiaires
Les colonnes intermédiaires n'ont pas de position Excel : elles servent uniquement aux calculs internes. Elles sont référencées dans les formules via @{Label}. Utile pour stocker des résultats intermédiaires réutilisés par d'autres formules.
Source de données (mapping)
Chaque colonne est associée à une source de données qui détermine d'où vient la valeur :
| Source | Description | Valeur source |
|---|---|---|
command_file | Fichier commande du lot (outil de pilotage) | Nom exact de la colonne |
kizeo | Formulaire Kizeo inspection | Nom du champ Kizeo |
kizeo_cpc | Formulaire Kizeo CPC | Nom du champ CPC |
sharepoint_list | Mission (outil de pilotage) — modèles 100% | Nom du champ de la mission |
rapport_pdf | Données extraites du PDF | Clé normalisée du pattern ($PDF.cle) |
formula | Formule calculée | Expression (voir section Formules) |
compil_pncee | Compil PNCEE (Modèles PNCEE uniquement) : résumé S / NS / NV / SO d'autres colonnes | Bouton Paramétrer (voir section Synthèses PNCEE) |
Type de modèle
À la création (bouton Nouveau modèle) ou via Renommer, un modèle est de type PP (personnes physiques), PM (personnes morales) ou PNCEE (synthèse de Contrôle PNCEE du client DGEC). Le type est rappelé dans le titre de l'éditeur. Un Modèle PNCEE dispose en plus de la source Compil PNCEE et de l'import de colonnes d'un modèle PP/PM (voir section Synthèses PNCEE (client DGEC)).
Colonne conditionnelle
Une colonne peut être conditionnelle : sa valeur n'est affichée que si la colonne référencée dans condition_col_label vaut "Oui". Sinon, la cellule reste vide. Cette condition « Si # = Oui » est aussi disponible sur les colonnes intermédiaires (qui ont une source) : la valeur de la colonne intermédiaire est alors vidée tant que la colonne référencée ne vaut pas « Oui », ce qui se répercute sur les formules qui l'utilisent.
Bouton Tester
Le bouton Tester le mapping dans l'éditeur de modèle permet de tester une référence de mission. Il applique le même pipeline de mapping et de validation que la génération réelle, et affiche le résultat colonne par colonne avec un code couleur (valeur trouvée, vide, erreur).
Synthèses PNCEE (client DGEC)
Le client DGEC (nom de client du lot commençant par « DGEC ») reçoit une synthèse de Contrôle PNCEE construite à partir d'un Modèle PNCEE : un modèle de type PNCEE (choisi à la création du modèle, ou via Renommer). Un Modèle PNCEE peut copier des colonnes des modèles PP/PM existants au lieu de les ressaisir, et ajoute des colonnes de synthèse Compil PNCEE.
Rattachement à la fiche CEE
Sur la page Fiches CEE, chaque fiche (et chacune de ses versions) porte deux champs facultatifs : le Modèle PNCEE à utiliser et le Code presta PNCEE. La valeur de la version prend le pas sur celle de la fiche quand elle est renseignée. Pour un lot DGEC, le Code presta PNCEE pilote le formulaire Kizeo et les correspondances de champs (celles du code prestation indiqué), et non le code prestation de la référence du lot. Un avertissement non bloquant s'affiche si le code prestation du Modèle PNCEE choisi diffère du Code presta PNCEE choisi.
Source « Compil PNCEE »
Proposée dans la liste des sources d'un Modèle PNCEE seulement. Le bouton Paramétrer ouvre une fenêtre où l'on choisit les colonnes lues (colonnes de sortie et intermédiaires de la synthèse, hors autres colonnes Compil) ; pour chacune, 4 blocs S, NS, NV, SO de règles = (égalité) ou contient (sous-chaîne) + valeur, ajoutées avec + OR et retirées avec x (une règle suffit pour classer la valeur).
- Chaque colonne lue est prise avec sa valeur finale (après formules et conditions « Si # = Oui ») puis classée S / NS / NV / SO ; comparaison insensible à la casse et aux espaces de bord ; si plusieurs listes correspondent, l'ordre de test est NS, NV, S, SO.
- Une valeur qui ne correspond à aucune règle, ou classée SO, est ignorée.
- Résultat de la colonne : NS si au moins un NS ; sinon NV si tous les retenus sont NV ; sinon S (S + NV donne S) ; SO si rien n'est retenu.
- Les colonnes Compil sont calculées en dernier : une formule ou une condition « Si # = Oui » qui lit une colonne Compil la voit vide (l'éditeur l'indique par un ⚠). Une colonne Compil peut elle-même porter une condition « Si # = Oui ».
- Les colonnes lues sont repérées par leur lettre (A, B…) ou leur référence d'intermédiaire (
INT_n) : elles suivent les ajouts / suppressions de colonnes ; une colonne lue supprimée est retirée du paramétrage.
Importer des colonnes d'un modèle PP/PM
Dans la section Mapping d'un Modèle PNCEE, le bouton Importer des colonnes d'un modèle PP/PM propose les modèles PP/PM des fiches CEE (et de leurs versions) qui référencent ce Modèle PNCEE. On coche les colonnes voulues (filtre par texte possible) ; le modèle est enregistré puis les colonnes sont copiées en fin de modèle, comme colonnes intermédiaires.
- C'est une copie ponctuelle, sans lien : une fois importées, les colonnes sont des intermédiaires comme les autres, entièrement modifiables. Une modification ultérieure du modèle d'origine n'est pas reportée dans le Modèle PNCEE (réimporter si besoin).
- Les colonnes dont dépendent leurs formules (dépendances) sont copiées aussi. Elles sont toujours recréées : réimporter une colonne (ou une colonne qui dépend d'une colonne déjà importée) crée de nouvelles copies.
- Le libellé d'origine est repris, suffixé
(2),(3)… s'il est déjà pris dans le Modèle PNCEE ; les références des formules sont réécrites en@{libellé}. - La condition « Si # = Oui » de la colonne d'origine est reprise : la colonne qu'elle teste est copiée aussi et la condition de la nouvelle colonne pointe sur cette copie.
- Avertissements : une référence de formule inconnue du modèle d'origine devient
@{⚠ référence introuvable : X}, qui vaut vide (⚠ sous la formule dans l'éditeur, rappel dans les avertissements de la génération) ; une condition qui n'a pas pu être reprise reste vide. Ces cas sont signalés dans le message affiché après l'import. - Les colonnes anciennement liées (avant la suppression des liens) sont devenues des intermédiaires ordinaires, avec leur dernier paramétrage.
Relevé de joignabilité (2e onglet de l'Excel)
L'Excel d'une synthèse PNCEE comporte deux onglets : synthèse_opérations puis relevé de joignabilité. Ce dernier liste, pour les lots de la génération, les tentatives de contact des missions au statut « RdV KO » (égalité exacte), lues dans le champ Prise de RdV de Pilotage CEE (source unique).
- Colonnes : TOP / TPM (référence client de la mission), Référence Spekty (référence de la mission), Date, Heure, Type (texte de la tentative).
- Une ligne par tentative, de la plus ancienne à la plus récente (date puis heure) ; une tentative sans date est placée en dernier. Les missions sont triées par référence, lot après lot.
- Une virgule dans le texte d'une tentative ne la coupe pas : le découpage se fait sur un saut de ligne ou sur une virgule suivie d'une date
jj/mm/aaaa. - Une mission « RdV KO » sans aucune tentative consignée ne produit aucune ligne.
- Si Pilotage CEE est injoignable ou refuse la lecture, la génération échoue (le relevé n'est jamais livré incomplet).
Génération d'une synthèse PNCEE
- Détection automatique : tout lot dont le client commence par DGEC (majuscules ou minuscules) produit une synthèse PNCEE, quel que soit le canal (interface ou API publique). Un lot DGEC lancé seul par le chemin habituel donne une synthèse PNCEE d'un seul lot. Les lots des autres clients ne changent pas.
- Options refusées sur un lot DGEC : Générique, Découpage P5/P6, Synthèse Excel partielle, TotalEnergies et Multi-formulaires Kizeo. La génération s'arrête avec le message « Lot DGEC : option incompatible avec la synthèse PNCEE (…) » qui nomme l'option.
- Une seule passe, un seul modèle : chaque lot est traité avec le Modèle PNCEE et le Code presta PNCEE de sa fiche (ou de la version retenue) : fichier commande, formulaires Kizeo et CPC du Code presta PNCEE, contrôles Kizeo habituels, lecture des rapports PDF si la fiche (ou la version) est en analyse PDF, mapping. La fiche est toujours celle du champ « Fiche CEE » du lot.
- Arrêts avec message clair : fiche du lot vide ou non configurée ; Modèle PNCEE ou Code presta PNCEE absent ; modèle choisi qui n'est pas de type PNCEE ; code prestation de la référence du lot différent du Code presta PNCEE (le message cite les deux codes) ; client d'un lot qui n'est pas DGEC.
- Colonnes signalées : chaque colonne du Modèle PNCEE d'un lot qui porte un avertissement de lien (dépendance non importée, référence introuvable, colonne d'origine supprimée, condition non reprise…) est rappelée dans les avertissements de la génération : « Lot réf. — Modèle PNCEE « nom », colonne libellé : avertissement ». Non bloquant.
- Plusieurs lots : une synthèse PNCEE peut regrouper plusieurs lots DGEC, de fiches différentes. Les lignes sont concaténées dans l'ordre de saisie des lots dans l'onglet synthèse_opérations (au format du Modèle PNCEE du 1er lot) et les relevés de tous les lots dans relevé de joignabilité. Si les colonnes de sortie des Modèles PNCEE diffèrent (libellés par position), un avertissement le signale.
- Validation lot par lot : les saisies manuelles et la relecture des rapports PDF se font dans la fenêtre de validation habituelle, une fenêtre par lot (son titre commence par « Lot référence (k/N) »). Les colonnes intermédiaires (liées ou non) qui lisent le PDF ou sont en saisie manuelle y sont proposées comme les colonnes de sortie. Après validation d'un lot, la fenêtre du lot suivant à valider s'ouvre automatiquement si l'on est resté sur la page Génération (sinon, un simple message « Lot suivant à valider : réf. » s'affiche) ; la fermer met la génération en pause : le job reste « À valider » et le bouton Valider de l'historique (ou le statut) rouvre le lot en cours. Rien n'est perdu, même après un redémarrage du serveur. L'Excel n'est produit qu'une fois tous les lots prêts.
- Erreur d'un lot (contrôle Kizeo bloquant, modèle manquant, garde-fou du code prestation…) : toute la génération échoue, avec un message qui commence par « Lot référence : ».
- Livrable : un Excel seul, nommé selon la convention habituelle :
Synthèse-<nom>.xlsx(nom saisi au lancement), sinonSynthèse-<1er lot> <fiche du 1er lot>.xlsx. Pas de PDF de synthèse, pas de validation des compteurs, pas de page KPI. - Échec en fin de génération (par exemple Pilotage CEE injoignable pour le relevé de joignabilité) une fois tous les lots validés : les validations sont conservées ; le bouton « Relancer l'Excel » de l'historique (affiché seulement dans ce cas) relance la seule production de l'Excel et son dépôt, sans relire les lots ni revalider.
- Une fenêtre de validation restée ouverte sur un lot déjà validé (autre onglet, lien partagé) est refusée avec le message « Ce lot a déjà été validé ou n'est plus le lot courant : rechargez » : seules les corrections du lot en cours sont acceptées.
- Dépôt : l'Excel est déposé sur chacun des lots du regroupement dans Pilotage CEE.
Lancer une synthèse PNCEE (interface)
- Cocher PNCEE (à côté de « Multi-formulaires Kizeo »). Les options incompatibles sont décochées et masquées : Multi-formulaires Kizeo, Générique, Découpage P5/P6, Synthèse Excel partielle, TotalEnergies et Mode 100%.
- Saisir les références des lots DGEC, une par ligne, dans l'ordre voulu des lignes de l'Excel (lignes vides et doublons ignorés).
- Cliquer sur Générer (PNCEE) : une fenêtre « Nom du fichier » demande le nom de l'Excel, qui sera
Synthèse-<nom>.xlsx. Ce nom sert aussi de libellé dans l'historique.
Dans l'historique, la synthèse porte le badge violet PNCEE n lots (l'infobulle liste les lots). Pendant la validation, le statut affiche l'avancement « À valider k/N » (k lots prêts sur N ; l'infobulle nomme le lot à valider). Le dépôt automatique suit la coche habituelle de dépôt.
Lancer une synthèse PNCEE (API publique)
POST /public-api/generation/pncee (token Bearer, appel synchrone, 5 minutes maximum) :
{
"lot_references": ["20261001-01-CEE-PNCEE-JS", "20261001-02-CEE-PNCEE-JS"],
"output_filename": "DGEC octobre 2026",
"user": "prenom.nom@spekty.fr"
}
lot_references(obligatoire, au moins une) : lots DGEC dans l'ordre des lignes de l'Excel ; espaces de bord, références vides et doublons ignorés ; chaque référence fait au moins 12 caractères et commence par une dateAAAAMMJJ.output_filename(obligatoire) : nom de l'ExcelSynthèse-<output_filename>.xlsx(caractères interdits\ / : * ? " < > |remplacés par_).user(facultatif) : demandeur affiché dans l'historique.
Le dépôt est automatique sur chaque lot. Réponse (HTTP 200) : completed avec excel_download_url ; pending_pdf_review si un lot demande une validation, avec job_id et validation_url (lien relatif vers la fenêtre de validation, à préfixer par l'adresse de l'outil) — l'Excel est produit et déposé à la fin de la validation, sans nouvel appel ; error avec error_message. Liste vide : erreur 422 ; aucune référence exploitable, référence mal formée ou nom vide : erreur 400.
{
"status": "pending_pdf_review",
"job_id": 456,
"lot_reference": "DGEC octobre 2026",
"fiche_numero": "BAR-TH-171",
"warnings": null,
"validation_url": "/#/generation?job=456"
}
{
"status": "completed",
"job_id": 456,
"lot_reference": "DGEC octobre 2026",
"excel_download_url": "/public-api/generation/456/download/excel",
"pdf_download_url": null
}
Formules
Les formules permettent de calculer des valeurs à partir des données sources et d'autres colonnes. Elles sont saisies dans le champ "Valeur source" lorsque le type de source est formula.
Références aux données sources
| Référence | Source | Exemple |
|---|---|---|
$CMD.champ | Fichier commande | $CMD.Code postal |
$KIZ.champ | Kizeo inspection | $KIZ.mission_realisable |
$KIZ_CPC.champ ou $CPC.champ | Kizeo CPC | $KIZ_CPC.conclusion_generale |
$PIL.champ | Champ de la mission (outil de pilotage), tous les modèles | $PIL.Statut |
$PIL.PB_RDV | Raison du problème de prise de RdV (mission « RdV KO », vide sinon) | Faux numéro |
$PIL.Client_SIRET | SIRET du client du lot (fiche client de l'outil de pilotage) | 55208131766522 |
$PDF.champ | Rapport PDF extrait | $PDF.Zone_climatique |
$KIZL.champ | Kizeo (label du champ) | $KIZL.type_isolant |
#A, #B, #C... | Colonne de sortie par lettre | #A = 1re colonne non-intermédiaire |
@{Label} | Colonne intermédiaire par label | @{Surface totale} |
Balises de la mission (outil de pilotage)
$PIL.<champ> lit un champ de la mission dans l'outil de pilotage, dans tous les modèles (PP, PM, TotalEnergies, PNCEE, 100 %). Exemples : IF($PIL.Statut="RdV KO"; "Non réalisée"; #F), $PIL.Client (client du lot). Le préfixe s'écrit indifféremment $PIL. ou $Pil. ; l'ancien nom $SP. reste compris (les formules existantes ont été converties en $PIL.). Dans l'éditeur de formule, choisissez la source « $PIL. (Mission — outil de pilotage) » : la liste des champs est proposée à la saisie. Une mission absente de l'outil de pilotage donne des balises vides.
$PIL.PB_RDV est un champ calculé : vide si le statut de la mission n'est pas « RdV KO », sinon la raison du problème de prise de RdV, d'après le champ « Prise de RdV » :
- la tentative la plus récente (date et heure ; une tentative sans date compte comme la plus récente) qui contient « Refus d'intervention », « Non disponible dans les délais », « Faux numéro » ou « Bénéficiaire injoignable » donne respectivement « Refus d’intervention », « Bénéficiaire non disponible », « Faux numéro » ou « Bénéficiaire injoignable » (majuscules, accents et apostrophes ignorés) ;
- sinon, si la Prise de RdV contient « Ne répond pas », « Message vocal » ou « SMS envoyé » : « Bénéficiaire injoignable » ;
- sinon : « Planification impossible ».
$PIL.Client_SIRET est aussi un champ calculé : le SIRET du client de la mission (le client du lot), lu sur la fiche client de l'outil de pilotage (une lecture par client et par génération). Si la fiche ne peut pas être lue, la balise est vide et la génération affiche un avertissement non bloquant.
Conversion des modèles existants : la formule client qui lisait le fichier commande (COALESCE($CMD.DG, …$CMD.E…)) lit désormais le client du lot dans l'outil de pilotage ($PIL.Client, complément entre parenthèses retiré), et les colonnes « Fichier commande » sur la colonne DH sont devenues des formules $PIL.Client_SIRET. De même, dans les formules, ISBLANK($KIZ.reference_site) (« opération sélectionnée ») est devenu AND($PIL.Statut<>"Terminé",$PIL.Statut<>"Déplacement vain",$PIL.Statut<>"RdV KO"), et le IFS($KIZ.prise_de_rendez_vous="RI",…) des motifs de RdV KO est devenu $PIL.PB_RDV : ces colonnes ne dépendent plus de la présence dans Kizeo des missions non réalisées.
Fonctions disponibles
| Fonction | Description |
|---|---|
IF(cond; vrai; faux) | Condition simple |
IFS(c1; v1; c2; v2; ...) | Conditions multiples (1re vraie retenue) |
AND(a; b) / OR(a; b) / NOT(a) | Opérateurs logiques |
UPPER / LOWER / TRIM | Manipulation de texte |
LEFT(t; n) / RIGHT(t; n) / MID(t; d; l) | Extraction de sous-chaîne (calculée mission par mission). Comme Excel : longueur négative ou début < 1 → valeur vide |
LEN(texte) | Longueur du texte |
SEARCH(cherche; dans) | Position de cherche dans dans (1-based), insensible à la casse ; 0 si non trouvé. Aligné sur Excel. |
FIND(cherche; dans) | Position de cherche dans dans (1-based), sensible à la casse ; 0 si non trouvé. Aligné sur Excel. |
REPLACE(t; ancien; nouveau) | Remplace dans le texte |
CONCAT(a; b; ...) | Concaténation |
COALESCE(a; b; ...) | 1re valeur non-vide |
ABS / INT / MOD / ROUND | Fonctions numériques |
MIN(a; b) / MAX(a; b) | Minimum / maximum |
TEXT(nombre; format) | Formatage numérique |
ISNUMBER(val) / ISBLANK(val) | Tests de type |
ZONE_CLIMATIQUE(cp) | Déduit H1/H2/H3 depuis un code postal |
CHAR(code) | Caractère ASCII (code invalide → valeur vide) |
DATE_EST_POSTERIEURE_A(date; date_ref) | Vrai si date ≥ date_ref (inclusif). Gère texte, serial Excel et dates réelles ; faux si une date est vide/illisible. |
Opérateurs de comparaison
=, != (ou <>), <, >, <=, >=
Le séparateur d'arguments peut être le point-virgule ; ou la virgule ,.
Évaluation itérative
Les formules sont évaluées en 2 phases :
- Phase 1 : toutes les valeurs brutes (non-formules) sont renseignées.
- Phase 2 : les formules sont évaluées en boucle (jusqu'à 10 itérations) jusqu'à stabilisation. Cela permet à une formule de référencer le résultat d'une autre formule, même si celle-ci est définie plus bas dans le modèle.
Validation de données et extraction PDF
Types de validation
Chaque colonne du modèle peut avoir un type de validation optionnel :
- Entier : la valeur doit être un nombre entier.
- Décimal : la valeur doit être un nombre décimal.
- Liste de valeurs : la valeur doit faire partie d'une liste prédéfinie (saisie ligne par ligne dans le paramètre de validation).
Saisie libre auth. — sous le sélecteur de type de validation, un toggle permet d'autoriser l'utilisateur à forcer une valeur hors contrainte lors de la validation PDF manuelle (coche Forcer la saisie dans la modale). Désactivé par défaut sur tous les mappings existants. À activer uniquement sur les colonnes où l'utilisateur doit pouvoir écrire une valeur libre (ex : mention spéciale, cas non prévu).
Source « Saisie manuelle »
Dans le mapping, la source Saisie manuelle signifie que la colonne n'a aucune source automatique : elle est toujours demandée à l'utilisateur lors de l'étape de validation manuelle (comme un champ PDF non trouvé).
- Pas de valeur source à renseigner dans le mapping.
- Validation de données (Entier / Décimal / Liste de valeurs) paramétrable normalement, ainsi que Saisie libre auth..
- Condition Si # = Oui respectée : si la condition n'est pas remplie, la valeur reste vide et aucune saisie n'est demandée.
- Déclenche l'étape de validation manuelle même sur une fiche sans Analyse PDF. Dans ce cas, la modale ne montre pas le panneau PDF à droite.
- Sur une fiche avec Analyse PDF, le rapport PDF reste affiché à côté (sans surlignage pour les colonnes Saisie manuelle).
Extraction PDF
Lorsque Analyse PDF est activée sur la fiche, les rapports PDF de chaque mission (rapport « en vigueur ») sont téléchargés depuis l'outil de pilotage et analysés automatiquement.
La configuration des patterns d'extraction se fait dans l'onglet PDF Templates. Pour chaque pattern :
- Texte du pattern : le texte à rechercher dans le PDF (en-tête de colonne, label...).
- Label : clé de stockage pour la valeur extraite. Utilisée pour la référence
$PDF.cledans les formules (normalisée automatiquement : espaces →_, caractères spéciaux supprimés). - Position :
right: 1re cellule non-vide à droite du pattern.below: cellule en dessous du pattern.checkboxes: collecte les cases cochées à droite du pattern (gère les cellules fusionnées et les lignes de continuation multi-lignes). Symboles reconnus : ☑ ☒ ✓ ✗ [x].
Smart cleaning (nettoyage intelligent)
Lorsqu'une colonne a une validation liste de valeurs, le système cherche automatiquement les valeurs autorisées dans le texte extrait du PDF :
- Si 1 seule valeur trouvée → retenue automatiquement.
- Si 2+ valeurs trouvées (ambiguïté) → la valeur brute est conservée et une validation manuelle est demandée.
- Les sous-chaînes sont éliminées intelligemment : si "Non vérifiable" est trouvé, "Non" seul n'est pas compté comme une correspondance indépendante.
Endpoint de debug PDF
L'endpoint GET /api/generation/debug-pdf/{ref_mission} permet de visualiser les tables brutes et le texte extrait par pdfplumber pour une mission donnée. Utile pour diagnostiquer les problèmes d'extraction (structure des tables, caractères spéciaux, colonnes vides).
Compteurs statistiques
Définition globale
Les compteurs sont définis globalement dans l'onglet Compteurs. Chaque compteur a :
- Clé : identifiant unique utilisé comme balise dans le PDF (ex :
nb_operations,nb_cpc). - Label : libellé affiché dans la modale de validation et dans le PDF.
- Ordre : position d'affichage.
Association aux modèles
Dans l'éditeur de modèle, chaque compteur peut être associé à une condition de comptage :
- Référence colonne : colonne de sortie à évaluer (ex :
#A). - Opérateur :
eq(égal),ne(différent),gt(supérieur),lt(inférieur)... - Valeur : valeur de comparaison.
- Conditions alternatives (OU) : liste JSON de conditions supplémentaires. Une ligne est comptée si au moins une condition est remplie.
Modèle sans aucun compteur : Excel seul
Si aucun compteur n'est configuré dans la section « Compteurs synthèse » du modèle utilisé (ni colonne, ni condition OU), la synthèse se limite à l'Excel : pas de PDF, pas de validation des compteurs, pas de comparaison avec les compteurs du lot, et aucune erreur. Le bouton « Modifier PDF » n'est alors pas proposé. S'applique aux synthèses standard (y compris en mode Générique) et 100%.
Un compteur sans condition compte toutes les lignes (utilisé pour nb_operations qui remplace l'ancien nb_total).
API publique
Authentification
Toutes les requêtes API nécessitent un token Bearer dans le header Authorization :
Authorization: Bearer votre-token-api
Les tokens sont créés et gérés dans l'onglet Tokens API. Chaque token a un nom, une date d'expiration optionnelle, et peut être révoqué à tout moment.
Endpoints disponibles
| Méthode | Endpoint | Description |
|---|---|---|
POST | /public-api/generation | Génération synchrone (sans dépôt) |
POST | /public-api/generation/with-sharepoint | Génération + dépôt automatique dans Pilotage CEE (nom historique, plus d'upload SharePoint) |
POST | /public-api/generation/100pct | Génération 100% par missions |
POST | /public-api/generation/100pct/with-sharepoint | Génération 100% + dépôt automatique dans Pilotage CEE (découpage P5/P6 automatique) |
POST | /public-api/generation/pncee | Synthèse PNCEE (client DGEC) de plusieurs lots → 1 Excel, dépôt sur chaque lot (voir section Synthèses PNCEE) |
POST | /public-api/generation/{id}/save-sharepoint | Dépôt manuel dans Pilotage CEE d'un job existant (réponse {uploaded, errors}) |
GET | /public-api/generation/{id} | État d'un job : pending / running (en cours), pending_review / pending_pdf_review (validation), completed (+ URLs), error. Sert après une réponse « Timeout » (la génération se poursuit en arrière-plan) : Pilotage CEE suit ainsi la fin d'un gros lot |
GET | /public-api/generation/{id}/download/excel | Télécharger le fichier Excel |
GET | /public-api/generation/{id}/download/pdf | Télécharger le fichier PDF |
GET | /public-api/kizeo-forms | Formulaires Kizeo (sur site + CPC) actifs pour un code presta à une date |
GET | /public-api/lot/missions-non-relues | Missions Kizeo non relues d'un lot (sur site + CPC) |
POST | /public-api/kpi/points | Points KPI (NS + compteurs) d'une liste de missions |
GET | /public-api/kpi/resolve-form | Formulaire Kizeo inspection en vigueur pour un lot (sans évaluer) |
GET | /public-api/kpi/catalog | Catalogue des mappings KPI par fiche CEE |
Corps de requête (génération standard)
{
"lot_reference": "20260303-07-DIVERS-INS-EDF",
"user": "prenom.nom@spekty.fr",
"output_filename": "REF-CLIENT-1234"
}
output_filename (optionnel) : si renseigné, les fichiers produits sont nommés Synthèse-<output_filename>.pdf et Synthèse-<output_filename>.xlsx au lieu du format par défaut Synthèse-<lot_reference> <fiche_numero>.<ext>. Sans effet sur le contenu des fichiers. S'applique aux endpoints /generation et /generation/with-sharepoint. Cette option n'est pas disponible via l'interface web. Les caractères interdits dans les noms de fichiers Windows/SharePoint (\ / : * ? " < > |) sont automatiquement remplacés par _.
Corps de requête (génération 100%)
{
"mission_references": ["REF-001", "REF-002"],
"fiche_numero": "BAR-TH-171",
"type_pp_pm": "PP",
"output_filename": "Ma synthese",
"user": "prenom.nom@spekty.fr"
}
Réponse type
{
"status": "completed",
"job_id": 123,
"warnings": [],
"excel_download_url": "/public-api/generation/123/download/excel",
"pdf_download_url": "/public-api/generation/123/download/pdf",
"sharepoint_excel_url": null,
"sharepoint_pdf_url": null,
"sharepoint_errors": null
}
Champs sharepoint_* (noms historiques, endpoints with-sharepoint) : plus aucun upload SharePoint, sharepoint_excel_url / sharepoint_pdf_url valent toujours null ; sharepoint_errors liste les erreurs du dépôt automatique dans Pilotage CEE (préfixe Pilotage :), null s'il n'y en a pas.
Génération 100% : découpage P5/P6 automatique
Si les missions envoyées couvrent les deux périodes (date d'engagement de la commande individuelle, lue dans l'outil de pilotage), deux synthèses sont produites. La réponse reste compatible : job_id et les URLs de premier niveau sont ceux de la synthèse P5, period_label vaut "P5", et jobs liste les deux synthèses. status vaut "error" si l'une des deux échoue (error_message préfixé par la période) ; les warnings sont préfixés [P5] / [P6]. Une seule période : réponse habituelle, sans jobs.
{
"status": "completed",
"job_id": 123,
"period_label": "P5",
"warnings": ["[P5] Découpage P5/P6 automatique (synthèse 100%) : 12 mission(s) P5, 4 mission(s) P6 — cette synthèse = P5."],
"excel_download_url": "/public-api/generation/123/download/excel",
"pdf_download_url": "/public-api/generation/123/download/pdf",
"jobs": [
{"period_label": "P5", "status": "completed", "job_id": 123, "pdf_download_url": "/public-api/generation/123/download/pdf", "...": "..."},
{"period_label": "P6", "status": "completed", "job_id": 124, "pdf_download_url": "/public-api/generation/124/download/pdf", "...": "..."}
]
}
Timeout et erreurs
Le timeout des requêtes API est de 5 minutes (300 secondes). En cas de timeout serveur Kizeo (erreur 504), le message d'erreur indique s'il s'agit du formulaire d'inspection ou CPC, et recommande de réessayer dans quelques minutes.
Formulaires Kizeo actifs (GET /public-api/kizeo-forms)
Renvoie, pour un code prestation et une date donnés, le formulaire Kizeo sur site (inspection) et le formulaire CPC actifs à cette date (chacun null s'il n'existe pas). Le formulaire actif est celui dont date_debut ≤ date et (date_fin vide ou date_fin ≥ date), le plus récent en cas de chevauchement.
Paramètres (query) : code_presta (ex. CEE-COF-MU) et date optionnelle (format YYYY-MM-DD ; si omise, la date du jour est utilisée). Chaque formulaire inclut aussi les champs de configuration Kizeo (colonnes du tableau « Formulaires Kizeo » de la page Code prestation) : field_ref_mission, field_ref_lot, field_prise_rdv, field_mission_realisable (inspection), field_conclusion (CPC), field_relecture.
GET /public-api/kizeo-forms?code_presta=CEE-COF-MU&date=2026-03-15
{
"code_presta": "CEE-COF-MU",
"date": "2026-03-15",
"inspection": {
"form_id": "123456",
"date_debut": "2024-01-01",
"date_fin": null,
"field_ref_mission": "reference_mission",
"field_ref_lot": "reference_lot",
"field_prise_rdv": "prise_de_rdv",
"field_mission_realisable": "mission_realisable",
"field_conclusion": null,
"field_relecture": "relecture_effectuee"
},
"cpc": {
"form_id": "789012",
"date_debut": "2024-01-01",
"date_fin": null,
"field_ref_mission": "reference_mission",
"field_ref_lot": "reference_lot",
"field_prise_rdv": "prise_de_rdv",
"field_mission_realisable": null,
"field_conclusion": "conclusion_generale",
"field_relecture": "relecture_effectuee"
}
}
Missions non relues d'un lot (GET /public-api/lot/missions-non-relues)
Pour un numéro de lot, renvoie la liste des missions Kizeo non relues, en appliquant les mêmes règles que la génération (résolution des doublons incluse) avec des critères distincts :
- Sur site (inspection) :
mission_realisable ∈ (O, OUI)ETrelecture = Non. - CPC :
prise_de_rdv = RDVETconclusion = Non satisfaisantETrelecture = Non.
Le code prestation et la date d'intégration sont déduits de la référence (YYYYMMDD-…) ; les formulaires actifs à cette date sont résolus. La réponse inclut aussi les numéros de formulaire Kizeo sur site et CPC utilisés.
GET /public-api/lot/missions-non-relues?lot_reference=20260303-07-CEE-COF-MU-EFY
{
"lot_reference": "20260303-07-CEE-COF-MU-EFY",
"code_presta": "CEE-COF-MU",
"date_integration": "2026-03-03",
"inspection_form_id": "123456",
"cpc_form_id": "789012",
"sur_site_non_relues": [
{ "ref_mission": "REF-001", "mission_realisable": "O", "relecture": "Non" }
],
"cpc_non_relues": [
{ "ref_mission": "REF-045", "prise_rdv": "RDV", "conclusion": "Non satisfaisant", "relecture": "Non" }
]
}
Points KPI par mission (POST /public-api/kpi/points)
Pour une liste de missions (max 200), renvoie les points KPI Non satisfaisants déclenchés et les 4 compteurs fixes, en réutilisant le moteur KPI (résolution modèle + mapping à la date d'intégration, données Kizeo du formulaire inspection actif, déduplication). Les missions sont regroupées par lot (1 recherche Kizeo par lot).
ref(obligatoire) : référence de la mission.fiche(optionnel) : numéro de fiche CEE, pour lever l'ambiguïté quand le code prestation porte plusieurs fiches. Recommandé : c'est le point d'entrée le plus fiable.form_id(optionnel) : numéro de formulaire Kizeo d'inspection. S'il est fourni, il est autoritaire : c'est le formulaire source utilisé, et le mapping/modèle est choisi sur son code prestation (court-circuite la résolution fiche→formulaire). Absent : Synthèses résout le formulaire lui-même (comportement inchangé, rétrocompatible).code_presta+date(optionnels) : repli pour les missions sans lot exploitable (commandes individuelles).
Les données Kizeo sont cherchées d'abord par lot, puis par mission en repli pour les références non trouvées — les commandes individuelles (ex. …-DIV-0001, non rattachées à un lot) sont donc bien évaluées.
Aucune erreur métier n'interrompt le traitement : chaque mission repart avec un status parmi ok, no_mapping, no_kizeo, no_form, no_lot (error est réservé aux erreurs techniques : date malformée, Kizeo indisponible). Seules les saisies Kizeo avec prise_de_rdv = "RDV" sont lues : une mission sans saisie « RDV » ressort no_kizeo. Le champ mapping_rev est une signature stable du mapping : s'il change, c'est que le mapping a été modifié et qu'il faut réévaluer. Le form_id renvoyé reflète le formulaire réellement utilisé (fourni s'il l'était, sinon résolu).
POST /public-api/kpi/points
{
"missions": [
{ "ref": "20260303-07-CEE-COF-MU-EFY-TXP-0004", "fiche": "BAR-EN-101", "form_id": "1186641" },
{ "ref": "AUTRE-REF-0007", "code_presta": "CEE-COF-CO", "date": "2026-03-15" }
]
}
{
"results": [
{
"ref": "20260303-07-CEE-COF-MU-EFY-TXP-0004",
"status": "ok",
"points_NS": [
{ "label": "Photo manquante", "category": "Documentaire", "position": 3 }
],
"compteurs": {
"ctrl_realises": true, "ctrl_satisfaisants": false,
"ctrl_non_satisfaisants": true, "ctrl_non_verifiables": false
},
"mapping_id": 12, "mapping_rev": "2026-03-01T10:00:00|a1b2c3d4e5f60718",
"model_id": 47, "form_id": "1138773"
},
{ "ref": "AUTRE-REF-0007", "status": "no_kizeo" }
]
}
Formulaire Kizeo d'un lot (GET /public-api/kpi/resolve-form)
Renvoie le numéro de formulaire Kizeo d'inspection en vigueur pour un lot (celui dont l'URL history est https://forms.kizeo.com/data/history/<form_id>), sans lire de données Kizeo ni évaluer de points.
ref(obligatoire) : référence du lot. Son préfixeAAAAMMJJ(date d'intégration) choisit la bonne configuration en cas de bascule datée (ex. BAR-EN-103 : CP avant le 01/07/2026, PL à partir).code_presta(optionnel, prioritaire) : résolution directe code presta + date → formulaire.fiche(optionnel) : utilisé sicode_prestaabsent ; le code presta effectif à la date (version active) est déduit de la fiche.
Au moins l'un de fiche/code_presta est requis. Non résolvable → {"form_id": null} (HTTP 200). Le form_id est cohérent avec celui renvoyé par POST /public-api/kpi/points pour une mission du même lot.
GET /public-api/kpi/resolve-form?ref=20260825-04-CEE-COF-VE-EDF-0001&code_presta=CEE-COF-VE
{ "form_id": "1186641" }
GET /public-api/kpi/resolve-form?ref=20260210-03-DIVERS-INS-XXX&fiche=DIVERS-INS
{ "form_id": null }
Catalogue des mappings KPI (GET /public-api/kpi/catalog)
Liste, par fiche CEE ayant un mapping KPI, les points NS configurés et la borne de reprise historique. date_min = la plus ancienne date_debut des formulaires Kizeo inspection du code prestation de la fiche (au-delà, aucune donnée à retrouver).
GET /public-api/kpi/catalog
{
"fiches": [
{
"fiche": "BAR-EN-101",
"mapping_id": 12,
"mapping_rev": "2026-03-01T10:00:00|a1b2c3d4e5f60718",
"points_NS": [
{ "label": "Photo manquante", "category": "Documentaire", "position": 3 }
],
"date_min": "2024-03-01"
}
]
}
KPI (admin)
L'outil KPI est une fonctionnalité annexe à la génération de synthèses. Il permet d'extraire un fichier Excel décomptant les opérations Non satisfaisantes par point KPI configuré, sur un périmètre filtré (clients, fiches CEE, période).
Pré-requis
- Un Mapping KPI doit être configuré sur le modèle de synthèse de chaque fiche concernée (page Mappings KPI).
- Les configurations existantes (clients, fiches, modèles, formulaires Kizeo, mappings de synthèse) sont réutilisées telles quelles. Aucune modification n'est nécessaire dans les paramétrages existants.
Lancer une analyse
- Aller dans l'onglet KPI.
- Saisir un ou plusieurs clients (un par ligne, ou séparés par
,/;). Doit correspondre exactement au champClientdes missions dans l'outil de pilotage. - Sélectionner une ou plusieurs fiches CEE.
- Renseigner les dates de début et de fin. Les missions retenues seront celles dont la
Date(outil de pilotage) est dans cet intervalle. - Cliquer sur Lancer l'analyse KPI. Le job s'exécute en arrière-plan, l'historique se met à jour automatiquement.
Filtrage des missions
Les missions sont lues dans l'outil de pilotage selon les critères :
Statut= TerminéClient∈ liste saisieFiche_CEE∈ fiches sélectionnéesDate∈ intervalle [date_debut, date_fin]
Choix du modèle et du mapping par lot
La résolution se fait par lot, à la date d'intégration du lot (les 8 premiers caractères AAAAMMJJ de la référence). Pour chaque lot :
- on prend le modèle de la FicheVersion active à cette date (PP en priorité, sinon PM) ;
- on cherche le mapping KPI où ce modèle est principal ; sinon où il est secondaire (dans ce cas l'évaluation se fait avec le modèle principal du mapping, comme pour la 2e page de synthèse) ;
- si ce modèle n'est rattaché à aucun mapping, on remonte vers les versions plus récentes jusqu'à en trouver un ;
- si aucun modèle (sur toutes les versions) n'a de mapping, les données du lot sont ignorées avec un avertissement.
Ainsi, sur une période à cheval sur un changement de modèle (frontière par date d'intégration), chaque lot est compté avec le bon mapping. Les comptages sont ensuite agrégés par libellé de point KPI au niveau de la fiche (même libellé entre deux modèles → additionné). Les modèles 100% sont exclus.
Limitation : seules les frontières par date d'intégration sont gérées. Pour une fiche dont les versions basculent par date d'engagement, l'outil en lot ne dispose pas de cette date (il ne lit pas les fichiers commande) et utilise la date d'intégration comme approximation.
Récupération des données
- Seules les données Kizeo inspection sont récupérées (pas de CPC, pas de fichier commande, pas de PDF), et uniquement les saisies avec
prise_de_rdv = "RDV"(comme pour la synthèse). - Multi-formulaires implicite : tous les formulaires Kizeo inspection du code prestation sont interrogés (sans filtre date), comme en mode "Multi-formulaires Kizeo".
- En cas de doublons Kizeo : même logique que pour la synthèse, mais lorsqu'un blocage serait déclenché, on prend la donnée la plus récente (
create_time). - Les colonnes du modèle dont la source est Fichier commande, Mission (outil de pilotage), Rapport PDF, Saisie manuelle ou Kizeo CPC sont évaluées comme vides (non utilisées par l'outil KPI).
Mappings KPI
Onglet Mappings KPI. Un mapping est rattaché à un modèle principal (qui définit la structure des références de colonnes utilisées dans les points), et éventuellement à un ou plusieurs modèles secondaires.
Chaque mapping contient une liste ordonnée de points Non satisfaisant. Pour chaque point :
- Libellé : nom du point (ex: "RDV non honoré").
- Catégorie : à choisir parmi Documentaire, Eligibilité, Paramètre de la prime, Non qualité manifeste.
- Condition principale : colonne du modèle + opérateur + valeur.
- Conditions OU : 0 à N conditions supplémentaires. Si la principale OU une condition OU matche, l'opération est comptée.
Opérateurs disponibles : égal, différent, contient, commence par, vide, non vide.
Modèles secondaires (rattachements multiples)
Un mapping KPI peut être appliqué à plusieurs modèles de synthèse via la liste de modèles secondaires. Cas d'usage typique : un modèle ... PP et son jumeau ... PM partagent les mêmes champs Kizeo, donc le paramétrage KPI est identique. Plutôt que de dupliquer le mapping, on rattache le modèle PM en secondaire du mapping principal PP.
Dans l'éditeur, sous le nom du mapping, la zone Modèles secondaires liste les rattachements actuels sous forme de chips. Pour en ajouter un, cliquer sur + Rattacher un modèle secondaire : une modale propose le sous-ensemble des modèles disponibles. Pour en retirer un, cliquer sur le × du chip correspondant.
Règle d'unicité : un modèle ne peut être rattaché qu'à un seul mapping à la fois, en principal ou en secondaire. Conséquences :
- Les modèles déjà rattachés ailleurs ne sont pas proposés dans la modale + Rattacher.
- À la création d'un mapping, si le modèle principal choisi est actuellement secondaire d'un autre mapping, une confirmation est demandée. Si elle est acceptée, le modèle est automatiquement détaché de l'ancien mapping puis devient le principal du nouveau.
- Si le modèle principal choisi est déjà principal d'un autre mapping, la création est refusée (il faut d'abord supprimer ou renommer l'ancien).
À l'exécution sur un lot dont le modèle de synthèse est un secondaire : le pipeline relance une 2e passe d'évaluation en interne avec le modèle principal, afin que les références de colonnes du mapping (qui suivent la structure du principal) trouvent leurs valeurs. Coût ~1-2 s, invisible pour l'utilisateur.
Format du fichier Excel de sortie
| Col | Contenu |
|---|---|
| A | Fiche CEE |
| B | Catégorie |
| C | Libellé du point Non satisfaisant |
| D | Nombre d'opérations Non satisfaisantes |
Une ligne par couple (fiche CEE × point KPI), y compris les compteurs à 0. À droite des données, un tableau cumul par catégorie + un camembert de répartition.
Non interférence avec la synthèse
Cette fonctionnalité n'a aucun impact sur la génération de synthèses : pas de modification du pipeline existant, pas de modification des mappings de colonnes, des modèles, des fiches ou des formulaires Kizeo.
Paramètres globaux
Les paramètres globaux sont configurés en haut de cette page :
- Token API Kizeo : token d'authentification pour l'API Kizeo Forms. Utilisé pour récupérer les données des formulaires d'inspection et CPC.
- Chemin fichier commande (repli SharePoint) : dossier SharePoint où chercher le fichier commande d'un lot seulement s'il est absent de l'outil de pilotage (ex :
Synthèses/Fichiers commandes pour synthèses). - Token API Intégrations : récupération des taux réglementaires.
- Pilotage CEE — URL de base / token API : source des lots, missions, fichiers commande et rapports PDF, et cible des dépôts de synthèse.
Nettoyage automatique
Les jobs de plus de 7 jours sont automatiquement supprimés (fichiers Excel/PDF et entrées en base), ainsi que les tokens API révoqués.
Compteurs de synthèse
Ces compteurs servent de balises dans la synthèse PDF. Ils sont partagés par tous les modèles.
| # | Cle (balise) | Label | Actions |
|---|
Aucun compteur configuré.
Taux réglementaires
Taux de contrôle réglementaires par fiche CEE et période. Le Type de lot d'un lot (outil de pilotage) est comparé au Libellé pour déterminer les taux cibles.
Comment les taux sont sélectionnés à la génération
1. Match par libellé (cas nominal) — Le Type_de_lot du lot est comparé (insensible à la casse) à Libellé (mode standard) ou aux Libellé PP / Libellé PM (mode distinct PP/PM) de toutes les lignes de la fiche. Le premier match détermine les taux à appliquer.
2. Fallback par date d'engagement — Si aucun libellé ne matche, on cherche la ligne dont la période [date_debut ; date_fin] inclut la date d'engagement max des opérations du lot. Si plusieurs lignes matchent, on prend celle avec date_debut le plus récent. Sur une ligne distincte PP/PM, la paire PP ou PM est choisie selon le type_pp_pm du lot.
3. Aucun match — Le taux_cible du lot est conservé tel quel et taux_cpc_cible reste vide.
Distincts PP/PM : une ligne peut porter des libellés + taux distincts pour PP et PM. À l'affichage, elle est découpée en 2 lignes (badge PP / PM) partageant fiche et dates. La configuration se fait dans l'outil Intégrations.
| Fiche | Date début | Date fin | Libellé | Taux site | Taux CPC |
|---|
Aucun taux disponible (vérifiez le token API Intégrations dans Paramètres).
Clients
Liste des clients (donneurs d'ordre). Le flag Synthèse avec KPI active une 2e page « KPI » dans le PDF de synthèse, à condition que le modèle de synthèse de la fiche ait un mapping KPI rattaché.
Le nom doit correspondre exactement au champ Client du lot (outil de pilotage), parenthèse comprise (ex : EDF (Marché des Particuliers)). Sensible à la casse.
| Nom | Synthèse avec KPI | Actions |
|---|
Aucun client configuré.
Templates PDF
Configurez les templates Excel utilisés pour générer les PDF de synthèse.
Placez des balises {{tag}} dans les cellules Excel.
Les pourcentages peuvent être des formules Excel natives (ex: =IFERROR(E26/E21,0)).
Templates disponibles
| Template | Description | Règles de sélection | Fichier | Actions |
|---|
Balises disponibles
Cliquez sur une balise pour la copier. Collez-la dans les cellules de vos fichiers Excel.
| Balise | Description | Source |
|---|
Gestion des utilisateurs
| Nom | Rôle | Accès KPI | Dernière connexion | Créé le | Actions |
|---|
Aucun utilisateur.