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

ServiceAdresse
Authentificationhttps://mon.urssaf.fr/authentifier_dpae
Dépôthttps://depot.dpae-edi.urssaf.fr/deposer-dsn/1.0/
Liste des retourshttps://consultation.dpae-edi.urssaf.fr/lister-retours-flux/1.0/
Téléchargement d'un retourhttps://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 à 1 en XML (TST en texte), 120 pour 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

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.