Établir la règle de valorisation

POST

/instruments/{instrument}/regle-valorisation

curl --request POST \
  --url https://example.com/instruments/example/regle-valorisation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "portee": "vehicule", "frequence": "quotidienne", "ancrage": "example", "heure_limite": "example", "fuseau": "example", "convention_report": "example", "delai_publication_jours": 1, "delai_reglement_jours": 1, "du": "2026-04-15", "calendriers": [ { "calendrier": "example", "semantique": "ouverture_requise" } ], "provenances": [ { "element": "frequence", "provenance": { "source": "document", "document": "example" } } ] }'

Une nouvelle version de règle remplace la précédente à sa date d’application — jamais de modification en place ; l’horizon des occurrences se recalcule et publie ses impacts.

Autorisations

• authentification
  instruments:administration

Paramètres

Paramètres (path)

instrument

required

string

>= 1 characters

Corps de la requête^required

Media typeapplication/json

object

portee

required

La règle vit au niveau qui porte le patrimoine valorisé d’un seul mouvement — le véhicule non compartimenté ou le compartiment ; la portée instrument reste au CCB.

string

Allowed values: vehicule compartiment instrument

frequence

required

string

Allowed values: quotidienne hebdomadaire mensuelle

ancrage

string

heure_limite

required

string

/^([01][0-9]|2[0-3]):[0-5][0-9]$/

fuseau

required

string

>= 1 characters

convention_report

string

delai_publication_jours

integer

delai_reglement_jours

integer

du

required

La date d’application de la version.

string format: date

calendriers

Les affectations — sémantique explicite, jamais un effet par simple présence.

Array<object>

object

calendrier

required

string

semantique

required

string

Allowed values: ouverture_requise fermeture_exclusive dependance_valorisation calcul_publication calcul_reglement informatif

provenances

required

La provenance de chaque élément établi — la résolution n’effacera pas la trace.

Array<object>

>= 1 items

object

element

required

string

Allowed values: frequence ancrage heure_limite convention_report delai_publication_jours delai_reglement_jours calendriers

provenance

required

object

source

required

string

Allowed values: document saisie flux_de_place

document

La référence du document versé — obligatoire quand la source est un document.

string

Réponses

202

La demande de validation est créée — l’effet attend sa validation par un valideur distinct du préparateur.

Media typeapplication/json

object

demande

required

string

objet

required

string

Allowed values: referencement transition_de_cycle caracteristique restriction regle_de_valorisation relation role_d_intervenant version_de_calendrier exception_de_calendrier intervenant

cible

string

Example

{
  "objet": "referencement"
}

400

La demande est irrecevable (champ manquant, date mal formée, flottant…) — le motif nomme le champ.

Media typeapplication/json

object

motif

required

Le motif

string

Example^generated

{
  "motif": "example"
}

401

Aucune identité présentée.

403

L’identité présentée n’a pas la famille d’accès instruments:administration.

404

La ressource est inconnue de ce tenant — rien n’existe à travers la muraille.

Media typeapplication/json

object

motif

required

Le motif

string

Example^generated

{
  "motif": "example"
}

422

Le domaine refuse (invariant violé : chevauchement de périodes, inapplicable à la nature, cycle qui n’admet pas la transition, rang déjà publié, préparateur valideur…) — rien n’est retenu, aucun fait n’existe ; le motif nomme l’invariant.

Media typeapplication/json

object

motif

required

Le motif

string

Example^generated

{
  "motif": "example"
}