Passer au contenu principal
Utilise ce guide pour confirmer qu’une prise de sang a bien eu lieu. La confirmation enregistre les codes de laboratoire (codes-barres des tubes) du kit physique et déclenche le processus de commande au laboratoire ; l’avancement des résultats se lit ensuite dans Obtenir les résultats.
La confirmation est irréversible. Une fois que tu confirmes une prise de sang, aucune autre modification — y compris l’ajout de panels — ne peut être apportée au rendez-vous. Assure-toi que tous les panels sont associés et que tous les détails sont corrects avant de continuer.
1

Vérifier que les panels sont ajoutés

Avant de confirmer, vérifie que tous les panels d’analyse nécessaires ont été ajoutés au rendez-vous. Tu ne peux plus ajouter de panels après confirmation.Consulte le guide Planifier un rendez-vous pour savoir comment associer des panels.Vérifie les points suivants avant de continuer :
  • Tous les panels requis sont associés au rendez-vous.
  • Les champs profile_id et location_id du rendez-vous sont corrects.
  • Le patient a effectué la prise de sang et le code-barres de chaque tube est à portée de main.
2

Confirmer la prise de sang

Envoie une requête POST à /api/v1/appointments/{id}/confirm avec les codes de laboratoire du kit physique de prise de sang. Une prise de sang veineuse a un seul code imprimé sur chaque tube — envoie-le dans lab_code. Une prise de sang en pharmacie a un code par microtainer — envoie-les dans lab_codes, à raison d’une entrée par code avec les panel_ids que son microtainer contient (issus des panels du rendez-vous) ; chaque code devient sa propre demande d’analyse au laboratoire. Les biomarqueurs individuels en pharmacie remplissent d’abord l’espace libre des microtainers de panel. Envoie une entrée sans panel_ids pour chaque microtainer dont ils ont besoin à eux seuls.
Chaque code doit être la chaîne numérique imprimée sur le tube physique remis au patient. Ne le remplace pas par un autre identifiant — un code incorrect fera échouer la commande au laboratoire. Chaque code est validé avant toute écriture ; si l’un d’eux est rejeté, rien n’est enregistré.
Une requête réussie renvoie 200 OK :
3

Vérifier le statut du rendez-vous

Après confirmation, récupère le rendez-vous pour vérifier que son statut est passé à blood_drawn.
Une fois que le rendez-vous affiche status: "blood_drawn", le processus de commande au laboratoire est déclenché. Le statut du rendez-vous reste à blood_drawn à partir de ce moment ; le suivi plus fin en aval est exposé via des endpoints dédiés : suis chaque entrée du tableau shipments intégré dans Obtenir une expédition pour les événements en transit / livré du transporteur, et utilise Obtenir les résultats pour la finalisation des résultats de laboratoire (status: "in_progress" → "completed").

Et ensuite

Après confirmation, le processus de commande au laboratoire d’Aniva prend le relais :
  1. Chaque code de laboratoire est associé à ses tubes physiques au laboratoire — la demande de chaque panel porte le code figurant sur ses propres tubes.
  2. Les panels associés au rendez-vous déterminent les analyses effectuées.
  3. Lorsque les résultats sont prêts, ils sont associés au profil du patient et apparaissent dans Obtenir les résultats — le champ status de premier niveau de la réponse passe de in_progress à completed une fois que chaque demande est clôturée et qu’une a renvoyé des résultats.
Aucune autre action n’est requise de la part de ton intégration après confirmation.

Gestion des erreurs