1. Pourquoi activer l’API CFA Atlas devient indispensable en 2025

Depuis 2023, l’OPCO Atlas a rejoint le programme API Convergence, permettant aux CFA (Centres de Formation d’Apprentis) d’automatiser la transmission de leurs contrats d’apprentissage et pièces justificatives vers l’OPCO, sans saisie manuelle.

L’objectif ? Supprimer les tâches chronophages (uploads, e-mails, erreurs de saisie) et garantir un échange fluide, sécurisé et normé entre votre logiciel de gestion (comme Linkpick) et Atlas.

Quels bénéfices concrets pour votre CFA ?

Le token API CFA Atlas, généré depuis le portail numérique de l’OPCO, agit comme une clé d’authentification unique. Elle permet de sécuriser les transmissions de votre CFA et d'assurer que seuls les organismes habilités peuvent échanger avec l’OPCO.

Bon à savoir : Sans cette clé, aucun flux ne peut être établi, même si votre logiciel est compatible. L'activation de l'API CFA Atlas est donc une étape obligatoire pour lancer l’interfaçage.

2. Vérifications essentielles avant de générer votre clé API Atlas

2.1 Accès au portail Atlas et habilitations requises

Avant de pouvoir générer votre clé API CFA Atlas, assurez-vous que votre CFA dispose d’un accès actif au portail Partenaire numérique de l’OPCO Atlas. Ce portail est indispensable pour effectuer toutes les démarches liées à l’API Convergence. Cependant, seuls les utilisateurs ayant le rôle “Administrateur” peuvent accéder à la rubrique « Gérer mes clés » et initier la génération d’un token.

À savoir : Si vous ne possédez pas encore de compte ou que vos droits sont insuffisants, vous devrez suivre la procédure décrite dans la prochaine section (partie 3).

Bonnes pratiques avant de commencer :

• Créez un compte administrateur dédié à l’API (ex. api_admin@votre-cfa.fr) pour éviter toute dépendance à un salarié.

• Centralisez les accès API dans un coffre-fort numérique sécurisé (Bitwarden, KeePass...).

• Désignez au moins deux administrateurs pour garantir la continuité de service en cas d’absence.
  
  

2.2 Données nécessaires : SIRET, email, mandat de gestion

Lorsque vous générez la clé API CFA Atlas, plusieurs données sont automatiquement encodées dans le token. Toute erreur ou oubli à ce stade bloquera les transmissions avec une erreur de type 401 “Invalid CFA_KEY”.

Voici les données à valider avant de passer à l’action :

✅ Numéro SIRET de l’établissement : copiez-le depuis votre extrait Kbis pour éviter toute erreur de frappe.
✅ Adresse e-mail de contact : professionnelle, fonctionnelle, et idéalement une adresse partagée (ex. api@votre-cfa.fr) pour recevoir les notifications d’erreurs ou d’expiration.
✅ Mandat de gestion Atlas : ce document officiel lie votre CFA à l’OPCO Atlas. Il doit être actif et enregistré dans le système Atlas. Sans lui, vous ne pourrez pas transmettre de contrats via l’API.

📌 Multi-sites / multi-SIRET ? Pensez à générer une clé distincte par établissement, cela facilite la traçabilité et limite les risques en cas de blocage ou de révocation.

3. Créer un compte administrateur sur le portail OPCO Atlas

L’obtention de la clé API CFA Atlas ne peut se faire que depuis un compte administrateur enregistré sur le portail numérique de l’OPCO. Cette étape est indispensable, car seul ce profil dispose des droits pour accéder à la rubrique « Gérer mes clés API ».

3.1 Étapes d’enregistrement et d’activation

Si vous ne possédez pas encore de compte administrateur, voici la procédure à suivre pour le créer et l’activer rapidement :

1. Rendez-vous sur le portail Atlas :
   Connectez-vous via l’espace dédié aux organismes de formation sur www.opco-atlas.fr/prestataire/espace-organisme-formation. Assurez-vous d’avoir un navigateur à jour (Chrome, Firefox…).
   
   

2. Cliquez sur “Créer un compte” ou “Première connexion”
   Vous serez invité à renseigner les éléments suivants :

   • Le numéro de SIRET de votre CFA (assurez-vous qu’il soit bien enregistré chez Atlas avec un mandat de gestion à jour).

   • Votre nom, prénom et votre fonction (idéalement « Responsable SI » ou « Référent administratif »).

   • Une adresse e-mail professionnelle nominative (évitez les adresses génériques type Gmail).
     
     

3.     Choisissez un mot de passe robuste
Il doit comporter au moins 12 caractères, incluant majuscules, chiffres et caractères spéciaux.

4.     Confirmez l’adresse e-mail
Un lien d’activation vous est envoyé. Il est valide pendant 24 heures uniquement. Passé ce délai, la création de compte devra être relancée.

Une fois ces étapes validées, vous accédez à votre espace personnel. Vous devez maintenant configurer la sécurité du compte.

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

Depuis 2024, Atlas impose la double authentification (2FA) pour tous les comptes administrateurs. Ce dispositif renforce la sécurité du portail en ajoutant une étape supplémentaire à la connexion.

Deux méthodes sont proposées :

• Application OTP (One-Time Password) : vous scannez un QR code avec une application comme Google Authenticator, FreeOTP ou Microsoft Authenticator. Un code à usage unique vous est alors généré à chaque connexion.

• Clé physique FIDO2 (optionnelle) : si votre structure est équipée, une clé de type Yubikey peut être utilisée.
  
  

💡 Bon à savoir : une fois la 2FA activée, pensez à enregistrer vos codes de secours dans un coffre-fort numérique. Ils seront nécessaires en cas de changement de téléphone ou de perte d’accès.

Enfin, une fois connecté et authentifié, assurez-vous que le menu latéral contient la rubrique « API Convergence » > « Gérer mes clés ». Si ce menu n’apparaît pas :

• Videz le cache de votre navigateur,

• Ou contactez votre référent OPCO Atlas pour valider votre niveau de droits.
  
  

📄 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

4. Générer votre clé API CFA Atlas étape par étape

Une fois votre compte administrateur validé sur le portail OPCO Atlas, vous pouvez procéder à la génération de votre clé API CFA Atlas. Cette étape est essentielle pour activer l’interconnexion entre votre logiciel de gestion – comme Linkpick – et le système d'information d’Atlas.

4.1 Où trouver la rubrique “Gérer mes clés API”

Une fois connecté avec votre profil administrateur :

1. Accédez au portail “Partenaire numérique” Atlas.

2. Dans le menu latéral, cliquez sur “API Convergence”, puis sélectionnez “Gérer mes clés”.

3. Si la section n’apparaît pas, cela peut être dû à :

   • Un problème de droits (votre compte n’est pas encore reconnu comme administrateur),

   • Un cache navigateur obsolète (vider le cache et recharger la page),

   • Une validation toujours en attente côté Atlas (contactez alors votre chargé d’appui Atlas).
     
     

Une fois dans l’interface, vous verrez s’afficher un bouton “Générer une nouvelle clé API CFA”.

4.2 Copie unique et sécurisation de la clé

⚠️ Attention : La clé API CFA Atlas ne s’affiche qu’une seule fois, immédiatement après sa génération. Il n’est pas possible de la récupérer ultérieurement. Vous devez donc impérativement la copier et la stocker immédiatement.

Étapes à suivre :

1. Cliquez sur “Générer une nouvelle clé” : une chaîne de 32 caractères alphanumériques unique vous est fournie.

2. Copiez la clé sans ajouter d’espace ou de caractère parasite.

3. Collez-la dans votre coffre-fort numérique sécurisé (ex. Bitwarden, KeePass, 1Password), avec un nom explicite :
   API_CFA_Atlas_<nom_du_CFA>_<date>.

4. Partagez la clé de manière sécurisée à la personne chargée de l’intégration technique dans Linkpick, via un canal chiffré (fonction “Send” de Bitwarden, lien à usage unique, ou outil interne sécurisé).
   
   

💡 Astuce : Ajoutez un rappel automatique dans votre agenda 11 mois après la date de génération, afin de planifier la rotation annuelle de la clé API et d'éviter toute coupure de service.

🔐 En cas de perte ou de mauvaise manipulation, vous devrez générer une nouvelle clé API, ce qui invalidera automatiquement l’ancienne.

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

Une fois la clé API CFA Atlas générée et sauvegardée dans votre coffre-fort numérique, il est temps de l’injecter dans votre logiciel de gestion. Si vous utilisez Linkpick, cette intégration est simple et rapide. Elle permet d’activer la communication automatisée entre votre CFA et l’OPCO Atlas, sans ressaisie manuelle ni envoi par e-mail.

5.1 Paramétrer le connecteur OPCO Atlas dans Linkpick

Pour commencer, connectez-vous à votre interface administrateur Linkpick avec les droits nécessaires. Ensuite, suivez les étapes ci-dessous :

1. Accédez au menu Administration > Connecteurs OPCO.

2. Sélectionnez Atlas dans la liste déroulante.

3. Dans le champ Token, collez votre clé API CFA Atlas précédemment générée.

4. Cliquez sur Enregistrer.
   
   

⚠️ Vérifiez qu’il n’y a aucun espace parasite au début ou à la fin de la clé collée. Une simple espace peut rendre le token invalide et générer une erreur de type 401.

Une fois enregistré, le connecteur Atlas devient actif dans Linkpick. Il reste à tester la connexion pour s’assurer que le lien est bien établi avec les serveurs de l’OPCO.

5.2 Vérifier la connexion et transmettre un dossier test

Linkpick propose un bouton « Tester la connexion » pour s’assurer que l’API CFA Atlas est correctement reliée.

Voici la procédure de vérification :

1. Cliquez sur Tester la connexion dans la fiche du connecteur Atlas.

2. Si tout est configuré correctement, un message « Connexion réussie » s’affiche.

3. Créez ensuite un contrat d’apprentissage test (statut brouillon).

4. Utilisez l’option Transmettre OPCO.

5. Le contrat apparaît dans Historique > Transmissions OPCO avec l’étiquette « Envoyé Atlas ».
   
   

💡 Ce test de bout en bout permet de vérifier que l’interfaçage API fonctionne réellement et que les transmissions sont bien prises en compte par Atlas.

En cas d’échec de test ou d’erreur (401, 403…), il faudra revoir :

• La validité de la clé,

• L’adresse IP de sortie de votre réseau (si filtrée par Atlas),

• La présence d’un mandat de gestion actif pour le SIRET utilisé.

6. Sécuriser et renouveler votre clé API CFA Atlas

La clé API CFA Atlas est un identifiant unique qui ouvre l’accès à l’envoi automatisé de contrats et de documents vers l’OPCO. Elle agit comme un véritable mot de passe technique : si elle est compromise, expirée ou mal stockée, vos flux peuvent être bloqués sans préavis.

C’est pourquoi la sécurisation et la gestion du cycle de vie de cette clé API sont essentielles pour garantir la continuité de vos transmissions via Linkpick.

6.1 Bonnes pratiques RGPD et sécurité API

Pour rester en conformité avec le RGPD et éviter toute faille de sécurité, adoptez ces réflexes dès la génération de votre clé API CFA Atlas :

• Stockage sécurisé : dès sa création, la clé ne s’affiche qu’une seule fois. Elle doit être copiée immédiatement et sauvegardée dans un coffre-fort numérique (Bitwarden, KeePass, 1Password…).

• Accès restreint : limitez son accès aux seuls administrateurs SI autorisés. Toute consultation ou transmission doit être tracée dans un registre interne.

• Mise à jour du mandat de gestion : si votre mandat n’est pas à jour sur le portail Atlas, les échanges via API seront bloqués. Vérifiez systématiquement sa validité avant d’activer ou de renouveler une clé.

• Transmission sécurisée : si vous devez transmettre la clé à un prestataire ou à une autre personne autorisée, utilisez un canal chiffré à usage unique (fonction "Send" de Bitwarden, par exemple).
  
  

📌 Conseil : formalisez ces bonnes pratiques dans une procédure RGPD interne et formez les utilisateurs concernés à leur mise en œuvre.

6.2 Anticiper la rotation annuelle et prévenir les coupures

Même si la clé API CFA Atlas ne comporte pas de date d’expiration automatique, l’OPCO recommande fortement une rotation annuelle, notamment pour :

• Réduire les risques en cas de fuite, de changement de personnel ou d’accès non contrôlé.

• Repartir sur une base saine en synchronisant les droits et l’environnement SI.
  
  

Voici comment anticiper efficacement le renouvellement de votre clé :

• Planifiez une alerte 30 jours avant l’anniversaire de la clé, via votre outil de gestion (Notion, Outlook, Trello…).

• Informez votre prestataire technique ou éditeur logiciel (ex. Linkpick) en amont : cela permet une transition fluide entre l’ancienne et la nouvelle clé, sans interruption de flux.

• Testez la nouvelle clé dès son intégration via le bouton “Tester la connexion” dans Linkpick, puis réalisez une transmission Cerfa fictive pour valider l’interfaçage.
  
  

🔐 Enfin, pensez à maintenir la double authentification (2FA) activée sur les comptes administrateurs du portail Atlas. C’est une exigence de sécurité obligatoire depuis 2024.

7. FAQ sur l’API CFA Atlas

📌 La clé API CFA Atlas expire-t-elle automatiquement ?
Non, la clé n’expire pas automatiquement, mais pour garantir la sécurité des échanges et limiter les risques liés à la gestion des accès, Atlas recommande un renouvellement annuel. Cette rotation évite les oublis en cas de changement de personnel ou d’exposition accidentelle du jeton.

📌 Puis-je récupérer ma clé API CFA Atlas après l’avoir générée ?
Non. La clé API CFA Atlas ne s’affiche qu’une seule fois au moment de sa création. Elle doit impérativement être copiée, sauvegardée et sécurisée immédiatement. En cas de perte, une nouvelle génération sera nécessaire, ce qui invalidera automatiquement la précédente.

📌 Est-il possible d’avoir plusieurs clés API pour un même CFA ?
Non. Le système Atlas n’autorise qu’un seul token API actif par SIRET. Si vous générez une nouvelle clé, l’ancienne est automatiquement révoquée. Cette règle garantit la traçabilité des échanges et évite les doublons dans les flux de transmission.

📌 Combien de temps prend l’activation de l’API CFA Atlas ?
L’activation est quasi instantanée. Dès que la clé est collée dans votre logiciel de gestion (comme Linkpick) et que le test de connexion est validé, vous pouvez transmettre un premier contrat. Il est recommandé de vérifier cette transmission test dans les minutes qui suivent, via l’onglet « Historique des échanges OPCO ».

📌 Comment faire si mon CFA a plusieurs établissements ?
Si vous gérez plusieurs établissements avec des SIRET différents, vous devez générer une clé API CFA Atlas distincte pour chaque SIRET. Cela permet de sécuriser les flux, d’améliorer la traçabilité, et de limiter les impacts en cas de rotation ou de révocation d’un token.

8. Gagnez du temps avec Linkpick + API CFA Atlas

8.1 Automatisez vos flux, renforcez votre conformité

L’interfaçage entre Linkpick et l’API CFA Atlas transforme votre gestion administrative en un processus fluide et sécurisé. Chaque contrat transmis via l’API est tracé, horodaté, conforme RGPD, et traité plus rapidement par l’OPCO. Fini les imports manuels, les oublis de pièces jointes ou les erreurs de saisie.

Grâce à cette automatisation, vous bénéficiez de :

• ✅ Des transmissions en temps réel sans ressaisie

• ✅ Une visibilité complète sur le statut de vos envois OPCO

• ✅ Une réduction des délais de traitement par Atlas

• ✅ Une traçabilité complète pour vos audits Qualiopi
  
  

Avec Linkpick, tout est centralisé : contrats, relevés d’activité, signatures, échanges CFA/OPCO. L’API CFA Atlas s’intègre naturellement dans votre flux quotidien.

8.2 Réservez une démo gratuite de l’intégration API Atlas

Vous hésitez encore à activer l’API CFA Atlas ? Ou vous souhaitez simplement vérifier que votre infrastructure est prête ?

👉 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 : Tout savoir sur les OPCO : histoire et guide des opérateurs de compétences en 2024