Saltar para o conteúdo principal
API

Os nomes dos recipientes na pré-visualização da marcação passam a ser nomes de produtos

A partir da próxima versão, containers[].name em Pré-visualizar marcação é o nome do produto do tubo. type não muda, por isso lê type se a tua aplicação comparar recipientes.
Painel de administraçãoAPI

A Aniva funciona agora em todos os idiomas da UE, e em mais alguns

API

Um único endpoint para listar painéis

API

Mostra os resultados de laboratório na tua app

Os teus pacientes podem agora ver os seus resultados de laboratório na tua app: a lista de biomarcadores, a tendência de cada biomarcador e um Twin 3D com uma classificação por área de saúde. A página usa a cor da tua marca e o teu logótipo, em modo claro ou escuro.A página de resultados é um extra pago e o teu contacto na Aniva pode indicar-te o preço. Criar sessão de incorporação mostra como a configurar.
API

As leituras de listagem da API ficam em cache até 5 minutos

Estes quatro endpoints guardam agora a resposta em cache até 5 minutos, pelo que uma alteração pode demorar até 5 minutos a aparecer:Os endpoints Get continuam a mostrar as alterações diretamente.Se fazes polling à API para detetar alterações, usa webhooks em vez disso. Um webhook avisa-te de cada alteração assim que acontece. Consulta Leituras repetidas.
Painel de administração

Vê quando o estafeta vem recolher as tuas amostras

O painel de administração mostra agora a próxima recolha por estafeta na tua clínica, com seguimento e etiqueta.Painel de administração com um banner no topo: GO! vem amanhã ~10:00–12:00.Painel de administração com um banner no topo: GO! vem amanhã ~10:00–12:00.
API

Os intervalos Aniva já estão disponíveis

Os teus resultados podem agora incluir os intervalos Aniva: um intervalo geral e um intervalo mais restrito para cada biomarcador, com as fontes que a Aniva registou. Os intervalos variam consoante a idade, o sexo e a semana de gravidez.Para obteres acesso, assina o breve acordo sobre os intervalos Aniva. Depois, ativamo-los para a tua chave de API. Pede o acordo ao teu contacto na Aniva.Os intervalos estão no novo campo aniva_range. Substitui reference_range_aniva, que era sempre null. Os intervalos são informação geral. Não avaliam um resultado e não constituem aconselhamento médico nem um dispositivo médico. O intervalo do laboratório continua a ser o padrão. Consulta Intervalos Aniva.
API

O tubo de fluoreto é agora fluoride

Pré-visualizar recipientes designa o tubo de fluoreto como fluoride. O valor antigo era naf. Se o teu código compara container.type com naf, altera-o para fluoride.Podem surgir dois novos valores: lihep_capillary e fluoride_capillary. São o tubo capilar de heparina de lítio e o tubo capilar de fluoreto.
API

Acabaram as marcações duplicadas no último horário

Se duas marcações para a última vaga de um horário chegarem ao mesmo tempo, apenas uma tem sucesso. A outra recebe 409, tal como em qualquer horário cheio. O mesmo se aplica quando uma marcação é alterada enquanto está a ser cancelada ou confirmada.Confirmar colheita de sangue tem três novos motivos 409:
  • remapped: o código corresponde agora a painéis diferentes dos anteriores.
  • sent_to_lab e order_in_flight: o laboratório pode já ter o pedido, pelo que o código tem de permanecer no seu tubo.
APIKits de teste em casa

Moradas de entrega mais rigorosas em encomendas de kits de teste em casa

Criar kit de teste em casa e Atualizar kit de teste em casa verificam delivery_address com mais rigor.
  • country_code aceita minúsculas, por exemplo, de. A Aniva guarda-o e devolve-o em maiúsculas.
  • Uma morada alemã (DE) precisa de um postal_code com exatamente 5 dígitos. Outros valores devolvem 400.
  • Os espaços à volta de postal_code são removidos antes de o guardarmos.
Painel de administraçãoKits de teste em casaAPI

Um novo kit para um kit devolvido

Quando a transportadora nos devolve um kit, já não esperamos pela caixa. Diz-nos que queres o kit novamente e enviamos logo um novo. Também o podes criar tu: chama Criar kit de teste em casa com replaces_home_kit_order_id definido para o kit devolvido. O novo kit é uma encomenda separada com um novo código de kit.Verificamos a caixa devolvida quando chega. Depois, o kit devolvido passa para cancelled e vês o que estava na caixa.
ResultadosAPIPainel de administração

Enviar um e-mail à tua equipa quando os resultados estiverem prontos

Pede-nos para definirmos um endereço de e-mail predefinido para o teu grupo de perfis, por exemplo, a caixa de entrada da tua equipa. Esse endereço passa a receber um e-mail quando os resultados de uma nova marcação estiverem prontos. Isto abrange marcações do painel de administração, da API e dos teus pacientes.Para o alterares numa marcação:
  • Painel de administração: edita os endereços de e-mail ou desativa “Enviar-me um e-mail quando os resultados estiverem prontos”.
  • API: envia uma lista em results_ready_emails para usares esses endereços de e-mail em alternativa. Para manteres o teu endereço de e-mail predefinido, inclui-o na lista. Envia [] para não enviar nenhum e-mail.
Vê E-mails de resultados prontos.
APIKits de teste em casa

O paciente introduz a data de nascimento e o sexo

Agora podemos permitir que o teu grupo de perfis crie um perfil sem date_of_birth e sex. O paciente introduz ambos na página de ativação do kit, escrevendo a data de nascimento duas vezes. Pede-nos para ativar esta opção. Vê Perfis.
Painel de administração

Um painel de administração mais rápido

O painel de administração mostra agora o primeiro conteúdo em cerca de 0,2 s, em vez de 1,3 s. Acabaram-se os indicadores de carregamento. As páginas preenchem-se à medida que os dados chegam. As páginas começam a carregar quando passas o cursor sobre uma ligação.
Painel de administraçãoKits de teste em casaWebhooks

Kits devolvidos

Quando a transportadora nos devolve um kit, a página Kits de teste em casa passa a mostrá-lo. Filtra por Devolvido para veres todos os kits que a transportadora nos devolveu, com o motivo da transportadora. O envio termina em fault e dispara shipment.fault, e já não em delivered. Assim que abrimos a caixa, também vês o que estava lá dentro: completo, com uma peça em falta ou aberto. Isso indica-te se o teu cliente recebe um reembolso total.Queres que voltemos a enviar o kit? Envia-nos uma mensagem com o código do kit e a morada de entrega correta. Enviamo-lo com o mesmo código de kit.
API

Unidades logarítmicas

Listar unidades devolve um terceiro unit_type: logarithmic, para um valor que é o logaritmo de uma grandeza, como o pH ou um índice aterogénico. Trata-o como physical ao apresentá-lo. Não lhe apliques escala: duas unidades logarítmicas diferem por um deslocamento, não por um fator.
APIPreços

Orçamentar um kit de teste em casa com as respetivas taxas

Orçamentar carrinho aceita fulfilment. Envia home_kit com um country_code e o orçamento adiciona as linhas do kit que a tua fatura mensal cobra por uma encomenda: a taxa do kit, os dispositivos de colheita, os portes de ida e volta para esse país, o invólucro e um saco de lancetas suplente. A predefinição continua a ser um draw num local com as taxas de marcação. A resposta indica qual deles orçamentou em fulfilment.kind.
Concierge

Conhece o Aniva Concierge

A partir de agora, o nosso registo de alterações também aparece no teu canal de Slack connosco, assim que lançamos algo.Também criámos o Aniva Concierge. Tens alguma dúvida sobre a API ou o painel de administração? Menciona @Aniva no Slack ou responde simplesmente a uma publicação do registo de alterações. Ele consulta a nossa documentação e diz-te onde clicar no painel de administração, ou que endpoint e filtros usar, com uma ligação para a página.
APIMarcações

Listar as marcações de um dia

Listar marcações aceita dois novos filtros. date (YYYY-MM-DD) devolve um dia de calendário, no fuso horário do local de cada marcação, primeiro as mais cedo. location_id devolve um local de análise. Usa ambos para a agenda de hoje de um local.
APIPerfis

Perfis duplicados são recusados

Criar perfil devolve agora 409 com error_name: "duplicate_profile_error" quando um perfil visível para a tua chave tem o mesmo nome próprio, apelido, sexo e data de nascimento. A resposta indica o profile_id existente. Usa-o em vez de criares um segundo perfil. Os apelidos de sandbox estão isentos.
Locais

Aniva Berlin Mitte encerra

A partir de 1 de novembro de 2026, a Aniva Berlin Mitte (206e8e2e-1ae6-401b-9dfe-781d639210ed) deixa de disponibilizar marcações. O local mais próximo é a Aniva Berlin P-Berg | Mariposa (f7897229-5c37-409b-bb43-dc8b50687fbc), Kastanienallee 83, 10435 Berlin.
Painel de administraçãoPreços

Catálogo de testes com os teus preços

O novo Catálogo de testes no painel de administração lista todos os biomarcadores com os respetivos laboratórios, tubos e preço na tua tabela de preços.
APIResultados

Porque é que um resultado não tem intervalo de laboratório

Cada resultado clínico em Obter resultados e Obter resultados de laboratório para kits de teste em casa tem agora reference_range_lab_absent_reason. Indica porque é que reference_range_lab é null:
  • not_provided: não existe intervalo. Mostra “Não aplicável”.
  • lab_text_only: o laboratório indicou apenas texto, como um valor-alvo ou um nível de risco. Mostra lab_reported.reference_range.
  • not_measured: o resultado é undeliverable.
É null quando existe um intervalo. Vê Resultados.
APILocais

Preços ao público e coordenadas

Os endpoints e o evento de preços ao público precisam do scope retail_prices_view.
Kits de teste em casaPainel de administração

Encomendar kits de teste em casa no painel de administração

Agora já podes encomendar um kit de teste em casa para o teu paciente na página Kits de teste em casa no painel de administração. Escolhe ou cria o paciente, escolhe o kit e introduz a morada de entrega. Também podes cancelar um kit aí.
APIPreços

Tabela de preços e orçamentos

  • Obter tabela de preços devolve as tuas tarifas no catálogo da Aniva e as tuas taxas.
  • Orçamentar carrinho calcula o preço de painéis e biomarcadores sem marcação.
  • A fatura em Orçamentar carrinho e Pré-visualizar marcação tem agora fees, total_with_fees_cents e um name em cada linha de biomarcador.
  • rate_card nas listagens aceita o id de Obter tabela de preços.
Ambos os novos endpoints precisam do scope prices_view.
APIResultados

Mais detalhes dos documentos

Cada entrada de documents em Obter resultados tem agora:
  • file_name: o nome que Transferir documento usa.
  • Novos: original_file_name, origin, content_type, etag, size_bytes.
Um PDF de relatório substituído envia agora results.updated, por exemplo, o relatório final do Labor Quade (_E) após o preliminar (_V).
APIWebhooks

Webhooks

A Aniva chama agora o teu servidor quando uma marcação, uma encomenda de kit de teste em casa, os seus resultados, uma localização, um perfil ou um envio muda. Já não precisas de fazer polling.
  • Regista um URL HTTPS com Criar webhook. Precisas do scope webhooks_manage. Pede à Aniva para o adicionar à tua chave ou para configurar o webhook por ti.
  • Os eventos cobrem todos os estados de uma marcação e de uma encomenda de kit de teste em casa, uma nova hora ou localização e todas as alterações aos resultados. results.completed indica-te que os resultados são finais.
  • Os eventos location.*, profile.* e shipment.* indicam-te quando uma localização, um perfil ou um envio aparece, muda ou desaparece. Um envio também envia shipment.<status> em cada mudança de estado.
  • Os eventos trazem IDs e estados, nunca valores laboratoriais nem dados pessoais. Lê o url no evento para obter os dados.
  • Cada pedido é assinado com o esquema Standard Webhooks.
  • A Aniva volta a tentar uma entrega falhada 10 vezes durante cerca de três dias. Podes listar e reenviar entregas durante 30 dias.
  • Cada resultado em Obter resultados tem agora um id, para poderes atualizar o resultado para o qual um evento results.updated aponta.
  • Obter localização devolve uma localização pelo seu id. O url de um evento location.* aponta para ele.
Consulta Webhooks.
ResultadosPainel de administração

Enviar os resultados ao cliente por e-mail

Agora podes enviar um e-mail a um cliente a avisar que os seus resultados laboratoriais estão prontos. Envia-o a partir da página de resultados laboratoriais no painel de administração, ou através de dois novos endpoints: Enviar resultados por e-mail para marcações e Enviar resultados por e-mail para encomendas de kits de teste em casa.
  • O e-mail pode anexar os relatórios laboratoriais como ficheiros PDF. Cada PDF está protegido por palavra-passe: a palavra-passe é a data de nascimento do cliente com 8 dígitos (DDMMAAAA), e o e-mail indica isso.
  • Podes adicionar uma nota pessoal de, no máximo, 1 000 caracteres.
  • Mostra o nome e o logótipo do grupo de perfis principal do perfil, no idioma do perfil.
  • Cada envio é um e-mail. Uma nova tentativa envia um segundo. Precisas do scope results_view para esse cliente.

Receber um e-mail quando os resultados estiverem prontos

Quando fazes uma marcação ou encomendas um kit de teste em casa de substituição no painel de administração, podes ativar “Enviar-me um e-mail quando os resultados estiverem prontos”. Enviamos então um e-mail para ti, ou para qualquer endereço que introduzas, assim que todos os resultados laboratoriais chegarem. O e-mail tem uma ligação para o resultado no painel de administração. O cliente não recebe este e-mail. Precisas do scope results_view para esse cliente.Através da API, podes definir até 5 endereços em results_ready_emails de Criar marcação, Criar encomenda de kit de teste em casa, Atualizar marcação e Atualizar encomenda de kit de teste em casa.
Kits de teste em casa

Enviar o telefone e o e-mail do destinatário com cada kit

Se o delivery_address de um kit de teste em casa tiver phone ou email, passamo-los à transportadora. A transportadora avisa então o destinatário quando a encomenda está a caminho ou à espera num ponto de recolha. Se os omitires, a transportadora não recebe nenhum contacto, mesmo que o perfil tenha um. Tu decides quem recebe os avisos da transportadora. O aviso pode indicar a Aniva Health como remetente.Consulta Criar encomenda de kit de teste em casa.
Localizações

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

Quatro novas localizações para colheitas de sangue venoso. Consulta Listar localizações.
Painel de administração

Página de resultados laboratoriais

A nova página de resultados laboratoriais no painel de administração lista cada colheita de sangue e cada kit de teste em casa ativado com os respetivos relatórios laboratoriais. Pesquisa por nome, data de nascimento ou código de barras do tubo. Precisas do scope results_view e de permissão para kits de teste em casa para ver os kits.
Kits de teste em casa

Chaves de API apenas para ativação

O novo scope home_kit_orders_activate permite que uma chave ative kits de teste em casa e mais nada. Não pode criar, alterar nem cancelar um kit. Pede à Aniva uma chave deste tipo se um sistema separado ativar os teus kits.Consulta Ativar encomenda de kit de teste em casa.
APIAlteração incompatível

O sexo tem de ser masculino ou feminino

Criar perfil e Atualizar perfil já não aceitam sex: 0 (desconhecido). Envia 1 para masculino ou 2 para feminino; 0 devolve 400. O laboratório precisa do sexo para os intervalos de referência, e uma encomenda para um perfil sem sexo não conseguia chegar ao laboratório.Consulta Criar perfil.
Kits de teste em casa

Kits que chegam ao laboratório sem ativação

Se uma amostra chegar ao laboratório antes de o kit ser ativado, a Aniva ativa o kit. activated_at é a manhã do primeiro evento de seguimento da encomenda de devolução, ou a manhã em que a amostra chegou ao laboratório se não houver seguimento. Uma chamada posterior a Ativar com um activated_at diferente devolve 409.Consulta Ativar encomenda de kit de teste em casa.
API

Intervalos da Aniva nos resultados

Os endpoints de resultados preenchem agora reference_range_aniva com os valores de comparação compilados pela Aniva, convertidos para a unidade do resultado. Os valores variam consoante a idade, o sexo e a semana de gravidez. A tua chave precisa do scope ANIVA_REFERENCE_RANGES_VIEW. Sem ele, o campo é null.Consulta Obter resultados da marcação.
APIKits de teste em casa

Kits de substituição

Encomenda uma substituição quando um kit não conseguiu fornecer todos os resultados. Uma substituição é uma nova encomenda com um novo código de laboratório e mantém o painel da encomenda original. biomarker_ids define o que o laboratório volta a analisar.Consulta Encomendas de kits de teste em casa.
APIPreçosAlteração incompatível

Um preço por biomarcador e painel

Os biomarcadores e painéis têm um price_cents na tua tabela de preços, com retail_cents ao lado:
  • > 0: pode ser pedido isoladamente.
  • 0: um rácio (vê requires), ou só pode ser pedido com outros marcadores (vê positions).
  • null: sem preço, por isso não pode ser pedido.
Alteração incompatível: groups[] foi removido das listagens e da pré-visualização da marcação. Os campos de preço retail e yours foram removidos.Vê Preços.
API

Chaves de idempotência

Os endpoints de criação para perfis, marcações, encomendas de kits de teste em casa e envios aceitam um cabeçalho Idempotency-Key. Uma nova tentativa com a mesma chave devolve a primeira resposta e não escreve nada.Vê Idempotência.
Locais

Aniva Hannover, Düsseldorf, Duisburg e Essen

Quatro novos locais Aniva na Alemanha estão abertos para colheitas de sangue venoso: Hannover, Düsseldorf, Duisburg e Essen. Chama Listar locais para veres os locais em que a tua chave pode marcar.