Vendre un produit annexe (extra, surclassement) sur un séjour

POST

/v1/stays/{stayId}/ancillaries

curl --request POST \
  --url https://example.com/v1/stays/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/ancillaries \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: example' \
  --header 'X-API-Key: <X-API-Key>' \
  --data '{ "ancillaryProductId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "quantity": 1 }'

TVA calculée serveur via le catalogue produit. businessDate résolue côté serveur. Idempotency-Key obligatoire.

Authorizations

• ApiKeyAuth
• BearerAuth

Parameters

Path Parameters

stayId

required

string format: uuid

Identifiant du séjour

Header Parameters

Idempotency-Key

required

string

Clé d’idempotence OBLIGATOIRE (8–200 car.) — anti-double-vente

Request Body ^required

Produit annexe à vendre. La TVA est toujours calculée serveur (jamais fournie par le client).

Media type application/json

object

ancillaryProductId

required

Identifiant du produit annexe

string format: uuid

quantity

required

integer

>= 1

Example

1

Responses

201

Produit annexe vendu — écriture folio ajoutée

Media type application/json

object

data

required

object

folioEntryId

required

string format: uuid

nullable

amountHtCents

required

Montant HT en centimes (bigint string)

string

upgraded

required

True si un surclassement a été effectué

boolean

Example ^generated

{
  "data": {
    "folioEntryId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "amountHtCents": "example",
    "upgraded": true
  }
}

400

Corps ou paramètres invalides

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 ou périmètre fiscal non vérifiable

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

Ressource 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
}

409

Folio non-open, surclassement indisponible

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
}