Saltar al contenido principal
Usa esta guía para confirmar que se ha realizado una extracción de sangre. La confirmación registra los códigos de laboratorio (códigos de barras de los tubos) del kit físico y activa el flujo de órdenes de laboratorio; a partir de ahí, el progreso de los resultados se consulta en Obtener resultados.
La confirmación es irreversible. Una vez que confirmas una extracción de sangre, no se pueden hacer más cambios —incluido añadir paneles— en la cita. Asegúrate de que todos los paneles estén asociados y de que todos los datos sean correctos antes de continuar.
1

Comprobar que los paneles estén añadidos

Antes de confirmar, comprueba que se hayan añadido a la cita todos los paneles de análisis necesarios. No puedes añadir paneles después de la confirmación.Consulta la guía Programar una cita para ver cómo asociar paneles.Confirma lo siguiente antes de continuar:
  • Todos los paneles necesarios están asociados a la cita.
  • El profile_id y el location_id de la cita son correctos.
  • El paciente ha completado la extracción de sangre y tienes a mano el código de barras de cada tubo.
2

Confirmar la extracción de sangre

Envía una solicitud POST a /api/v1/appointments/{id}/confirm con los códigos de laboratorio del kit físico de extracción de sangre. Una extracción venosa tiene un único código impreso en todos los tubos: envíalo como lab_code. Una extracción en farmacia tiene un código por microtubo: envíalos como lab_codes, con una entrada por código y los panel_ids que contiene ese microtubo (tomados de panels de la cita); cada código genera su propia petición de laboratorio. Los biomarcadores individuales en farmacia ocupan primero el espacio libre de los microtubos de los paneles. Envía una entrada sin panel_ids por cada microtubo que necesiten por separado.
Cada código debe ser la cadena numérica impresa en el tubo físico entregado al paciente. No lo sustituyas por otro identificador: un código incorrecto hará que falle la orden de laboratorio. Todos los códigos se validan antes de guardar nada; si se rechaza uno, no se registra nada.
Una solicitud correcta devuelve 200 OK:
3

Verificar el estado de la cita

Después de la confirmación, consulta la cita para comprobar que su estado ha cambiado a blood_drawn.
Cuando la cita muestra status: "blood_drawn", se ha activado el flujo de órdenes de laboratorio. A partir de aquí, el estado de la cita se mantiene en blood_drawn; el avance detallado posterior se consulta en endpoints específicos: sigue cada entrada del array integrado shipments en Obtener envío para los eventos de mensajería en tránsito / entregado, y usa Obtener resultados para ver la finalización de los resultados de laboratorio (status: "in_progress" → "completed").

Qué ocurre después

Tras la confirmación, el flujo de órdenes de laboratorio de Aniva toma el relevo:
  1. Cada código de laboratorio se empareja con sus tubos físicos en el laboratorio: la petición de cada panel lleva el código de sus propios tubos.
  2. Los paneles asociados a la cita determinan qué pruebas se realizan.
  3. Cuando los resultados están listos, se asocian al perfil del paciente y aparecen en Obtener resultados: el campo status de nivel superior de la respuesta cambia de in_progress a completed cuando todos los envíos se han cerrado y uno ha emitido resultados.
Tu integración no tiene que hacer nada más después de la confirmación.

Gestión de errores