Aller au contenu

L'avancement d'une transmission et les écarts constatés

GET
/v1/entreprises/{entreprise}/transmissions/{transmission}
curl --request GET \
--url https://passerelle.teneur.exemple/v1/entreprises/example/transmissions/example \
--header 'Authorization: Bearer <token>' \
--header 'Correlation-Id: example'

Les écarts sont ceux que le contrôle a retenus, avec de quoi les corriger : un matricule inconnu, une sortie sans date, une personne déjà sortie.

entreprise
required
string
>= 1 characters

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.

transmission
required
string
>= 1 characters

La référence de la transmission, telle que la prise en compte l’a publiée.

Correlation-Id
required
string
>= 1 characters <= 128 characters

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.

L’avancement de la transmission et ses écarts.

Media typeapplication/json
object
transmission
required
string
etat
required
string
recue_le
required
string format: date-time
mouvements_recus
required
integer
mouvements_appliques
required
integer
ecarts
required

Le tableau vide signifie « aucun écart ». Un écart isolé ne rejette pas la transmission : les autres mouvements s’appliquent.

Array<object>
object
ligne
required

Le rang du mouvement dans la transmission

integer
matricule
string
nature
required

La nature de l’écart

string
precision
required

De quoi le corriger

string
Examplegenerated
{
"transmission": "example",
"etat": "example",
"recue_le": "2026-04-15T12:00:00Z",
"mouvements_recus": 1,
"mouvements_appliques": 1,
"ecarts": [
{
"ligne": 1,
"matricule": "example",
"nature": "example",
"precision": "example"
}
]
}
Correlation-Id
string
>= 1 characters <= 128 characters

L’identifiant de corrélation reçu, restitué tel quel — la jointure entre le journal du teneur et le nôtre.

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".

Media typeapplication/json
object
code
required

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.

string
Allowed values: DEMANDE_MAL_FORMEE CHAMP_INVALIDE NON_AUTHENTIFIE HORS_PERIMETRE_SOUSCRIT RESSOURCE_INCONNUE REJEU_DIVERGENT ECRITURE_REFUSEE AGREGAT_RETENU
motif
required

Le motif, qui nomme le champ ou l’identifiant en cause.

string
champ

Le champ en cause, quand l’erreur en désigne un.

string
correlation

L’identifiant de corrélation de l’appel — le même que l’en-tête restitué.

string
Example
{
"code": "DEMANDE_MAL_FORMEE"
}
WWW-Authenticate
string

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.

Media typeapplication/json
object
code
required

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.

string
Allowed values: DEMANDE_MAL_FORMEE CHAMP_INVALIDE NON_AUTHENTIFIE HORS_PERIMETRE_SOUSCRIT RESSOURCE_INCONNUE REJEU_DIVERGENT ECRITURE_REFUSEE AGREGAT_RETENU
motif
required

Le motif, qui nomme le champ ou l’identifiant en cause.

string
champ

Le champ en cause, quand l’erreur en désigne un.

string
correlation

L’identifiant de corrélation de l’appel — le même que l’en-tête restitué.

string
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.

Media typeapplication/json
object
code
required

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.

string
Allowed values: DEMANDE_MAL_FORMEE CHAMP_INVALIDE NON_AUTHENTIFIE HORS_PERIMETRE_SOUSCRIT RESSOURCE_INCONNUE REJEU_DIVERGENT ECRITURE_REFUSEE AGREGAT_RETENU
motif
required

Le motif, qui nomme le champ ou l’identifiant en cause.

string
champ

Le champ en cause, quand l’erreur en désigne un.

string
correlation

L’identifiant de corrélation de l’appel — le même que l’en-tête restitué.

string
Example
{
"code": "DEMANDE_MAL_FORMEE"
}