Yparéo (Septeo) est l'ERP des CFA et des organismes de formation. Par ce connecteur, Livia lit vos apprenants, vos groupes, l'assiduité, le planning, les contrats d'alternance, les stages, les entreprises et les documents des apprenants. Ces données servent aux audits Qualiopi, au tableau de bord Scolarité et au suivi des relations entreprises.
Ce que l'école fournit
- L'URL de votre environnement Yparéo, celle à laquelle vous vous connectez, sans « /index.php » ni slash final. Exemple : https://mon-ecole.ymag.fr/netypareo.
- Le jeton d'authentification généré à la création du prestataire webservices.
Créer le prestataire webservices
Yparéo 3.7.16 ou ultérieure convient.
- Dans Yparéo, allez dans Paramètres, Administration, Modules, Prestataires webservices REST.
- Cliquez sur Ajouter un prestataire, nommez-le « Livia » et activez Autoriser l'accès.
- Cochez les permissions que Livia doit utiliser, en lecture (apprenants, groupes, absences, planning, contrats, stages, entreprises, documents) et en écriture (absences, observations, préinscriptions, documents).
- Validez. Le jeton d'authentification s'affiche : copiez-le dans Livia.
Vérification
Une erreur 401 signale un jeton invalide ou une méthode non autorisée pour le prestataire. Les permissions se règlent par point d'entrée dans Yparéo.
Lecture et écriture
Livia peut appeler chaque point d'entrée coché pour le prestataire, en lecture comme en écriture. Toute écriture (absences, préinscriptions, observations, documents) passe par l'espace À valider.
Pièces des intervenants
L'API d'Yparéo ne donne accès à aucun document de la fiche personnel. CV, diplômes, attestation URSSAF, RIB et pièce d'identité restent invisibles pour Livia, quelles que soient les permissions cochées. Pour qu'elle contrôle ces pièces lors d'un audit Qualiopi (indicateur 21), rangez-les dans votre Drive ou votre OneDrive et indiquez-lui le dossier.
Documentation Yparéo : https://demo.ymag.fr/documentation-api/