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.Aniva ya funciona en todos los idiomas de la UE, y en algunos más
- Panel de administración, sitio web, centro de ayuda y documentación: en los 32 idiomas.
- Perfiles: configura el idioma de cada paciente. La página de resultados y los correos de resultados usan ese idioma.
Un solo endpoint para listar paneles
- Listar paneles ahora devuelve
biomarker_groups. Úsalo en lugar de/api/v2/panels. - Se ha eliminado Crear panel. Usa el panel de administración.
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.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 endpointsGet 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.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 campoaniva_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.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.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 recibe409, 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_labyorder_in_flight: el laboratorio puede tener ya el pedido, así que el código debe permanecer en su tubo.
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 compruebandelivery_address de forma más estricta.country_codeacepta minúsculas, p. ej.,de. Aniva lo guarda y lo devuelve en mayúsculas.- Una dirección alemana (
DE) necesita unpostal_codede exactamente 5 dígitos. Otros valores reciben un400. - Los espacios alrededor de
postal_codese eliminan antes de guardarlo.
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 conreplaces_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.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_emailspara 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.
El paciente introduce la fecha de nacimiento y el sexo
Ahora podemos permitir que tu grupo de perfiles cree un perfil sindate_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.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.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 enfault 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.Unidades logarítmicas
Listar unidades devuelve un tercerunit_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.Presupuestar un kit de prueba en casa con sus tarifas
Presupuestar carrito aceptafulfilment. 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.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.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.Se rechazan los perfiles duplicados
Crear perfil ahora devuelve409 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.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.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 incluyereference_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. Muestralab_reported.reference_range.not_measured: el resultado esundeliverable.
null cuando hay un rango. Consulta Resultados.Precios de venta al público y coordenadas
- Las ubicaciones ahora tienen
state_code,latitudeylongitude. - Listar precios de venta al público y Obtener precios de venta al público devuelven el precio de cada panel que una farmacia vende a clientes sin cita.
- El webhook
location.retail_prices.updatedte avisa cuando cambia un precio.
retail_prices_view.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í.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_centsy unnameen cada fila de biomarcador. rate_carden los listados toma elidde Obtener lista de tarifas.
prices_view.Más detalles de los documentos
Cada entrada endocuments de Obtener resultados ahora tiene:file_name: el nombre que usa Descargar documento.- Nuevos:
original_file_name,origin,content_type,etag,size_bytes.
results.updated, por ejemplo el informe final de Labor Quade
(_E) tras el preliminar (_V).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.completedte indica que los resultados son definitivos. - Los eventos
location.*,profile.*yshipment.*te avisan cuando una ubicación, un perfil o un envío aparece, cambia o desaparece. Un envío también envíashipment.<status>en cada cambio de estado. - Los eventos incluyen ID y estados, nunca valores de laboratorio ni datos personales. Consulta la
urldel 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 eventoresults.updated. - Obtener ubicación devuelve una ubicación por su
id. Laurlde un eventolocation.*apunta a ella.
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_viewpara 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 permisoresults_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.Enviar el teléfono y el correo del destinatario con cada kit
Sidelivery_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.Aniva Berlin P-Berg (Mariposa), Potsdam, Mannheim y Wiesbaden
Cuatro nuevas ubicaciones para extracciones de sangre venosa. Consulta Listar ubicaciones.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 permisoresults_view y una autorización de kits de prueba en casa para ver los kits.Claves de API solo para activación
El nuevo permisohome_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.El sexo debe ser masculino o femenino
Crear perfil y Actualizar perfil ya no aceptansex: 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 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.Intervalos de Aniva en los resultados
Los endpoints de resultados ahora rellenanreference_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.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.Un precio por biomarcador y panel
Los biomarcadores y los paneles tienen un únicoprice_cents según tu lista de tarifas, con retail_cents junto
a él:> 0: se puede pedir por separado.0: un cociente (consultarequires), o solo se puede pedir con otros marcadores (consultapositions).null: sin precio, por lo que no se puede pedir.
groups[] de los listados y de la vista previa de la cita. Se
eliminan los campos de precio retail y yours.Consulta Precios.Claves de idempotencia
Los endpoints de creación de perfiles, citas, pedidos de kits de prueba en casa y envíos aceptan una cabeceraIdempotency-Key. Un reintento con la misma clave devuelve la primera respuesta y no escribe
nada.Consulta Idempotencia.
