Enregistrer une proposition pour validation dans CMTA

  • Services
  • 3 routes
Comment créer une proposition puis la rendre disponible dans CMTA ?

Ce scénario montre comment générer une proposition, l'enrichir avec les participants, puis prolonger sa persistance pour qu'elle puisse être retrouvée et validée dans CMTA.

Il convient aux parcours partenaires où le devis doit rester accessible avant le paiement du client.

Vue d'ensemble

Le parcours démarre par la création d'une proposition, se poursuit avec l'identification des participants, puis se termine par l'opération d'extension de persistance utilisée pour conserver la proposition côté Club Med.

Prérequis

  • Préparer les critères de recherche nécessaires à la création de la proposition.
  • Rassembler les informations participants avant l'étape de mise à jour.
  • Conserver le proposal_id renvoyé à l'étape de création.

Process workflow

Legend:
Obligatoire
Optionnel
1

Créer la proposition

Obligatoire

Utilisez POST/v3/proposals/search pour créer la proposition.

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 '{"product_id": "product-1", "start_date": "2026-07-05", "end_date": "2026-07-12", "attendees": [{"birthdate": "1990-03-12"}]}' \
  "https://api.clubmed.com/v3/proposals/search"

Example answer

[
  {
    "id": "proposal-1",
    "product_id": "product-1",
    "price": {
      "amount": 2890,
      "currency": "EUR"
    },
    "remaining_stock": 4
  }
]

info: Conservez le proposal_id retourné pour le transmettre ensuite au parcours de validation CMTA.

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/v3/proposals/search
Voir plus
2

Ajouter les participants

Obligatoire

Utilisez PUT/v3/proposals/{proposal_id}/attendees pour ajouter les participants.

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 '{"attendees": [{"id": "attendee-1", "first_name": "Jane", "last_name": "Doe", "birthdate": "1990-03-12"}]}' \
  "https://api.clubmed.com/v3/proposals/{proposal_id}/attendees"

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/v3/proposals/{proposal_id}/attendees
Voir plus
3

Prolonger la persistance de la proposition

Obligatoire

Utilisez PATCH/v0/proposals/{proposal_id} pour prolonger la persistance de la proposition.

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 PATCH \
  -H "x-api-key: YOUR_API_KEY" \
  -H "accept-language: fr-FR" \
  -H "Content-Type: application/json" \
  -d '{"operation": "extend_persistence"}' \
  "https://api.clubmed.com/v0/proposals/{proposal_id}"

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.
PATCH/v0/proposals/{proposal_id}
Voir plus