Grupos de perfiles
Al crear un perfil, lo asignas a un grupo de perfiles mediante el parámetroprofile_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
UUID generado automáticamente por Aniva. Úsalo para hacer referencia al perfil en otras llamadas
a la API.
Nombre del paciente. Solo caracteres latinos, 1–100 caracteres. Obligatorio al crear el perfil.
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.
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.
Número de teléfono en formato E.164 (p. ej.,
+14155552671). Puede ser null.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.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.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.
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 sindate_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:- Crear — registra el perfil con los campos demográficos obligatorios y un
profile_group(UUID o slug). - Actualizar (opcional) — añade o cambia campos como
phone,heightoweight. - Asociar — vincula el perfil a citas usando su
idcomoprofile_id.
profile.* te avisa cuando un perfil aparece, cambia o se elimina.