Lister les plans de pension actifs d'un établissement (MP-6a)

GET

/v1/meal-plans

curl --request GET \
  --url 'https://example.com/v1/meal-plans?establishmentId=2489E9AD-2EE2-8E00-8EC9-32D5F69181C0' \
  --header 'X-API-Key: <X-API-Key>'

Authorizations

• ApiKeyAuth
• BearerAuth

Parameters

Query Parameters

establishmentId

required

string format: uuid

Responses

200

Catalogue des plans de pension actifs (trié par code ASC)

Media type application/json

object

data

required

Array<object>

object

id

required

string format: uuid

establishmentId

required

string format: uuid

code

required

string

name

required

string

mealPlanType

required

string

Allowed values: breakfast half_board full_board

services

required

Array<object>

object

serviceType

required

string

Allowed values: breakfast lunch dinner

includedQty

required

integer

>= 1

priceAdultCents

required

Prix adulte en centimes (bigint-safe)

string

priceChildCents

Prix enfant en centimes ou null

string

nullable

childAgeThreshold

DÉPRÉCIÉ (ADR-00D115 B1) — plus utilisé pour la facturation : le seuil enfant vient de la bande d’âge food_service de l’établissement. Valeur historique conservée en lecture, cleanup routé.

integer

nullable

pricingMode

required

string

Allowed values: per_person_per_night per_stay per_unit

vatCategory

required

string

Allowed values: food_beverage_onsite reduced standard

currency

required

string

Allowed values: EUR GBP

active

required

boolean

mealSkipReducesBilling

required

Si true, un repas sauté réduit la facturation prorata

boolean

arrivalMeals

Repas du soir facturés la nuit d’arrivée (null = défaut dérivé du type)

Array<string>

nullable

Allowed values: breakfast lunch dinner

departureMeals

Repas retenus le matin du check-out (null = défaut dérivé du type)

Array<string>

nullable

Allowed values: breakfast lunch dinner

Example

{
  "data": [
    {
      "code": "DP-STD",
      "name": "Demi-pension standard",
      "mealPlanType": "breakfast",
      "services": [
        {
          "serviceType": "breakfast"
        }
      ],
      "priceAdultCents": "4500",
      "pricingMode": "per_person_per_night",
      "vatCategory": "food_beverage_onsite",
      "currency": "EUR",
      "arrivalMeals": [
        "breakfast"
      ],
      "departureMeals": [
        "breakfast"
      ]
    }
  ]
}

400

Paramètre manquant ou 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 (meal_plan.read) ou IDOR établissement

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
}