Parcours de pré-réservation

  • Réservation
  • Prébooking
  • 2 routes
Comment transformer une recherche de proposition en étape de pré-réservation ?

Ce scénario montre comment rechercher la meilleure proposition puis enchaîner immédiatement avec l'étape de pré-réservation utilisée avant la création d'un booking.

Vue d'ensemble

Le parcours enchaîne POST/v1/proposals/search/best avec POST/v1/prebookings pour passer d'une estimation de proposition à une préparation de pré-réservation.

Prérequis

  • Les critères de réservation doivent être disponibles pour la recherche de proposition.
  • La seconde étape dépend du contexte de proposition renvoyé par la première.
  • accept-language et x-api-key sont requis sur les appels documentés.

Process workflow

Legend:
Obligatoire
Optionnel
1

Générer la meilleure proposition

Optionnel

Utilisez POST/v1/proposals/search/best pour générer la meilleure proposition candidate pour les critères soumis avant d’entrer dans le flux de pré-réservation.

Prérequis

  • Header accept-language
  • Header x-api-key
  • Header optionnel authorization
  • Le body porte les critères de réservation. Son schéma complet exact n’est pas entièrement visible dans l’extrait de contrat disponible.

Calling CURL

curl -X POST "https://api.clubmed.com/v1/proposals/search/best" \
  -H "accept-language: fr-FR" \
  -H "x-api-key: <your-api-key>" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json"

Example answer

{
  "id": "123456",
  "product_id": "MPAC",
  "package_id": "AI",
  "duration": 7,
  "price": {
    "total": 9815.4,
    "currency": "EUR"
  },
  "remaining_stock": 2,
  "option_available": true
}

info: Conservez l’identifiant de proposition retourné ainsi que le contexte tarifaire. Cette réponse fait le lien fonctionnel entre la sélection produit et la demande de pré-réservation.

Codes de réponse

  • 200 : meilleure proposition retournée avec succès.
  • 400 : critères incomplets, composition voyageurs incohérente, ville de départ invalide, erreur de validation ou JSON invalide.
  • 401 : authentification invalide ou absente.
  • 403 : au moins un client n’est pas autorisé à poursuivre la réservation.
  • 404 : produit inconnu.
POST/v1/proposals/search/best
Voir plus
2

Créer la pré-réservation

Obligatoire

Utilisez POST/v1/prebookings pour transformer le contexte de proposition en objet de pré-réservation exploitable dans le parcours de booking.

Prérequis

  • Header accept-language
  • Header x-api-key
  • Header optionnel authorization
  • Le body est requis, mais son schéma complet exact n’est pas visible dans l’extrait de contrat disponible. Réutilisez le contexte de proposition retourné à l’étape précédente.

Calling CURL

curl -X POST "https://api.clubmed.com/v1/prebookings" \
  -H "accept-language: fr-FR" \
  -H "x-api-key: <your-api-key>" \
  -H "authorization: Bearer <token>" \
  -H "Content-Type: application/json"

Example answer

[
  {
    "customer_id": "123456789",
    "type": "MAIN"
  }
]

info: Une pré-réservation réussie confirme que la proposition sélectionnée peut entrer dans le parcours de booking. Conservez le contexte client et participant retourné pour préparer les appels suivants.

Codes de réponse

  • 200 : pré-réservation créée avec succès.
  • 400 : requête invalide, erreur de validation ou JSON invalide.
  • 401 : authentification invalide ou absente.
POST/v1/prebookings
Voir plus