Renouveler un contrat saisonnier (crée un draft chaîné)

POST

/v1/long-stay-contracts/{id}/renew

curl --request POST \
  --url https://example.com/v1/long-stay-contracts/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/renew \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <X-API-Key>' \
  --data '{ "newContractId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "newTotalAmountCents": "example", "newCurrency": "EUR", "newPeriodStart": "2026-04-15", "newPeriodEnd": "2026-04-15", "newInstallments": [ { "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "seqNo": 1, "dueDate": "2026-04-15", "amountCents": "example", "currency": "EUR" } ], "newNoticePeriodDays": 1, "newDepositNature": "arrhes", "newTerminationPolicy": "pro_rata_nuits" }'

Authorizations

• ApiKeyAuth
• BearerAuth

Parameters

Path Parameters

id

required

string format: uuid

Request Body ^required

Media type application/json

object

newContractId

required

string format: uuid

newTotalAmountCents

required

Montant total en centimes (bigint string)

string

/^\d+$/

newCurrency

required

string

Allowed values: EUR GBP

newPeriodStart

required

string format: date

newPeriodEnd

string format: date

nullable

newInstallments

required

Array<object>

>= 1 items

object

id

required

string format: uuid

seqNo

required

integer

dueDate

required

string format: date

amountCents

required

Centimes (bigint string)

string

/^\d+$/

currency

required

string

Allowed values: EUR GBP

newNoticePeriodDays

integer

nullable

newDepositNature

string

nullable

Allowed values: arrhes acompte

newTerminationPolicy

string

nullable

Allowed values: pro_rata_nuits forfait_frais contractuel

Responses

200

Contrat renouvelé

Media type application/json

object

data

required

object

currentContractId

required

string format: uuid

nextContractId

required

string format: uuid

Example ^generated

{
  "data": {
    "currentContractId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "nextContractId": "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
}

404

Contrat introuvable

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
}