Provisionner (créer/reposer) l'identité légale vendeur d'un mandat — control-plane, fail-closed

POST

/admin/operating-mandates/{mandateId}/seller-identity

curl --request POST \
  --url https://example.com/admin/operating-mandates/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/seller-identity \
  --header 'Content-Type: application/json' \
  --data '{ "tenantId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "effectiveFrom": "2026-04-15", "legalName": "example", "legalForm": "example", "addressLine1": "example", "addressLine2": "example", "postalCode": "example", "city": "example", "countryCode": "example", "vatNumber": "example", "rcsMention": "example" }'

Parameters

Path Parameters

mandateId

required

string format: uuid

Identifiant du mandat d’exploitation

Request Body ^required

Identité légale de l’assujetti (EN 16931 côté vendeur). Champs BT-27/BG-5/BT-31 requis (fail-closed). Effective-dated append-only : toute modification = nouvelle version effectiveFrom.

Media type application/json

object

tenantId

required

string format: uuid

effectiveFrom

required

Date d’effet (AAAA-MM-JJ)

string format: date

legalName

required

Raison sociale de l’assujetti (BT-27)

string

legalForm

Forme juridique + capital (mention FR R123-237), ex. « SAS au capital de 50 000 € »

string

nullable

addressLine1

required

Adresse postale (BG-5)

string

addressLine2

string

nullable

postalCode

required

string

city

required

string

countryCode

required

Pays ISO 3166-1 alpha-2 (BR-08)

string

>= 2 characters <= 2 characters

vatNumber

required

N° TVA intracommunautaire (BT-31 — format FR validé si countryCode=FR)

string

rcsMention

Mention RCS (ex. « RCS Montpellier 123 456 789 »)

string

nullable

Example ^generated

{
  "tenantId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "effectiveFrom": "2026-04-15",
  "legalName": "example",
  "legalForm": "example",
  "addressLine1": "example",
  "addressLine2": "example",
  "postalCode": "example",
  "city": "example",
  "countryCode": "example",
  "vatNumber": "example",
  "rcsMention": "example"
}

Responses

201

Identité vendeur provisionnée

Media type application/json

object

data

required

object

operatingMandateId

required

string format: uuid

effectiveFrom

required

string format: date

Example ^generated

{
  "data": {
    "operatingMandateId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "effectiveFrom": "2026-04-15"
  }
}

400

Champ vendeur obligatoire absent ou invalide (fail-closed)

401

Non authentifié (session control-plane requise)

403

Opérateur non autorisé