Transmettre les mouvements de population
const url = 'https://passerelle.teneur.exemple/v1/entreprises/example/transmissions';const options = { method: 'POST', headers: { 'Idempotency-Key': 'example', 'Correlation-Id': 'example', Authorization: 'Bearer <token>', 'Content-Type': 'application/json' }, body: '{"arretee_le":"2026-04-15","mouvements":[{"matricule":"example","action":"ENTREE","date_effet":"2026-04-15","type_activite":"example","etablissement":"example","motif_sortie":"example"}],"reference_du_teneur":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://passerelle.teneur.exemple/v1/entreprises/example/transmissions \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'Correlation-Id: example' \ --header 'Idempotency-Key: example' \ --data '{ "arretee_le": "2026-04-15", "mouvements": [ { "matricule": "example", "action": "ENTREE", "date_effet": "2026-04-15", "type_activite": "example", "etablissement": "example", "motif_sortie": "example" } ], "reference_du_teneur": "example" }'La transmission est prise en compte, elle n’est pas appliquée : elle est contrôlée, et ses écarts sont rendus par la ressource que Location désigne.
Autorisations
Section intitulée « Autorisations »Paramètres
Section intitulée « Paramètres »Paramètres (path)
Section intitulée « Paramètres (path) »L’identifiant publié de l’entreprise chez ce teneur de compte. Il désigne la ressource ; un identifiant d’entreprise dans une URL ne vaut jamais autorisation.
Paramètres (header)
Section intitulée « Paramètres (header) »La clé d’idempotence de l’écriture, choisie par l’appelant. Un serveur tiers réessaie : deux envois de la même clé produisent un effet. Le rejeu à charge identique rend la réponse d’origine ; le rejeu à charge différente est refusé.
L’identifiant que le teneur de compte donne à l’échange dans son journal. Obligatoire : notre trace dit qui a lu quoi, jamais pour qui, et ce champ est la seule jointure entre les deux journaux. Il est restitué dans la réponse.
Corps de la requêterequired
Section intitulée « Corps de la requêterequired »object
La date à laquelle l’entreprise a arrêté ces mouvements.
Les mouvements de la période. Au-delà de la borne, la transmission se découpe : une écriture partenaires reste une écriture, pas un transfert de fichier.
object
L’entrée d’une personne dans l’entreprise, sa sortie, ou sa mise à disposition auprès d’une autre entreprise du périmètre.
La raison pour laquelle la relation de travail est déclarée terminée — dont la retraite et la préretraite. C’est une qualification du départ dans cette entreprise, jamais une qualité universelle de la personne.
Réponses
Section intitulée « Réponses »La transmission est prise en compte et son contrôle est engagé.
object
La référence de ce qui est né — celle que Location désigne.
Examplegenerated
{ "reference": "example", "etat": "example", "recu_le": "2026-04-15T12:00:00Z", "reference_du_teneur": "example"}La ressource de transmission où lire l’avancement et les écarts.
L’identifiant de corrélation reçu, restitué tel quel — la jointure entre le journal du teneur et le nôtre.
400 — la demande est mal formée ; le motif nomme le champ en cause.
object
Le code stable sur lequel un portail se branche — le motif, lui, est écrit pour être lu par une personne et peut changer sans rupture.
Le motif, qui nomme le champ ou l’identifiant en cause.
Le champ en cause, quand l’erreur en désigne un.
L’identifiant de corrélation de l’appel — le même que l’en-tête restitué.
Example
{ "code": "DEMANDE_MAL_FORMEE"}401 — aucune identité présentée, ou jeton invalide : signature, émetteur, dates, tenant, ou audience obtenue pour une autre surface. La réponse porte WWW-Authenticate: Bearer error="invalid_token".
object
Le code stable sur lequel un portail se branche — le motif, lui, est écrit pour être lu par une personne et peut changer sans rupture.
Le motif, qui nomme le champ ou l’identifiant en cause.
Le champ en cause, quand l’erreur en désigne un.
L’identifiant de corrélation de l’appel — le même que l’en-tête restitué.
Example
{ "code": "DEMANDE_MAL_FORMEE"}Le défi d’authentification, au format des jetons porteurs.
403 — le cas d’usage n’est pas dans le périmètre souscrit de ce client. La réponse ne dit jamais si la ressource existe.
object
Le code stable sur lequel un portail se branche — le motif, lui, est écrit pour être lu par une personne et peut changer sans rupture.
Le motif, qui nomme le champ ou l’identifiant en cause.
Le champ en cause, quand l’erreur en désigne un.
L’identifiant de corrélation de l’appel — le même que l’en-tête restitué.
Example
{ "code": "DEMANDE_MAL_FORMEE"}404 — inconnu de ce teneur de compte. Une entreprise, un dispositif ou une opération relevant d’un autre teneur est inexistant, jamais interdit : la muraille de Chine ne laisse pas fuir une existence.
object
Le code stable sur lequel un portail se branche — le motif, lui, est écrit pour être lu par une personne et peut changer sans rupture.
Le motif, qui nomme le champ ou l’identifiant en cause.
Le champ en cause, quand l’erreur en désigne un.
L’identifiant de corrélation de l’appel — le même que l’en-tête restitué.
Example
{ "code": "DEMANDE_MAL_FORMEE"}409 — cette clé d’idempotence a déjà servi, avec une charge utile différente. Rien n’a été engagé.
object
Le code stable sur lequel un portail se branche — le motif, lui, est écrit pour être lu par une personne et peut changer sans rupture.
Le motif, qui nomme le champ ou l’identifiant en cause.
Le champ en cause, quand l’erreur en désigne un.
L’identifiant de corrélation de l’appel — le même que l’en-tête restitué.
Example
{ "code": "DEMANDE_MAL_FORMEE"}422 — la demande est bien formée mais l’écriture est refusée par le métier : dispositif clos à la période déclarée, exercice déjà arrêté, montant global incohérent avec la répartition transmise.
object
Le code stable sur lequel un portail se branche — le motif, lui, est écrit pour être lu par une personne et peut changer sans rupture.
Le motif, qui nomme le champ ou l’identifiant en cause.
Le champ en cause, quand l’erreur en désigne un.
L’identifiant de corrélation de l’appel — le même que l’en-tête restitué.
Example
{ "code": "DEMANDE_MAL_FORMEE"}