1. Le rôle stratégique de l’API CFA Afdas et les bénéfices pour votre CFA

L’API CFA Afdas est la brique qui relie automatiquement votre logiciel de gestion, par exemple Linkpick, au système d’information de l’OPCO Afdas. Finies les feuilles Excel et les uploads manuels : grâce à un token API Afdas chiffré, vos contrats d’apprentissage, demandes de prise en charge et factures circulent sans ressaisie.

Pourquoi c’est déterminant ?

Le réseau API Convergence que déploient les OPCO depuis 2022 vise justement à réduire les frictions administratives entre CFA et financeurs ; Afdas fut l’un des premiers à proposer la clé API CFA Afdas – indispensable pour s’authentifier.

2. Les prérequis techniques pour activer l’API CFA Afdas avant de se lancer

Avant de cliquer sur « Générer ma clé », passez cette check‑list ; vous éviterez ainsi les échecs d’activation et les flux bloqués dès le premier jour.:

1. Compte administrateur Afdas : habilité au module « Partenaire numérique ».
   Seul ce rôle peut créer, révoquer ou consulter la clé API CFA Afdas.
   -> Centralisez les accès dans un coffre‑fort et désignez deux administrateurs pour la continuité de service.
   
   
   

2. Numéro SIRET valide ; il sera encodé dans la clé API CFA Afdas.
   Le SIRET est encapsulé dans le token ; une simple faute rendra la clé inutilisable (erreur 401 « Invalid CFA_KEY »).
   Copiez‑collez le SIRET depuis votre extrait K bis pour éviter les inversions de chiffres.
   
   
   

3. Gestionnaire SI identifié : c’est la personne qui collera la clé dans Linkpick.
   C’est la personne qui intégrera la clé dans Linkpick et assurera le suivi technique.
   Mentionnez son nom dans votre procédure interne afin de savoir qui contacter en cas de rotation de clé.
   
   
   

4. Gestionnaire de mots de passe prêt : la clé ne s’affiche qu’une fois.
   La clé API CFA Afdas ne s’affiche qu’une seule fois ; vous devez la sauvegarder immédiatement.
   Utilisez Bitwarden, KeePass ou un équivalent avec partage sécurisé entre les administrateurs.
   
   
   

5. Double authentification (2FA) activée
   Depuis 2024, Afdas refuse la génération de clé sans 2 FA par mesure de cybersécurité.
   Authenticator, OTP SMS ou clé FIDO 2 : choisissez la méthode la plus adaptée à vos équipes.
   
   

Pour un tutoriel complet sur comment récupérer la clé d'authentification Afdas : cliquez ici

🔐 Bon à savoir : la 2 FA protège votre espace « Partenaire numérique » contre les vols d’identifiants, mais elle n’est efficace que si chaque administrateur utilise un second facteur distinct (smartphone dédié ou clé physique).

Afdas impose la double authentification (2FA) pour les profils administrateurs depuis sa mise à jour 2024 ; activez‑la avant de poursuivre.

2.1 – Comptes utilisateurs et droits nécessaires pour l’API CFA Afdas

Seul un profil avec le rôle « Administrateur » dans le portail Afdas peut créer ou révoquer la clé API CFA Afdas. Afin d’éviter les blocages lors d’un départ salarié :

• Créez plutôt un compte générique (ex. api_admin@votre‑cfa.fr) et stockez‑en les accès dans votre coffre‑fort.

• Consignez les identifiants, la méthode 2 FA et la date de création dans votre registre de sécurité.

• Attribuez un rôle « Lecture seule » aux collaborateurs qui doivent simplement consulter les journaux API, jamais générer de clé.

2.2 – Numéro SIRET et autres données indispensables à l’API CFA Afdas

Le SIRET et l’e‑mail d’alerte sont embarqués dans le token API Afdas ; la plateforme valide ces champs à chaque requête. En cas d’incohérence :

• Le serveur renvoie une erreur 401 « Invalid CFA_KEY »,

• L’ensemble des transmissions est stoppé jusqu’à régénération de la clé.
  
  

Checklist de conformité :

1. SIRET : copiez‑collez depuis votre extrait K bis pour éviter les inversions.

2. E‑mail de contact : utilisez une adresse de groupe (ex. api-alertes@votre‑cfa.fr) afin que plusieurs personnes reçoivent les log d’échec.

3. Mandat de gestion : assurez‑vous qu’il est enregistré et à jour sur le portail Afdas ; un mandat expiré bloque l’activation de l’API CFA Afdas.
   
   

⚠️ Un SIRET multi‑sites ? Générer une clé API CFA Afdas spécifique à chaque établissement simplifie le suivi et limite l’impact d’une éventuelle révocation.

3. Créer ou activer votre accès administrateur afin d’utiliser l’API CFA Afdas

Pour générer la clé API CFA Afdas, vous devez d’abord disposer d’un compte Administrateur sur l’espace « Partenaire numérique » d’Afdas. La procédure, simple mais encadrée, garantit que seuls les acteurs habilités peuvent manipuler les jetons de sécurité.

Pourquoi un compte administrateur ?

Le rôle Administrateur concentre trois privilèges essentiels :

Bon réflexe : prévoyez deux administrateurs titulaires (titulaire + suppléant) pour assurer la continuité de service pendant les congés ou en cas de départ.

Étapes détaillées de création :

1. Accéder au portail
   Ouvrez « Partenaire Numérique » et cliquez sur « Première connexion ». Veillez à utiliser un navigateur récent (Chrome/Edge ≥ v115) pour éviter les alertes de compatibilité TLS.
   
   
   

2. Remplir le formulaire

   SIRET : saisi automatique du nom légal.

   Nom / prénom de l’administrateur.

   Adresse e‑mail professionnelle (évitez les Gmail/Yahoo).

   Fonction : sélectionnez « Responsable SI » ou « Direction CFA » — ces deux rôles sont prioritaires pour l’activation.

   Mot de passe : 12 caractères minimum + symbole.

   
   Astuce : Si vous optez pour un compte générique (api_admin@votre‑cfa.fr), définissez une règle de distribution afin que deux personnes reçoivent chaque courriel d’Afdas.
   
   
   

3. Confirmer la demande
   Un e‑mail automatique intitulé « Activation compte Partenaire numérique » est envoyé dans la minute. Cliquez sur « Activer mon compte » ; le lien reste valide 24 h.
   
   
   

4. Sécuriser par la double authentification (2FA)
   À la première connexion, le portail déclenche l’assistant 2FA :
   Application OTP (Google Authenticator, Microsoft Authenticator, FreeOTP…) recommandée : scannez le QR code, saisissez le code à 6 chiffres.

   SMS possible mais déconseillé (risque de SIM‑swap).

   Clé FIDO2 acceptée si votre organisation dispose de tokens physiques.

   
   Pensez à télécharger les codes de secours ; ils sont nécessaires si votre téléphone est perdu ou réinitialisé.
   
   
   

5. Validation par Afdas
   Le service « Appui régulation » vérifie les informations déclarées (SIRET actif, mandat de gestion, cohérence de la fonction). Le délai moyen est de moins de 24 h ; un courriel de confirmation « Accès administrateur validé » marque la fin du processus.
   
   
   

6. Vérifier la présence du menu “API Convergence”
   Une fois connecté, ouvrez la barre latérale. Vous devez voir “API Convergence” → “Gérer mes clés”.
   Si le menu n’apparaît pas :
   Videz le cache navigateur puis reconnectez‑vous ;

   Si le problème persiste, contactez immédiatement votre chargé d’appui régulation Afdas (coordonnées dans l’e‑mail de validation).

En suivant ces étapes, vous disposerez d’un accès administrateur pleinement opérationnel, prêt à générer la clé API CFA Afdas et à lancer l’intégration dans Linkpick sans accroc.

📄 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 pas à pas votre clé API CFA Afdas

4.1 – Bouton “Générer” : alerte de remplacement de la clé API CFA Afdas

Dans API Convergence > Gérer mes clés, cliquez sur Générer ma clé. Afdas affiche un message d’avertissement :

« Cette opération révoque définitivement votre clé actuelle. Assurez‑vous qu’aucun service n’utilise encore l’ancienne clé. »

C’est ici que beaucoup de CFA se trompent : ils génèrent une nouvelle clé API CFA Afdas sans prévenir leur éditeur de SI, ce qui stoppe net les flux. D’où la nécessité d’un calendrier de rotation coordonné.

4.2 – Copier et stocker en toute sécurité la nouvelle clé API CFA Afdas

Une fois la génération confirmée, la clé API CFA Afdas (chaîne alphanumérique de 32 caractères) s’affiche dans une fenêtre modale — c’est votre unique occasion de la capturer :

1. Copier → sélectionnez la clé et copiez‑la dans le presse‑papiers sans laisser d’espace en début ou fin de chaîne.

2. Coller → ouvrez immédiatement votre coffre‑fort d’entreprise (Bitwarden, KeePass, 1Password…) et enregistrez la clé dans une entrée nommée : CFA‑Afdas_API_Key_<AAAA‑MM‑JJ>. Activez le champ « Masquer les caractères ».

3. Transmettre → partagez la clé avec le gestionnaire SI via un canal chiffré (fonction « Send » de Bitwarden, lien à usage unique, ou messagerie interne E2E).
   
   

❗ La clé API CFA Afdas s’affiche une seule fois ; toute perte oblige à en générer une nouvelle, ce qui invalide instantanément la précédente et stoppe les flux vers Afdas. Planifiez donc chaque régénération avec votre équipe SI pour éviter une interruption de service.

5. Intégrer la clé API CFA Afdas dans Linkpick et vérifier immédiatement la connexion`

Une fois votre jeton généré et sécurisé, il faut l’injecter dans Linkpick pour activer le canal automatique vers l’OPCO. L’opération se fait entièrement depuis l’interface web du logiciel ; comptez moins de deux minutes.

H3 5.1 – Étapes pas à pas pour ajouter la clé API CFA Afdas

1. Ouvrir : Administration › Connecteurs OPCO.

2. Choisir Afdas : la fiche de paramétrage s’affiche (statut Inactif par défaut).

3. Coller la clé : dans le champ Token, collez la clé API CFA Afdas copiée depuis votre coffre‑fort, sans espace parasite.

4. Sauvegarder : cliquez Enregistrer pour activer le bouton de test.

5.2 – Vérifier la connexion et envoyer un contrat test via l’API CFA Afdas

1. Cliquez Tester la connexion. Linkpick envoie une requête ping à l’API Convergence.

2. Message vert « Connexion réussie » : l’interfaçage est opérationnel.

3. Créez un contrat fictif (statut Brouillon) puis déclenchez Transmettre OPCO ; le dossier apparaît en quelques minutes dans votre journal Historique › Transmissions OPCO.

4. Conservez l’accusé de réception Afdas pour vos audits Qualiopi.

5.3 – Dépanner rapidement la clé API CFA Afdas dans Linkpick

• Erreur 401 / 403 ? Vérifiez qu’aucun espace ne précède ou ne suit le token.

• Test KO ? Assurez‑vous que l’IP publique de Linkpick est autorisée par votre pare‑feu sortant.

• Toujours bloqué ? Contactez le support Afdas au 01 44 78 38 28 en précisant votre SIRET, la date de génération et le libellé exact de l’erreur.

5.4 – Bonnes pratiques post‑intégration de l’API CFA Afdas

• Planifier la rotation : créez une alerte Linkpick 30 jours avant la date anniversaire de la clé API CFA Afdas.

• Surveiller les journaux : exportez chaque trimestre le log Transmissions OPCO pour votre registre RGPD.

• Former les équipes : partagez la vidéo de paramétrage et le protocole de dépannage afin qu’un remplaçant puisse reprendre la main sans délai.
  
  

En suivant ces quatre sous‑étapes, votre API CFA Afdas fonctionne de bout en bout : chaque Cerfa ou avenant validé dans Linkpick est expédié automatiquement à Afdas, sans ressaisie ni risque d’erreur.

6. Sécuriser et renouveler votre clé API CFA Afdas pour une conformité durable

La clé API CFA Afdas donne accès à des données sensibles et à des flux critiques. Il est donc essentiel de la gérer comme un identifiant de sécurité à part entière.

6.1 – Bonnes pratiques RGPD autour de l’API CFA Afdas

Dès sa création, la clé API doit être sauvegardée dans un coffre‑fort numérique sécurisé. Son accès doit être limité aux administrateurs SI autorisés, et tracé dans votre registre RGPD.

Il est recommandé de la renouveler au moins une fois par an, ou à chaque changement de responsable SI. Pensez aussi à vérifier régulièrement que votre mandat de gestion Afdas est bien à jour pour garantir la continuité du service.

Enfin, auditez les accès à votre coffre-fort de manière trimestrielle et mettez à jour votre procédure interne à chaque régénération de clé.

6.2 – Mettre en place la double authentification et la rotation annuelle de la clé API CFA Afdas

Depuis 2024, Afdas impose la double authentification (2FA) pour tous les comptes administrateurs. Activez-la dès la création de votre compte via une application OTP (Google Authenticator, FreeOTP, etc.).

Pensez également à planifier une alerte 30 jours avant la date de renouvellement de votre clé API CFA Afdas. Cela vous permet d’éviter toute coupure de service.

Enfin, informez votre contact chez Linkpick au moment du renouvellement : l’intégration d’une nouvelle clé prend moins de 5 minutes et peut être réalisée sans interrompre les flux en cours.

7. FAQ : Les réponses clés à propos de l’API CFA Afdas

La clé API CFA Afdas expire‑t‑elle automatiquement ?

Non, la clé ne possède pas de date d’expiration intégrée. Cela dit, Afdas recommande vivement de la renouveler chaque année par mesure de sécurité. Cette rotation régulière permet de limiter les risques liés à l’usage prolongé d’un même jeton, notamment en cas de changement de personnel ou de faille potentielle.

Puis‑je récupérer la clé API CFA Afdas après sa création ?

Non. Pour des raisons de sécurité, la clé n’est affichée qu’une seule fois, immédiatement après sa génération. Si vous ne l’avez pas copiée ou si elle a été perdue, vous devrez en générer une nouvelle, ce qui révoquera automatiquement l’ancienne.

Est‑il possible d’avoir plusieurs clés actives pour un même CFA ?

Non, le système Afdas autorise une seule clé API active par numéro de SIRET. Si vous tentez d’en créer une nouvelle, l’ancienne sera automatiquement désactivée. Il est donc essentiel de coordonner la régénération avec l’équipe SI et les utilisateurs de Linkpick pour éviter toute interruption de service.

Combien de temps prend l’activation de la clé API CFA Afdas côté Afdas ?

L’activation est quasi immédiate. Une fois la clé collée dans Linkpick et la connexion testée, vous pouvez envoyer un premier contrat pour vérifier que le flux est bien actif. La bonne réception par Afdas confirme que la clé API CFA Afdas est fonctionnelle. Aucune étape de validation manuelle n’est requise à ce stade. 

8. Demandez votre démo Linkpick et maîtrisez l’API CFA Afdas

Vous souhaitez sécuriser vos flux, gagner du temps et accélérer vos remboursements ?


👉 Réservez une démo gratuite de 15 minutes : nos experts vous montrent comment Linkpick s’appuie sur votre API CFA Afdas pour automatiser chaque contrat et générer les relevés d’activité sans effort.

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