Provisionner (créer/reposer) le profil fiscal d'un mandat — control-plane, fail-closed

POST

/admin/operating-mandates/{mandateId}/fiscal-profile

curl --request POST \
  --url https://example.com/admin/operating-mandates/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/fiscal-profile \
  --header 'Content-Type: application/json' \
  --data '{ "tenantId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "effectiveFrom": "2026-04-15", "vatCollectionBasis": "debits", "depositNature": "arrhes", "depositAccount": "example", "refundAccount": "example", "longStayThresholdDays": 1, "longStayTreatment": "exempt_261D", "fiscalCountry": "example", "fiscalYearStartMonth": 1, "chartOverrides": [ { "accountKey": "example", "num": "example", "lib": "example" } ] }'

Parameters

Path Parameters

mandateId

required

string format: uuid

Identifiant du mandat d’exploitation

Request Body ^required

Configuration fiscale du mandat. TOUS les champs sont requis (fail-closed, zéro défaut).

Media type application/json

object

tenantId

required

string format: uuid

effectiveFrom

required

Date d’effet (AAAA-MM-JJ)

string format: date

vatCollectionBasis

required

string

Allowed values: debits cash_receipts

depositNature

required

Arrhes (hors-champ) / acompte (TVA encaissement)

string

Allowed values: arrhes acompte

depositAccount

required

Compte comptable acompte (fourni par le cabinet)

string

refundAccount

required

Compte comptable remboursement

string

longStayThresholdDays

required

Seuil long séjour (CGI 261 D 4°)

integer

longStayTreatment

required

string

Allowed values: exempt_261D taxable

fiscalCountry

required

Pays fiscal (ISO alpha-2)

string

>= 2 characters <= 2 characters

fiscalYearStartMonth

required

integer

>= 1 <= 12

chartOverrides

Surcharges du plan comptable (optionnel)

Array<object>

object

accountKey

required

string

num

required

string

lib

required

string

Responses

201

Profil fiscal provisionné

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 fiscal obligatoire absent ou invalide (fail-closed)

401

Non authentifié (session control-plane requise)

403

Opérateur non autorisé