Créer un contrat de mandat propriétaire

POST

/v1/management-contracts

curl --request POST \
  --url https://example.com/v1/management-contracts \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <X-API-Key>' \
  --data '{ "ownerId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "unitId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "establishmentId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "contractType": "mandate_rental", "mandateType": "transparent", "revenueShareModel": "percent_to_owner", "ownerShareBps": 1, "managementFeeBps": 1, "fixedRentCents": "example", "fixedRentCurrency": "example", "statementPeriod": "monthly", "validFrom": "2026-04-15", "validUntil": "2026-04-15" }'

Authorizations

• ApiKeyAuth
• BearerAuth

Request Body ^required

Media type application/json

object

ownerId

required

string format: uuid

unitId

required

string format: uuid

establishmentId

required

string format: uuid

contractType

required

string

Allowed values: mandate_rental concierge fixed_rent

mandateType

required

string

Allowed values: transparent commissionnaire

revenueShareModel

required

string

Allowed values: percent_to_owner fixed_rent_to_owner percent_to_camp

ownerShareBps

Bps part propriétaire (requis si percent_to_owner)

integer

nullable <= 10000

managementFeeBps

integer

nullable <= 10000

fixedRentCents

Montant fixe en centimes (bigint string, requis si fixed_rent_to_owner)

string

nullable

fixedRentCurrency

string

nullable >= 3 characters <= 3 characters

statementPeriod

required

string

default: monthly

Allowed values: monthly quarterly

validFrom

required

string format: date

validUntil

string format: date

nullable

Responses

201

Contrat créé

Media type application/json

object

data

required

object

id

required

string format: uuid

Example ^generated

{
  "data": {
    "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
  }
}

400

Corps invalide

Media type application/json

object

code

required

Code machine de l’erreur

string

message

required

Message lisible

string

origin

Origine domaine de l’erreur (optionnel)

object

boundedContext

string

module

string

status

required

integer

traceId

required

Identifiant de corrélation pour le support

string

Example

{
  "code": "RESERVATION_NOT_FOUND",
  "message": "Réservation introuvable",
  "status": 404
}

401

Non authentifié

Media type application/json

object

code

required

Code machine de l’erreur

string

message

required

Message lisible

string

origin

Origine domaine de l’erreur (optionnel)

object

boundedContext

string

module

string

status

required

integer

traceId

required

Identifiant de corrélation pour le support

string

Example

{
  "code": "RESERVATION_NOT_FOUND",
  "message": "Réservation introuvable",
  "status": 404
}

403

Permission refusée

Media type application/json

object

code

required

Code machine de l’erreur

string

message

required

Message lisible

string

origin

Origine domaine de l’erreur (optionnel)

object

boundedContext

string

module

string

status

required

integer

traceId

required

Identifiant de corrélation pour le support

string

Example

{
  "code": "RESERVATION_NOT_FOUND",
  "message": "Réservation introuvable",
  "status": 404
}