Aller au contenu

Ouvrir un compte — un numéro ne s'ouvre qu'une fois.

POST
/tenants/{tenant}/comptes
curl --request POST \
--url https://example.com/tenants/example/comptes \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "numero": "example", "categorie": "avoirs", "historise": false }'

Le compte ouvert participe aussitôt au paramétrage. Un numéro déjà connu — ouvert ou clos — est refusé : un compte clos ne se rouvre pas, on en ouvre un autre. L’ouverture publie le fait « compte ouvert ».

tenant
required
string
>= 1 characters

Le teneur de compte — la muraille de Chine.

Media typeapplication/json
object
numero
required

L’identifiant public du compte à ouvrir.

string
>= 1 characters
categorie
required

Un compte d’avoirs n’est jamais négatif ; un compte de passage est structurellement à zéro, le négatif de transit est toléré.

string
Allowed values: avoirs passage
historise

La position sera photographiée à chaque variation.

boolean

Le compte est ouvert.

Media typeapplication/json
object
tenant
required
string
compte
required
string
categorie
required
string
Allowed values: avoirs passage
historise
required
boolean
statut
required

Le cycle de vie — ouvert, puis clos (définitif).

string
Allowed values: ouvert clos
Example
{
"categorie": "avoirs",
"statut": "ouvert"
}

La demande est irrecevable — le motif nomme le champ.

Media typeapplication/json
object
motif
required

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

string
Examplegenerated
{
"motif": "example"
}

Aucune identité présentée.

L’identité présentée n’a pas la famille d’accès tenue-de-compte:parametrage.

Le tenant est inconnu.

Le numéro est déjà connu (ouvert ou clos) — motivé.

Media typeapplication/json
object
motif
required

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

string
Examplegenerated
{
"motif": "example"
}