1. Pourquoi utiliser l’API CFA Constructys pour votre CFA

Depuis 2023, l’OPCO Constructys a rejoint le dispositif API Convergence, qui permet aux CFA de transmettre automatiquement leurs contrats d’apprentissage, demandes de prise en charge ou factures à l’OPCO. Cette évolution marque un tournant dans la gestion des flux administratifs : fini les e-mails, fichiers PDF à envoyer manuellement ou les erreurs de saisie.

Grâce à l’API CFA Constructys, vos échanges sont désormais structurés, sécurisés et traçables, directement depuis votre logiciel de gestion comme Linkpick. Mais à quoi sert concrètement cette API, et pourquoi est-elle devenue indispensable pour les CFA en 2025 ?

Les enjeux de la transmission numérique vers l’OPCO Constructys

L’API CFA Constructys agit comme un pont sécurisé entre votre CFA et l’OPCO. Elle repose sur un token d’authentification unique, généré par le portail Constructys, qui permet à votre logiciel d’envoyer et de recevoir des données en temps réel.

Voici les objectifs principaux de cette interconnexion :

• Éviter les doubles saisies : les données sont directement reprises du système de gestion (ex. Linkpick), ce qui réduit les risques d’erreur (RNCP, SIRET, pièces jointes…).

• Respecter les exigences réglementaires : l’API garantit la conformité RGPD et la traçabilité exigée par Qualiopi.

• Gagner en fluidité opérationnelle : les délais de traitement côté OPCO sont raccourcis, et les CFA peuvent suivre l’état de chaque transmission depuis leur tableau de bord.

• Sécuriser les échanges : chaque appel API est horodaté, chiffré, et validé grâce au token API Constructys.
  
  

Les avantages concrets pour les CFA en 2025

L’adoption de l’API CFA Constructys offre des bénéfices immédiats aux équipes pédagogiques, administratives et informatiques :

🔐 Bon à savoir : sans clé API CFA Constructys, aucun échange via API n’est possible, même si votre logiciel est compatible. Cette clé est le sésame indispensable pour établir une communication fiable avec Constructys.

2. Vérifications essentielles avant d’activer votre clé API Constructys 

Accès au portail et profils habilités

Avant toute tentative d’interconnexion, il est indispensable de vérifier que vous disposez d’un accès administrateur sur le portail Constructys. Ce rôle est le seul à permettre la génération ou la révocation d’une clé API CFA Constructys.

Pour rappel :

• Un compte utilisateur standard ne peut ni visualiser la clé API ni accéder aux paramètres de l’API Convergence.

• Il est recommandé de créer une adresse générique sécurisée pour l’usage API (ex. api_constructys@votre-cfa.fr), afin d’éviter toute interruption de service en cas de départ d’un salarié.

• Les identifiants doivent être centralisés dans un coffre-fort numérique type Bitwarden, KeePass ou équivalent.
  
  

💡 Bon à savoir : si vous travaillez avec un prestataire logiciel comme Linkpick, assurez-vous que l’intégrateur ait un accès technique validé pour coller et tester la clé API dans l’interface du logiciel.

Pour plus d'information : cliquez ici !

Données techniques obligatoires à prévoir

Lors de la génération de la clé API CFA Constructys, plusieurs informations critiques sont encodées automatiquement dans le jeton. Une seule erreur ou incohérence peut bloquer l’activation et générer une erreur de type 401 : Invalid CFA_KEY.

Vérifiez donc :

• Numéro de SIRET : copié-collé depuis votre extrait Kbis sans faute de frappe.

• Adresse e-mail de contact : professionnelle, fonctionnelle, idéalement partagée (ex. api-alertes@votre-cfa.fr).

• Mandat de gestion enregistré sur le portail Constructys : sans ce mandat, aucune communication via l’API ne sera autorisée.
  
  

En cas de CFA multi-sites, il est vivement conseillé de générer une clé distincte par établissement (et donc par SIRET). Cela vous permettra :

• De segmenter les flux et faciliter les audits OPCO.

• D’éviter qu’un seul dysfonctionnement n’impacte l’ensemble de vos campus.

3. Créer un compte administrateur sur le portail Constructys

Pour activer et utiliser la clé API CFA Constructys, vous devez impérativement posséder un compte administrateur actif sur l’espace numérique Constructys dédié aux partenaires. Sans cet accès, vous ne pourrez ni générer ni gérer le token API qui sert de clé d’authentification pour l’interfaçage entre votre logiciel (comme Linkpick) et l’OPCO Constructys.

Étapes de création et validation

Voici les étapes à suivre pour créer un compte administrateur Constructys :

1. Accédez au portail numérique Constructys
   ➤ Connectez-vous via l’espace formation de Constructys. Vous devrez passer par la rubrique “Partenaire numérique” si c’est votre première connexion.

2. Complétez le formulaire de demande
   Il vous sera demandé de renseigner :

   • Le SIRET de votre établissement

   • Vos nom et prénom

   • Votre fonction dans l’organisme (idéalement « Responsable SI » ou « Référent administratif »)

   • Une adresse e-mail professionnelle (évitez les boîtes personnelles de type Gmail, Yahoo…)

3. Choisissez un mot de passe sécurisé
   Le mot de passe doit comporter au moins 12 caractères, dont une majuscule, un chiffre et un symbole.

4. Activez votre compte via l’e-mail de confirmation
   Un message vous est envoyé dans la minute. Le lien de validation reste actif pendant 24 heures. Passé ce délai, la procédure devra être recommencée.

5. Connexion réussie ? Vérifiez l’accès à l’API
   Une fois connecté, vous devez voir dans le menu latéral l’onglet “API Convergence” puis “Gérer mes clés”.
   ➤ Si ce menu n’apparaît pas, videz le cache du navigateur ou contactez votre chargé d’appui Constructys.
   
   

Sécuriser l’accès avec la double authentification (2FA)

Depuis 2024, l’activation de la double authentification (2FA) est obligatoire pour tous les administrateurs utilisant le portail numérique Constructys.

🛡️ Cette sécurité repose sur l’ajout d’un second facteur d’identification :

• Application mobile (Google Authenticator, Microsoft Authenticator, FreeOTP…)

• Clé de sécurité physique (FIDO2)

• SMS sécurisé (option déconseillée)
  
  

Conseils de mise en place :

• Activez la 2FA dès la première connexion.

• Conservez les codes de secours dans un coffre-fort numérique.

• Mentionnez dans votre registre RGPD la méthode choisie et la date d’activation.

En sécurisant correctement votre compte administrateur, vous évitez toute faille de sécurité dans la génération de la clé API CFA Constructys et vous vous assurez d’un accès fiable et conforme au service d’échange de données.

4. Générer la clé API CFA Constructys étape par étape

Une fois votre compte administrateur validé sur le portail Constructys, vous pouvez procéder à la génération de la clé API CFA Constructys. Cette clé est indispensable pour activer l’interfaçage avec votre logiciel de gestion, tel que Linkpick.

Où trouver la section “API Convergence”

Dès que vous êtes connecté en tant qu’administrateur sur le Portail Numérique Constructys, repérez le menu latéral gauche. Vous y trouverez une section nommée “API Convergence”, puis un sous-menu “Gérer mes clés”.

C’est à cet emplacement que sont listées les éventuelles clés existantes pour votre CFA. Si vous n’avez encore jamais généré de clé, la zone sera vide.

Pour créer une nouvelle clé :

1. Accédez à API Convergence > Gérer mes clés

2. Cliquez sur le bouton “Générer une nouvelle clé”

3. Validez la demande après lecture de l’avertissement affiché à l’écran
   
   

💡 Ce bouton n’est visible que si vous disposez des droits administrateur. Si ce n’est pas le cas, contactez votre référent Constructys.

Tuto : comment récupérer la clé d'authentification API CFA Constructys (cliquez)

Attention à la révocation automatique de l’ancienne clé

Avant de générer une nouvelle clé, Constructys vous affichera un message d’alerte :

“Cette opération entraîne la révocation immédiate de votre clé actuelle. Assurez-vous qu’elle n’est plus utilisée avant de poursuivre.”

Cela signifie que toute clé API CFA Constructys préexistante sera automatiquement désactivée. Si elle est encore utilisée dans Linkpick ou un autre logiciel, vos envois de contrats seront rejetés avec une erreur de type 401 Invalid CFA_KEY.

Pour éviter toute interruption de service :

• Prévenez votre équipe SI ou votre éditeur logiciel avant toute régénération

• Planifiez la nouvelle génération en dehors des périodes critiques (rentrée, pic de contrats)

• Préparez l’intégration immédiate de la nouvelle clé dans Linkpick (voir partie suivante)
  
  

Une fois générée, la clé s’affiche une seule fois sous forme d’une chaîne alphanumérique de 32 caractères. Vous devez impérativement :

• La copier immédiatement dans le presse-papiers

• L’enregistrer dans un coffre-fort sécurisé (Bitwarden, KeePass, 1Password…)

• La transmettre via un canal chiffré à la personne en charge de l’intégration dans Linkpick
  
  

📄 Consultez le guide officiel de récupération de clé API CFA sur le portail OPCO (PDF) : Mode opératoire API Convergence – version 6.4

⚠️ Si la clé est perdue ou mal copiée, vous devrez en générer une nouvelle. Toute clé précédente devient alors caduque, même si elle n’a jamais été utilisée.

5. Intégrer la clé API CFA Constructys dans Linkpick

Une fois la clé API CFA Constructys générée et stockée en toute sécurité, il est temps de passer à son intégration dans votre logiciel de gestion. Si vous utilisez Linkpick, l’opération est simple, rapide et sans interruption de service, à condition de respecter quelques étapes clés.

Paramétrage dans l’espace administrateur Linkpick

L’interfaçage entre Linkpick et l’OPCO Constructys repose sur un connecteur natif conçu pour les flux API Convergence. Pour activer ce lien automatique :

1. Connectez-vous à l’espace administrateur Linkpick

Accédez au menu : Administration > Connecteurs OPCO

2. Choisissez Constructys dans la liste déroulante des OPCO

Une fiche de configuration s’affiche. Par défaut, le statut est inactif.

3. Collez votre clé API CFA Constructys dans le champ prévu

Vérifiez qu’aucun espace ne précède ou ne suit la chaîne alphanumérique.

4. Cliquez sur “Enregistrer” pour finaliser le paramétrage.

👉 Une fois cette opération effectuée, la connexion avec Constructys est techniquement établie. Il est maintenant temps de vérifier qu’elle fonctionne comme prévu.

Tester la connexion et transmettre un dossier de test

Pour vous assurer que l’intégration est réussie, réalisez un test de communication via l’API CFA Constructys :

1. Utilisez le bouton “Tester la connexion”
   Si tout est conforme, vous verrez apparaître le message :

   ✅ Connexion établie avec Constructys
   
   

2. Créez un contrat d’apprentissage test dans Linkpick
   Donnez-lui le statut “Brouillon” et renseignez un SIRET valide.
   
   

3. Transmettez-le via l’option “Envoyer à l’OPCO”
   Si tout est bien paramétré, le contrat apparaîtra dans :

   Historique > Transmissions OPCO, avec le statut “Envoyé Constructys”
   
   

4. Vérifiez la réception côté OPCO
   Un accusé de réception ou une notification d’erreur vous indique si le dossier a bien été pris en compte par Constructys.

6. Sécuriser, tracer et renouveler votre clé API CFA Constructys

La clé API CFA Constructys permet d’authentifier votre CFA auprès de l’OPCO et d’échanger des données sensibles (contrats d’apprentissage, avenants, pièces justificatives…). Elle doit donc être traitée comme une information critique, au même titre que vos identifiants administrateurs ou vos accès SIRH.

Une mauvaise gestion (clé perdue, oubliée, exposée…) peut entraîner une interruption des flux entre votre logiciel et Constructys, ou pire, une faille de sécurité.

Bonnes pratiques de sécurité RGPD

Voici les règles clés à respecter pour sécuriser votre usage de l’API CFA Constructys :

• Stockage chiffré : dès sa génération, copiez la clé API dans un coffre-fort numérique (ex. Bitwarden, KeePass, 1Password). Activez les droits restreints par utilisateur.

• Accès limité : seul le responsable SI ou un référent API doit avoir accès à cette clé. Les droits d’usage doivent être consignés dans une politique interne.

• Traçabilité RGPD : chaque manipulation de la clé (création, modification, révocation) doit être inscrite dans un registre de sécurité.

• Mandat de gestion valide : veillez à ce que votre mandat Constructys soit à jour. Un mandat expiré bloque toute transmission API, même si la clé est correcte.
  
  

💡 Astuce : ajoutez un chapitre "Gestion des clés API OPCO" dans votre charte de sécurité informatique.

Planifier la rotation annuelle de la clé Constructys

Contrairement à un mot de passe, la clé API Constructys n’expire pas automatiquement. Cependant, Constructys recommande fortement de la renouveler au moins une fois par an pour :

• Réduire les risques de compromission

• Gérer les départs de personnel ayant eu accès à la clé

• Réinitialiser les flux dans un environnement propre
  
  

Pour bien anticiper ce renouvellement :

1. Ajoutez une alerte 30 jours avant la date de génération de la clé, dans votre outil de gestion (ex. Outlook, Notion, Trello).

2. Planifiez un créneau avec votre éditeur logiciel (comme Linkpick) pour insérer la nouvelle clé sans interruption de service.

3. Testez la nouvelle clé en transmettant un contrat d’apprentissage ou une simulation.
   
   

Enfin, n’oubliez pas d’activer la double authentification (2FA) sur le portail Constructys, obligatoire pour générer une clé API en toute sécurité.

7. Foire aux questions sur l’API CFA Constructys

La clé API Constructys a-t-elle une date d’expiration automatique ?

Non. La clé API CFA Constructys reste techniquement valide sans durée de péremption imposée. Néanmoins, Constructys recommande vivement une rotation annuelle afin de renforcer la sécurité de vos flux, notamment en cas de changement d’administrateur ou de suspicion d’accès non autorisé.

Puis-je récupérer la clé après sa génération ?

Non. La clé API ne s’affiche qu’une seule fois lors de sa création. Pour cette raison, elle doit être copiée et stockée immédiatement dans un coffre-fort numérique sécurisé (type Bitwarden, KeePass ou 1Password). Si vous la perdez, vous devrez en générer une nouvelle, ce qui désactivera automatiquement l’ancienne.

Est-il possible de disposer de plusieurs clés en parallèle ?

Non. Une seule clé API peut être active à la fois par numéro SIRET. Générer une nouvelle clé entraîne la révocation immédiate de l’ancienne. Il est donc essentiel de bien planifier toute régénération avec votre responsable SI ou votre prestataire (ex. Linkpick) pour éviter toute interruption des flux de transmission.

Quels sont les délais d’activation de la clé Constructys ?

L’activation de la clé API CFA Constructys est généralement quasi instantanée. Dès que la clé est intégrée dans votre logiciel de gestion et que la connexion testée est réussie, vous pouvez transmettre un premier contrat d’apprentissage. Aucun délai de validation manuelle n’est requis par l’OPCO.

Comment gérer les établissements multi-sites ou multi-SIRET ?

Si votre organisme de formation dispose de plusieurs entités juridiques avec des SIRET différents, il est recommandé de générer une clé API distincte par SIRET. Cela permet de mieux isoler les flux, de faciliter la traçabilité et d’assurer un pilotage administratif optimal, notamment lors des audits OPCO.

8. Automatisez votre gestion CFA avec Linkpick + Constructys

Centralisation, conformité et gain de temps pour votre CFA

L’intégration de l’API CFA Constructys dans un outil comme Linkpick permet de transformer radicalement la gestion administrative de votre organisme de formation. Ce connecteur natif vous donne accès à un pilotage fluide, normé et conforme, depuis une seule interface.

Concrètement, vous pouvez :

• Transmettre vos contrats d’apprentissage, avenants et demandes de prise en charge directement à Constructys, sans passerelle manuelle.

• Suivre l’état des transmissions en temps réel : chaque dossier transmis est horodaté, archivé et retraçable.

• Automatiser vos exports OPCO, générer les relevés d’activités et faciliter vos audits Qualiopi.

• Être notifié immédiatement en cas d’échec de transmission pour agir sans délai.
  
  

C’est la fin des emails, des portails déconnectés et des tableurs partagés : Linkpick devient votre guichet unique.

Demandez votre démo gratuite avec un expert Linkpick

Vous envisagez de connecter votre CFA à Constructys via l’API Convergence ? Gagnez du temps et sécurisez vos transmissions en découvrant Linkpick en action.

👉 Profitez d’une démo gratuite de 15 minutes avec un expert Linkpick : nous vous guidons pas à pas, de la génération de la clé sur le portail Atlas jusqu’à la première transmission automatisée dans l’outil.

C’est l’occasion idéale pour :

• Poser vos questions techniques ou fonctionnelles

• Découvrir les autres connecteurs OPCO disponibles

• Optimiser vos process d’alternance et de relation OPCO
  
  

📲 Rejoignez-nous sur Instagram, Facebook et LinkedIn pour encore plus de conseils, d’actualités et d’astuces sur l’alternance et le monde professionnel !

Tu peux aussi lire : Comment activer et intégrer l’API CFA OPCO 2i : guide complet 2025