Récupérer les contrats de vente d’un booking

  • Bookings
  • Docs booking
  • 2 routes
Comment lister et télécharger les contrats de vente rattachés à un dossier ?

Ce scénario explique comment lister tous les contrats de vente rattachés à un booking puis récupérer un contrat précis pour affichage ou téléchargement.

Vue d'ensemble

Utilisez les deux routes en scope client pour d'abord énumérer les contrats de vente liés à un booking, puis cibler un contract_id précis pour une récupération détaillée.

Prérequis

  • customer_id et booking_id doivent pointer vers un booking existant dans le scope client.
  • Le contract_id est nécessaire pour la seconde étape.
  • accept-language, authorization et x-api-key sont requis sur les appels documentés.

Process workflow

Legend:
Obligatoire
Optionnel
1

Lister les contrats de vente d’un booking

Obligatoire

Utilisez GET/v0/customers/{customer_id}/bookings/{booking_id}/sell_contracts pour lister les documents contractuels rattachés à un booking avant d’en sélectionner un pour affichage ou téléchargement.

Prérequis

  • Header accept-language
  • Header authorization
  • Header x-api-key
  • Path customer_id
  • Path booking_id

Calling CURL

curl -X GET "https://api.clubmed.com/v0/customers/123456789/bookings/0123456789/sell_contracts" \
  -H "accept-language: fr-FR" \
  -H "authorization: Bearer <token>" \
  -H "x-api-key: <your-api-key>"

Example answer

[
  {
    "id": "EUR",
    "type": "TCS",
    "label": "Terms and Conditions of Service"
  }
]

info: Réutilisez l’id retourné comme contract_id dans l’étape suivante. Cette étape est la plus sûre pour n’exposer que les documents effectivement disponibles pour le booking.

Codes de réponse

  • 200 : contrats de vente retournés avec succès.
  • 400 : requête invalide ou erreur de validation.
  • 401 : authentification invalide ou absente.
  • 403 : mismatch client, issuer mismatch ou locale mismatch.
GET/v0/customers/{customer_id}/bookings/{booking_id}/sell_contracts
Voir plus
2

Télécharger un contrat de vente spécifique

Obligatoire

Utilisez GET/v0/customers/{customer_id}/bookings/{booking_id}/sell_contracts/{contract_id} avec un identifiant retourné par l’étape précédente pour récupérer le document contractuel sélectionné.

Prérequis

  • Header accept-language
  • Header authorization
  • Header x-api-key
  • Path customer_id
  • Path booking_id
  • Path contract_id

Calling CURL

curl -X GET "https://api.clubmed.com/v0/customers/123456789/bookings/0123456789/sell_contracts/b2c3ed75-763c-4042-b84b-f35059368108" \
  -H "accept-language: fr-FR" \
  -H "authorization: Bearer <token>" \
  -H "x-api-key: <your-api-key>"

Example answer

HTTP/1.1 200 OK

info: Le format exact du payload de réponse n’est pas visible dans l’extrait de contrat disponible. Passez d’abord par l’étape de liste pour éviter de demander un identifiant de document indisponible pour le booking.

Codes de réponse

  • 200 : contrat récupéré avec succès.
  • 400 : requête invalide ou erreur de validation.
  • 401 : authentification invalide ou absente.
  • 403 : mismatch client, issuer mismatch ou locale mismatch.
GET/v0/customers/{customer_id}/bookings/{booking_id}/sell_contracts/{contract_id}
Voir plus