Saltar para o conteúdo principal
Este guia acompanha-te no fluxo principal: encontrar um local de análise, criar um perfil de paciente, agendar uma marcação e confirmar uma colheita de sangue.

Pré-requisitos

Precisas de uma chave de API de parceiro emitida pela Aniva.
Se ainda não tens uma chave de API, contacta a Aniva para que seja emitida uma para a tua conta de parceiro.

Passos

1

Listar locais disponíveis

Obtém a lista de locais de análise para encontrar um location_id para a marcação que vais agendar.
Exemplo de resposta
Anota o id do local que queres usar. Vais precisar dele no passo 3.
2

Criar um perfil

Cria um perfil de paciente enviando os respetivos dados demográficos. O profile_group associa o perfil à tua conta de parceiro — aceita o UUID imutável do grupo ou o respetivo slug legível por humanos.
Campos do corpo do pedido** Opcional quando o teu grupo de perfis permite ao paciente introduzir ambos na página de ativação do kit. Consulta Perfis.Exemplo de resposta (201 Created)
Anota o id da resposta. Vais usá-lo como profile_id no passo seguinte.
3

Agendar uma marcação

Cria uma marcação usando o profile_id do passo 2 e o location_id do passo 1. Define scheduled_at para o início de um horário que Obter disponibilidade devolve para esse local. A API rejeita uma hora que não faça parte da grelha de horários.
Exemplo de resposta (201 Created)
Anota o id da marcação. Vais usá-lo para confirmar a colheita de sangue.
4

Confirmar a colheita de sangue

Depois de concluída a colheita de sangue, submete o código de laboratório (código de barras do tubo) para confirmar a colheita e acionar o pipeline de pedidos laboratoriais. Numa colheita cujos tubos tenham vários códigos, envia antes lab_codes — consulta Confirmar colheita de sangue.
Exemplo de resposta (200 OK)
Depois de confirmada, o pipeline de pedidos laboratoriais é acionado. Podes obter a marcação para verificar se o estado mudou para "blood_drawn".

Próximos passos