Propositions : répartition avancée des chambres

  • Création option
  • 3 routes
Comment ajuster précisément la répartition des chambres dans une proposition ?

Ce scénario détaille le parcours avancé permettant de choisir précisément les chambres d'une proposition existante et d'affecter nominativement les participants à chaque unité.

Contrairement au parcours standard, il donne la main sur l'inventaire disponible, la simulation de répartition et l'application finale de la nouvelle configuration.

Vue d'ensemble

Ce parcours est utile lorsque la répartition standard des hébergements ne suffit pas et qu'il faut composer manuellement les chambres.

Prérequis

  • Disposer d'un proposal_id valide issu d'une recherche de proposition.
  • Connaître les participants à répartir et les contraintes d'occupation attendues.
  • Vérifier les impacts de stock et de prix avant validation finale, car la disponibilité n'est pas gelée pendant la simulation.

Process workflow

Legend:
Obligatoire
Optionnel
1

Récupérer les options d'hébergement

Obligatoire

Utilisez GET/v0/accommodations_arrangement pour lister les combinaisons d'hébergement à considérer avant de retenir une répartition plus détaillée des chambres.

Prérequis

Préparez les paramètres utiles à l'appel. Conservez x-api-key et, si la route est customer-scoped, un bearer token valide.

Calling CURL

curl -X GET \
  -H "x-api-key: YOUR_API_KEY" \
  -H "accept-language: fr-FR" \
  "https://api.clubmed.com/v0/accommodations_arrangement"

Example answer

[
  {
    "id": "A2",
    "remaining_stock": 11,
    "occupancy": 2,
    "eligible_attendees": [
      "A",
      "B"
    ]
  }
]

info: Comparez remaining_stock, occupancy et eligible_attendees avant de choisir la répartition à valider ensuite.

Codes de réponse

  • 200 OK : les données attendues sont renvoyées.
  • 400 Bad Request : la requête est invalide ou incomplète.
  • 404 Not Found : la ressource demandée est introuvable.
GET/v0/accommodations_arrangement
Voir plus
2

Valider la répartition (Simulation)

Optionnel

Utilisez POST/v1/accommodations_arrangement/check pour simuler une répartition de chambres et vérifier que la combinaison sélectionnée reste cohérente avant de l'appliquer.

Prérequis

Préparez les paramètres utiles à l'appel. Conservez x-api-key et, si la route est customer-scoped, un bearer token valide. Vérifiez le body avant appel pour éviter une erreur de validation.

Calling CURL

curl -X POST \
  -H "x-api-key: YOUR_API_KEY" \
  -H "accept-language: fr-FR" \
  -H "Content-Type: application/json" \
  -d '[{"id": "room-1", "occupancy": 2, "attendees": [{"id": "attendee-1"}, {"id": "attendee-2"}]}]' \
  "https://api.clubmed.com/v1/accommodations_arrangement/check"

Example answer

[
  {
    "id": "room-1",
    "remaining_stock": 3,
    "differential_prices": {
      "amount": 120,
      "currency": "EUR"
    }
  }
]

info: Réutilisez le stock et les écarts tarifaires renvoyés pour décider si cette répartition doit être appliquée à la proposition.

Codes de réponse

  • 200 OK : l'opération est prise en compte et la ressource est renvoyée.
  • 400 Bad Request : le body ou les paramètres sont invalides.
  • 404 Not Found : la ressource ciblée est introuvable.
POST/v1/accommodations_arrangement/check
Voir plus
3

Modification effective des chambres

Obligatoire

Utilisez PUT/v1/proposals/{proposal_id}/accommodations_arrangement pour appliquer à la proposition la répartition des chambres validée à l'étape précédente.

Prérequis

Préparez proposal_id. Conservez x-api-key et, si la route est customer-scoped, un bearer token valide. Vérifiez le body avant appel pour éviter une erreur de validation.

Calling CURL

curl -X PUT \
  -H "x-api-key: YOUR_API_KEY" \
  -H "accept-language: fr-FR" \
  -H "Content-Type: application/json" \
  -d '[{"id": "room-1", "occupancy": 2, "attendees": [{"id": "attendee-1"}, {"id": "attendee-2"}]}]' \
  "https://api.clubmed.com/v1/proposals/{proposal_id}/accommodations_arrangement"

Example answer

HTTP/1.1 204 No Content

info: Le succès peut être renvoyé sans body. Relisez la ressource ensuite si vous devez afficher l'état final.

Codes de réponse

  • 204 No Content : l'opération est appliquée avec succès.
  • 400 Bad Request : le body ou les paramètres sont invalides.
  • 404 Not Found : la ressource ciblée est introuvable.
PUT/v1/proposals/{proposal_id}/accommodations_arrangement
Voir plus