Accueil › Guides › API DPAE de l'Urssaf
L'API DPAE de l'Urssaf : services, format, dépôt d'essai et retours
Par Etienne Bourrinet, président de SASU EBO, qui fait lui-même sa paie et ses DSN. Mis à jour le 20 novembre 2026.
En bref : l'API DPAE fonctionne comme l'API DSN : un jeton d'authentification, un dépôt de fichier compressé, puis la consultation des retours. Seules l'authentification et les adresses changent.
Le principe
D'après la note officielle de l'Urssaf sur l'API DPAE : « Seules les données d'authentification et les adresses web services changent pour transmettre une DPAE », et « Les formats de fichier de la DPAE (Déclaration, accusé de réception métier et bis) n'évoluent pas ».
Les adresses
| Service | Adresse |
|---|---|
| Authentification | https://mon.urssaf.fr/authentifier_dpae |
| Dépôt | https://depot.dpae-edi.urssaf.fr/deposer-dsn/1.0/ |
| Liste des retours | https://consultation.dpae-edi.urssaf.fr/lister-retours-flux/1.0/ |
| Téléchargement d'un retour | https://telechargement.dpae-edi.urssaf.fr/telecharger-retour/1.0/ |
Selon le guide d'implémentation, les concentrateurs ajoutent le port 8443 aux adresses de dépôt, de consultation et de téléchargement (pas à l'authentification).
Déclarant ou concentrateur
- Service 25 : l'entreprise ou le tiers déclarant, avec les identifiants de son espace en ligne de l'Urssaf (SIRET, nom, prénom, mot de passe). « L'API DPAE ne nécessite pas d'inscription spécifique. »
- Service 98 : le concentrateur (un éditeur qui dépose pour ses clients). Il s'inscrit par courriel à api-dpae@acoss.fr, objet « Inscription Concentrateur », même s'il est déjà inscrit à l'API DSN.
Le fichier
- Format XML (schéma DUE_Upload.xsd et exemples) ou texte à plat (format texte).
- Plusieurs embauches d'un même établissement par fichier ; 100 Mo au plus par dépôt ; « Seule la DPAE en anomalie est rejetée ».
- Dépôt d'essai sur le service réel : indicateur de test à
1en XML (TSTen texte),120pour un dépôt réel.
Les retours
- Codes 10 et 11 : comme en DSN (accusé de réception électronique ou avis de rejet ; certificat de conformité ou bilan d'anomalies).
- Code 20 : bilan d'identification du salarié (BIS), en cas de divergence avec le Système national de gestion des identifiants.
- Code 41 : accusé de réception de la DPAE, aussi appelé certificat de conformité.
Avec Cerfaless
Cerfaless produit le fichier XML de la DPAE au format officiel, vérifié contre le schéma de l'Urssaf, et prépare le dépôt par cette API. Pour l'utiliser dès maintenant dans ChatGPT ou Claude : le connecteur gratuit https://cerfaless.fr/mcp/dpae.
Questions fréquentes
Faut-il s'inscrire pour utiliser l'API DPAE ?
Non pour une entreprise ou un tiers déclarant : il suffit d'un abonné à un service en ligne de l'Urssaf. Un concentrateur doit s'inscrire par courriel à api-dpae@acoss.fr.
Comment faire un dépôt de test ?
Sur le service réel, avec l'indicateur de test à 1 dans le fichier XML (TST dans le format texte) ; 120 correspond à un dépôt réel.
Sources
- due.urssaf.fr : format XML de la DPAE (schéma DUE_Upload.xsd et exemples)
- due.urssaf.fr : format texte de la DPAE
- net-entreprises.fr : la DPAE sur net-entreprises (formulaire en ligne, dépôt de fichier)
- net-entreprises.fr : API DSN (même fonctionnement)
La DPAE depuis la conversation.
Le connecteur gratuit Cerfaless DPAE prépare la déclaration, calcule le délai et vérifie chaque mention, dans ChatGPT ou Claude.