La version applicable d'un objet versionné à une date d'effet

POST

/entreprise/v1/resolutions/version

curl --request POST \
  --url https://example.com/entreprise/v1/resolutions/version \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Correlation-Id: example' \
  --header 'X-Tenant-Id: example' \
  --data '{ "objet_type": "example", "objet_id": "example", "date_effet": "2026-04-15", "connu_a": "2026-04-15T12:00:00Z" }'

Autorisations

• authentification
  entreprise:resolution

Paramètres

Paramètres (header)

X-Tenant-Id

required

string

>= 1 characters

Le teneur de compte — injecté et signé par la passerelle ; le corps ne choisit jamais le tenant. Une ressource d’un autre tenant est traitée comme inexistante.

X-Correlation-Id

required

string

>= 1 characters

La corrélation de bout en bout — reprise dans toute réponse.

Corps de la requête^required

Media typeapplication/json

object

objet_type

required

Objets acceptés : entité, rattachement de dossier, périmètre, acte, dispositif, jeu d’abondement, formule collective, règle de répartition, offre, panier, stratégie, convention, tarif.

string

objet_id

required

string

date_effet

required

string format: date

connu_a

Temps de connaissance — réservé aux lectures d’audit.

string format: date-time

Example^generated

{
  "objet_type": "example",
  "objet_id": "example",
  "date_effet": "2026-04-15",
  "connu_a": "2026-04-15T12:00:00Z"
}

Réponses

200

La version applicable — par exemple REP-2027-V2 pour le 15 février 2027, même si une V3 est préparée pour juillet.

Media typeapplication/json

La version applicable résolue.

object

objet_type

required

string

objet_id

required

string

version_id

required

L’identifiant stable de la version.

string

numero

required

integer

date_debut_effet

required

string format: date

date_fin_effet

string format: date

empreinte

string

remplace_version

La version remplacée éventuelle.

integer

Example^generated

{
  "objet_type": "example",
  "objet_id": "example",
  "version_id": "example",
  "numero": 1,
  "date_debut_effet": "2026-04-15",
  "date_fin_effet": "2026-04-15",
  "empreinte": "example",
  "remplace_version": 1
}

401

Aucune identité présentée (401).

403

L’identité présentée n’a pas la famille d’accès entreprise:resolution (403). Les 403 croisés entre familles sont prouvés par les tests d’assemblage.

404

Ressource absente ou invisible — y compris une ressource d’un autre tenant (le régime de la muraille : 404, jamais 403).

Media typeapplication/json

object

code

required

Par exemple ENT_VERSION_CONFLICT.

string

message

required

string

correlation_id

required

string

details

Array<object>

object

champ

string

motif

string

Example^generated

{
  "code": "example",
  "message": "example",
  "correlation_id": "example",
  "details": [
    {
      "champ": "example",
      "motif": "example"
    }
  ]
}

422

Commande comprise mais impossible au regard du métier (422).

Media typeapplication/json

object

code

required

Par exemple ENT_VERSION_CONFLICT.

string

message

required

string

correlation_id

required

string

details

Array<object>

object

champ

string

motif

string

Example^generated

{
  "code": "example",
  "message": "example",
  "correlation_id": "example",
  "details": [
    {
      "champ": "example",
      "motif": "example"
    }
  ]
}

503

Dépendance indisponible, sans effet partiel (503) — jamais convertie en réponse négative (ENT-DEC-002).

Media typeapplication/json

object

code

required

Par exemple ENT_VERSION_CONFLICT.

string

message

required

string

correlation_id

required

string

details

Array<object>

object

champ

string

motif

string

Example^generated

{
  "code": "example",
  "message": "example",
  "correlation_id": "example",
  "details": [
    {
      "champ": "example",
      "motif": "example"
    }
  ]
}