• Spekty integrations v3.15
  • Préparer un fichier↗︎
  • Pré-intégration
  • Intégrer un lot
  • Commandes R2
  • Guide
  • Fiches CEE
  • Paramétrage ▾
    • Codes prestations
    • Pôles & qualifications
    • Paramètres
    • Format d'entrée
    • Format de sortie
    • Mémo des champs
    • Taux réglementaires
    • Tbase
    • Tokens API
    • Tokens API clients
    • Utilisateurs
  • ▾
    • Déconnexion
  • Se connecter

Intégrer un lot

⬆

Glisser-déposer votre fichier de lot ici

ou cliquez pour parcourir

Fichier sélectionné
Préremplie depuis le nom de fichier ; modifiable.

Historique des intégrations (7 derniers jours)

Réf. Spekty Client Fiche Réf. client PP/PM Délai Lignes Utilisateur Date 📧

Aucune intégration sur les 7 derniers jours.

Commandes R2 à préparer

Commandes R2 nouvelles, non encore prises en compte. Cliquez sur une ligne pour préparer le contrôle.

N° mission Client Nom Prénom Adresse CP Ville Type opération

Aucune commande R2 à préparer.

Guide utilisateur

Aucune section ne contient ce terme.

Génération des fichiers — étapes

  1. Préparer le fichier Excel du lot (seul le premier onglet — le plus à gauche — est lu, en-tête en ligne 1, données dès la ligne 2). Le format de chaque colonne est défini par le Format d'entrée du code prestation concerné — voir plus bas la sous-section dynamique « Détail d'un code prestation ».
  2. Glisser-déposer le fichier dans la dropzone de la page « Intégrer un lot ». Possibilité de le télécharger via « Définir le dossier par défaut » pour pointer directement au bon endroit la première fois (Chrome/Edge).
  3. Pré-validation automatique : détection fiche CEE (colonne N ; colonne U en « Intégration PNCEE »), déduction code prestation (Site > Contact > CVAD), détection PP/PM (colonne « Bénéficiaire PM »), vérification que les dates d'engagement ne franchissent pas de frontière P4/P5/P6, contrôle des colonnes marquées obligatoires dans le Format d'entrée (blocage si une cellule est vide), calcul du taux réglementaire applicable. Si le type de contrôle déduit ne convient pas (ex. un lot de CPC reconnu par défaut comme contrôle sur site, qui bloque sur une colonne obligatoire), l'encart d'erreur propose des boutons « Relancer en … » pour réintégrer en imposant un autre type de contrôle disponible pour la fiche (Sur site / Contrôle par contact CPC / CVAD).
  4. Modale principale : choisir le client (filtre par tapping), le mode Zen/Premium, le taux retenu (Réglementaire ou 100%), confirmer Demande / Consignes / CPC / Commentaire. Les dates butoir / clôture terrain / clôture client se recalculent en direct.
    • Lot « Contrôle par contact » (CONTACTCEE) : Taux réglementaires forcé (grisé), Taux retenu = 0 non modifiable, CPC réalisés en interne = Oui forcé (grisé). Demande client et Consignes préremplies « CPC uniquement : X% » (taux CPC réglementaire), modifiables.
    • Lot sur site avec CPC interne = Oui : la Demande client ajoute automatiquement « + CPC : X% » (taux CPC réglementaire) au texte des satisfaisants.
    • Fiche site + contact avec taux site réglementaire = 0 : le contrôle par contact devient le mode réglementaire (sélectionné par défaut) ; « Contrôles sur site (volontaire) » reste cliquable. Basculer entre les deux re-prévalide le fichier avec le code prestation correspondant (format d'entrée/sortie + ref de lot adaptés).
    • Intégration ASP (leasing social, hors CEE) : après avoir déposé le fichier, cliquer sur « Intégration ASP » (bouton bleu clair, à droite de « Intégrer ») au lieu de « Intégrer ». Le code prestation CTL-ASP-VE et la fiche « Leasing social » sont imposés : la colonne N du fichier n'est pas lue, la fiche n'a pas à figurer dans le fichier de commande. Les contrôles propres aux CEE (frontière de période, taux réglementaires) ne s'appliquent pas, mais les colonnes obligatoires du Format d'entrée restent contrôlées. PP/PM est détecté comme d'habitude si le Format d'entrée désigne la colonne « Raison sociale PM », sinon le lot est en PP. Dans la modale : client « ASP - Agence de services et de paiement de l'Etat » imposé, non modifiable. À défaut du libellé exact, l'unique client dont le nom commence par « ASP - Agence de services » est retenu ; s'il est absent ou ambigu, l'intégration est bloquée, Zen imposé (Premium grisé), contrôle à 100 % (Demande « 100% », Consignes « Prendre 100% », modifiables) et « Contrôles par contact à faire en interne » verrouillé sur Non. Délai Zen ASP : clôture client le dernier mardi ou vendredi du mois (le plus tardif des deux) s'il laisse au moins 3 semaines (21 jours), sinon celui du mois suivant ; la date reste ajustable avec les flèches ‹ ›. Le client ASP ne peut pas être choisi dans le parcours classique (voir « Spécificités PNCEE », § Clients réservés).
  5. Fiche client lue dans Pilotage CEE : au passage de la modale au tableur, l'outil relit la fiche du client choisi dans Pilotage CEE (elle alimente les colonnes calculées avec $CLIENT.…, ex. le nom du client dans le fichier Flow). En cas d'erreur passagère, la lecture est retentée plusieurs fois (~15 s). Si Pilotage ne répond toujours pas, la préparation est bloquée avec le message « Impossible de lire la fiche du client dans Pilotage CEE… » : réessayer un peu plus tard. Aucun numéro de lot n'est consommé. Avant ce blocage (v3.1), ces colonnes sortaient vides sans avertissement.
  6. Caractéristiques de l'opération à compléter : si la fiche a un modèle de caractéristiques, il est rappelé au dépôt quand la colonne de sortie « Caractéristiques de l'opération » reprend une colonne du fichier source (on peut encore corriger le fichier). Sinon (colonne de sortie vide ou calculée, ex. formats PNCEE), le rappel se fait après la validation de la modale, une fois les colonnes de sortie calculées. À cette étape, si la colonne est vide sur au moins une ligne et que le modèle contient des zones {{…}}, une modale « Compléter les Caractéristiques de l'opération » propose, pour chaque zone, une colonne du fichier source (lettre + en-tête, ou « laisser à compléter »), avec un aperçu sur la première ligne à remplir. Le texte du modèle est modifiable dans la modale, zones comprises (ajout — en tapant {{libellé}} ou avec le bouton « + Zone {{…}} » qui l'insère au curseur —, suppression d'une ligne entière balise comprise, reformulation) : la liste des zones et l'aperçu suivent à la frappe ; la modification ne vaut que pour ce lot (la fiche n'est pas modifiée). « Remplir la colonne » complète les cellules vides ligne par ligne (dates en jj/mm/aaaa ; les cellules déjà remplies ne bougent pas) ; une zone sans valeur sur une ligne reste affichée {{…}} pour être repérée dans le tableur. Les colonnes choisies sont mémorisées par fiche + client et proposées d'office la fois suivante ; une zone retirée du texte pour un lot (ex. ligne « Capacité » supprimée faute d'information) garde sa colonne mémorisée pour les lots suivants. Le résultat reste modifiable dans le tableur et la coche « J'ai vérifié le champ… » reste obligatoire.
  7. Durée maximale : 1 h entre le clic qui lance l'intégration (fichier choisi : Intégrer, Intégration ASP ou Intégration PNCEE ; ou Intégrer depuis la Pré-intégration) et « Valider et intégrer ». Au-delà, la suite est refusée avec le message « Intégration commencée à HH:MM : une intégration ne doit pas durer plus d'1 h » (à la validation de la modale, ou à la génération si l'on s'est attardé dans le tableur) : rien n'est généré, il faut recommencer depuis le début. La bascule de mode dans la modale (site volontaire ↔ contact) ne remet pas le chrono à zéro. Si le clic de lancement échoue (ex. « Colonnes obligatoires ») et qu'on relance avec le bouton « Relancer en « … » » de l'encadré d'erreur, le chrono part de ce second clic. Le temps de préparation automatique de la Pré-intégration ne compte pas.
  8. Tableur d'édition : modification colonne par colonne (✎ dans l'en-tête de chaque colonne modifiable_preview). En mode édition, un bouton 📋⬇ permet un coller-en-masse : copier une colonne depuis Excel (même nombre de lignes), la coller dans la modale → toutes les cellules de la colonne sont remplacées d'un coup. Bandeau récap en haut. Une cellule tronquée (colonne trop étroite) affiche son contenu complet en infobulle au survol. Affichage des warnings/blocages (jaune/rouge) et des doublons potentiels (violet, avec icônes 🗑 et ℹ par ligne).
  9. Bouton « Valider et intégrer » : déclenche la génération en parallèle des 4 sorties (cf. ci-dessous) + ouvre la modale d'envoi du mail terrain (validation manuelle).

Sélection du code prestation (auto / forcée)

Le code prestation détermine tout le traitement du lot : format d'entrée (colonnes attendues + colonnes obligatoires), format de sortie (mappings Pilotage CEE), taux réglementaire et référence de lot. Il est choisi en deux temps.

1. Déduction automatique (par défaut)

À l'upload, l'outil déduit le code prestation à partir des modes de contrôle cochés sur la fiche CEE, par ordre de priorité :

  1. Contrôle sur site → le code prestation « CS » configuré sur la fiche (ex. DIVERS-INS, CEE-COF-…). Prioritaire dès que « Contrôle sur site » est coché et qu'un code presta CS est renseigné.
  2. sinon Contrôle par contact → CONTACTCEE (les CPC).
  3. sinon CVAD (contrôle à distance) → CTRL-VISIO.

Si aucun mode n'est actif sur la fiche, l'intégration est refusée (« aucun mode de contrôle activé »).

2. Exception « site volontaire » (bascule auto)

Cas particulier d'une fiche qui a à la fois Sur site et Contact, mais dont le taux site réglementaire = 0 : le mode réglementaire est en réalité le contrôle par contact. L'outil bascule donc automatiquement sur CONTACTCEE par défaut, et la modale propose « Contrôles sur site (volontaire) » si on veut quand même forcer le site. (Voir aussi le comportement de la modale dans la section précédente.)

3. Forçage manuel du code prestation

La déduction auto peut se tromper quand une fiche est cochée sur plusieurs modes. Exemple typique : on intègre des CPC (contrôle par contact) sur une fiche aussi cochée « Sur site » pour des contrôles volontaires occasionnels → l'outil déduit le code presta site (ex. DIVERS-INS) et bloque sur une colonne obligatoire (« Caractéristiques de l'opération » par ex.) qui n'existe pas pour CONTACTCEE.

Deux moyens de forcer le bon code prestation :

  • Sur erreur de pré-validation : l'encart rouge affiche des boutons « Relancer en … » (un par mode disponible pour la fiche : Sur site / Contrôle par contact CPC / CVAD). Le clic ré-uploade le fichier en imposant ce mode et relance l'intégration avec le code prestation correspondant.
  • Dans la modale principale (cas « site volontaire ») : le lien « Contrôles sur site (volontaire) » re-prévalide avec le code presta site.

Le forçage ne désactive aucun contrôle métier (colonnes obligatoires, périodes, etc.) : il rejoue simplement la pré-validation avec le format d'entrée/sortie du code prestation imposé. Si ce code n'est pas autorisé sur la fiche (mode non coché), le forçage est refusé.

Spécificités PNCEE (client DGEC)

Les lots du PNCEE sont commandés par le client « DGEC - Direction générale de l’énergie et du climat ». Ils suivent un parcours dédié : bouton « Intégration PNCEE » et contrôle sur site spécifique paramétré sur chaque fiche.

1. Paramétrage des fiches : « Contrôle PNCEE »

  • Dans l'onglet Fiches CEE, chaque fiche a une coche « Contrôle PNCEE » PNCEE : c'est un contrôle sur site dédié au PNCEE, avec la même section que le contrôle sur site (code prestation — obligatoire —, qualification, temps de mission et, si le code est DIVERS-INS ou C-PNCEE-JS, la sous-section « Spécifique … » : section du formulaire, contrôle sous accréditation, diffusion automatique, points de contrôle, précisions Kizeo).
  • La section PNCEE est indépendante du contrôle sur site : elle peut avoir le même code prestation (ex. DIVERS-INS) avec une section, une qualification ou un temps de mission différents.
  • Dans la liste des fiches, le code du contrôle PNCEE s'affiche sous le code déduit, avec le cartouche PNCEE ; la colonne « Contrôles » porte un badge PNCEE. Le code déduit (site > contact > CVAD) n'est pas modifié : il reste celui de l'intégration classique.

2. Intégrer un lot PNCEE

  • Déposer le fichier, puis cliquer sur « Intégration PNCEE » (bouton bleu-vert, à côté de « Intégration ASP ») au lieu de « Intégrer ».
  • Fichier d'entrée : il peut comporter plusieurs onglets ; c'est toujours le premier onglet (le plus à gauche) qui est lu, quel que soit l'onglet actif à l'enregistrement. La fiche CEE est lue en colonne U (au lieu de la colonne N de l'intégration classique), avec les mêmes contrôles : une seule fiche par lot, aucune ligne vide, fiche connue de l'onglet Fiches CEE. Les découpes proposées en cas de lot mixte (périodes, PP / PM) lisent aussi la colonne U et utilisent le code du Contrôle PNCEE.
  • Code prestation = celui du Contrôle PNCEE de la fiche (et donc son format d'entrée et son format de sortie). Fiche sans contrôle PNCEE : blocage « pas de contrôle PNCEE configuré » (aucune bascule vers un autre mode n'est proposée).
  • Les contrôles CEE s'appliquent comme pour un contrôle sur site (colonnes obligatoires, frontière de période), mais le taux de contrôle est toujours de 100 %.
  • PP / PM : un lot PNCEE n'est ni PP ni PM ; il peut contenir des opérations PP et/ou PM. Pas de détection PP/PM, pas de blocage « lot mixte » ni de découpe PP / PM. Rien n'est affiché (pas de ligne PP/PM dans la modale ni dans le tableur, colonne vide dans l'historique) ; $INTEG.pp_pm est vide (les champs Pilotage CEE mappés dessus restent vides). Fiche dont le taux réglementaire est distinct PP / PM : le taux le plus élevé des deux est affiché (site comme CPC), libellés PP et PM côte à côte — à titre indicatif, le taux appliqué étant 100 %.
  • Modale : client DGEC imposé, non modifiable (à défaut du libellé exact, l'unique client dont le nom commence par « DGEC - Direction générale » ; absent ou ambigu → intégration bloquée). Le mode affiché est « Contrôle PNCEE » avec son code. Zen est coché par défaut (Premium reste possible). Taux : 100 % imposé, non modifiable (« 100 % » coché et grisé, taux retenu 100 ; Demande « 100% » et Consignes « Prendre 100% » préremplies, modifiables) ; les taux réglementaires restent affichés pour information. Les autres réglages (CPC, commentaire) se font comme d'habitude.
  • Formats de sortie : pendant une intégration PNCEE, les champs du contrôle sur site de la fiche ($FICHE.cs_code_presta, cs_qualification, cs_temps_mission, cs_section_divers_ins, cs_sous_accreditation, cs_diffusion_auto, cs_precisions_kizeo, cs_points_controle_json) prennent les valeurs de la section PNCEE : les formats existants utilisent la section dédiée sans modification. Ces noms ne changent pas selon le code prestation : $FICHE.cs_section_divers_ins (et les autres champs de la sous-section) sert aussi bien pour DIVERS-INS que pour C-PNCEE-JS. Les valeurs PNCEE restent disponibles en $FICHE.pn_… et le mode en $INTEG.mode (= pncee) ; tous ces champs sont proposés dans les listes du Format de sortie.

3. Clients réservés à leur mode dédié

  • Les clients DGEC et ASP ne peuvent pas être intégrés par le parcours classique : s'ils sont sélectionnés dans la modale, le message « Intégration impossible : veuillez utiliser le mode d'intégration dédié à ce client. » s'affiche et « Valider » est masqué (contrôle refait par le serveur).
  • Réciproquement, « Intégration PNCEE » n'accepte que DGEC et « Intégration ASP » que l'ASP.

Sorties générées

  • JSON de commande compressé ({ref_lot}.json.gz) — déposé dans Pilotage CEE (fichier data_synthese du lot). Contient toutes les colonnes non-intermédiaires. Les anciens fichiers restés sur SharePoint restent lisibles (repli en lecture).
  • Excel Flow ({ref_lot}.xlsx) — joint au mail terrain et déposé dans Pilotage CEE sur le lot (fichier fichier_flow, distinct du data_synthese) : c'en est la seule copie conservée, le dossier de travail du serveur étant vidé à chaque déploiement. Contient les colonnes dans_fichier_kizeo=true non-intermédiaires, avec types préservés (number, date au format DD/MM/YYYY).
  • Lot + missions dans Pilotage CEE — le lot via le mapping lots du format de sortie, une mission par opération via le mapping opérations. En cas d'échec malgré les réessais, la création part en file d'attente et est rejouée automatiquement (le lot est alors considéré comme intégré).
  • Mail à terrain@spekty.fr — éditable dans une modale rich-text avant envoi. Pièce jointe = Excel Flow. Expéditeur = pole.email_emetteur de la fiche, Reply-To = user connecté.

Fonctionnalités spécifiques

  • Numéro du jour : compteur incrémental atomique (1..99, A0..Z9 max 359 / jour). Endpoint public /public-api/numero-jour/today utilisé par la macro VBA historique (auth par token Bearer).
  • Numéro de mission individuelle du jour : second compteur incrémental atomique, indépendant du numéro de lot, au format 4 chiffres (0001..9999, pas de conversion en lettres). Endpoint public GET /public-api/numero-mission-jour/today (auth par token API : Authorization: Bearer, X-Api-Key, ou ?api_token= — cf. section Admin pour le connecteur Power Automate). Chaque appel réserve le prochain numéro de façon atomique (SELECT … FOR UPDATE) : un même numéro n'est jamais attribué deux fois. Réponse : date, reserved (ex. "0007", déjà formaté sur 4 chiffres), reserved_int. Peek lecture seule (sans réserver) : GET /api/numero-mission-jour/today.
  • Taux réglementaires — source de vérité partagée : les taux réglementaires ne se saisissent que dans cet outil. Ils sont exposés en lecture seule via l'endpoint public GET /public-api/taux (auth par token API — Authorization: Bearer integ_…, X-Api-Key: integ_… ou ?api_token=integ_…, trois formes acceptées par tous les endpoints /public-api/*), afin que d'autres applications (ex. syntheses-pncee) les récupèrent sans double saisie. La réponse contient generated_at (horodatage UTC), count et taux (même contrat que l'onglet Taux réglementaires). Les applications consommatrices maintiennent un miroir local en lecture seule.
  • Pôles — source de vérité partagée : la table des pôles est également exposée en lecture seule via GET /public-api/poles (même auth par token API). Réponse : generated_at (UTC), count et poles (chaque ligne : id, libelle, sort_order, email_emetteur — même contrat que GET /api/poles).
  • Fiches CEE — liste simplifiée partagée : exposée en lecture seule via GET /public-api/fiches (même auth par token API), limitée aux colonnes Numéro / Libellé / Groupe de compétence / Pôle / Qualification. Réponse : generated_at (UTC), count et fiches (chaque ligne : numero, libelle, pole = libellé du pôle ou null, qualification = code de la qualification du contrôle sur site, ou null si la fiche n'est pas cochée « contrôle sur site »). S'y ajoute groupe_competence (groupe de compétence DGEC INS REF 31, ex. « 1 - Enveloppe », ou null), pn_qualification (code de la qualification du contrôle PNCEE, ou null si la fiche n'est pas cochée « contrôle PNCEE » ; lu par Rapport Word pour vérifier la qualification du signataire d'un rapport PNCEE), ainsi que trois booléens, toujours présents (jamais null) : controle_sur_site, controle_par_contact et cvad — les cases de la fiche, lues telles quelles. Une fiche peut en avoir 0, 1, 2 ou 3 à vrai. Un quatrième booléen, controle_pncee, donne la case « contrôle PNCEE » (lu par Pilotage CEE pour « Puis-je relire… ? »). Pour savoir si une fiche se contrôle sur site, lire controle_sur_site et non la présence d'une qualification : une fiche sur site sans qualification saisie a qualification: null. Triée par numero.
  • Détection de doublons (asynchrone) : lance en arrière-plan une recherche des missions Pilotage CEE après ouverture du tableur. Match exact sur Fiche_CEE + téléphone + statut éligible (En cours / Échantillonné / Planifié, ou Terminé créé < 60 j). Affiché en panneau violet, avec corbeille pour retirer la ligne + modale ℹ détaillée.
  • Regroupement de lignes (RES-EC-104 uniquement) : bouton ⇧ par ligne pour fusionner avec la ligne au-dessus. Checks d'équalité sur Client/Adresse/CP/Ville/Prénom/Nom/Tel1/Artisan. Confirme le nombre de luminaires de chaque ligne, somme les cadres A, concatène Ref client / Référence Emmy / Référence interne / Volume HP / Volume P / Montant RAI. Le bouton « Valider et intégrer » est verrouillé par une case « J'ai vérifié les regroupements » spécifique à cette fiche.
  • RES-EC-104 — split 01/01/2025 : à l'upload, si le lot contient des dates d'engagement strictement antérieures à 01/01/2025 ET ≥ 01/01/2025, l'intégration est bloquée avec le message « Le lot comporte des opérations engagées AVANT et APRES le 01/01/2025. Découper le lot en 2. » (changement de règles d'éligibilité à cette date).
  • Découpe automatique par période CEE : si l'upload bloque parce que les dates d'engagement franchissent une frontière P4/P5/P6, un bouton « ✂ Découper automatiquement le fichier » apparaît dans l'encart d'erreur. Il génère 1 sous-fichier par période (en-tête + formatage préservés, lignes filtrées par période), nommés <original>-P5.xlsx, <original>-P6.xlsx, etc. Les fichiers sont enregistrés dans le dossier par défaut configuré (ou téléchargés en fallback sur Firefox/Safari). Le user peut ensuite ré-uploader chaque sous-fichier indépendamment. À côté du bouton « Découper », un bouton « Poursuivre quand même » permet, après confirmation, d'intégrer le lot tel quel sans le découper (le contrôle de frontière de période est alors ignoré pour ce lot uniquement).
  • Découpe automatique PP / PM : si l'upload bloque sur un lot mixte (PP + PM dans le même fichier — détecté via la colonne « Bénéficiaire PM » du Format d'entrée : vide=PP, rempli=PM), un bouton « ✂ Découper en PP / PM » génère 2 sous-fichiers <original>-PP.xlsx et <original>-PM.xlsx. Même mécanique d'enregistrement que la découpe par période.
  • Vérification contrat client (contrôles sur site uniquement) : à l'ouverture de la modale, appel à fiches-contrats-cee.spekty.fr pour confirmer que le client a la fiche dans son contrat cadre. Trois cas distincts affichés :
    • ⛔ rouge — client inconnu dans Fiches Contrats CEE (aucun contrat cadre trouvé) : vérifier le nom / créer le client ;
    • ⚠️ jaune — client connu mais fiche non couverte par le contrat cadre : s'assurer qu'un devis a été établi ;
    • ℹ️ gris — vérification indisponible (API injoignable / token absent / erreur) : vérifier manuellement. Ce message s'affiche désormais aussi si l'appel échoue, plutôt que de rester silencieux.
  • Mauvais payeur : si le client a Mauvais_payeur=Oui sur la liste SP des clients, bandeau rouge bloquant et bouton Valider caché. Contacter la direction commerciale.
  • Caractéristiques d'opération : si la fiche en a (HTML rich), confirmation au moment de l'upload pour rappeler à l'utilisateur de compléter ces précisions dans le fichier importé. Dans le tableur, si une colonne « Caractéristiques de l'opération » est définie dans le mapping et que la fiche a un modèle, la colonne est mise en évidence en vert WhatsApp (en-tête + cellules), un bouton ☰ dans l'en-tête ouvre une modale affichant le modèle + bouton « Copier le texte » (collable dans une cellule en mode édition, avec textarea pour multi-lignes). Une checkbox verte « J'ai vérifié le champ Caractéristiques de l'opération » verrouille « Valider et intégrer » jusqu'à validation manuelle (similaire à la checkbox rose pour les regroupements RES-EC-104).
  • Tableur — passages à la ligne & resize colonne : les cellules respectent les \n explicites du contenu (CHAR(10)) sans wrap automatique sur les longues lignes. Chaque en-tête de colonne a une poignée de redimensionnement à droite (drag) permettant d'élargir une colonne pour des contenus longs (Caractéristiques en particulier).
  • Dates affichées en dd/MM/yyyy dans le preview ET dans le fichier Excel Flow (détection automatique des valeurs ISO 8601, plus besoin de configurer format_type=date sur la colonne).

Historique des intégrations

La page « Intégrer un lot » affiche en bas un tableau d'historique des lots réellement intégrés (génération aboutie), tous utilisateurs confondus, sur les 7 derniers jours (les lignes plus anciennes sont purgées automatiquement). Un lot qui a été annulé avant la fin (blocage, annulation) n'y figure pas.

  • Colonnes : Réf. Spekty (référence du lot), Client, Fiche, Réf. client, PP/PM, Délai (Zen/Premium + date de clôture), Lignes (nombre d'opérations), Utilisateur (celui qui a intégré), Date (format relatif « Il y a X min / h / j », date exacte au survol).
  • Picto 📧 : ✓ vert si le mail terrain a été envoyé par l'outil pour ce lot (survol « Mail envoyé par l'outil à l'équipe planification »), — sinon.
  • Filtre : le champ de recherche filtre en direct sur Réf. Spekty, Client, Fiche, Réf. client et Utilisateur.
  • Bouton 📋 par ligne (à côté de la case à cocher) : copie un vrai tableau (Réf. client, Fiche, Réf. Spekty, Date de clôture prévue) collable directement dans un mail Outlook (en-têtes bleus) ou Excel.
  • Sélection multiple : cocher plusieurs lignes fait apparaître « 📋 Copier la sélection » — actif uniquement si toutes les lignes cochées concernent le même client.
  • Pagination : 25 lignes par page.
  • Actualisation : rechargé à chaque arrivée sur la page et après chaque intégration ; bouton ↻ pour forcer.
  • « 📄 Visualiser un fichier de commande » (bouton en bas) : saisir un numéro de lot ouvre le JSON de commande généré à l'intégration, affiché en tableau (une ligne par opération, colonnes redimensionnables, dates en jj/mm/aaaa). Le fichier est relu dans Pilotage CEE (à défaut, pour un ancien lot, sur SharePoint) — la visualisation reste donc possible au-delà des 7 jours de l'historique.
    • Édition colonne par colonne : un crayon ✎ dans l'en-tête bascule la colonne entière en édition (une saisie par cellule). En mode édition, un bouton 📋⬇ permet un coller-en-masse : copier une colonne depuis Excel (même nombre de lignes que le fichier) et la coller remplace toutes les cellules de la colonne d'un coup. Les cellules modifiées (non encore enregistrées) apparaissent en vert. Les dates saisies en jj/mm/aaaa sont re-stockées au format ISO du fichier ; les nombres restent des nombres.
    • « 💾 Modifier le fichier de commande » : dès qu'une cellule est modifiée, ce bouton apparaît en bas. Il déclenche une confirmation forte (il faut taper MODIFIER) puis écrase le fichier {ref_lot}.json.gz dans Pilotage CEE (et la copie locale) — seules les opérations sont remplacées, les métadonnées du fichier sont préservées. Action irréversible. Double garde côté serveur : la modification est refusée si le mot MODIFIER n'est pas transmis.

Commandes R2

Onglet « Commandes R2 » (accessible à tous les utilisateurs) : liste les commandes R2 nouvelles à préparer — les commandes individuelles R2 de Pilotage CEE au statut Nouveau.

  • Une pastille rouge clignotante apparaît sur l'onglet dès qu'il y a au moins une commande à préparer.
  • Colonnes : N° mission (champ Title de la commande), Client, Nom, Prénom, Adresse, CP, Ville, Type d'opération. Les textes longs passent à la ligne, sur 3 lignes au maximum (texte complet au survol). Un clic sur une ligne ouvre la modale « Préparation avant contrôle ».
  • En-tête (lecture seule) : Nom, Prénom, Client, Adresse, CP/Ville, Fiche (dérivée du type d'opération).
  • Encart orange (modifiable) : Société ayant réalisé l'audit, Scénario sélectionné, Réf/URL contrôle R1, case « PM - Personne morale », Montant facturé (entier, à vider en cas de doute).
  • Boutons : « Télécharger l'audit », « Télécharger la facture » (ouvrent les PDF), « Retrouver rapport R1 » (ouvre welcome.spekty.fr filtré sur le type d'opération).
  • Travaux : cases pré-cochées d'après la commande. Certains travaux affichent des champs de détail obligatoires une fois cochés (type de PAC, nb de splits, type de VMC, nb de fenêtres…). Décocher un travail vide ses champs de détail.
    • Pour Autres travaux (1, 2, 3) : en plus du « Type de travaux », un champ « Points de contrôles » (texte court libre, facultatif, affiché en large) apparaît à droite lorsqu'on coche la case. Il alimente respectivement les champs Autres_tx_1_controle, Autres_tx_2_controle, Autres_tx_3_controle.
  • Intégrer automatiquement : met à jour la commande dans Pilotage CEE (PATCH : audit, travaux en toutes lettres dans Travaux, codes dans Travaux_prevus_kizeo, champs de détail dans le sous-objet details, Montant à la racine ; décocher un travail vide ses champs de détail), sans toucher au statut ni à la date de prise en compte. Puis déclenche le flux Power Automate d'intégration (webhook) et attend sa fin (réponse 200) avant de rafraîchir la liste. La commande disparaît de la liste une fois que le flux a renseigné la date de prise en compte. Si le flux échoue, l'enregistrement reste fait et un avertissement s'affiche. L'URL du webhook se configure dans Paramétrage → Paramètres → « Intégration R2 » (source unique) ; si elle n'est pas renseignée, aucun flux n'est déclenché.

Contrôles et messages d'erreur

Détail d'un code prestation (dynamique)

Sélectionne un code prestation pour voir ses fiches rattachées, ses champs d'entrée obligatoires, et l'ensemble de ses conditions de contrôle warning/bloquantes paramétrées.

Liste statique des messages d'erreur

Toutes les erreurs susceptibles d'apparaître à l'utilisateur, extraites automatiquement du code source par le hook pre-commit.

Section Admin — Configuration

Paramétrage de base

Le menu Paramétrage est découpé en onglets : Codes prestations, Pôles & qualifications, Paramètres (réglages transverses), puis Format d'entrée / de sortie, Taux, Tbase, Tokens API, Utilisateurs. La page Paramètres affiche en haut un bandeau lecture seule séparé en deux : à gauche le prochain numéro de lot du jour (GET /api/numero-jour/today), à droite le prochain numéro de mission individuelle du jour (GET /api/numero-mission-jour/today). Chaque côté indique le prochain disponible, le dernier réservé et la date courante (bouton ↻ pour rafraîchir). Ce sont des peeks (sans réservation) ; la réservation atomique se fait via l'API publique.

  • Codes prestation (10 par défaut) : CEE-COF-CP/MU/PA/CB/R1/R2/RG, DIVERS-INS, CONTACTCEE, CTRL-VISIO.
  • Pôles (5) : Résidentiel, Industrie & Tertiaire, Mobilité électrique, Rénovation Globale, Excellence opérationnelle. Chaque pôle a un email_emetteur utilisé pour le mail terrain.
  • Qualifications (8) : CEE-1ENV → CEE-8TRA + CEE-SPEC.
  • Tbase : 6121 codes postaux (températures Tmin/Tmax) seedés depuis docs/seed_excel/ZipCodes.xlsx. Plus 95 départements (zone climatique, info pare-vapeur) seedés depuis docs/seed_excel/Dpt.xlsx.
  • Taux réglementaires : 192 lignes seedées depuis docs/seed_excel/Taux.xlsx. Dans la fenêtre d'ajout / modification d'un taux, Date début et Date fin se saisissent en jj/mm/aaaa quelle que soit la langue du navigateur (les barres se placent seules, « 03022025 » ou « 3/2/25 » sont acceptés ; date impossible → champ en rouge), avec un bouton calendrier à droite du champ.

Export Excel des taux réglementaires (vérification vs l'arrêté)

Onglet « Taux régl. » → bouton ⬇ Exporter Excel : télécharge Taux_reglementaires_AAAA-MM-JJ.xlsx avec deux feuilles :

  • Taux : tous les taux renseignés, triés par fiche puis date de début. Les 6 premières colonnes reprennent exactement le format d'import (Fiche, Date début, Date fin, Libellé du taux, Taux site, Taux CPC) : un fichier corrigé peut être réimporté tel quel. Les colonnes PP/PM suivent (lecture seule, ignorées à l'import).
  • Fiches sans taux en vigueur : fiches CEE de l'outil soumises à un contrôle (sur site et/ou par contact) pour lesquelles aucun taux ne couvre la date du jour — « aucun taux », taux échu (date de fin du dernier) ou « à venir ».

Comparer à l'arrêté : l'outil ne connaît pas le texte de l'arrêté. Donner le fichier exporté et l'arrêté (PDF) à une session Claude, par exemple : « Compare les taux de la feuille Taux à ceux de l'arrêté joint : liste les fiches de l'arrêté absentes du fichier, les taux différents (site / CPC) et les périodes incohérentes. Rends les corrections au même format que les 6 premières colonnes pour que je puisse les réimporter. »

Import Excel des taux réglementaires

Onglet « Taux régl. » → bouton Importer Excel : ouvre une modale avec un bouton « ⬇ Télécharger un modèle Excel » (en-têtes attendus : Fiche, Date début, Date fin, Libellé du taux, Taux site, Taux CPC ; les taux en décimal, ex. 0.125 = 12,5 %) et un sélecteur de fichier.

L'import fonctionne en AJOUT (upsert), pas en remplacement : chaque ligne du fichier est rapprochée de l'existant par la clé (Fiche + Libellé) — si elle existe, elle est mise à jour ; sinon elle est ajoutée. Tous les autres taux déjà en base sont conservés. Le résultat indique « X ajouté(s), Y mis à jour ». (L'import crée des taux en mode standard ; le mode distinct PP/PM se règle à la main via « Modifier ».)

Chaînage automatique des périodes : à l'ajout d'un taux (à la main ou par import), si la fiche a déjà un taux sans date de fin, ce taux précédent est automatiquement clôturé à la date de début du taux ajouté − 1 jour. Si plusieurs taux sont ajoutés d'un coup pour la même fiche, la borne utilisée est la date de début la plus ancienne parmi les lignes ajoutées.

Cas ambigus (non modifiés, signalés en avertissement) : pour éviter toute modification hasardeuse, la clôture automatique est désactivée et un avertissement est remonté (sans rien changer) quand :

  • la fiche a plusieurs taux précédents ouverts (ex. deux périodes sans date de fin, ou lignes PP/PM parallèles) → cas ambigu à corriger à la main ;
  • un taux ouvert démarre à la même date ou après le taux ajouté (borne inversée).

Seul le cas net — exactement un taux précédent ouvert ayant commencé avant la borne — est clôturé automatiquement.

Fiches CEE

Onglet « Fiches CEE » : ajout/édition/suppression des fiches. Chaque fiche définit :

  • Toggles Contrôle sur site / Contrôle PNCEE / Contrôle par contact / CVAD (Contrôle PNCEE : même section que le contrôle sur site, utilisée par « Intégration PNCEE » — voir « Spécificités PNCEE ») ;
  • Sous-section spécifique conditionnelle : apparaît quand le code prestation choisi est DIVERS-INS ou C-PNCEE-JS (même fonctionnement : section du formulaire, contrôle sous accréditation, diffusion automatique, points de contrôle JSON, précisions Kizeo ; vidée pour tout autre code). Badge rouge dans la liste si l'un de ces codes est utilisé sans « contrôle sous accréditation » (site comme PNCEE) ;
  • Pôle, libellé, caractéristiques d'opération (éditeur HTML rich) ;
  • Zones à compléter {{…}} dans les caractéristiques : le bouton {{…}} de la barre de l'éditeur insère une zone (ex. Nombre de luminaires : {{Nb luminaires}}). À l'intégration, si la colonne de sortie « Caractéristiques de l'opération » est vide, chaque zone est remplie, ligne par ligne, depuis une colonne du fichier source choisie dans une modale (voir « Intégrer un lot »). Une fiche sans zone se comporte comme avant ;
  • Groupe de compétence (colonne entre Libellé et Pôle, liste fermée des 8 groupes définis par la DGEC pour le programme d'accréditation INS REF 31 : 1 - Enveloppe, 2 - Calorifuge, 3 - Systèmes simples…, 4 - Systèmes complexes…, 5 - Equipements Simples, 6 - Equipements Complexes, 7 - Rénovation Globale, 8 - Transport) : initialisé le 26/10/2026 pour les fiches déjà présentes dans l'outil à partir du catalogue « Groupes de compétences - Inspection CEE - Catalogue - 80ème arrêté » (rapprochement par numéro ; aucune fiche n'a été créée, les fiches absentes du catalogue restent vides), puis modifiable dans la fiche. Exposé par GET /public-api/fiches et pris en compte par la recherche ;
  • Colonne « Qualif CSS » (entre Contrôles et Code déduit) : code de la qualification du contrôle sur site ; « — » si la fiche n'est pas cochée « Contrôle sur site » ou n'a pas de qualification saisie. Prise en compte par la recherche ;
  • Toggle pm_majoritaire : déclenche un warning si un lot PP arrive sur une fiche PM-majoritaire.

Format d'entrée

Onglet « Format d'entrée » : 1 format par code prestation (peut couvrir plusieurs codes via groupe d'onglets de l'Excel modèle). Définit :

  • Les colonnes attendues (par lettre A, B, …) avec libellé, couleur d'en-tête, type date (oui/non), obligatoire (oui/non) ;
  • Le rôle Date d'engagement sur 1 colonne (sert au calcul des taux) ;
  • Le rôle Bénéficiaire PM sur 1 colonne (détection PP/PM : vide=PP, rempli=PM, mix bloque).

Dupliquer un modèle : copie le format d'entrée d'un autre code prestation déjà configuré (colonnes, libellés, couleurs, types date, obligatoires, rôles Date d'engagement et Bénéficiaire PM) ; les colonnes actuelles du code sont remplacées, après confirmation. Utile pour démarrer un nouveau code proche d'un existant (ex. C-PNCEE-JS depuis DIVERS-INS), puis l'ajuster et enregistrer. La colonne de la fiche CEE n'est pas un réglage du format d'entrée (N, ou U en intégration PNCEE).

⚠️ La lecture du fichier d'entrée est positionnelle (par lettre de colonne, jamais par libellé d'en-tête). Les libellés peuvent différer du modèle sans impact.

Format de sortie

Onglet « Format de sortie » : 1 format par code prestation, avec 3 sections :

  • Colonnes (Flow + JSON) : ordre des colonnes du fichier Flow + JSON. Chaque colonne a un libellé, un type (text/number/date), une couleur d'en-tête, une nature : Flow (colonne de l'Excel envoyé au terrain ; s'appelait « Kizeo » jusqu'à la v3.3), JSON (JSON de commande seul, données conservées pour les synthèses : à partir de la colonne DG pour les fiches CEE, DA pour les mappings PNCEE) ou Int. (intermédiaire : gris dans le tableur, non exportée), un flag « modifiable preview » (✎ dans le tableur), une source (champ d'intégration, client SP, fiche, colonne d'entrée par lettre, formule, …).
  • Remplacer les colonnes JSON (bouton à droite de « + Colonne ») : remplace entièrement les colonnes JSON du format affiché par celles d'un autre format de sortie, choisi dans une liste (« Attention, cela va écraser les colonnes existantes »). Possible seulement si, des deux côtés, les colonnes JSON sont toutes à la fin et d'un seul tenant (aucune colonne Flow ou intermédiaire entre elles ou après) ; seuls les formats qui respectent cette règle et ont au moins une colonne JSON sont proposés. Les colonnes Flow et intermédiaires ne bougent pas. Enregistrer d'abord ses modifications en cours. Si des numéros saisis à la main (verrou ouvert) ne suivent plus la séquence, ils apparaissent en rouge, à corriger.
  • Mapping Liste opérations : 1 ligne SP par opération du lot. Source = libellé d'une colonne du tableau Colonnes (« Mapping Flow/JSON »), ou formule.
  • Mapping Liste lots : 1 ligne SP par lot. Idem.

Une 4e section Conditions de contrôle contient les règles évaluées par opération : sévérité (warning/blocking), formule, message à afficher. Le bouton Importer de cette section copie les conditions cochées d'un autre format de sortie et enregistre automatiquement le format (comme « Enregistrer » : les autres modifications en cours sont enregistrées en même temps). Cf. la sous-section dynamique plus haut.

Moteur de formules : $INTEG.x (data intégration — dont $INTEG.integre_par = nom de l'utilisateur qui réalise l'intégration, à mapper sur une colonne dédiée si besoin), $CLIENT.x (client Pilotage CEE), $FICHE.x (fiche), #A (colonne entrée par lettre), @{libellé} (autre colonne mapping), opérateur & (concat). Fonctions : IF / IFS / CONCAT / COALESCE / UPPER / LOWER / TRIM / LEFT / RIGHT / MID / LEN / SEARCH / REPLACE / NOMPROPRE / TEL / CP / NOMBRE / ROUND / ROUNDDOWN / ROUNDUP / ABS / INT / MOD / MIN / MAX / TEXT / CHAR / NUM_OPERATION / TBASE_MIN / TBASE_MAX / TBASE_MIN_DPT / TBASE_MAX_DPT / ZONE_CLIMATIQUE / PAREVAPEUR / DATE_EST_POSTERIEURE_A / ISDATE / YEAR (année d'une date, en nombre ; vide si la valeur n'est pas une date) / VERIF_BONIF.

VERIF_BONIF(tvv; date_achèvement; type_bonif) : appelle l'API verifbonif.spekty.fr (token configurable dans Paramétrage → Paramètres, repli sur VERIF_BONIF_API_TOKEN du .env) et renvoie le texte de réponse. La date est convertie en YYYY-MM-DD. Résultats mis en cache par (tvv, date, bonif). Renvoie vide si le token n'est pas configuré ou en cas d'erreur réseau.

Mémo des champs : en tête de la page « Format de sortie », un bloc repliable « Mémo des champs Flow » (plié par défaut, l'état est mémorisé par navigateur) rappelle l'usage des principaux libellés de champs côté Flow et côté Kizeo (Référence mission = clé unique, Qualification obligatoire pour Flow, Raison sociale PM affichée comme bénéficiaire sur le rapport…), avec une note sous le tableau. Le mémo est générique : il ne dépend pas du code prestation choisi et reste visible sans en sélectionner un. Il se modifie dans Paramétrage → Mémo des champs : ajouter, modifier, réordonner (↑ ↓) ou supprimer des lignes, éditer la note, puis Enregistrer. Les lignes vides sont ignorées. Une cellule « - » ou vide (sans objet pour cet outil) s'affiche grisée.

Pré-intégration (portail client)

Les clients déposent leurs fichiers Excel depuis le portail welcome.spekty.fr, dans un module embarqué d'integrations. Chaque fichier est conservé, puis préparé automatiquement par l'outil Préparation avec le nom du client transmis par le portail, tel quel.

  • Onglet Pré-intégration (visible de tous les utilisateurs, placé avant « Intégrer un lot ») : périmètre par pôle — les pôles de chaque utilisateur sont lus dans Pilotage CEE (relus au plus tard toutes les 10 min, ou tout de suite avec le bouton ↻ de l'onglet, utile juste après avoir changé ses pôles dans Pilotage). Si le filtre est indisponible alors qu'il devrait marcher, un message orange sous le titre en donne la raison (Pilotage ne répond pas, ou pôles Pilotage sans correspondance dans l'outil). En haut à droite, un toggle comme dans Pilotage : Tous | un bouton par pôle de l'outil, chaque pôle séparément (même pour un utilisateur rattaché à plusieurs pôles). Sur chaque bouton de pôle, un rond rouge clignotant affiche le nombre de lots (une fiche = un lot) à préparer ou à intégrer du pôle, quel que soit le filtre affiché (rien s'il n'y en a pas). Un bouton de pôle n'affiche que les fichiers comportant au moins une fiche de ce pôle (strict : les fiches non rattachées — fiche inconnue de l'outil ou sans pôle dans Fiches CEE — et les fichiers pas encore préparés n'y figurent pas, ils restent sous « Tous »). Par défaut, chacun arrive sur son pôle s'il n'en a qu'un dans Pilotage CEE (pôles relus au plus tard toutes les 10 min, ou tout de suite avec le bouton ↻), sinon sur « Tous » ; un choix fait en cliquant est mémorisé dans le navigateur. Si Pilotage ne répond pas ou que ses pôles ne correspondent à aucun pôle de l'outil, un message orange l'indique sous le titre. Le filtre s'applique aux trois sections (À traiter, Attente client, Historique). Chaque section a son titre sur un bandeau de couleur (bleu : À traiter, orange : Attente client, gris : Historique) et est paginée par 25 fichiers (un fichier et ses fiches restent sur la même page) : boutons « ‹ Précédent / Suivant › » sous le tableau, avec « 1–25 sur N fichiers · page x/y », affichés seulement au-delà de 25 ; la page est conservée après une action ou ↻, et revient à la 1ʳᵉ au changement de filtre de pôle. Le rond rouge de l'onglet ne s'allume que s'il y a des lots à traiter dans son périmètre (ses pôles + fiches non rattachées ; tout, s'il n'a pas de pôle). Le rond rouge de l'onglet ne s'allume que s'il y a des lots à traiter dans son périmètre (tout, s'il n'en a pas). Réservé aux administrateurs : la croix de suppression de l'historique et les réglages du module (Paramétrage). chaque fiche est un lot à part. Reçu le, client / demandeur et fichier reçu (nom + bouton bleu de téléchargement) sont regroupés ; à partir du statut, une ligne par lot avec sa fiche, ses opérations, l'Excel préparé (bouton vert) et ses actions. Statuts internes :
    • À préparer : client non paramétré dans Préparation, erreur de préparation (ex. fiche non paramétrée), ou anomalies sur les données de sortie acceptées par le client. La cause est indiquée sous le statut.
    • Section Attente client (entre « À traiter » et « Historique », repliée par défaut, le nombre de fichiers dans une pastille ; masquée s'il n'y en a aucun) : fichiers pas encore validés par le client, affichés pour information sans aucun bouton (ni Intégrer, ni Rejouer, ni Annuler — refusé aussi côté serveur) et hors rond rouge. Deux statuts : Attente client (la préparation a relevé des anomalies ; le client voit les messages, suivis de la mention « Nos outils sont paramétrés de façon à contrôler le format des fichiers déposés, en cohérence avec le format des fichiers que vous nous transmettez habituellement. », et choisit Corriger le fichier, qui annule l'envoi, ou Poursuivre quand même, qui le met au panier) et Non validé par le client (au panier, pas encore commandé). Une fois commandé, le fichier passe dans « À traiter » ; retiré du panier, il disparaît. Non commandé 72 h après le dépôt, il passe automatiquement dans l'historique (Spekty et client) au statut Commande interrompue (« Automatique (72 h sans commande) ») ; il ne compte plus pour les doublons, le client peut le redéposer.
    • À intégrer : préparation sans anomalie. Un fichier contenant plusieurs fiches CEE donne un lot par fiche, intégré (ou annulé) individuellement.
    • Archives (.zip, .rar, .7z — portail uniquement) : une seule ligne pour le client ; côté Spekty, un lot par fiche de chaque fichier contenu (le fichier d'origine est affiché sous la fiche) et, pour chaque fichier que Préparation n'a pas pu traiter, une ligne À préparer avec son message — les autres fichiers de l'archive restent intégrables. Rejouer relance toute l'archive.
    • Annuler : annule le lot de la ligne (les autres fiches du fichier restent à traiter) ; pour un fichier non préparé, annule le fichier. Les lots annulés passent dans l'Historique (une ligne par fiche, y compris pour un fichier annulé en entier). Dans l'historique, le statut indique qui a annulé : Annulé par Spekty ou Annulé par le client (un fichier annulé par le client quitte « À traiter » et le rond rouge).
    • Supprimer une ligne de l'historique (administrateurs) : la croix × en bout de ligne supprime définitivement le fichier (fichier reçu, fichiers préparés, toutes ses fiches), après confirmation. Il disparaît aussi de l'historique du client et ne compte plus pour la détection des doublons. Les lots déjà créés dans Pilotage CEE ne sont pas touchés. Seules les lignes de l'historique sont supprimables (pas les fichiers à traiter ni ceux en attente client).
  • Côté client, seuls deux statuts sont visibles : Demande enregistrée (à préparer) et Fichier vérifié (à intégrer). Le client voit ses fichiers en attente (nom, fiche(s), client, demandeur, nombre d'opérations), peut les télécharger ou les annuler ; les fichiers intégrés ou annulés quittent cette liste pour le tableau Historique (30 derniers jours) situé en dessous : tous les fichiers du client (quel que soit le demandeur) intégrés, annulés (par le client ou par Spekty) ou en Commande interrompue, avec la date correspondante et le téléchargement du fichier déposé (sans n° de lot ni information interne). Les fichiers retirés du panier n'y figurent pas.
  • Panier et commande (côté client) : après vérification (ou « Poursuivre quand même » en cas d'anomalies), chaque fichier va dans le panier du client, partagé entre tous ses demandeurs (colonne « Déposé par » ; chacun voit, commande, retire ou décide sur les fichiers déposés par ses collègues, exactement comme les siens ; les anomalies indiquent « Déposé par … le … ») — y compris s'il n'a pas pu être vérifié — et n'apparaît pas dans « Vos fichiers en attente d'intégration » tant qu'il n'est pas commandé (côté Spekty : section « Attente client », statut « Non validé par le client », sans action). Pour chaque ligne (ou pour tout le panier d'un coup) :
    • Contrôles par contact (interrupteur) : Non, non activable si la fiche n'a pas de taux CPC réglementaire aujourd'hui ; Non, activable si, dans Pilotage CEE, « CPC demandés par le client » commence par « Non » ou vaut « N » ; sinon Oui, désactivable.
    • Délai : Zen par défaut, bouton « Passer en Premium » (par ligne ou pour tout le panier). Affichées une fois pour tout le panier : Prochaine date d'enregistrement = le prochain lundi ou jeudi (le jour même si lundi ou jeudi avant 12 h) et les Dates de clôture prévisionnelle Zen et Premium = cette date + 22 j (Zen) ou 8 j (Premium), reportée au lundi si week-end (même règle que la modale d'intégration). Les dates sont affichées avec le jour de la semaine (ex. « jeudi 22/10/2026 ») et la mention « Dates prévisionnelles, sous réserve de confirmation de Spekty lors de l'intégration ».
    • Consignes spécifiques : texte libre facultatif.
    « Commander » (bouton vert au contour pulsé) transmet les lignes à Spekty ; sous le panier, une mention toujours affichée rappelle que les commandes sont traitées dans les conditions du contrat et à condition que celui-ci couvre le type d'opérations soumis ; « Retirer » enlève une ligne du panier (sans trace côté Spekty). Doublon : un fichier au contenu identique déjà chargé (hors annulés, retirés et commandes interrompues) est refusé — « Fichier déjà chargé le jj/mm/aaaa à hh:mm:ss » (même client) ou « … sur une autre entité … ».
  • Côté Spekty, les choix de la commande s'affichent sous le fichier reçu (Zen/Premium + clôture prévisionnelle, CPC, consignes) et pré-remplissent la modale d'intégration (Zen/Premium, CPC, consignes en commentaire) — sauf champ imposé par le contexte (CPC seul, ASP). Via l'API clients, le dépôt vaut commande ; délai, CPC et consignes sont facultatifs et rien n'est mis par défaut : non renseignés, ils sont décidés à l'intégration.
  • Intégrer : le bouton pose un verrou (« Intégration en cours par … ») pour que deux personnes n'intègrent pas le même fichier, puis ouvre Intégrer un lot avec le fichier préparé et le client présélectionné dans la modale. Une fois le lot généré, l'élément passe dans l'Historique avec son n° de lot. L'Historique (fichiers déposés sur les 90 derniers jours) est trié par date d'intégration, la plus récente en haut (dernière intégration du fichier, ou date d'annulation pour un fichier annulé). Annuler la modale ou « Changer de fichier » libère le verrou ; un verrou oublié expire au bout d'1 h (comme la durée max d'une intégration), ou se libère avec Libérer. Écran pas à jour : cliquer Intégrer sur un lot déjà intégré, annulé ou en cours chez un collègue affiche le motif (« Déjà intégré (lot …) par … », « Lot annulé par … », « Intégration déjà en cours par … ») et rafraîchit la liste ; si deux personnes cliquent en même temps, une seule obtient le verrou. À la génération, le lot doit être encore verrouillé à votre nom : s'il a été intégré, annulé ou repris par un collègue entre-temps (verrou expiré), la génération est refusée — jamais deux lots pour la même fiche.
  • Rejouer (À préparer) : relance la préparation, avec le nom du portail (une fois le client paramétré dans Préparation) ou en choisissant ponctuellement un modèle Préparation. La liste des modèles peut mettre plusieurs secondes à venir (« Chargement… » sur le bouton, puis gardée 10 min) ; si Préparation ne la fournit pas, le rejeu reste possible avec le nom du portail. Les choix de commande du client sont conservés. Une anomalie venant des données du fichier reviendra à l'identique : dans ce cas, contrôler l'Excel préparé puis Passer à intégrer. Pour que les dépôts suivants d'un client passent automatiquement, ajouter son nom comme client secondaire dans Préparation (rattachement de plusieurs clients à un même modèle). Passer à intégrer valide manuellement un fichier préparé avec anomalies.
  • API clients (dépôt par programme) : un client peut aussi déposer ses fichiers par API (POST /client-api/v1/lots, documentation Swagger dédiée et publique sur /client-api/docs). Les tokens cli_… se gèrent dans Paramétrage → Tokens API clients (distincts des tokens de l'API publique) : chaque token est rattaché à un client Pilotage CEE (par son ID) et ne voit que les lots de ce client. Le dépôt suit le même circuit que le portail ; le demandeur affiché est « API — nom du token ». Pas d'archives par l'API : .xlsx, .xls, .xlsm, .csv, un fichier par appel. Sans humain pour décider, des anomalies de données font passer le lot directement « À préparer » (elles sont aussi renvoyées à l'appelant).
  • Téléchargements : l'Excel reçu (⬇ nom du fichier) et l'Excel préparé (⬇ préparé) quand la préparation automatique a abouti.
  • Un rond rouge clignotant sur l'onglet signale des fichiers à préparer ou à intégrer (rafraîchi toutes les 2 minutes).
  • Réglages (Paramétrage → Paramètres → Pré-intégration) : URL et clé API de Préparation, sites autorisés à afficher le module, secret de signature (le portail signe l'URL de l'iframe : client, e-mail, expiration ; sans signature valide l'accès est refusé) et générateur de lien de test. La documentation d'intégration (PDF : paramètres, calcul de la signature, exemple PHP, iframe) se télécharge au même endroit, à transmettre au gestionnaire du portail avec le secret.

Utilisateurs & Tokens API

  • Vue mini : case à cocher dans le menu utilisateur (en haut à droite, au-dessus de Déconnexion). Cochée, elle masque tous les menus sauf Pré-intégration et Intégrer un lot. Réglage propre à chaque utilisateur, mémorisé dans le navigateur ; les autres écrans restent accessibles par leur adresse, il suffit de décocher pour retrouver tous les menus.
  • Connexion et session expirée (SSO Microsoft) : à l'ouverture, sans session valide, l'outil lance la connexion Microsoft silencieuse (aucun choix de compte ni saisie si la session Microsoft est active) et revient sur l'écran demandé. En cours d'utilisation, si la session de l'outil expire, la prochaine action (chargement d'une liste, enregistrement, envoi de fichier, téléchargement…) relance cette même connexion, affiche « Connexion… » le temps de la redirection et ramène sur l'écran où l'on était, sans message d'erreur ; l'action interrompue est à refaire (une saisie non enregistrée est perdue). Garde-fou : pas de seconde redirection automatique dans les 12 s (la page « Connexion requise » s'affiche alors). Après une déconnexion volontaire, aucune reconnexion automatique : bouton « Se connecter ».
  • Onglet Utilisateurs : CRUD + toggle admin/user. La création se fait par INITIAL_ADMIN_EMAIL au 1er démarrage si la table est vide. Allowlist stricte : seuls les utilisateurs déclarés ici peuvent se connecter — un compte Azure AD non déclaré reçoit une page « Accès non autorisé » (pas d'auto-création). Pour donner accès à quelqu'un, l'ajouter d'abord dans cet écran.
  • Onglet Tokens API : create / revoke / delete. Les tokens sont hashés avec API_TOKEN_HASH_SECRET (distinct de JWT_SECRET_KEY). Utilisés par la macro VBA + scripts tiers sur les endpoints /public-api/*. Trois formes d'authentification équivalentes : header Authorization: Bearer integ_…, header X-Api-Key: integ_…, ou query ?api_token=integ_…. Le header X-Api-Key est destiné aux connecteurs personnalisés Power Platform (évite le préfixe « Bearer » à taper à la main, et ne met pas le token dans l'URL/les logs).
  • Connecteur Power Automate (numéro de mission du jour) : les flux Power Automate réservent le numéro de mission individuelle via un connecteur personnalisé pointant sur GET /public-api/numero-mission-jour/today (Swagger 2.0 fourni : connectors/powerautomate-swagger2.json, auth X-Api-Key). ⚠️ Leur créer un token dédié : le rate limit de /public-api/* est par token (défaut 30/min) — un token partagé avec l'UI/VBA ferait se concurrencer les quotas.

Sécurité (audit ASVS v4.0.3, F-01 à F-23)

Garanties activées en production :

  • JWT_SECRET_KEY et API_TOKEN_HASH_SECRET ≥ 32 chars, distincts ; rejet du démarrage si insecure.
  • AUTH_DISABLED refusé hors ENVIRONMENT=development. PG_SSL_MODE=disable refusé hors dev.
  • Cookies session SameSite=Strict + HttpOnly + Secure ; CSRF middleware (X-Requested-With requis).
  • Rôle re-vérifié depuis la DB à chaque requête (rétrogradation immédiate).
  • Uploads cappés à MAX_UPLOAD_BYTES (25 Mo) + openpyxl en read_only avec garde 500 000 cellules.
  • Conditions évaluées en mode fail-closed (formule qui plante = traitée comme déclenchée).
  • /docs Swagger UI : accessible UNIQUEMENT aux admins (DocsAdminGuardMiddleware vérifie le rôle en base à chaque requête, 404 sinon). Le schéma OpenAPI exposé est filtré aux endpoints /public-api/*.
  • Headers : Permissions-Policy strict, X-Frame-Options DENY, CSP default-src 'self', HSTS preload en prod.
  • Mail : whitelist domaine to, from_email vérifié contre pole.email_emetteur, attachment_path confiné sous OUTPUT_DIR.
  • Logs : PII (Tel_1, Email, Nom_prenom, Adresse) redactée.
  • Jobs (génération + doublons) taggés par owner_email : 404 si requester ≠ owner.
  • OUTPUT_DIR purgé au boot (rétention 30 j par défaut).

Pilotage CEE — source de référence

Depuis le big bang (22/10/2026), Pilotage CEE est la source unique : lots, missions, commandes R2 et clients y sont lus et écrits ; plus aucune écriture n'a lieu sur SharePoint. Seule exception : un ancien fichier de commande (.json.gz) introuvable dans Pilotage CEE est encore relu sur SharePoint (repli en lecture).

  • Configuration (menu Paramétrage → Paramètres, bloc « Pilotage CEE ») : URL de base + token. Le token est stocké côté serveur et jamais réaffiché (masqué). Sans URL ni token, aucun lot ne peut être créé (erreur « Pilotage CEE non configuré » au récapitulatif).
  • Lot déjà présent (409) : traité comme un succès.
  • Résilience (retry + file d'attente) : chaque écriture Pilotage est d'abord réessayée automatiquement en cas d'erreur transitoire (redéploiement de Pilotage, timeout, 502/503/504) avec un court backoff synchrone (≈ 15 s, anti micro-coupure). Si elle échoue malgré tout, l'opération part dans une file d'attente durable (« outbox ») : un worker de fond la rejoue tant qu'elle ne passe pas (idempotent : 409 = déjà fait). Aucune écriture Pilotage n'est perdue. Les fichiers data_synthese (JSON) et fichier_flow (Excel Flow) sont stockés en octets dans la file (rejoués par référence après création du lot). Une entrée est marquée en échec après plusieurs essais (conservée pour investigation ; les réussites sont purgées après 7 jours).
  • Suivi dans l'historique : tant qu'une réplication est en attente, la ligne du lot dans Historique des intégrations affiche un badge ⏳ Réplication Pilotage CEE en attente (ou ⛔ Pilotage : échec). Sous le badge s'affiche, en rouge, la dernière erreur renvoyée par Pilotage CEE (ex. « HTTP 400 — Client introuvable : « … » » quand le client n'existe pas dans Pilotage CEE sous exactement le même nom) : corriger la cause, puis attendre le rejeu automatique ou utiliser ↻P. Le badge disparaît dès que la file est vidée. Un admin peut forcer un rejeu immédiat via le bouton ↻P sur la ligne.

Champs client des mappings et des formules $CLIENT.… : noms des champs Pilotage CEE (ex. raison_sociale, adresse, cp_ville, siret, tous les mails du client : rapport / organisation pour résidentiel, rénovation globale, mobilité électrique, tertiaire-industrie, et emails autorisés des commandes individuelles).

Commandes R2 : le webhook Power Automate est appelé après l'enregistrement de la préparation dans Pilotage CEE.

Tableur d'édition du lot

Cliquez sur ✎ dans l'en-tête d'une colonne pour éditer toutes ses cellules. Les colonnes estompées sont des colonnes « JSON » (incluses dans le JSON de commande mais pas dans le fichier Flow). Les éditions sont conservées jusqu'au clic « Valider et intégrer ».

Pôles & qualifications

Pôles

Libellé Email émetteur (FROM des mails commande) Ordre

Aucun pôle.

Qualifications

CodeLibellé

Aucune qualification.

Codes prestation

Liste

CodeLibellé

Aucun code prestation.

Mémo des champs

Aide-mémoire affiché en tête de la page Format de sortie : usage de chaque libellé de champ côté Flow et côté Kizeo. Il est générique (commun à tous les codes prestation).

Contenu par défaut (jamais modifié).
ChampFlowKizeo

Pré-intégration

À traiter

Reçu leClient / demandeurFichier reçu Statut du lotFicheOp. Préparé

Aucune soumission à traiter.

Reçu leClient / demandeurFichier reçu Statut du lotFicheOp. Préparé

Historique (90 derniers jours)

Reçu leClient / demandeurFichier reçu FicheRésultatPréparé

Aucune soumission intégrée ou annulée.

Paramètres

Prochain numéro de lot du jour
—
Dernier réservé : —
Date : —
Prochain numéro de mission individuelle du jour
—
Dernier réservé : —
Date : —
Lots intégrés
—
Opérations intégrées
—
Lots (aujourd'hui)
—

Pilotage CEE (réplication)

Connexion à Pilotage CEE, désormais la source des intégrations (lot + missions + fichier de commande). L'URL de base et le token ci-dessous permettent à l'outil d'y lire les commandes et d'y écrire les intégrations. Tant qu'ils ne sont pas renseignés, la connexion est inactive.

Intégration R2 — webhook Power Automate

URL du flux Power Automate déclenché à l'intégration automatique d'une commande R2. C'est la seule source : tant qu'elle n'est pas renseignée ici, l'intégration automatique R2 ne déclenche aucun webhook (l'enregistrement dans Pilotage CEE reste fait).

Fiches Contrats CEE — vérification du contrat cadre

Token d'accès à l'API fiches-contrats-cee.spekty.fr, utilisée à l'ouverture de la modale d'intégration (contrôles sur site) pour vérifier que le client a la fiche dans son contrat cadre. Sans token, la vérification affiche « indisponible ».

Verif Bonif — éligibilité aux bonifications

Token d'accès à l'API verifbonif.spekty.fr, utilisée par la formule VERIF_BONIF(...) des formats de sortie. Sans token, la formule renvoie une valeur vide.

Pré-intégration — portail client & Préparation

Les fichiers déposés par les clients sur le portail sont préparés automatiquement via l'API de l'outil Préparation (/api/v1/convert, clé cee_…).

Une ou plusieurs adresses https://, séparées par des espaces.

Signature des liens du portail

Le portail signe l'URL de l'iframe (client, e-mail, expiration) avec ce secret partagé : sans signature valide, le module refuse l'accès.

⬇ Documentation d'intégration (PDF)

Tester le module

Fiches CEE

Numéro Libellé Groupe de compétence Pôle Contrôles Qualif CSS Code déduit

Aucune fiche CEE.

Températures de base (Tbase)

Département Zone climatique Info pare-vapeur Tbase min Tbase max

Aucun département.

Code postal Tbase min Tbase max

Aucun code postal trouvé.

Taux réglementaires

Fiche Début Fin Libellé Site CPC

Aucun taux réglementaire.

Format d'entrée

Pos. Libellé Couleur entête Date Obligatoire

Format de sortie

▾ 💡 Mémo des champs Flow
Usage des principaux libellés de champs, commun à tous les codes prestation. Modifier
ChampFlowKizeo

▾ Colonnes (Flow + JSON)
Libellé Type Nature N° Édit. ✎ Source Valeur source
▾ Conditions de contrôle

Formules évaluées par opération avant ET après le tableur d'édition. TRUE = message déclenché. Source : @{libellé mapping}, $INTEG, $CLIENT, $FICHE, #A.

Message au user Formule (TRUE = déclenche) Sévérité
▾ Mapping Liste des opérations

→ Pilotage CEE, missions (une par opération).

Champ Pilotage CEESourceValeur source
▾ Mapping Liste des lots

→ Pilotage CEE, lot (un par lot).

Champ Pilotage CEESourceValeur source

Tokens API clients

Tokens cli_… de l'API de dépôt de lots : un client dépose un Excel par API, comme dans le module du portail. Le fichier est préparé si possible et apparaît dans Pré-intégration comme les autres. Chaque token est rattaché à un client Pilotage CEE et ne donne accès qu'aux lots de ce client. Distincts des tokens de l'API publique (Tokens API). Documentation à transmettre au client : Swagger de l'API clients ↗.

NomClient (Pilotage CEE)PréfixeCréé par / le Dernière utilisationStatut

Aucun token client.

Tokens API publique

Tokens d'accès pour les endpoints /public-api/* (ex. numero-jour/today) — utilisés par VBA, scripts tiers, etc. Voir la documentation Swagger des endpoints publics.

Nom Préfixe Créé par Créé le Expire Dernière utilisation Statut

Aucun token actif.

Connecteur Power Automate — Numéro de mission du jour

Fichier Swagger 2.0 à importer dans Power Platform pour réserver le numéro de mission via GET /public-api/numero-mission-jour/today (authentification par header X-Api-Key).

  1. Power Automate → Connecteurs personnalisés → + Nouveau → Importer un fichier OpenAPI, et sélectionner ce fichier.
  2. Sécurité : déjà réglée sur API Key / header / X-Api-Key.
  3. Créer une connexion en collant un token dédié (créé ci-dessus) — le rate limit est par token.
  4. Action « Réserver le numéro de mission du jour » → utiliser le champ reserved (déjà en 4 chiffres).

Utilisateurs

Email Nom affiché Rôle Dernière connexion Créé le

Aucun utilisateur.

Bienvenue sur integrations

Cette application permet d'intégrer un lot d'opérations CEE en vue de la mise en production dans les outils Spekty (Kizeo + synthèses + Pilotage CEE).

Utilisez le menu pour naviguer entre les onglets.

Connexion requise

Vous devez vous connecter pour accéder à l'application.

Se connecter avec Microsoft

Connexion…