# dpae.r3m.fr

> L'API JSON dpae.r3m.fr permet à votre application de transmettre à l'URSSAF vos déclarations préalables à l'embauche (DPAE) de manière automatisée et sécurisée.

Points clés :

- Authentification : `POST /api/login_check` avec `username`/`password` renvoie un `token` JWT valable 30 jours, à transmettre dans `Authorization: Bearer <JWT>`. Réutiliser le jeton ; le renouveler sur une réponse `401`.
- Déclaration : `POST /api/embauches` avec les données employeur, salarié et contrat. Une DPAE est générée et transmise à l'URSSAF de façon asynchrone (de quelques minutes à quelques heures).
- Résultat : quand l'accusé de réception URSSAF arrive, l'API appelle votre webhook (action `embauche.declaree`) en `POST` avec l'embauche au format JSON. Le statut est dans `dpae.codeRetourAr` : seuls `00` et `98` sont des succès ; sinon, corriger les données et créer une nouvelle embauche.
- Webhook : répondre en `2xx` ; sinon jusqu'à 10 nouvelles tentatives (délai croissant, plafonné à 1 h, `Retry-After` respecté). Si le webhook a un `secret`, vérifier l'en-tête `X-Dpae-Signature: sha1=<sha1(corps brut + secret)>`.
- Mode test : par défaut, aucune donnée n'est transmise à l'URSSAF ; le passage en production se fait sur demande.
- Pagination : 30 éléments par page, paramètre `page`, non configurable.
- Erreurs : codes HTTP standards ; `422` détaille les erreurs dans `violations` (`propertyPath`, `message`).
- `codeCentreMedecineTravail` : code du service santé du siège social, [liste URSSAF](https://www2.due.urssaf.fr/declarant/jasperServlet) (`MT999` si le centre est interne).

## Documentation

- [Documentation interactive (Scalar)](https://dpae.r3m.fr/api/docs): guide complet (authentification, mode test, pagination, erreurs, codes retours URSSAF, webhooks)
- [Spécification OpenAPI 3.1.0 (JSON)](https://dpae.r3m.fr/api/docs.jsonopenapi): référence complète des opérations, schémas et exemples
- [Spécification OpenAPI 3.1.0 (YAML)](https://dpae.r3m.fr/api/docs.yamlopenapi): même contenu au format YAML

## Authentification

- [POST /api/login_check](https://dpae.r3m.fr/api/docs#tag/authentification/POST/api/login_check): Obtenir un jeton

## Embauche

- [GET /api/embauches/{id}](https://dpae.r3m.fr/api/docs#tag/embauche/GET/api/embauches/{id}): Détail d'une embauche
- [GET /api/embauches](https://dpae.r3m.fr/api/docs#tag/embauche/GET/api/embauches): Liste des embauches
- [POST /api/embauches](https://dpae.r3m.fr/api/docs#tag/embauche/POST/api/embauches): Soumettre une embauche

## Webhook

- [GET /api/webhooks/{id}](https://dpae.r3m.fr/api/docs#tag/webhook/GET/api/webhooks/{id}): Détail d'un webhook
- [PUT /api/webhooks/{id}](https://dpae.r3m.fr/api/docs#tag/webhook/PUT/api/webhooks/{id}): Modifier un webhook
- [DELETE /api/webhooks/{id}](https://dpae.r3m.fr/api/docs#tag/webhook/DELETE/api/webhooks/{id}): Supprimer un webhook
- [GET /api/webhooks](https://dpae.r3m.fr/api/docs#tag/webhook/GET/api/webhooks): Liste des webhooks
- [POST /api/webhooks](https://dpae.r3m.fr/api/docs#tag/webhook/POST/api/webhooks): Créer un webhook

## Notifications sortantes

- [embauche.declaree](https://dpae.r3m.fr/api/docs): Embauche déclarée (requête `POST` envoyée par l'API vers l'URL de votre webhook)