Passer au contenu principal
PATCH
Mettre à jour les détails d’un rendez-vous, comme l’horaire prévu ou le lieu de prélèvement. Seuls les rendez-vous dont la prise de sang n’a pas encore été confirmée peuvent être modifiés.
Un rendez-vous ne peut plus être modifié une fois la prise de sang confirmée ou s’il est déjà annulé. Toute tentative de mise à jour d’un tel rendez-vous renvoie 409 Conflict. La seule exception est results_ready_emails, que tu peux toujours modifier après la prise de sang.
Nécessite le scope appointments_schedule ou appointments_manage.

Requête

Paramètres de chemin

string
requis
Identifiant unique (UUID) du rendez-vous à mettre à jour.

Paramètres du corps

Tous les paramètres du corps sont facultatifs — inclus uniquement les champs que tu veux modifier.
string
Nouvelle date et heure du rendez-vous au format ISO 8601 (par ex. 2026-05-20T14:00:00Z ou 2026-05-20T16:00:00+02:00). Doit inclure un indicateur de fuseau horaire — soit Z, soit un décalage explicite comme +02:00 ; les dates et heures sans fuseau sont rejetées. Doit être dans le futur.Doit correspondre exactement au début d’un créneau disposant encore de places — voir Consulter les disponibilités. Le rendez-vous en cours de report n’est jamais décompté de son propre créneau cible, mais le déplacer vers un créneau où le même profil a déjà un autre rendez-vous renvoie 409 avec l’appointment_id de ce rendez-vous.Si le lieu cible est géré par Aniva, le nouvel horaire doit aussi être situé au moins 12 heures à l’avance — voir Délai minimum.
string
UUID du nouveau lieu de prélèvement. Le lieu doit exister et être actif. Utilise Lister les lieux pour trouver les identifiants de lieux disponibles.
string[]
Remplace la liste de 5 adresses maximum qui reçoivent chacune un e-mail une fois tous les résultats de laboratoire définitifs. Envoie [] pour désactiver ces e-mails. Ce champ reste modifiable après la prise de sang ; seul un rendez-vous annulé le refuse. Après la prise de sang, envoie-le seul : avec scheduled_at ou location_id dans le même corps, la requête renvoie 409. Ta clé doit avoir l’accès results_view au patient, sinon 403. Voir E-mails de résultats prêts.
string | null
Nouvelle méthode de prélèvement : capillary ou venous, ou null pour réutiliser le default_draw_method du lieu. Le lieu doit inclure cette méthode dans ses draw_methods et les analyses réservées doivent être réalisables avec elle, sinon 400. Lorsque tu déplaces un rendez-vous vers un autre lieu, la même vérification s’y applique : sur son propre draw_method, ou sinon sur le default_draw_method du nouveau lieu.

Réponse

En cas de succès, l’API renvoie 200 OK avec le rendez-vous mis à jour et son profil intégré.
string
requis
Identifiant unique du rendez-vous (UUID).
string
requis
UUID du profil auquel ce rendez-vous appartient.
string
UUID du lieu de test où la prise de sang a lieu.
string
Date et heure prévues du rendez-vous sous forme d’instant UTC (ISO 8601 avec le suffixe Z, par ex. 2026-05-20T14:00:00Z). Peut être null.
string
requis
Statut actuel du rendez-vous. Prend l’une des valeurs pending, confirmed, blood_drawn ou cancelled. Le détail d’avancement des résultats de laboratoire s’obtient via Récupérer les résultats ; la progression fine des envois via chaque entrée du tableau shipments intégré (voir ci-dessous), puis Récupérer un envoi.
string
Motif en texte libre saisi lors de l’annulation du rendez-vous (par ex. absence, annulation tardive, « Échec. À refaire »). null sauf si status vaut cancelled.
string[]
requis
Adresses en minuscules qui reçoivent chacune un e-mail une fois tous les résultats de laboratoire définitifs. Vide si désactivé. Voir E-mails de résultats prêts.
string
requis
Méthode de prise de sang : capillary (au bout du doigt ou sur le haut du bras, dans des microtubes) ou venous (dans la veine, dans des tubes). C’est la méthode définie par le rendez-vous, sinon le default_draw_method de son lieu. Après la prise de sang, c’est la méthode qui a été utilisée.
string
requis
Horodatage ISO 8601 de création du rendez-vous.
string
Horodatage ISO 8601 de la dernière mise à jour. Peut être null.
object
requis
Le profil patient associé à ce rendez-vous.
AppointmentPanel[]
requis
Panels actuellement associés à ce rendez-vous. Exclut les associations annulées. Consulte les détails d’un panel (nom, biomarqueurs) via Lister les panels.
AppointmentIndividualBiomarker[]
requis
Biomarqueurs à la carte rattachés à ce rendez-vous en dehors de tout panel (voir Ajouter des biomarqueurs personnalisés). Croise chaque biomarker_id avec Lister les biomarqueurs pour obtenir les données d’affichage.
AppointmentShipmentLink[]
requis
Expéditions liées à ce rendez-vous, du lien le plus ancien au plus récent. Tableau vide lorsqu’aucune expédition n’est liée. Croise chaque id avec Consulter une expédition pour obtenir la charge utile complète de l’expédition.
string[]
requis
Codes laboratoire (codes-barres des tubes) enregistrés pour ce rendez-vous, dans l’ordre de scan. Vide jusqu’à la confirmation de la prise de sang. Une prise de sang veineuse porte un seul code imprimé sur chaque tube ; une prise de sang capillaire porte un code par microtube. Les résultats et documents dans Obtenir les résultats référencent ces codes via lab_code.

Réponses d’erreur