Où en sont la répartition

GET

/v1/entreprises/{entreprise}/operations-collectives/{operation}

curl --request GET \
  --url https://passerelle.teneur.exemple/v1/entreprises/example/operations-collectives/example \
  --header 'Authorization: Bearer <token>' \
  --header 'Correlation-Id: example'

• Un hôte par teneur de compte — un processus ne sert qu'un tenant. Le tenant se lit à l'hôte et au jeton, jamais dans un chemin : le nom d'hôte route, l'identité autorise.

Les trois étapes que le correspondant surveille, servies décidées : l’état de la répartition, celui de l’ordre passé au marché et celui de l’exécution.

Autorisations

• jetonPartenaire

Paramètres

Paramètres (path)

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.

operation

required

string

>= 1 characters

La référence de l’opération collective, telle que la plateforme l’a publiée.

Paramètres (header)

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.

Réponses

200

L’avancement de l’opération collective.

Media typeapplication/json

object

operation

required

string

dispositif

required

string

nature

required

string

etat

required

string

exercice

integer

montant_global_ct

integer

repartition

required

object

etat

required

L’état de la répartition

string

beneficiaires

required

integer

montant_reparti_ct

integer

arretee_le

string format: date-time

ordre

Le passage au marché — absent tant qu’aucun ordre n’est né.

object

etat

string

date_centralisation

string format: date

execution

required

object

etat

required

string

date_execution

string format: date

date_reglement

string format: date

anomalies

Les anomalies retenues, en nombre et en nature, avec de quoi les corriger. Leur traitement appartient au teneur de compte.

Array<object>

object

nature

required

string

nombre

required

integer

precision

Destinée à être affichée telle quelle.

string

Example^generated

{
  "operation": "example",
  "dispositif": "example",
  "nature": "example",
  "etat": "example",
  "exercice": 1,
  "montant_global_ct": 1,
  "repartition": {
    "etat": "example",
    "beneficiaires": 1,
    "montant_reparti_ct": 1,
    "arretee_le": "2026-04-15T12:00:00Z"
  },
  "ordre": {
    "etat": "example",
    "date_centralisation": "2026-04-15"
  },
  "execution": {
    "etat": "example",
    "date_execution": "2026-04-15",
    "date_reglement": "2026-04-15"
  },
  "anomalies": [
    {
      "nature": "example",
      "nombre": 1,
      "precision": "example"
    }
  ]
}

Headers

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

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

Headers

WWW-Authenticate

string

Le défi d’authentification, au format des jetons porteurs.

403

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

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