PrevenAPI

L'API des fichiers d'import Passeport de prévention

Intégrez la génération et la validation des fichiers d'import en masse directement dans votre logiciel RH, votre LMS ou votre outil de gestion de formation.

Obtenir une clé APIVoir la documentation

Clés de test gratuites, sans carte bancaire. Règles issues des guides officiels du 27/02/2026.

POST https://api.prevenapi.fr/v1/files/generate
# vos données
{
  "type": "adf", "declarant": "employer",
  "declarations": [{
    "id": "SST_2025_07",
    "training": { "name": "Sauveteur secouriste du travail",
                  "start_date": "2025-07-22", … },
    "holders": [{ "nir": "1880375…", "birth_name": "DUPONT", … }]
  }]
}
# le fichier attendu par le portail
ID_DECLARATION|REFERENCE_DECLARATION|ID_UNIQUE_PARTENAIRE|…
SST_2025_07|SESSION_JUILLET|SST-0001|Sauveteur secouriste du
travail|22/07/2025|25/07/2025|PRESENTIEL|…|DUPONT||||25/07/2025

Ce que fait l'API

Une couche entre vos données et le portail : elle produit le fichier, ou vérifie le vôtre. Elle ne se connecte jamais au portail officiel.

Générer

Transformez vos données RH en fichier conforme : séparateur, encodage, ordre des colonnes, dates, champs conditionnels.

Valider

Détectez les erreurs avant le dépôt, ligne par ligne et champ par champ, avec des codes d'erreur stables.

Intégrer

Une API REST simple pour vos logiciels RH et LMS : JSON en entrée, clé de test gratuite, exemples Python et JavaScript.

À jour

Les règles suivent les spécifications officielles. Chaque fichier indique la version appliquée ; les référentiels sont rafraîchis chaque nuit.

Les quatre fichiers officiels

Les colonnes dépendent du type de déclaration, les champs obligatoires du déclarant. L'API applique le bon contrat dans chaque cas.

FichierDéclarantColonnesExemples de règles propres
Attestations de formationEmployeur20Colonnes employeur laissées vides, compétences ROME facultatives
Attestations de formationOrganisme de formation203 à 10 compétences ROME, SIRET de l'employeur si convention
Justificatifs de réussiteEmployeur29Bloc formation entièrement vide ou entièrement renseigné
Justificatifs de réussiteOrganisme de formation29Code de certification obligatoire si la formation est certifiante

Ce qui est vérifié, et ce qui ne peut pas l'être

Un contrôle avant dépôt réduit les rejets. Il ne remplace pas ceux que seul le portail peut faire.

Vérifié par PrevenAPI

  • Encodage UTF-8, séparateur, en-têtes et leur ordre, nom du fichier
  • Champs obligatoires, conditionnels, et ceux qui doivent rester vides
  • Dates, longueurs, valeurs autorisées, NIR à 13 caractères, clé du SIRET
  • Formacodes, codes NSF, compétences ROME et certifications RS
  • Doublons, cohérence d'une déclaration, 500 titulaires au plus

Vérifié seulement par le portail

  • La reconnaissance du couple NIR et nom de naissance
  • L'existence réelle du SIRET de l'employeur
  • Un identifiant déjà utilisé lors d'un dépôt précédent

Un fichier valide chez nous peut donc encore voir des lignes refusées pour ces trois raisons.

Données des salariés

Le service traite des NIR. Il est conçu pour en garder le moins possible, le moins longtemps possible.

Rien en base

Aucune donnée de titulaire n'est enregistrée en base. Un fichier envoyé pour contrôle est analysé en mémoire.

24 heures au plus

Les fichiers générés sont chiffrés, puis supprimés automatiquement. Vous pouvez demander qu'aucun ne soit conservé.

Journaux sans NIR

Ni contenu, ni nom, ni numéro dans les journaux. L'assistance se fait avec un identifiant de requête.

Accord de sous-traitance

Accepté à l'inscription, conforme à l'article 28 du RGPD. Lire l'accord

Tarifs

Une déclaration correspond à un titulaire dans un fichier. Quota atteint : les appels sont refusés jusqu'au mois suivant, sans facturation au dépassement.

Free

0 € / mois

100 déclarations par mois
30 requêtes par minute

Starter

9 € / mois

2 000 déclarations par mois
60 requêtes par minute

Pro

29 € / mois

10 000 déclarations par mois
300 requêtes par minute

Business

79 € / mois

50 000 déclarations par mois
600 requêtes par minute

TVA non applicable, article 293 B du Code général des impôts. Service réservé aux professionnels. Les clés de test ne sont jamais comptées.

Essayez avec une clé de test

Création du compte en une minute. Le quickstart tient en trois appels.

Obtenir une clé APILire le quickstart