Passer au contenu principal
POST
Enregistre qu’une prise de sang a été effectuée et déclenche le flux de commande laboratoire. Envoie les codes laboratoire (codes-barres des tubes) du kit de prise de sang pour lier les échantillons physiques au rendez-vous. Une prise de sang porte ses codes de deux manières possibles :
  • Un code pour toute la prise de sang — une prise de sang veineuse, où le même code-barres est imprimé sur chaque tube. Envoie-le dans lab_code.
  • Un code par microtube — une prise de sang capillaire, où chaque microtube possède son propre code-barres. Envoie-les dans lab_codes, à raison d’une entrée par code avec les panel_ids que contient son microtube. Chaque code devient sa propre demande de laboratoire — le code-barres sur le tube correspond au numéro de commande du laboratoire. Une entrée sans panel_ids sert d’entrée générique pour tous les panels non mentionnés ailleurs. Une prise de sang veineuse en comporte au maximum une.
Envoie exactement l’un des deux. Chaque panel rattaché doit se retrouver sous exactement un code (sa propre entrée ou l’entrée générique). Pour une prise de sang veineuse, les biomarqueurs à la carte nécessitent l’entrée générique. Pour une prise de sang capillaire, indique chaque panel sur le code de son microtube. Les biomarqueurs à la carte occupent l’espace libre des microtubes des panels et n’utilisent de nouveaux microtubes qu’en cas de besoin. Nous les répartissons équitablement. Chaque microtube en contient au maximum 150 µl. Envoie une entrée sans panel_ids pour chaque microtube qui leur est propre, et pas davantage. Un code qui se retrouve sans panel ni biomarqueur est refusé avec 409 et reason: "panel_coverage". Chaque code est validé avant toute écriture ; si un code ne peut pas être utilisé ou qu’un panel n’est pas couvert, rien n’est enregistré et la réponse indique le problème. Nécessite le scope appointments_schedule, appointments_manage ou appointments_operate.
Cette action est irréversible. Une fois que tu confirmes la prise de sang, le rendez-vous est verrouillé — aucune modification supplémentaire, y compris l’ajout de panels, n’est possible.

Requête

Paramètres de chemin

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

Paramètres du corps

string
Code laboratoire numérique imprimé sur le kit de prise de sang, lorsqu’un seul code couvre tous les tubes. Mutuellement exclusif avec lab_codes.
object[]
Tous les codes laboratoire de la prise de sang, dans l’ordre de scan (au moins une entrée). Mutuellement exclusif avec lab_code. Un code ne peut apparaître qu’une seule fois ; un panel ne peut être mentionné que sur une seule entrée.

Réponse

En cas de succès, l’API renvoie 200 OK confirmant que le flux de commande laboratoire a été déclenché.
boolean
true lorsque la prise de sang a été enregistrée et que le pipeline de commande laboratoire a été déclenché.
string
Présent uniquement lorsque la prise de sang a été enregistrée un autre jour que celui du rendez-vous. Les clés ordinaires ne peuvent pas le faire — elles reçoivent un 409 avec reason: "appointment_not_today". Replanifie le rendez-vous au jour de la prise de sang, puis confirme.
Les codes enregistrés sont renvoyés sous lab_codes dans Récupérer un rendez-vous, et chaque résultat et document dans Récupérer les résultats porte le lab_code sous lequel il a été classé.

Réponses d’erreur