Changelog SGRDV — release 1.2.5

Date de publication : 2 septembre 2026

Légende : 🔴 = rupture sur contrat de production (experimental = false) · 🟠 = rupture sur contrat en validation (experimental = true) · 🟢 = ajout ou assouplissement rétrocompatible

1. Terminologie — spécialités de professionnels

1.1 Retrait de codes SNOMED CT du ValueSet SGRDVSpecialtyVS 🟠

Le jeu de valeurs SGRDVSpecialtyVS (binding required sur PractitionerRole.specialty, utilisé par $find, $aggregate et $book sur les deux surfaces) est aligné sur les types de professionnels réellement en usage : retrait de trois codes obsolètes et ajout d'un code.

L'exemple de référence SGRDVExamplePractitionerRoleRequester est mis à jour de 59058001 vers 62247001.

⚠️ Action requise : tout partenaire envoyant ou recevant PractitionerRole.specialty avec l'un des trois codes retirés doit migrer immédiatement.

2. Réservation de rendez-vous ($book)

2.1 Langue de communication du patient obligatoire 🟠

Le profil SGRDVBaseBookPatient déclare désormais Patient.communication avec une cardinalité 1..* (au moins une langue), restreinte au français et à l'anglais via le nouveau ValueSet SGRDVLanguageVS (BCP 47).

⚠️ Action requise : si vous intégrez $book (api-sgrdv ou api-source) en validation anticipée, incluez désormais au moins une langue de communication (fr ou en) dans Patient.communication pour chaque requête et réponse $book.

3. Profils Patient communs

3.1 Canal SMS disponible dès $find et $aggregate 🟢

Le slice telecom[sms] (optionnel), auparavant déclaré uniquement sur SGRDVBaseBookPatient, est remonté sur le profil parent SGRDVBaseFindPatient. Il est donc désormais disponible sur $find et $aggregate, en plus de $book, sur les deux surfaces API. Le rang de préférence (telecom.rank) demeure une contrainte propre à $book.

Aucune action requise — ajout rétrocompatible et purement optionnel.

4. Exemples

4.1 Alignement de conformité des instances de réponse 🟢

Corrections des instances d'exemple (Usage: #example) pour $lock, $extend-lock, $book, $find et $aggregate :

• Ajout de Bundle.entry.fullUrl sur les Bundles collection (contrainte bdl-15).
• Alignement des OperationOutcome d'exemple sur SGRDVBaseOperationOutcome.
• Utilisation de SGRDVBaseFindPractitioner pour l'exemple Practitioner de $find.
• Correction de la cible Provenance du rendez-vous réservé — Appointment/{id}/_history/{versionId} plutôt qu'un urn:uuid.
• Ajout du code MSG_BOOK_REUSSI au CodeSystem SGRDVOperationOutcomeCodesExtensionCS (message de succès pour $book).

Aucune action requise — corrections d'exemples et ajout de code optionnel, sans impact sur les profils ou contrats existants.

5. Recommandations de migration pour les partenaires

Si vous intégrez la recherche de professionnels (specialty) — $find / $aggregate / $book

1. Retirez toute dépendance aux codes SNOMED CT 59058001, 224571005 et 45081000087108.

Si vous intégrez $book

1. Fournissez au moins une langue de communication (Patient.communication, fr ou en) dans chaque requête et réponse $book.
2. Le canal SMS (telecom[sms]) est maintenant disponible dès $find/$aggregate si vous souhaitez le collecter plus tôt dans le parcours.

Toutes intégrations confondues

1. Alignez vos consommations sur la version 1.2.5 du paquet IG.
2. Revalidez vos payloads utilisant PractitionerRole.specialty contre le SGRDVSpecialtyVS mis à jour.