Rafraîchir une proposition

  • Création option
  • 1 route
Comment recalculer une proposition avec le stock et le pricing à jour ?

Ce scénario explique comment rafraîchir une proposition existante pour réévaluer le prix, le stock, la durée d'option et les informations transport avant de poursuivre le parcours de réservation.

Il est utile après un délai, après une modification sensible au stock, ou chaque fois que l'interface doit confirmer que la proposition reste exploitable avant une pré-réservation ou une création de booking.

Vue d'ensemble

Utilisez ce scénario lorsqu'une proposition existante doit être recalculée avant d'être affichée à nouveau, réutilisée ou convertie dans l'étape suivante du parcours de réservation. La route de refresh renvoie une proposition mise à jour avec le pricing courant, le stock restant, la durée d'option et les principaux indicateurs de bookabilité.

Prérequis

  • Un proposal_id valide.
  • Les en-têtes accept-language et x-api-key.
  • Selon le canal, un contexte authorization peut être nécessaire.
  • La proposition doit déjà exister et être encore accessible dans le contexte appelant.

Résultat attendu

L'application peut confirmer qu'une proposition reste exploitable, détecter une variation de prix ou de stock, puis décider de poursuivre le parcours de réservation ou de demander une nouvelle sélection.

1

Rafraîchir la proposition

Obligatoire

Utilisez POST/v1/proposals/{proposal_id}/refresh pour recalculer une proposition existante avec le stock et le pricing les plus récents avant de poursuivre le parcours de réservation.

Prérequis

  • Conserver un proposal_id valide.
  • Envoyer accept-language et x-api-key.
  • Ajouter Authorization: Bearer YOUR_TOKEN si votre canal exige un contexte authentifié.

Calling CURL

curl -X POST \
  -H "accept-language: fr-FR" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  "https://api.clubmed.com/v1/proposals/{proposal_id}/refresh"

Example answer

{
  "id": "123456",
  "product_id": "MPAC",
  "price": {
    "total": 9815.4,
    "currency": "EUR",
    "total_without_transport": 9005.4
  },
  "remaining_stock": 2,
  "option_available": true,
  "option_durability": {
    "expiration_date_time": "20160415T10:23:00.234Z",
    "is_reliable": true
  },
  "is_bookable": false
}

info: Comparez price, remaining_stock et option_durability avec les valeurs déjà affichées pour décider si le parcours peut continuer sans relancer une nouvelle recherche.

Codes de réponse

  • 200 OK : la proposition recalculée est renvoyée.
  • 400 Bad Request : la requête est invalide ou le format du payload est rejeté.
  • 401 Unauthorized : l'authentification est requise mais absente ou invalide.
  • 403 Forbidden : l'accès à cette proposition est refusé dans le contexte courant.
  • 404 Not Found : non documenté dans le Swagger.
  • 409 Conflict : au moins un service de la proposition n'est plus disponible.
POST/v1/proposals/{proposal_id}/refresh
Voir plus