Effectuer le check-in d'une réservation confirmée

POST

/v1/reservations/{id}/check-in

curl --request POST \
  --url https://example.com/v1/reservations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/check-in \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <X-API-Key>' \
  --data '{ "unitId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "headcountAdults": 1, "headcountChildren": 1, "childrenAges": [ 1 ], "headcountReason": "example", "currency": "EUR" }'

Authorizations

• ApiKeyAuth
• BearerAuth

Parameters

Path Parameters

id

required

string format: uuid

Identifiant de la réservation

Request Body ^required

Media type application/json

object

unitId

Unité physique assignée. OPTIONNELLE (G2) : dérivée de la pré-attribution active si absente ; fournie = override.

string format: uuid

headcountAdults

CORRECTION d’occupation constatée à l’arrivée (P5) — optionnel, avec headcountChildren. Absent = headcount dérivé du pax annoncé (bébés exclus). Journalisée NF203.

integer

>= 1 <= 50

headcountChildren

CORRECTION d’occupation constatée à l’arrivée (P5) — optionnel, avec headcountAdults.

integer

<= 50

childrenAges

Âges des enfants/bébés CONSTATÉS (B4) — avec la correction ; le serveur classe bébé/enfant (bande accommodation) et persiste les âges.

Array<integer>

<= 50 items

headcountReason

Motif de la correction (NF203). Optionnel.

string

>= 1 characters <= 500 characters

currency

DÉPRÉCIÉ : la devise du folio est DÉRIVÉE du tarif figé. Si fournie, doit l’égaler (400 CHECK_IN_CURRENCY_MISMATCH sinon).

string

Allowed values: EUR GBP

Responses

200

Check-in effectué

Media type application/json

object

data

required

object

stayId

required

string format: uuid

folioId

required

string format: uuid

headcountDelta

B4 : delta d’occupation constaté à l’arrivée (per_person) — TTC string bigint-safe, posted = recette postée au folio.

object

ttcCents

string

posted

boolean

reason

string

Example ^generated

{
  "data": {
    "stayId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "folioId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "headcountDelta": {
      "ttcCents": "example",
      "posted": true,
      "reason": "example"
    }
  }
}

409

Réservation non confirmée ou déjà checked-in

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
}