Intégration API URSSAF
Nous développons votre connecteur URSSAF
« API URSSAF » désigne deux produits incompatibles : le catalogue open data d'open.urssaf.fr, et le dépôt machine-to-machine de la DPAE. Nous cadrons lequel vous voulez, puis nous livrons le connecteur. Pas les deux dans la même classe.
- Équipe produit senior
- connecteurs de données publiques en production
- du cadrage au monitoring
À quoi sert l'API URSSAF et comment l'intégrer dans un logiciel RH ou paie ?
L'URSSAF expose des APIs pour automatiser les déclarations sociales et accéder à des données statistiques sur l'emploi. L'API DPAE permet de soumettre la déclaration préalable à l'embauche directement depuis votre logiciel RH, sans connexion manuelle au portail, dès qu'un nouveau collaborateur est créé. Les données open data de l'URSSAF permettent d'enrichir une application avec des indicateurs d'emploi par secteur et région. On intègre ces APIs dans des SIRH, des logiciels de paie ou des outils de gestion du personnel pour automatiser les obligations déclaratives et réduire le risque d'oubli.
Ce que nos clients construisent sur l'API URSSAF
Module DPAE dans un SIRH
À la validation de l'embauche, dépôt machine-to-machine, stockage de l'accusé, relance si J-8 n'est pas couvert.
Tableau de bord territorial
DPAE agrégées et masse salariale par département, pour un réseau de franchises ou d'agences d'emploi. Aucun SIRET d'employeur dans ces jeux.
Étude de marché auto-entrepreneurs
Stock par NAF et département, pour un outil commercial B2B qui a besoin d'un ordre de grandeur, pas d'un fichier nominatif.
Audit de conformité éditeur paie
Comment vos clients déposent-ils encore la DPAE ? Si la réponse est « par mail », ils sont hors délai depuis 2022.
Ce que ça change dans votre produit RH ou étude
La technique au service d'un résultat mesurable : le bon produit cadré en une question, pas six semaines perdues.
Une question d'avant-vente, pas un client unique
« Vous voulez les stats, ou déposer la DPAE ? » Les URL ne se ressemblent pas. Un UrssafClient unique est une erreur d'architecture.
La DPAE n'est plus un PDF
Accusé d'enregistrement, certificat de conformité, accusé métier. C'est la différence entre un module embauche et une embauche conforme le jour J.
L'open data ne connaît pas vos clients
Les DPAE du catalogue sont agrégées par région. Aucun filtre « mes employeurs ». Promettre l'inverse est illégal, pas ambitieux.
L'attestation de vigilance est ailleurs
Elle ne sort pas d'open.urssaf.fr. Un SaaS privé qui la promet via l'open data promet quelque chose qui n'existe pas.
Comment nous livrons votre connecteur URSSAF
Cadrage
Open data ou DPAE, volume, délai légal J-8, repli vers le téléservice. On sépare les deux contrats avant d'écrire une ligne.
Développement
Deux connecteurs séparés. Open data : cache long, records ou exports. DPAE : secrets par dossier employeur, journal des accusés.
Recette
Rejeu sur vos jeux ou vos dossiers d'embauche, test du plafond records, test du repli si le SI DPAE est indisponible.
Monitoring
Fraîcheur des jeux open data, alertes sur rejet DPAE, horodatage des accusés. Vous voyez un dépôt manqué avant le contrôle Urssaf.
Ce que permettent les API URSSAF
- Catalogue open data
- 124 jeux sur Explore v2.1 : effectifs, masse salariale, auto-entrepreneurs, DPAE agrégées, procédures collectives France entière.
- ODSQL et exports
- Même mécanique Huwise que le BODACC : records pour une région, exports pour la France entière, attribution Urssaf / Licence ouverte.
- Dépôt DPAE machine-to-machine
- Authentification, dépôt, consultation des retours, téléchargement. Concentrateurs en 8443 sur dépôt / consultation / téléchargement.
- Convergence DSN
- Un éditeur déjà en DSN machine a un chemin. Un éditeur qui n'a jamais fait de DSN n'en a pas. L'email et le CFT sont morts depuis 2022.
Le vocabulaire des API URSSAF
- DPAE
- Déclaration préalable à l'embauche, obligatoire dans les 8 jours précédant l'embauche. La preuve de la date réelle sert aux contrôles. Un workflow qui dépose « quand RH a le temps » crée un risque Urssaf.
- open.urssaf.fr
- Le portail open data, Explore v2.1, 124 jeux agrégés. Aucun SIRET d'employeur. Utile à un observatoire, inutile à un dossier d'embauche.
- API DSN
- Le chemin vers lequel l'offre DPAE converge (GIP-MDS). Un éditeur déjà en DSN machine a une longueur d'avance. Un éditeur paie sans DSN part de zéro.
- Port 8443
- Concentrateurs de dépôt, consultation et téléchargement DPAE. Pas l'authentification. Un oubli de port casse uniquement certains clients, le pire diagnostic.
- Attestation de vigilance
- Elle ne sort pas de l'open data Urssaf. Elle circule notamment via API Entreprise, pour des administrations habilitées. Un SaaS privé n'y a pas accès par ce mot-clé.
- records vs exports
- Même piège Huwise que le BODACC. Un tableau de bord qui interroge à chaque affichage gaspille un plafond non documenté et ralentit tout le monde.
Les contraintes réelles des API URSSAF
Deux produits, deux contrats
Open data statistique d'un côté, dépôt DPAE de l'autre. Les traiter comme une seule intégration est l'erreur d'avant-vente de ce mot-clé (320 recherches).
L'open data est agrégé
« DPAE par région » n'est pas la DPAE de l'entreprise cliente. Aucun SIRET d'employeur. Un filtre « mes clients » est impossible, et le promettre est faux.
J-8 n'est pas une suggestion UX
La DPAE se dépose dans les 8 jours précédant l'embauche. Reporter le dépôt à la fin du workflow RH crée un risque de contrôle, pas un confort.
L'email DPAE est mort depuis 2022
Canal email arrêté le 1er juillet 2022, CFT à la fin 2022. Toute procédure interne « on envoie encore par mail » est déjà hors délai. L'API n'est pas un nice-to-have.
Open data URSSAF ou API DPAE ?
Deux systèmes derrière le même mot-clé. Le bon choix tient en une question d'avant-vente.
| Critère | Open data UrssafCatalogue Huwise | API DPAEDépôt embauche |
|---|---|---|
| Hôte | open.urssaf.fr | depot.dpae-edi.urssaf.fr |
| Accès | Ouvert, sans clé | Compte, logique DSN |
| Grain | Agrégats région / NAF | L'embauche d'un salarié |
| SIRET employeur | Absent des jeux publics | Au cœur du dépôt |
| Délai légal | Sans objet | 8 jours avant embauche |
| Repli | Dernier extract local | Téléservice officiel, pas l'email |
| Le bon cas | Observatoire, étude de marché | SIRH / logiciel de paie |
On ne les combine pas dans le même client. On les combine éventuellement dans le même produit, derrière deux connecteurs et deux clauses.
Ce que nous mesurons sur une intégration URSSAF
Les autres API publiques
Les briques que nous branchons le plus souvent à côté, une fois le produit Urssaf cadré.
URSSAFNous développons votre connecteur URSSAFCette page
API AdresseNormaliser l'adresse de l'établissement ou du salarié, code INSEE inclus.
Météo FranceVigilance et observations, sans rapport avec la DPAE : autre canal, autre secret.
SNCF & transportDéplacements salariés, quand le SIRH gère aussi le trajet, pas la déclaration.API Particulier
France Travail
DVF & cadastre
LegifranceNous développons votre connecteur Légifrance
API GéoOn combine URSSAF avec
La stack qui entoure Urssaf sur nos projets.
Intégration URSSAF : vos questions
D'abord trancher : stats open data, ou dépôt DPAE. Pour l'open data, un client Explore v2.1, cache long, records pour une région, exports pour la France, attribution Urssaf. Pour la DPAE, un connecteur séparé : authentification sur mon.urssaf.fr/authentifier_dpae, dépôt / consultation / téléchargement sur les hôtes dpae-edi (port 8443 hors auth), journal des accusés, rapprochement du salarié, repli vers le téléservice si l'API est down. Jamais d'email. Jamais les deux dans la même classe.
L'open data est gratuit. La DPAE est un projet d'éditeur paie / SIRH, pas un widget. Un tableau de bord territorial sur trois jeux est un chantier court. Un module DPAE avec accusés, rejets, J-8 et environnements sandbox / prod est un projet à part, plus long si vous n'avez jamais fait de DSN. Nous cadrons le produit et donnons une estimation ferme avant de commencer. L'attestation de vigilance, si elle apparaît dans le brief, est un autre produit (API Entreprise) et un autre contrat.
Non. Ni l'open data, ni l'API DPAE ne servent l'attestation de vigilance, ni le compte cotisant, ni les effectifs nominatifs. L'attestation circule notamment via API Entreprise, réservée aux administrations sous habilitation. Un SaaS privé qui promet « on récupère l'attestation Urssaf par l'API open data » promet quelque chose qui n'existe pas. Nous le disons à la première réunion. Nous le vérifions à la première réunion, avant toute estimation, pour ne pas vendre un flux qui n'existe pas.
L'open data décrit des agrégats (embauches par région, masse salariale, auto-entrepreneurs). L'API DPAE dépose la déclaration d'une embauche réelle, avec un accusé opposable. Les hôtes, l'auth, le grain, le RGPD et le repli n'ont rien en commun. Le mot-clé SEO les fusionne ; le contrat ne doit pas. C'est le tri commercial de cette page. Si le brief mélange les deux, on écrit deux connecteurs et deux clauses, ou on en retire un.
Non. Le canal email a été arrêté le 1er juillet 2022, le CFT à la fin 2022. Toute procédure interne qui « envoie encore la DPAE par mail » est hors délai depuis quatre ans. L'API, ou le téléservice officiel, sont les canaux restants. Pour un éditeur paie, ce n'est plus une option produit : c'est de la conformité. Pour un éditeur paie, le chantier DPAE est de la conformité, pas un nice-to-have à caler en fin de backlog.
Un projet d'intégration URSSAF ?
Parlons-en. 30 minutes pour cadrer le produit (open data ou DPAE), vérifier ce que chaque API permet vraiment et vous dire franchement ce qui est faisable.
Parler de mon projet URSSAF