Échanges Web Services eSedit RH ⇄ GEEF

Table des matières

Échanges Web Services eSedit RH ⇄ GEEF

Documentation fonctionnelle et technique du connecteur d’échanges entre GEEF et le logiciel de paie/carrière eSedit RH (éditeur Berger‑Levrault). Elle décrit le fonctionnement de chaque flux, les correspondances de données (mapping) et les paramétrages/transcodages à maintenir.

Conventions de lecture. Les noms de balises/champs eSedit (matricule, codeStatut, dateDebut…) sont ceux de l’API de l’éditeur : ils sont cités tels quels. Côté GEEF, les données sont désignées par leur libellé métier (celui affiché à l’écran), et non par les noms techniques internes.

1. Vue d’ensemble

Le connecteur regroupe six flux répartis en deux sens. eSedit RH est maître de la paie et de la carrière ; GEEF est maître de la GPEC (emplois, diplômes opérationnels).

N°	Flux	Sens	Déclenchement	Transport	Format
1	Agents (identité, carrière, situations)	eSedit → GEEF	À chaque mise à jour dans eSedit ayant un impact sur la carrière synthétique	eSedit appelle un point d’entrée web de GEEF (`POST`/`GET`)	XML
2	Absences	GEEF ← eSedit	GEEF interroge eSedit (automatique, ~1×/jour, sur la veille)	GEEF appelle l’API eSedit (`POST`)	JSON
3	Besoins en formation	GEEF ← eSedit	GEEF interroge eSedit (à la demande d’un administrateur / automatique)	GEEF appelle l’API eSedit (`POST`)	JSON
4	Qualifications	GEEF → eSedit	Mise à jour d’un emploi/diplôme dans GEEF (envoi ~30 s après)	GEEF appelle l’API eSedit (`POST`)	XML
5	Diplômes	GEEF → eSedit	idem flux 4	idem	XML
6	Formations SPP/SPV	GEEF → eSedit	idem flux 4	idem	XML
—	Référentiel Employeurs/Entreprises	GEEF ← eSedit	GEEF interroge eSedit (automatique, ~1×/jour)	GEEF appelle l’API eSedit (`POST`)	JSON

Les flux 4/5/6 partagent le même mécanisme d’envoi (une seule requête « CV »). Le référentiel Employeurs est un flux entrant complémentaire qui alimente le référentiel des tiers, préalable indispensable au traitement des conventions du flux 1.

Rôles des référentiels (à maintenir de part et d’autre) :

eSedit est maître des référentiels statuts, services, grades, positions et du référentiel formation. Toute création/modification doit être communiquée à l’administrateur GEEF pour mettre à jour les transcodages.
GEEF est maître des référentiels emplois et diplômes. Toute création d’emploi doit être communiquée à l’administrateur eSedit, qui crée le code correspondant côté eSedit et le retourne à GEEF pour l’associer à l’emploi.

Périmètre réellement implémenté. L’API eSedit RH expose davantage de services que ce que le connecteur consomme aujourd’hui (voir §10). Le connecteur utilise : l’appel entrant « agent » (flux 1), l’envoi « CV » (flux 4/5/6), la récupération des absences, la récupération des besoins en formation et la récupération du référentiel des entreprises.

2. Principes techniques communs

2.1 Authentification & sécurité

Flux 1 (entrant dans GEEF). eSedit s’authentifie auprès de GEEF en HTTP Basic (identifiant/mot de passe hors annuaire LDAP, gérés dans la configuration du serveur d’application GEEF ; un compte LDAP est possible en option). GEEF peut en complément exiger une clé WebService applicative : la valeur reçue dans l’en‑tête Authorization doit alors correspondre exactement à la clé configurée.
Flux 2/3/4/5/6 + référentiel (sortants de GEEF). GEEF s’authentifie auprès d’eSedit en HTTP Basic (Authorization: Basic …). La clé est stockée sous forme encodée. En cas de redirection vers une page de connexion, le connecteur réémet automatiquement un couple identifiant/mot de passe puis rejoue la requête.
Certificats (HTTPS).
- Flux 1 : le certificat public de GEEF doit être présent dans le magasin de la JVM d’eSedit ; le certificat SSL est installé côté serveur GEEF.
- Flux sortants : le certificat public d’eSedit doit être présent dans le magasin de la JVM de GEEF.
- Un certificat absent/expiré se traduit par une erreur PKIX dans les journaux du côté appelant. Il est recommandé d’anticiper les renouvellements pour éviter une interruption (et une resynchronisation).

2.2 Formats & dates

Corps XML ou JSON selon le flux (voir tableau §1), encodage UTF‑8.
Dates au format AAAA‑MM‑JJ pour tous les flux consommés par le connecteur.
Le matricule agent peut être normalisé sur une longueur fixe (complété à gauche par des zéros) selon un paramètre dédié, en entrée comme en sortie.

2.3 Identification d’un agent et d’une carrière

Un agent est identifié par son matricule (numérique).
Une carrière GEEF résulte du couple matricule agent + statut résolu par transcodage (voir §4.5). Un même agent peut donc porter plusieurs carrières (ex. un même individu SPV et PATS).

3. Flux 1 — Agents (eSedit → GEEF)

3.1 Objet

Ce flux est déclenché par eSedit dès qu’une donnée impactant la carrière synthétique est mise à jour. eSedit transmet l’intégralité des données de l’agent (situation actuelle et situation précédente) : il n’y a pas de différentiel, chaque message est un instantané complet.

Le message reçu est journalisé dans l’interface entrante de GEEF (Outils > Interface > Entrante) puis intégré : création ou mise à jour de la fiche agent et de toutes ses situations.

3.2 Activation & pré‑requis

Le service doit être actif (paramètre d’activation, voir §9).
Les informations de connexion (URL du point d’entrée GEEF, identifiant, mot de passe) sont fournies par Cegape et saisies côté eSedit.
Le message est traité de manière synchrone uniquement lorsque l’élément racine est un agent. D’autres natures de documents (listes de personnel, gardes, sessions, équipements, besoins…) sont réservées à un traitement asynchrone (relevé en journal, intégration différée).

3.3 Données intégrées et mapping

a) Identité de l’agent → fiche Agent

Balise eSedit	Donnée GEEF (libellé)
`nom`	Nom
`prenom`	Prénom
`nomJeuneFille`	Nom de naissance
`dateNaissance`	Date de naissance
`communeNaissance`	Ville de naissance
`codePostalNaissance`	Département de naissance
`paysNaissance`	Pays de Naissance
`numeroSs`	NIR (n° de sécurité sociale)
`adresseMail`	Adresse Courriel (utilisée par GEEF pour ses envois de courriels)
`sexe`	Sexe
`libelleEtatCivil`	Situation (état civil / marital)
`dateEmbauche`	Date d’entrée collectivité
`dateentfp`	Date d’entrée Fonction Publique

b) Adresse postale → adresse de l’Agent

Balise(s) eSedit	Donnée GEEF (libellé)
`numero` + `complement` + `libelleTypeVoie` + `ligne1` (concaténées)	Adresse (rue)
`ligne2`	Appartement
`ligne3`	Bâtiment
`codePostal`	Code Postal
`boitePostale`	Boîte Postale
`commune`	Ville

c) Numéros & contacts → Contacts de l’Agent

Bloc listeTelephones/telephone. Chaque entrée porte un code (type de contact) et une valeur :

Balise eSedit	Donnée GEEF (libellé)
`telephone/code`	Libellé du contact (créé automatiquement s’il n’existe pas)
`telephone/valeur`	Valeur du contact (n° de téléphone, courriel complémentaire…)

Les contacts absents du message sont supprimés (le flux fait foi).

d) Personnes à prévenir → Personnes à prévenir de l’Agent

Bloc listContact/contact. Les personnes à prévenir sont entièrement resynchronisées à chaque message.

Balise eSedit	Donnée GEEF (libellé)
`nom`	Nom
`prenom`	Prénom
`courriel`	Courriel
`commentaire`	Commentaire
`priorite`	Ordre / priorité
`telephone1`	Contact « Téléphone 1 » de la personne
`telephone2`	Contact « Téléphone 2 » de la personne
`courriel`	Contact « Courriel » de la personne

e) Situation → Carrière de l’Agent

Chaque situation du message donne une carrière (= engagement : SPP, SPV, PATS, JSP…). Les situations sont traitées de façon à agréger correctement l’état de radiation indépendamment de leur ordre.

Donnée eSedit	Donnée GEEF (libellé)	Règle
`situation/numero` (n° de carrière) + `statut/codeStatut`	N°Statut	Résolus par transcodage (voir §4.5) ; un statut non transcodé bloque la situation (code 200).
`statut/dateDebut` (statut « titulaire »)	Titulaire = oui + Date de Titularisation	À défaut, la date de titularisation de la fiche agent (`dateTitul`) est utilisée.
`situation/dateFinContrat` (ou `statut/dateFinContrat`)	Radié + renseignement « Date de départ »	La carrière n’est radiée que si aucune de ses situations n’est ouverte ; la « Date de départ » reçoit alors la date de fin la plus récente.

f) Affectations → Affectations des Agents

Deux niveaux : service (affectation principale) et service/serviceAffectationSecondaire (affectations secondaires).

Balise eSedit	Donnée GEEF (libellé)
`service/code`	N°Service (par transcodage service)
`service/dateDebut`	Date de début
`service/dateFin`	Date de fin
`service/libelleFonction`	Fonction
`situation/libelle`	Motif d’affectation (libellé de la situation)
niveau du bloc	Secondaire (oui pour les affectations secondaires)

g) Temps de travail → Temps de Travail

Issu des position de la situation.

Balise eSedit	Donnée GEEF (libellé)
`position/pctTempsTravail`	Volume (quotité)
`position/dateDebut`	Date d’effet
`position/dateFin`	Date de fin

h) Suspensions / positions administratives → Suspensions (Arrêts et Suspensions)

Issues des position marquant une absence de l’agent (agentPresent = faux). Se cumulent avec les absences remontées par le flux 2.

Balise eSedit	Donnée GEEF (libellé)
`position/codePositionAdmin`	Motif de la Suspension (par transcodage motif)
`position/dateDebut`	Date de début
`position/dateFin`	Date de fin

i) Grades → Historique des Grades

Bloc grade de la situation.

Balise eSedit	Donnée GEEF (libellé)
`grade/codeGrade`	N°Grade (par transcodage grade)
`grade/codeEchelon`	N°échelon (par transcodage échelon)
`grade/dateDebut`	Date d’obtention

j) Conventions (fiches entreprise) → Employeur des agents

Si l’option est activée (§9), le bloc ficheEntreprise/convention alimente le lien agent ↔ employeur. L’employeur doit exister au préalable dans le référentiel des tiers, identifié par son code externe = codeEntreprise (référentiel alimenté par le flux Employeurs, voir §8) ; sinon la convention est ignorée et tracée.

Donnée eSedit	Donnée GEEF (libellé)	Règle
`ficheEntreprise/codeEntreprise`	Employeur	Résolu via le code externe du tiers.
`convention/codeTypeConvention` (`O`/`F`/`G`)	Type de convention	`O` = Opérationnel, `F` = Formation, `G` = Garde. Le type est créé s’il n’existe pas.
`convention/numero`	N° Convention
`convention/dateDebut`	Date de début	À défaut, la date de début de la fiche entreprise.
`convention/dateFin`	Date de fin	À défaut, la date de fin de la fiche entreprise.
`convention/dateSignature` + `convention/observation`	Commentaire	Concaténés (« Signature : … - … »).
—	Convention (régime)	Régime par défaut « Indemnité ».
attribut `delete="true"`	Suppression	Supprime la convention correspondante.

Clé d’unicité applicative d’une convention : agent + employeur + date de début + type de convention.

3.4 Comportements de purge (options)

Avant réintégration, plusieurs options permettent de purger les données existantes de l’agent pour qu’elles reflètent exactement le message (le flux faisant foi) :

suppression des grades, des suspensions, des affectations principales, des affectations secondaires (par option, voir §9).

3.5 Transcodages requis (flux 1)

Ces correspondances doivent être tenues à jour côté GEEF à partir des codes fournis par l’administrateur eSedit :

Référentiel	Clé eSedit utilisée	Résolution GEEF
Statuts	`situation/numero` + `statut/codeStatut`	Statut GEEF (mode simple ou combinatoire, voir ci‑dessous)
Services	`service/code`	Service GEEF
Grades	`grade/codeGrade`	Grade GEEF
Échelons	`grade/codeEchelon`	Échelon GEEF
Positions / motifs de suspension	`position/codePositionAdmin`	Motif de suspension GEEF

Mode de résolution du statut :

Mode simple : le statut est retrouvé en priorité par le code statut eSedit, puis à défaut par le numéro de carrière eSedit.
Mode combinatoire (activable, voir §9) : le couple (numéro de carrière, code statut) est résolu via une table de correspondance dédiée, avec repli sur le numéro de carrière seul.

3.6 Filtrage par collectivité

Seules les situations dont le codeCollectivite figure dans la liste des collectivités autorisées (paramètre, §9) sont intégrées ; les autres sont ignorées et tracées.

3.7 Codes retour (flux 1)

GEEF renvoie un document retourWebService contenant un codeRetour :

Code	Signification
0	OK — traitement asynchrone (le document sera traité ultérieurement)
1	OK — traitement synchrone (document traité immédiatement)
2	Erreur inattendue (nécessite une analyse Cegape)
98	Document vide
99	Document invalide (contenu inconnu / inexploitable)
100	Matricule invalide (synchrone uniquement)
101	Agent non créé (synchrone uniquement)
102	Agent ne peut pas être créé (synchrone uniquement)
103	Erreur de mise à jour de l’agent (synchrone uniquement)
200	Code statut inconnu (synchrone uniquement)
201	Carrière non créée (synchrone uniquement)
202	Carrière ne pouvant être créée (synchrone uniquement)
203	Erreur de mise à jour de la carrière (synchrone uniquement)
400	WebService inactif
401	Absence d’authentification (HTTP 401)
403	Authentification OK mais accès refusé (HTTP 403)

Même avec un code global « OK », des sous‑éléments (téléphones, personnes à prévenir, affectations, suspensions, grades, conventions) peuvent échouer individuellement : ces erreurs sont tracées sans interrompre le reste de l’intégration (« intégration incomplète, des erreurs ont été marquées »).

3.8 Synchronisation & résolution des anomalies

Synchronisation de masse : non disponible en flux temps réel. Après une interruption, une resynchronisation par fichiers plats est possible (sur devis si réalisée par les équipes GEEF). Les fichiers plats ne portent pas certains détails (affectations secondaires, positions).
Une modification eSedit n’apparaît pas dans GEEF :
1. Vérifier côté eSedit le message « Carrière Synthétique mise à jour » (sans lui, rien ne sort d’eSedit).
2. Vérifier la réception dans l’interface entrante de GEEF.
3. Si le message est arrivé et contient les données : vérifier la cohérence des transcodages (statuts, services, grades, positions). En cas de désaccord de référentiels, les administrateurs eSedit et GEEF doivent s’accorder ; sinon → ticket GEEF.
4. Si le message est arrivé sans les données → ticket eSedit.
5. Si le message n’arrive pas : vérifier la saisie côté eSedit puis le certificat (erreur PKIX dans les journaux eSedit) → sinon ticket eSedit.

3.9 Paramètres et impacts

Paramètre	Impact sur le flux
`eSedit - WebService Actif`	À `OUI`, le point d’entrée accepte les messages ; sinon toute requête est refusée (code 400).
`eSedit - Clé WebService`	Si renseigné, la valeur de l’en‑tête `Authorization` doit lui être strictement égale : en‑tête absent → code 401, valeur différente → code 403. Vide ⇒ aucun contrôle applicatif de clé.
`eSedit entrant - Longueur matricule`	Normalise le matricule (complété à gauche par des zéros) sur cette longueur avant recherche/écriture. Vide ⇒ matricule laissé tel quel.
`eSedit entrant - Collectivités`	Filtre : seules les situations dont le `codeCollectivite` figure dans la liste (séparateurs `,` `;` `.` `-`) sont intégrées ; les autres sont ignorées et tracées. Une valeur vide bloque donc toutes les situations.
`eSedit entrant - Combinatoire Statut`	À `OUI`, le statut est résolu par le couple (n° de carrière, code statut) via la table de correspondance combinatoire ; à `NON`, résolution simple (code statut puis n° de carrière). Un statut non résolu bloque la situation (code 200).
`eSedit entrant - Traiter Affectations Secondaires`	À `OUI`, les affectations secondaires sont intégrées ; sinon elles sont ignorées.
`eSedit entrant - Traiter les Conventions`	À `OUI`, le bloc « fiches entreprise » alimente l’Employeur des agents (§3.3‑j) ; sinon il est ignoré.
`eSedit entrant - Supprimer les Grades`	À `OUI`, purge l’Historique des Grades de l’agent avant réintégration (le flux fait foi).
`eSedit entrant - Supprimer les Suspensions`	À `OUI`, purge les Suspensions de l’agent avant réintégration.
`eSedit entrant - Supprimer Affectations Principales`	À `OUI`, purge les affectations principales de l’agent avant réintégration.
`eSedit entrant - Supprimer Affectations Secondaires`	À `OUI`, purge l’affectation secondaire correspondant à la date de début de chaque service traité.

4. Flux 2 — Absences (GEEF ← eSedit)

4.1 Objet

GEEF interroge eSedit (automatiquement, ~1×/jour, sur les absences saisies/modifiées la veille) et intègre les absences comme suspensions (écran GRH > Livrets Individuels > Détails > Arrêts et Suspensions). Elles se cumulent avec les suspensions issues du flux 1.

4.2 Appel

Ressource eSedit : absence/pointageSaisie (POST, réponse JSON).
Requête, pour chaque combinaison organisme × domaine configurée :

Champ requête	Contenu
`codeOrganisme`	Code organisme (liste paramétrée)
`codeDomaine`	Code domaine (liste paramétrée)
`dateModification`	Date de référence (la veille)

4.3 Mapping (réponse `listPointageSaisi`) → Suspensions

Champ eSedit	Donnée GEEF (libellé)	Règle
`matriculeAgent`	Agent → carrière(s)	La suspension est appliquée à chaque carrière de l’agent.
`dateDebut`	Date de début
`dateFin`	Date de fin
`codeAbsence` / `codeGenerique` (+ libellés)	Motif de la Suspension	Résolu par transcodage motif (code externe puis libellé) ; motif inconnu → pointage rejeté et tracé.

Une suspension déjà présente (même carrière, même motif, même date de début) est mise à jour si sa date de fin diffère, sinon ignorée.

4.4 Paramètres et impacts

Paramètre	Impact sur le flux
`eSedit Absences - WebService Actif`	À `OUI`, la récupération automatique des absences est active.
`eSedit Absences - Codes Organismes`	Liste des organismes interrogés (séparateurs `,` `;`). Le connecteur boucle sur chaque combinaison organisme × domaine.
`eSedit Absences - Codes Domaines`	Liste des domaines interrogés (idem).
`eSedit sortant - URL`, `eSedit sortant - URL PROXY`, `eSedit sortant - Clé WebService`	Paramètres de connexion réutilisés pour joindre eSedit (voir §9).

Le motif d’absence est résolu par transcodage sur le code externe (à défaut le libellé) des motifs de suspension : un motif non transcodé fait rejeter le pointage. À noter : la connexion s’appuie sur les paramètres sortants ci‑dessus ; au moins une catégorie d’envoi « CV » (§6.5) doit par ailleurs être activée pour que la connexion s’initialise.

5. Flux 3 — Besoins en formation (GEEF ← eSedit)

5.1 Objet

GEEF récupère les souhaits de formation exprimés lors des entretiens et les intègre dans Plan de Formation > Besoins Individuels > Demandes.

5.2 Appel

Ressource eSedit : evaluation/besoinFormation (POST, réponse JSON).
Requête, pour chaque organisme configuré : codeOrganisme, dateDebut (date de référence).

5.3 Mapping (réponse `listBesoinFormation`)

Chaque besoin crée/complète une période de saisie puis une candidature :

Champ eSedit	Donnée GEEF (libellé)	Règle
`matriculeAgent` + `numeroCarriere`	Carrière concernée	Résolus par transcodage statut ; carrière introuvable → rejet tracé.
`anneeCampagne`	Année (période de saisie)	À défaut, année de l’entretien + 1.
`dateDebut` / `dateFin`	Date de début / Date de fin de recueil
`dateEntretien`	Date de dépôt (et Date de réponse)
`besoinFormation`	Nature de l’action (stage « demande libre »)	Rattaché au stage par défaut (paramètre « Code Stage »).
`avisCollectiviteBesoinFormation`	Avis / motif
`motivationAgentBesoinFormation`	Commentaire de la demande
`etatCR`, `demandeEvalutateur…`, `demandeEvalue…`	Commentaire	Concaténés (état de l’entretien + origine de la demande : évaluateur et/ou évalué).

Une candidature déjà présente (même carrière, même date de dépôt, même nature) est conservée telle quelle.

5.4 Paramètres et impacts

Paramètre	Impact sur le flux
`eSedit Besoins Formation - WebService Actif`	À `OUI`, la récupération des besoins est active (automatique et à la demande).
`eSedit Besoins Formation - Code Stage`	Stage par défaut auquel sont rattachées les candidatures créées à partir des besoins.
`eSedit Absences - Codes Organismes`	Liste des organismes interrogés — partagée avec le flux Absences (§4.4).
`eSedit sortant - URL`, `eSedit sortant - URL PROXY`, `eSedit sortant - Clé WebService`	Paramètres de connexion réutilisés pour joindre eSedit (voir §9).

Comme pour les absences, au moins une catégorie d’envoi « CV » (§6.5) doit être activée pour que la connexion s’initialise.

6. Flux 4/5/6 — Qualifications, Diplômes, Formations SPP/SPV (GEEF → eSedit)

6.1 Objet

Lors de la mise à jour d’un emploi ou d’un diplôme dans GEEF, une demande d’envoi est initiée (~30 s plus tard) pour mettre à jour la partie Curriculum Vitae de l’agent côté eSedit. GEEF n’envoie que le différentiel (créations, mises à jour, suppressions) par rapport au dernier envoi.

La demande porte sur :

Qualifications eSedit ← emplois GEEF (actifs/inactifs) ;
Diplômes eSedit ← diplômes GEEF liés à des emplois/activités opérationnels (pas les diplômes académiques) ;
Formations SPP/SPV eSedit ← certains diplômes GEEF (ex. fin de formation initiale, fin de FAE/FAAR…).

Les compétences peuvent également être transmises (option), mais le référentiel standard étant celui du CNFPT, elles ne sont en général pas envoyées.

6.2 Appel

Ressource eSedit : agentSynchro/updateCV (POST, corps XML).
Enveloppe : racine cv (namespace http://berger-levrault.com/eSeditRH/agentSynchro) avec codeOrganisme et matricule, puis les listes listQualifications, listDiplomes, listFormations (et listCompetences).

6.3 Mapping (GEEF → eSedit)

Structure eSedit	Balises	Donnée GEEF (libellé)
Qualification (`qualification`)	`codeQualification`, `dateObtention`, `dateFinValidite`	Code externe Qualification de l’emploi, Date de début, Date de fin
Diplôme (`diplome`)	`codeDiplome`, `dateObtention`	Code externe Diplôme de l’emploi, Date d’obtention
Formation SPP/SPV (`formation`)	`codeFormation`, `dateObtention`	Code externe Formation de l’emploi, Date d’obtention

Chaque élément porte l’attribut delete="true" lorsqu’il s’agit d’une suppression. Clés d’unicité eSedit : (code externe, date de début, matricule) pour diplômes ; (code externe, matricule) pour formations et qualifications.

6.4 Suivi, transcodages & resynchronisation

Suivi : chaque demande porte un statut (À envoyer → Envoi en cours → Envoyé / Erreur) et un code retour d’eSedit, consultables dans Outils > Importations > CiviRH (ou SEDIT) > Interface sortante vers eSedit > Détails.
Transcodages : les codes externes eSedit (qualification/diplôme/formation) doivent être renseignés sur les emplois GEEF. Un code manquant provoque un envoi vide (message « … Empty entity », statut Erreur).
Résolution des anomalies :
- Statut Envoyé, code retour 1 mais données absentes côté eSedit → ticket eSedit.
- Statut Envoyé, message « La qualification […] n’existe pas […] » → créer/corriger la correspondance côté eSedit (Accueil GPEC > Paramétrages > Référentiels) et l’associer au bon emploi GEEF (accord entre administrateurs).
- Statut Erreur, « … Empty entity » → transcodage manquant côté GEEF ou certificat public eSedit absent/expiré (erreur PKIX côté GEEF).
Resynchronisation de masse : disponible via un script fourni par Cegape (à jouer après purge des onglets Qualifications/Diplômes/Formations SPP/SPV côté eSedit, en accord avec l’interlocuteur eSedit).

6.5 Paramètres et impacts

Paramètre	Impact sur le flux
`eSedit sortant - WebService Actif`	À `OUI`, l’envoi « CV » est actif.
`eSedit sortant - URL`	URL du serveur eSedit (obligatoire ; vide ⇒ envoi en erreur).
`eSedit sortant - URL PROXY`	Proxy éventuel pour joindre eSedit.
`eSedit sortant - Clé WebService`	Clé d’authentification (encodée) envoyée en HTTP Basic.
`eSedit sortant - Longueur matricule`	Normalise le matricule inscrit dans le message.
`eSedit sortant - Qualifications`	Envoie (ou non) les qualifications.
`eSedit sortant - Diplômes`	Envoie (ou non) les diplômes.
`eSedit sortant - Formations SPP/SPV`	Envoie (ou non) les formations SPP/SPV.
`eSedit sortant - Compétences`	Envoie (ou non) les compétences (référentiel CNFPT — généralement laissé à `NON`).
`eSedit sortant - Conventions`	Réservé : l’envoi de conventions n’est pas implémenté (sans effet).

Au moins une catégorie d’envoi (qualifications, diplômes, formations, compétences) doit être à OUI, sinon aucune connexion n’est établie et l’envoi échoue. Ces paramètres de connexion conditionnent aussi les flux 2 et 3.

7. Référentiel Employeurs / Entreprises (GEEF ← eSedit)

7.1 Objet

GEEF récupère la liste des entreprises/tiers paramétrés côté eSedit (organismes de formation, prestataires…) et alimente son référentiel des Employeurs. Ce flux est le préalable au traitement des conventions du flux 1 (§3.3‑j).

7.2 Appel

Ressource eSedit : divers/getReferentielDivers avec choixEntreprise = true (POST, réponse JSON), pour chaque organisme configuré.

7.3 Mapping (`entreprise`) → Employeurs

Champ eSedit	Donnée GEEF (libellé)	Règle
`code`	Code externe	Clé d’upsert de l’employeur.
`nom`	Employeur + Raison Sociale	À défaut, le code.
`numSiret`	SIRET	À défaut, le code.
`adresse` (`numero` + `libelleTypeVoie` + `ligne1`)	Adresse
`adresse/ligne2`	Bâtiment
`adresse/codePostal`	Code postal
`adresse/commune`	Ville
`banque/libelleBanque`	Domiciliation
`banque/codeBIC`	BIC
`iban`	IBAN	Conservé (personne morale).
`listeContact[0]/nom`	Contact
`listeContact[0]/courriel`	Email
`listeContact[0]/numTel1`	Téléphone
`listeContact[1]/nom`	Représentant
`observation`	Commentaire

Les employeurs sont créés (secteur public, actif) ou mis à jour selon la présence du code externe.

Donnée sensible. L’IBAN et les coordonnées bancaires sont transmis en clair côté eSedit : précautions RGPD à respecter.

7.4 Paramètres et impacts

Paramètre	Impact sur le flux
`eSedit Référentiel Entreprises - WebService Actif`	À `OUI`, la récupération du référentiel des entreprises est active.
`eSedit Référentiel Entreprises - Codes Organismes`	Liste des organismes interrogés (séparateurs `,` `;`).
`eSedit sortant - URL`, `eSedit sortant - URL PROXY`, `eSedit sortant - Clé WebService`	Paramètres de connexion réutilisés pour joindre eSedit (voir §9). Contrairement aux flux 2 et 3, ce flux n’exige pas qu’une catégorie d’envoi « CV » soit activée.

8. Journalisation & traçabilité

Flux 1 : chaque message reçu est archivé dans l’interface entrante de GEEF avec son statut (erreur / asynchrone / succès) et un journal détaillé (ouverture, chaque sous‑traitement, résultat).
Flux sortants (2/3/4/5/6, référentiel) : le résultat de chaque exécution est notifié dans GEEF (succès/échec) et les détails sont journalisés ; les envois « CV » portent en plus le code retour d’eSedit.

9. Connexion partagée & cadence

L’impact détaillé de chaque paramètre est documenté dans la section du flux concerné : §3.9 (flux 1), §4.4 (absences), §5.4 (besoins), §6.5 (CV sortant), §7.4 (référentiel entreprises). Les éléments ci‑dessous sont communs à plusieurs flux.

Paramètres de connexion sortante — utilisés par les flux 2, 3, 4/5/6 et le référentiel entreprises pour joindre eSedit :

Paramètre	Rôle
`eSedit sortant - URL`	URL du serveur eSedit à joindre.
`eSedit sortant - URL PROXY`	Proxy éventuel.
`eSedit sortant - Clé WebService`	Clé d’authentification HTTP Basic (encodée).

Les flux 2 (absences) et 3 (besoins) s’appuient sur ces paramètres et requièrent qu’au moins une catégorie d’envoi « CV » (§6.5) soit activée pour établir la connexion. Le référentiel entreprises (§7) n’a pas cette contrainte.

Cadence indicative : absences et besoins ~horaire (sur la veille), référentiel entreprises ~quotidien, envoi « CV » ~toutes les quelques heures. Les besoins en formation peuvent aussi être lancés à la demande par un administrateur.

10. Services eSedit disponibles mais non consommés

L’API eSedit RH « Synchronisation Agent » expose d’autres services (état civil, unités de gestion, contrats, fiches statut/position/grade/affectation/poste/imputation, régimes SS et retraite), ainsi que des services de lecture (organigramme, cadre statutaire = statuts/positions/grades). De même, l’API « Absences » propose l’écriture d’absences (saveAbsence/modifyAbsence/deleteAbsence).

Le connecteur GEEF ne consomme pas ces services à ce jour : ils constituent des évolutions possibles. Cette documentation couvre uniquement les flux effectivement implémentés (§3 à §7).