Guide technique — Avril 2026

Import CSV : le guide technique complet

Le contrat d'interface de la Caisse des Dépôts décortiqué : encodage, séparateur, colonnes, identifiants, statuts de traitement. Vérificateur et générateur intégrés.

Spécifications techniques 2 outils intégrés ~12 min de lecture Gratuit

Sommaire

1 Spécifications du contrat d'interface

Le contrat d'interface de la Caisse des Dépôts impose des règles strictes. Un seul paramètre non conforme et le fichier est rejeté en totalité.

Paramètre Règle Justification
Format CSV exclusif Standardisation et légèreté des transferts
Encodage UTF-8 obligatoire Préservation des accents et caractères français (é, à, ç)
Séparateur Pipe | Évite les corruptions liées aux virgules ou points-virgules dans les titres
Taille max 200 Mo Permet ~1 million de titulaires par import
Nom de fichier Max 200 car., pas de @ < > : / \ | ? * % Prévention des vulnérabilités d'injection
Stagiaires/déclaration Max 500 par ID_DECLARATION Optimisation du batch processing de la CDC

2 Structure du fichier CSV

Le fichier est composé d'une ligne d'en-tête (noms de colonnes) suivie des lignes de données. Chaque ligne représente un stagiaire pour une session de formation.

Exemple ADF (Attestation de Formation)

# En-tete (10 colonnes ADF) ID_DECLARATION|ID_UNIQUE_PARTENAIRE|NIR|NOM_NAISSANCE|PRENOM|DATE_DEBUT_FORMATION|DATE_FIN_FORMATION|INTITULE_FORMATION|DOMAINE_FORMACODE|CODE_ROME # Ligne de donnees DECL-2026-001|DECL-2026-001-001|1850775115042|MARTIN|Pierre|2026-06-10|2026-06-12|Sensibilisation risques chimiques|42884|H1301

Exemple JDR (Justificatif de Réussite)

# En-tete (15 colonnes JDR = 10 ADF + 5 supplementaires) ID_DECLARATION|...|CODE_ROME|DATE_DEBUT_VALIDITE|DATE_FIN_VALIDITE|CODE_RNCP_RS|MODALITE_EVALUATION|TYPE_JUSTIFICATIF # Ligne de donnees (CACES R489) DECL-2026-002|DECL-2026-002-001|2900169200132|DURAND|Sophie|2026-07-01|2026-07-03|CACES R489 Cat 3|31795|N1101|2026-07-03|2031-07-03||Test pratique et theorique|Certificat
Les fichiers ADF et JDR sont des fichiers séparés. Ne mélangez pas les deux dans un même fichier. Si vous avez des formations de type ADF et d'autres de type JDR, générez deux fichiers distincts.

3 Colonnes ADF vs JDR

L'ADF (Attestation de Formation) confirme la participation complète du travailleur. Le JDR (Justificatif de Réussite) valide l'acquisition de compétences évaluées et exige 5 colonnes supplémentaires.

Colonne Type Description
ID_DECLARATION Alphanum. (255) Identifiant unique de la session globale
ID_UNIQUE_PARTENAIRE Alphanum. (255) Clé primaire : 1 stagiaire + 1 session = 1 ID unique
NIR 13 chiffres Numéro de sécurité sociale (extrait DSN)
NOM_NAISSANCE Texte Nom de naissance (pas nom d'usage, pas nom marital)
PRENOM Texte Prénom du stagiaire
DATE_DEBUT_FORMATION AAAA-MM-JJ Premier jour de la session
DATE_FIN_FORMATION AAAA-MM-JJ Dernier jour de la session
INTITULE_FORMATION Texte Nom complet de la formation
DOMAINE_FORMACODE Code Code Formacode du domaine SST (référentiel CDC)
CODE_ROME Code Code ROME du métier concerné
DATE_DEBUT_VALIDITE AAAA-MM-JJ Début de validité du justificatif (souvent = date fin formation)
DATE_FIN_VALIDITE AAAA-MM-JJ Fin de validité (ex : +5 ans pour un CACES)
CODE_RNCP_RS Texte Référence RNCP ou RS (ex : RS5801 pour SST)
MODALITE_EVALUATION Texte Test pratique, théorique, mise en situation...
TYPE_JUSTIFICATIF Texte Certificat, Habilitation, Certification RNCP, Diplôme

Pour choisir entre ADF et JDR : ADF vs JDR : quelle preuve déclarer ?

4 ID_DECLARATION et ID_UNIQUE_PARTENAIRE

Ces deux identifiants sont générés par l'émetteur (vous) et garantissent la cohérence de la base de données :

ID_DECLARATION

Identifie une session de formation. Si 50 stagiaires ont participé à la même session, les 50 lignes partagent le même ID_DECLARATION. Max 255 caractères.

# Exemple CACES-R489-20260610-SITE-LYON

ID_UNIQUE_PARTENAIRE

Clé primaire de la ligne. Identifie la participation d'un stagiaire précis à une session. Doit être unique dans tout le fichier. Sert de référence en cas de rectification.

# Exemple CACES-R489-20260610-SITE-LYON-001
L'ID_UNIQUE_PARTENAIRE empêche les doublons : un employeur ne peut pas déclarer deux fois la même personne pour la même session. En cas de rectification ultérieure, c'est cet identifiant qui permet de retrouver la ligne à corriger.

5 Flux de traitement après dépôt

Après le téléversement du fichier sur le portail, la plateforme effectue un traitement asynchrone en deux phases :

Dépôt du fichier
Vérification structurelle
Vérification sémantique
Statut final

Phase 1 : vérification structurelle

Le système contrôle le format brut du fichier : présence de virus, encodage, séparateur, nombre de colonnes. En cas d'erreur, le fichier est rejeté complètement (aucune ligne n'est traitée).

Phase 2 : vérification sémantique

Le moteur d'intégration contrôle la validité des données : cohérence des NIR, exactitude des codes RNCP/ROME, unicité des ID. Le rejet partiel est possible : seules les lignes en erreur sont rejetées, les autres sont intégrées.

Les 4 statuts de traitement

En cours d'intégration

Le fichier est en cours de traitement par les serveurs de la CDC.

Traité avec succès

Toutes les lignes intégrées. Les formations apparaîtront dans le passeport des travailleurs.

Traité avec erreurs

Rejet partiel. Certaines lignes en erreur, les autres intégrées. Téléchargez le rapport.

Rejeté

Rejet complet. Problème structurel (format, encodage, séparateur). Aucune donnée intégrée.

7 Erreurs fréquentes et solutions

Rejet complet : mauvais séparateur
Solution : Le fichier utilise une virgule ou un point-virgule. Remplacez par le pipe (|). Dans Excel : "Enregistrer sous" > CSV UTF-8, puis ouvrez dans un éditeur de texte et remplacez le ; par |.
Rejet complet : encodage non UTF-8
Solution : Ouvrez le fichier dans Notepad++ ou VS Code. "Encodage" > "Convertir en UTF-8". Ré-enregistrez.
Rejet partiel : NIR invalide
Solution : Le NIR doit être exactement 13 chiffres (sans la clé à 2 chiffres, sans espaces). Vérifiez dans la DSN (bloc S21.G00.30). Utilisez le nom de naissance, pas le nom d'usage.
Rejet partiel : ID_UNIQUE_PARTENAIRE en doublon
Solution : Chaque ligne doit avoir un identifiant unique. Si vous avez copié-collé des lignes, assurez-vous de modifier l'ID pour chaque stagiaire.
Rejet partiel : dates incohérentes
Solution : Le format attendu est AAAA-MM-JJ (ex : 2026-06-15). Vérifiez que la date de début n'est pas postérieure à la date de fin.
Nom de fichier rejeté
Solution : Pas de caractères spéciaux dans le nom (@, <, >, :, /, \, |, ?, *, %). Maximum 200 caractères. Renommez simplement le fichier.

Articles liés

Tutoriel déclaration

Pas à pas sur Net-entreprises

Collecte données RH

NIR, DSN, nettoyage SIRH

Checklist SIRH

20 points de vérification

8 Questions fréquentes

La fonctionnalité d'import CSV est prévue pour le 9 juillet 2026. Avant cette date, seule la saisie manuelle est possible pour les employeurs. Les organismes de formation y ont accès depuis avril 2025.

Non. Les fichiers ADF et JDR doivent être séparés car ils n'ont pas le même nombre de colonnes. Le système rejettera un fichier mélangeant les deux types.

Pas directement. Excel exporte en CSV avec des virgules ou des points-virgules. Vous devez ensuite remplacer le séparateur par un pipe (|) et vérifier l'encodage UTF-8. Notre générateur évite cette manipulation.

Téléchargez le rapport d'erreurs depuis l'onglet "Mes dépôts". Chaque ligne en erreur est identifiée. Corrigez les données dans votre SIRH puis re-soumettez uniquement les lignes corrigées.

L'upload s'effectue via le portail sécurisé Net-entreprises avec authentification. Le traitement du NIR est autorisé par le décret n° 2023-1073 du 20 novembre 2023 dans le cadre exclusif du passeport de prévention.
Dashboard Conformité gratuit

Arrêtez de suivre vos habilitations dans un tableur.
Utilisez notre dashboard.

Centralisez les habilitations SST de vos salariés, recevez des alertes avant chaque expiration, et calculez automatiquement vos dates limites de déclaration à la Caisse des Dépôts.

  • Gratuit jusqu'à 20 salariés
  • Référentiel SST & CACES pré-chargé
  • Calcul des échéances automatisé
  • Export CSV
Sans engagement
0 € / mois
Découvrir le dashboard
Démo + tarifs + FAQ en une page
Dashboard Conformité

Pilotez la conformité de vos salariés au Passeport de Prévention : suivi des habilitations, alertes, échéances et exports.

Gratuit jusqu'à 20 salariés Référentiel SST pré-chargé Calcul automatique des échéances
Découvrir le dashboard Créer mon compte direct →
Outils du portail
À lire aussi