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.A Aniva funciona agora em todos os idiomas da UE, e em mais alguns
- Painel de administração, site, centro de ajuda e documentação: em todos os 32 idiomas.
- Perfis: define o idioma de cada paciente. A página de resultados e os e-mails de resultados usam esse idioma.
Um único endpoint para listar painéis
- Listar painéis devolve agora
biomarker_groups. Usa-o em vez de/api/v2/panels. - Criar painel foi removido. Usa o Painel de administração.
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.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 endpointsGet 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.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 campoaniva_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.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.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 recebe409, 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_labeorder_in_flight: o laboratório pode já ter o pedido, pelo que o código tem de permanecer no seu tubo.
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 verificamdelivery_address com mais rigor.country_codeaceita minúsculas, por exemplo,de. A Aniva guarda-o e devolve-o em maiúsculas.- Uma morada alemã (
DE) precisa de umpostal_codecom exatamente 5 dígitos. Outros valores devolvem400. - Os espaços à volta de
postal_codesão removidos antes de o guardarmos.
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 comreplaces_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.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_emailspara 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.
O paciente introduz a data de nascimento e o sexo
Agora podemos permitir que o teu grupo de perfis crie um perfil semdate_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.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.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 emfault 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.Unidades logarítmicas
Listar unidades devolve um terceirounit_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.Orçamentar um kit de teste em casa com as respetivas taxas
Orçamentar carrinho aceitafulfilment. 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.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.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.Perfis duplicados são recusados
Criar perfil devolve agora409 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.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.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 agorareference_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. Mostralab_reported.reference_range.not_measured: o resultado éundeliverable.
null quando existe um intervalo. Vê Resultados.Preços ao público e coordenadas
- Os locais têm agora
state_code,latitudeelongitude. - Listar preços ao público e Obter preços ao público devolvem o preço de cada painel que uma farmácia vende a clientes sem marcação.
- O webhook
location.retail_prices.updatedavisa-te quando um preço muda.
retail_prices_view.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í.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_centse umnameem cada linha de biomarcador. rate_cardnas listagens aceita oidde Obter tabela de preços.
prices_view.Mais detalhes dos documentos
Cada entrada dedocuments em Obter resultados tem agora:file_name: o nome que Transferir documento usa.- Novos:
original_file_name,origin,content_type,etag,size_bytes.
results.updated, por exemplo, o relatório final do
Labor Quade (_E) após o preliminar (_V).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.completedindica-te que os resultados são finais. - Os eventos
location.*,profile.*eshipment.*indicam-te quando uma localização, um perfil ou um envio aparece, muda ou desaparece. Um envio também enviashipment.<status>em cada mudança de estado. - Os eventos trazem IDs e estados, nunca valores laboratoriais nem dados pessoais. Lê o
urlno 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 eventoresults.updatedaponta. - Obter localização devolve uma localização pelo seu
id. Ourlde um eventolocation.*aponta para ele.
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_viewpara 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 scoperesults_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.Enviar o telefone e o e-mail do destinatário com cada kit
Se odelivery_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.Aniva Berlin P-Berg (Mariposa), Potsdam, Mannheim e Wiesbaden
Quatro novas localizações para colheitas de sangue venoso. Consulta Listar localizações.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 scoperesults_view e de permissão para kits de teste em casa para ver os kits.Chaves de API apenas para ativação
O novo scopehome_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.O sexo tem de ser masculino ou feminino
Criar perfil e Atualizar perfil já não aceitamsex: 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 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.Intervalos da Aniva nos resultados
Os endpoints de resultados preenchem agorareference_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.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.Um preço por biomarcador e painel
Os biomarcadores e painéis têm umprice_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.
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.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çalhoIdempotency-Key. Uma nova tentativa com a mesma chave devolve a primeira resposta e não
escreve nada.Vê Idempotência.
