Saltar al contenido principal
POST
Informa de que el paciente ha tomado su muestra. Es el equivalente para kit de prueba en casa de Confirmar extracción de sangre, sin código de barras, porque el código del kit se aplica al empaquetarlo. Solo tienes que pasar la marca de tiempo de la toma. La marca de tiempo tiene relevancia clínica: es la hora de la toma que figurará en el informe del laboratorio. Envía el momento real en que el paciente tomó la muestra, no el momento en que tu sistema lo procesó. Volver a enviar el mismo activated_at devuelve 200 con el pedido activado; uno diferente devuelve 409. Consulta Idempotencia. La activación pasa el pedido a activated, un estado terminal. Un pedido activado ya no se puede cancelar, y su composición y dirección de entrega quedan bloqueadas. La activación se acepta mientras el pedido esté en pending o dispatched, siempre que tenga un lab_code: el paciente puede tener el kit en sus manos antes de que nuestro registro indique que se ha enviado, y su hora real de toma siempre prevalece sobre nuestro control interno. Un pedido sin lab_code devuelve 409: sin el código, no se puede asociar la muestra al paciente en el laboratorio. La activación también envía la solicitud de laboratorio para el panel del kit bajo el lab_code del pedido, de modo que el laboratorio espera la muestra y los resultados pueden vincularse en cuanto se comunican. Esto ocurre de forma asíncrona tras la respuesta: un problema en el laboratorio nunca hará fallar tu petición. A partir de aquí, Obtener resultados muestra los marcadores como planned hasta que el laboratorio los comunique. Un webhook home_kit_order.results.updated te avisa cuando cambian. Si la muestra llega al laboratorio antes de que actives el kit, Aniva lo activa. activated_at corresponde a la mañana del primer evento de seguimiento del paquete de devolución, o a la mañana en que la muestra llegó al laboratorio si no hay seguimiento. Una llamada posterior con un activated_at distinto devuelve entonces 409. Requiere el scope home_kit_orders_manage o el scope más específico home_kit_orders_activate.

Solicitud

Parámetros de ruta

string
requerido
Identificador único (UUID) del pedido de kit de prueba en casa que se va a activar.

Parámetros del cuerpo

string
requerido
Momento en que el paciente tomó la muestra, como instante UTC (ISO 8601 con sufijo Z, p. ej., 2026-08-28T07:30:00Z). No puede ser futuro ni tener más de 30 días de antigüedad.

Respuesta

Si tiene éxito, la API devuelve 200 OK con el pedido de kit de prueba en casa actualizado: status es activated y activated_at contiene la marca de tiempo que enviaste.

Respuestas de error