Passer au contenu principal
POST
Signale que le patient a effectué son prélèvement. C’est l’équivalent pour le kit à domicile de Confirmer la prise de sang — sans code-barres, car le code du kit est apposé lorsque le kit est emballé. Tu transmets uniquement l’horodatage du prélèvement. L’horodatage a une importance clinique : c’est l’heure de prélèvement qui figurera sur le rapport de laboratoire. Envoie le moment réel du prélèvement par le patient, pas celui auquel ton système l’a traité. Renvoyer le même activated_at retourne 200 avec la commande activée ; un horodatage différent retourne 409. Voir Idempotence. L’activation fait passer la commande au statut activated — un statut final. Une commande activée ne peut plus être annulée, et sa composition ainsi que son adresse de livraison sont verrouillées. L’activation est acceptée tant que la commande est pending ou dispatched, à condition qu’elle dispose d’un lab_code — le patient peut avoir un kit en main avant que nos données n’indiquent qu’elle est expédiée, et son heure réelle de prélèvement prime toujours sur notre suivi. Une commande sans lab_code renvoie 409 : sans ce code, l’échantillon ne peut pas être rattaché au patient au laboratoire. L’activation passe aussi la commande au laboratoire pour le panel du kit sous le lab_code de la commande, afin que l’échantillon soit attendu au laboratoire et que les résultats puissent y être associés dès leur transmission. Cela se fait de manière asynchrone après la réponse — un problème de laboratoire ne fait jamais échouer ta requête. À partir de là, Obtenir les résultats affiche les marqueurs comme planned jusqu’à ce que le laboratoire les transmette. Un webhook home_kit_order.results.updated t’informe lorsqu’ils changent. Si l’échantillon arrive au laboratoire avant que tu n’actives le kit, Aniva l’active. activated_at correspond au matin du premier événement de suivi du colis retour, ou au matin où l’échantillon est arrivé au laboratoire s’il n’y a pas de suivi. Un appel ultérieur avec un autre activated_at renvoie alors 409. Nécessite le scope home_kit_orders_manage ou le scope plus restreint home_kit_orders_activate.

Requête

Paramètres de chemin

string
requis
Identifiant unique (UUID) de la commande de kit à domicile à activer.

Paramètres du corps

string
requis
Moment auquel le patient a effectué le prélèvement, sous forme d’instant UTC (ISO 8601 avec suffixe Z, par ex. 2026-08-28T07:30:00Z). Ne doit pas être dans le futur ni remonter à plus de 30 jours.

Réponse

En cas de succès, l’API renvoie 200 OK avec la commande de kit à domicile mise à jour — status vaut activated et activated_at contient l’horodatage que tu as envoyé.

Réponses d’erreur