Saltar al contenido principal
Esta guía te acompaña paso a paso por el flujo principal: encontrar una ubicación de análisis, crear un perfil de paciente, programar una cita y confirmar una extracción de sangre.

Requisitos previos

Necesitas una clave API de socio emitida por Aniva.
Si todavía no tienes una clave API, contacta con Aniva para que emita una para tu cuenta de socio.

Pasos

1

Listar ubicaciones disponibles

Obtén la lista de ubicaciones de análisis para encontrar un location_id para la cita que vas a programar.
Ejemplo de respuesta
Anota el id de la ubicación que quieras usar. Lo necesitarás en el paso 3.
2

Crear un perfil

Crea un perfil de paciente enviando sus datos demográficos. profile_group vincula el perfil a tu cuenta de socio: acepta tanto el UUID inmutable del grupo como su slug legible.
Campos del cuerpo de la solicitud** Opcional cuando tu grupo de perfiles permite que el paciente introduzca ambos datos en la página de activación del kit. Consulta Perfiles.Ejemplo de respuesta (201 Created)
Anota el id de la respuesta. Lo usarás como profile_id en el siguiente paso.
3

Programar una cita

Crea una cita con el profile_id del paso 2 y el location_id del paso 1. Establece scheduled_at con la hora de inicio de una franja que devuelva Consultar disponibilidad para esa ubicación. La API rechaza cualquier hora que no coincida con las franjas disponibles.
Ejemplo de respuesta (201 Created)
Anota el id de la cita. Lo usarás para confirmar la extracción de sangre.
4

Confirmar la extracción de sangre

Cuando termine la extracción de sangre, envía el código de laboratorio (código de barras del tubo) para confirmarla y activar el flujo de órdenes de laboratorio. Si los tubos de una extracción llevan varios códigos, envía lab_codes en su lugar; consulta Confirmar extracción de sangre.
Ejemplo de respuesta (200 OK)
Una vez confirmada, se activa el flujo de órdenes de laboratorio. Puedes consultar la cita para comprobar que su estado ha cambiado a "blood_drawn".

Próximos pasos