Saltar al contingut principal
POST
Informa que el pacient ha recollit la mostra. És l’equivalent per al kit de prova a casa de Confirma l’extracció de sang — sense codi de barres, perquè el codi del kit s’aplica quan s’empaqueta. Només has de passar la marca de temps de la recollida. La marca de temps té importància clínica: és l’hora de recollida que constarà a l’informe del laboratori. Envia el moment real en què el pacient ha recollit la mostra, no el moment en què el teu sistema ho ha processat. Tornar a enviar el mateix activated_at retorna 200 amb la comanda activada; un de diferent retorna 409. Consulta Idempotència. L’activació passa la comanda a activated — un estat final. Una comanda activada ja no es pot cancel·lar, i la composició i l’adreça de lliurament queden bloquejades. L’activació s’accepta mentre la comanda és pending o dispatched, sempre que tingui un lab_code — el pacient pot tenir un kit a les mans abans que el nostre registre indiqui que s’ha enviat, i la seva hora real de recollida sempre preval sobre el nostre control intern. Una comanda sense lab_code retorna 409: sense el codi, la mostra no es pot associar al pacient al laboratori. L’activació també fa la sol·licitud al laboratori per al panell del kit amb el lab_code de la comanda, de manera que el laboratori espera la mostra i els resultats s’hi poden vincular tan bon punt es notifiquin. Això passa de manera asíncrona després de la resposta — un problema del laboratori no fa fallar mai la teva petició. A partir d’aquest moment, Obtén els resultats mostra els marcadors com a planned fins que el laboratori els notifiqui. Un webhook home_kit_order.results.updated t’avisa quan canvien. Si la mostra arriba al laboratori abans que activis el kit, l’activa Aniva. activated_at és el matí del primer esdeveniment de seguiment del paquet de retorn, o el matí en què la mostra ha arribat al laboratori si no hi ha seguiment. Aleshores, una crida posterior amb un activated_at diferent retorna 409. Requereix l’àmbit home_kit_orders_manage o l’àmbit més restringit home_kit_orders_activate.

Sol·licitud

Paràmetres de ruta

string
requerit
Identificador únic (UUID) de la comanda de kit de prova a casa que vols activar.

Paràmetres del cos

string
requerit
Quan el pacient ha recollit la mostra, com a instant UTC (ISO 8601 amb el sufix Z, p. ex., 2026-08-28T07:30:00Z). No pot ser en el futur ni tenir més de 30 dies d’antiguitat.

Resposta

Si té èxit, l’API retorna 200 OK amb la comanda de kit de prova a casa actualitzada — status és activated i activated_at conté la marca de temps que has enviat.

Respostes d’error