Saltar al contenido principal
Un perfil es un registro que representa a un paciente o usuario en el sistema de Aniva. Cada cita, pedido de laboratorio y resultado está asociado a un perfil.

Grupos de perfiles

Al crear un perfil, lo asignas a un grupo de perfiles mediante el parámetro profile_group. Un grupo de perfiles organiza los perfiles en tu cuenta de socio, vinculándolos a un programa o una integración concretos. El campo profile_group acepta tanto el UUID inmutable del grupo como su slug legible. El UUID es la referencia duradera: nunca cambia y se mantiene aunque se renombre el slug. El slug está pensado para URL legibles e integraciones de socios. Es obligatorio indicar un valor en profile_group (UUID o slug) al crear el perfil. El campo heredado profile_group_slug sigue aceptándose como alias obsoleto.

Campos

string
requerido
UUID generado automáticamente por Aniva. Úsalo para hacer referencia al perfil en otras llamadas a la API.
string
Nombre de usuario o identificador opcional para el perfil. Puede ser null.
string
Nombre del paciente. Solo caracteres latinos, 1–100 caracteres. Obligatorio al crear el perfil.
string
Apellido del paciente. Solo caracteres latinos, 1–100 caracteres. Obligatorio al crear el perfil: los laboratorios rechazan pedidos de pacientes sin apellido. Puede ser null en perfiles creados antes de que fuera obligatorio.
string
Dirección de correo electrónico del paciente. Si no proporcionas una al crear el perfil, Aniva genera automáticamente un correo electrónico provisional.
string
Número de teléfono en formato E.164 (p. ej., +14155552671). Puede ser null.
integer
Sexo biológico según ISO/IEC 5218: 1 = masculino, 2 = femenino. Obligatorio al crear el perfil, salvo que tu grupo de perfiles permita que lo introduzca el paciente (ver más abajo). El laboratorio lo necesita para los intervalos de referencia, así que crear o actualizar con 0 (desconocido) devuelve 400. Los perfiles creados antes del 30 de septiembre de 2026 pueden seguir devolviendo 0.
string
Fecha de nacimiento en formato YYYY-MM-DD. Obligatoria al crear el perfil, salvo que tu grupo de perfiles permita que la introduzca el paciente (ver más abajo). Debe ser una fecha pasada, no anterior a 1900, e implicar una edad de entre 16 y 100 años; los valores inverosímiles se rechazan con 400. La fecha de nacimiento se envía al laboratorio en el pedido y no puede modificarse una vez realizado el pedido.
number
Altura en centímetros. Puede ser null.
number
Peso en kilogramos. Puede ser null.
string
Idioma preferido para las comunicaciones con el paciente. Valores aceptados: en, de, fi.
boolean
Indica si el perfil recibe correos electrónicos transaccionales, como confirmaciones de cita y avisos de resultados listos. Es independiente del consentimiento de marketing. Es null si nunca se ha configurado.
string
requerido
Marca de tiempo ISO 8601 de cuándo se creó el perfil.
string
Marca de tiempo ISO 8601 de la actualización más reciente. Es null si el perfil nunca se ha actualizado.
Los campos first_name, last_name, sex, date_of_birth y profile_group son obligatorios al crear un perfil. Todos los demás campos son opcionales. El campo heredado profile_group_slug sigue aceptándose como alias obsoleto de profile_group.

Permitir que el paciente introduzca la fecha de nacimiento y el sexo

Podemos activar un ajuste para tu grupo de perfiles. Así podrás crear un perfil sin date_of_birth ni sex. Pídenos que lo activemos. Sin este ajuste, crear un perfil omitiendo cualquiera de los dos campos devuelve 400. El paciente introduce ambos datos en la página de activación del kit (anivahealth.com/activate), junto con el código del kit. La página pide la fecha de nacimiento dos veces, porque el laboratorio no puede modificarla después. A partir de entonces, el kit solo se abre con esa fecha de nacimiento. Hasta que el paciente introduce ambos datos, retenemos el pedido de laboratorio. Usa este ajuste solo para kits de prueba en casa.

Ciclo de vida

Los perfiles siguen un ciclo de vida sencillo:
  1. Crear — registra el perfil con los campos demográficos obligatorios y un profile_group (UUID o slug).
  2. Actualizar (opcional) — añade o cambia campos como phone, height o weight.
  3. Asociar — vincula el perfil a citas usando su id como profile_id.
Un webhook profile.* te avisa cuando un perfil aparece, cambia o se elimina.

Perfil de ejemplo