Saltar al contenido principal
API

Los nombres de los recipientes en la vista previa de la cita pasan a ser nombres de producto

A partir de la próxima versión, containers[].name en Previsualizar cita es el nombre de producto del tubo. type no cambia, así que lee type si tu app compara recipientes.
Panel de administraciónAPI

Aniva ya funciona en todos los idiomas de la UE, y en algunos más

API

Un solo endpoint para listar paneles

API

Muestra resultados de laboratorio dentro de tu app

Tus pacientes ya pueden ver sus resultados de laboratorio dentro de tu app: la lista de biomarcadores, la evolución de cada biomarcador y un Twin 3D con una puntuación por área de salud. La página usa el color de tu marca y tu logo, en modo claro u oscuro.La página de resultados es un complemento de pago y tu contacto en Aniva puede decirte el precio. Crear sesión incrustada muestra cómo configurarla.
API

Las lecturas de listado de la API se guardan en caché hasta 5 minutos

Estos cuatro endpoints ahora guardan en caché su respuesta hasta 5 minutos, por lo que un cambio puede tardar hasta 5 minutos en aparecer:Los endpoints Get siguen mostrando los cambios directamente.Si consultas la API periódicamente para detectar cambios, usa webhooks en su lugar. Un webhook te avisa de cada cambio en cuanto ocurre. Consulta Lecturas repetidas.
Panel de administración

Consulta cuándo viene el mensajero a por tus muestras

El panel de administración ahora muestra la próxima recogida del mensajero en tu consulta, con seguimiento y etiqueta.Panel de administración con un banner en la parte superior: GO! viene mañana ~10:00–12:00.Panel de administración con un banner en la parte superior: GO! viene mañana ~10:00–12:00.
API

Los rangos de Aniva ya están disponibles

Tus resultados ya pueden incluir los rangos de Aniva: un rango general y un rango más estrecho para cada biomarcador, con las fuentes que ha registrado Aniva. Los rangos varían según la edad, el sexo y la semana de embarazo.Para obtener acceso, firma el breve acuerdo sobre los rangos de Aniva. Después los activamos para tu clave de API. Pide el acuerdo a tu contacto en Aniva.Los rangos están en el nuevo campo aniva_range. Sustituye a reference_range_aniva, que siempre era null. Los rangos son información general. No evalúan un resultado y no son consejo médico ni un producto sanitario. El rango del laboratorio sigue siendo el estándar. Consulta Rangos de Aniva.
API

El tubo de fluoruro ahora es fluoride

Previsualizar contenedores llama fluoride al tubo de fluoruro. El valor anterior era naf. Si tu código compara container.type con naf, cámbialo a fluoride.Pueden aparecer dos nuevos valores: lihep_capillary y fluoride_capillary. Son el tubo capilar de heparina de litio y el tubo capilar de fluoruro.
API

Sin reservas duplicadas en la última franja

Si llegan a la vez dos reservas para la última plaza de una franja, solo se completa una. La otra recibe 409, como cualquier franja completa. Lo mismo ocurre cuando se modifica una cita mientras se cancela o se confirma.Confirmar extracción de sangre tiene tres nuevos motivos de 409:
  • remapped: el código ahora corresponde a paneles distintos a los anteriores.
  • sent_to_lab y order_in_flight: el laboratorio puede tener ya el pedido, así que el código debe permanecer en su tubo.
APIKits de prueba en casa

Direcciones de entrega más estrictas en los pedidos de kits de prueba en casa

Crear kit de prueba en casa y Actualizar kit de prueba en casa comprueban delivery_address de forma más estricta.
  • country_code acepta minúsculas, p. ej., de. Aniva lo guarda y lo devuelve en mayúsculas.
  • Una dirección alemana (DE) necesita un postal_code de exactamente 5 dígitos. Otros valores reciben un 400.
  • Los espacios alrededor de postal_code se eliminan antes de guardarlo.
Panel de administraciónKits de prueba en casaAPI

Un kit nuevo por un kit que nos devuelven

Cuando el transportista nos devuelve un kit, ya no esperamos a recibir la caja. Dinos que quieres el kit de nuevo y enviamos uno nuevo enseguida. También puedes crearlo por tu cuenta: llama a Crear kit de prueba en casa con replaces_home_kit_order_id establecido en el kit devuelto. El kit nuevo es un pedido aparte con un nuevo código de kit.Revisamos la caja devuelta cuando llega. Entonces el kit devuelto pasa a cancelled y ves qué había en la caja.
ResultadosAPIPanel de administración

Enviar un correo a tu equipo cuando los resultados estén listos

Pídenos que configuremos una dirección de correo predeterminada para tu grupo de perfiles, por ejemplo, la bandeja de entrada de tu equipo. Así recibirá un correo cuando los resultados de una nueva reserva estén listos. Esto cubre las reservas del panel de administración, de la API y de tus pacientes.Para cambiarlo en una reserva:
  • Panel de administración: edita las direcciones de correo o desactiva “Enviarme un correo cuando los resultados estén listos”.
  • API: envía una lista en results_ready_emails para usar esas direcciones de correo en su lugar. Para mantener tu dirección de correo predeterminada, inclúyela en la lista. Envía [] para no enviar ningún correo.
Consulta Correos de resultados listos.
APIKits de prueba en casa

El paciente introduce la fecha de nacimiento y el sexo

Ahora podemos permitir que tu grupo de perfiles cree un perfil sin date_of_birth ni sex. El paciente introduce ambos datos en la página de activación del kit, escribiendo dos veces la fecha de nacimiento. Pídenos que lo activemos. Consulta Perfiles.
Panel de administración

Un panel de administración más rápido

El panel de administración ahora muestra el primer contenido en unos 0,2 s, frente a los 1,3 s anteriores. Se acabaron los indicadores de carga. Las páginas se rellenan a medida que llegan sus datos. Las páginas empiezan a cargarse al pasar el cursor por un enlace.
Panel de administraciónKits de prueba en casaWebhooks

Kits que nos devuelven

Cuando el transportista nos devuelve un kit, la página Kits de prueba en casa ahora lo muestra. Filtra por Devuelto para ver todos los kits que nos devolvió el transportista, con el motivo que indicó. El envío termina en fault y dispara shipment.fault, ya no delivered. En cuanto abrimos la caja, también ves qué había dentro: completo, falta una pieza o abierto. Eso te indica si tu cliente recibe un reembolso completo.¿Quieres que volvamos a enviar el kit? Escríbenos con el código del kit y la dirección de entrega correcta. Lo enviamos con el mismo código de kit.
API

Unidades logarítmicas

Listar unidades devuelve un tercer unit_type: logarithmic, para un valor que es el logaritmo de una magnitud, como el pH o un índice aterogénico. Trátalo como physical al mostrarlo. No lo escales: dos unidades logarítmicas difieren por un desplazamiento, no por un factor.
APIPrecios

Presupuestar un kit de prueba en casa con sus tarifas

Presupuestar carrito acepta fulfilment. Envía home_kit con un country_code y el desglose añade las líneas del kit que cobra tu factura mensual por un pedido: la tarifa del kit, los dispositivos de recogida, el envío postal de ida y vuelta a ese país, la funda y una bolsa de lancetas de repuesto. El valor predeterminado sigue siendo draw en una ubicación con las tarifas de la cita. La respuesta indica cuál ha presupuestado en fulfilment.kind.
Concierge

Conoce Aniva Concierge

A partir de ahora, nuestro registro de cambios también aparece en tu canal de Slack con nosotros, en cuanto lanzamos algo.También hemos creado Aniva Concierge. ¿Tienes alguna pregunta sobre la API o el panel de administración? Menciona a @Aniva en Slack o simplemente responde en una publicación del registro de cambios. Consulta nuestra documentación y te dice dónde hacer clic en el panel de administración, o qué endpoint y filtros usar, con un enlace a la página.
APICitas

Listar las citas de un día

Listar citas acepta dos filtros nuevos. date (YYYY-MM-DD) devuelve un día natural, en la zona horaria de la ubicación de cada cita, empezando por la más temprana. location_id devuelve una única ubicación de pruebas. Usa ambos para la agenda de hoy de una ubicación.
APIPerfiles

Se rechazan los perfiles duplicados

Crear perfil ahora devuelve 409 con error_name: "duplicate_profile_error" cuando un perfil visible para tu clave tiene el mismo nombre, apellido, sexo y fecha de nacimiento. La respuesta indica el profile_id existente. Úsalo en lugar de crear un segundo perfil. Los apellidos del sandbox están exentos.
Ubicaciones

Cierra Aniva Berlin Mitte

A partir del 1 de noviembre de 2026, Aniva Berlin Mitte (206e8e2e-1ae6-401b-9dfe-781d639210ed) deja de ofrecer citas. La ubicación más cercana es Aniva Berlin P-Berg | Mariposa (f7897229-5c37-409b-bb43-dc8b50687fbc), Kastanienallee 83, 10435 Berlin.
Panel de administraciónPrecios

Catálogo de pruebas con tus precios

El nuevo Catálogo de pruebas del panel de administración muestra cada biomarcador con sus laboratorios, tubos y precio en tu lista de tarifas.
APIResultados

Por qué un resultado no tiene rango de laboratorio

Cada resultado clínico en Obtener resultados y Obtener resultados de laboratorio para kits de prueba en casa ahora incluye reference_range_lab_absent_reason. Indica por qué reference_range_lab es null:
  • not_provided: no existe ningún rango. Muestra “No aplicable”.
  • lab_text_only: el laboratorio solo imprimió texto, como un objetivo o un nivel de riesgo. Muestra lab_reported.reference_range.
  • not_measured: el resultado es undeliverable.
Es null cuando hay un rango. Consulta Resultados.
APIUbicaciones

Precios de venta al público y coordenadas

Los endpoints y el evento de precios de venta al público necesitan el scope retail_prices_view.
Kits de prueba en casaPanel de administración

Pedir kits de prueba en casa en el panel de administración

Ahora puedes pedir un kit de prueba en casa para tu paciente en la página de kits de prueba en casa del panel de administración. Elige o crea al paciente, elige el kit e introduce la dirección de entrega. También puedes cancelar un kit desde ahí.
APIPrecios

Lista de tarifas y presupuestos

  • Obtener lista de tarifas devuelve tus tarifas del catálogo de Aniva y tus cargos.
  • Presupuestar cesta calcula el precio de paneles y biomarcadores sin cita.
  • La factura en Presupuestar cesta y Previsualizar cita ahora tiene fees, total_with_fees_cents y un name en cada fila de biomarcador.
  • rate_card en los listados toma el id de Obtener lista de tarifas.
Ambos endpoints nuevos necesitan el permiso prices_view.
APIResultados

Más detalles de los documentos

Cada entrada en documents de Obtener resultados ahora tiene:
  • file_name: el nombre que usa Descargar documento.
  • Nuevos: original_file_name, origin, content_type, etag, size_bytes.
Un PDF de informe sustituido ahora envía results.updated, por ejemplo el informe final de Labor Quade (_E) tras el preliminar (_V).
APIWebhooks

Webhooks

Aniva ahora llama a tu servidor cuando cambia una cita, un pedido de kit de prueba en casa, sus resultados, una ubicación, un perfil o un envío. Ya no necesitas consultar periódicamente.
  • Registra una URL HTTPS con Crear webhook. Necesitas el permiso webhooks_manage. Pide a Aniva que lo añada a tu clave o que configure el webhook por ti.
  • Los eventos cubren todos los estados de una cita y de un pedido de kit de prueba en casa, una nueva hora o ubicación y todos los cambios en los resultados. results.completed te indica que los resultados son definitivos.
  • Los eventos location.*, profile.* y shipment.* te avisan cuando una ubicación, un perfil o un envío aparece, cambia o desaparece. Un envío también envía shipment.<status> en cada cambio de estado.
  • Los eventos incluyen ID y estados, nunca valores de laboratorio ni datos personales. Consulta la url del evento para obtener los datos.
  • Cada petición está firmada con el esquema Standard Webhooks.
  • Aniva reintenta una entrega fallida 10 veces durante unos tres días. Puedes listar y reenviar entregas durante 30 días.
  • Cada resultado en Obtener resultados ahora tiene un id, así que puedes actualizar el resultado al que apunta un evento results.updated.
  • Obtener ubicación devuelve una ubicación por su id. La url de un evento location.* apunta a ella.
Consulta Webhooks.
ResultadosPanel de administración

Enviar los resultados al cliente por correo

Ahora puedes avisar por correo a un cliente de que sus resultados de laboratorio están listos. Envíalo desde la página de resultados de laboratorio en el panel de administración, o mediante dos nuevos endpoints: Enviar resultados por correo para citas y Enviar resultados por correo para pedidos de kits de prueba en casa.
  • El correo puede adjuntar los informes de laboratorio como archivos PDF. Cada PDF está protegido con contraseña: la contraseña es la fecha de nacimiento del cliente en 8 dígitos (DDMMAAAA), y el correo lo indica.
  • Puedes añadir una nota personal de como máximo 1.000 caracteres.
  • Muestra el nombre y el logo del grupo de perfiles principal del perfil, en el idioma del perfil.
  • Cada envío es un correo. Un reintento envía un segundo correo. Necesitas el permiso results_view para ese cliente.

Recibir un correo cuando los resultados estén listos

Cuando reservas una cita o pides un kit de prueba en casa de sustitución en el panel de administración, puedes activar “Enviarme un correo cuando los resultados estén listos”. Entonces te enviamos un correo, o a la dirección que escribas, en cuanto lleguen todos los resultados de laboratorio. El correo enlaza al resultado en el panel de administración. El cliente no recibe este correo. Necesitas el permiso results_view para ese cliente.A través de la API, puedes indicar hasta 5 direcciones en results_ready_emails en Crear cita, Crear pedido de kit de prueba en casa, Actualizar cita y Actualizar pedido de kit de prueba en casa.
Kits de prueba en casa

Enviar el teléfono y el correo del destinatario con cada kit

Si delivery_address de un kit de prueba en casa incluye phone o email, se los pasamos al transportista. El transportista avisa entonces al destinatario cuando el paquete está en camino o espera en un punto de recogida. Si los omites, el transportista no recibe ningún contacto, aunque el perfil tenga uno. Tú decides quién recibe los avisos del transportista. El aviso puede indicar a Aniva Health como remitente.Consulta Crear pedido de kit de prueba en casa.
Ubicaciones

Aniva Berlin P-Berg (Mariposa), Potsdam, Mannheim y Wiesbaden

Cuatro nuevas ubicaciones para extracciones de sangre venosa. Consulta Listar ubicaciones.
Panel de administración

Página de resultados de laboratorio

La nueva página de resultados de laboratorio en el panel de administración muestra cada extracción de sangre y cada kit de prueba en casa activado con sus informes de laboratorio. Busca por nombre, fecha de nacimiento o código de barras del tubo. Necesitas el permiso results_view y una autorización de kits de prueba en casa para ver los kits.
Kits de prueba en casa

Claves de API solo para activación

El nuevo permiso home_kit_orders_activate permite que una clave active kits de prueba en casa y nada más. No puede crear, modificar ni cancelar un kit. Pide a Aniva una clave así si un sistema independiente activa tus kits.Consulta Activar pedido de kit de prueba en casa.
APICambio incompatible

El sexo debe ser masculino o femenino

Crear perfil y Actualizar perfil ya no aceptan sex: 0 (desconocido). Envía 1 para masculino o 2 para femenino; 0 devuelve 400. El laboratorio necesita el sexo para los intervalos de referencia, y un pedido para un perfil sin sexo no podía llegar al laboratorio.Consulta Crear perfil.
Kits de prueba en casa

Kits que llegan al laboratorio sin activar

Si una muestra llega al laboratorio antes de que se active su kit, Aniva activa el kit. activated_at es la mañana del primer evento de seguimiento del paquete de devolución, o la mañana en que la muestra llegó al laboratorio si no hay seguimiento. Una llamada posterior a Activar con un activated_at diferente devuelve 409.Consulta Activar pedido de kit de prueba en casa.
API

Intervalos de Aniva en los resultados

Los endpoints de resultados ahora rellenan reference_range_aniva con los valores de comparación que Aniva ha recopilado, convertidos a la unidad del resultado. Los valores varían según la edad, el sexo y la semana de embarazo. Tu clave necesita el permiso ANIVA_REFERENCE_RANGES_VIEW. Sin él, el campo es null.Consulta Obtener resultados de la cita.
APIKits de prueba en casa

Kits de sustitución

Pide una sustitución cuando un kit no haya podido proporcionar todos los resultados. Una sustitución es un pedido nuevo con un nuevo código de laboratorio y mantiene el panel del pedido original. biomarker_ids indica qué vuelve a analizar el laboratorio.Consulta Pedidos de kits de prueba en casa.
APIPreciosCambio incompatible

Un precio por biomarcador y panel

Los biomarcadores y los paneles tienen un único price_cents según tu lista de tarifas, con retail_cents junto a él:
  • > 0: se puede pedir por separado.
  • 0: un cociente (consulta requires), o solo se puede pedir con otros marcadores (consulta positions).
  • null: sin precio, por lo que no se puede pedir.
Cambio incompatible: se elimina groups[] de los listados y de la vista previa de la cita. Se eliminan los campos de precio retail y yours.Consulta Precios.
API

Claves de idempotencia

Los endpoints de creación de perfiles, citas, pedidos de kits de prueba en casa y envíos aceptan una cabecera Idempotency-Key. Un reintento con la misma clave devuelve la primera respuesta y no escribe nada.Consulta Idempotencia.
Ubicaciones

Aniva Hannover, Düsseldorf, Duisburg y Essen

Cuatro nuevas ubicaciones de Aniva en Alemania están abiertas para extracciones de sangre venosa: Hannover, Düsseldorf, Duisburg y Essen. Llama a Listar ubicaciones para ver las ubicaciones que puede reservar tu clave.