Saltar para o conteúdo principal
Usa este guia para confirmar que foi realizada uma colheita de sangue. A confirmação regista os códigos de laboratório (códigos de barras dos tubos) do kit físico e aciona o fluxo de pedidos laboratoriais; o progresso dos resultados é depois lido em Obter resultados.
A confirmação é irreversível. Assim que confirmares uma colheita de sangue, não podem ser feitas mais alterações — incluindo adicionar painéis — à marcação. Certifica-te de que todos os painéis estão associados e todos os dados estão corretos antes de avançar.
1

Garantir que os painéis estão adicionados

Antes de confirmar, verifica se todos os painéis de análises necessários foram adicionados à marcação. Não podes adicionar painéis após a confirmação.Consulta o guia Agendar uma marcação para obteres instruções sobre como associar painéis.Confirma o seguinte antes de continuar:
  • Todos os painéis necessários estão associados à marcação.
  • O profile_id e o location_id na marcação estão corretos.
  • O paciente concluiu a colheita de sangue e o código de barras de cada tubo está à mão.
2

Confirmar a colheita de sangue

Envia um pedido POST para /api/v1/appointments/{id}/confirm com os códigos de laboratório do kit físico de colheita de sangue. Uma colheita venosa tem um único código impresso em todos os tubos — envia-o como lab_code. Uma colheita em farmácia tem um código por microtainer — envia-os como lab_codes, uma entrada por código com os panel_ids que o respetivo microtainer contém (a partir dos panels da marcação); cada código dá origem à sua própria requisição laboratorial. Os biomarcadores individuais numa farmácia ocupam primeiro o espaço livre dos microtainers dos painéis. Envia uma entrada sem panel_ids para cada microtainer de que precisem em separado.
Cada código deve ser a sequência numérica impressa no tubo físico entregue ao paciente. Não substituas por outro identificador — um código incorreto fará o pedido laboratorial falhar. Todos os códigos são validados antes de qualquer dado ser gravado; se um for rejeitado, nada é registado.
Um pedido bem-sucedido devolve 200 OK:
3

Verificar o estado da marcação

Após a confirmação, obtém a marcação para verificar se o seu estado mudou para blood_drawn.
Assim que a marcação apresentar status: "blood_drawn", o fluxo de pedidos laboratoriais foi acionado. O estado da marcação em si permanece em blood_drawn a partir daqui; o progresso detalhado nas etapas seguintes é exposto através de endpoints dedicados: segue cada entrada no array shipments incluído em Obter envio para eventos de trânsito / entrega da transportadora, e usa Obter resultados para a conclusão dos resultados laboratoriais (status: "in_progress" → "completed").

O que acontece a seguir

Após a confirmação, o fluxo de pedidos laboratoriais da Aniva assume o processo:
  1. Cada código de laboratório é associado aos respetivos tubos físicos no laboratório — a requisição de cada painel contém o código dos seus próprios tubos.
  2. Os painéis associados à marcação determinam quais as análises realizadas.
  3. Quando os resultados ficam prontos, são associados ao perfil do paciente e aparecem em Obter resultados — o campo status de nível superior da resposta passa de in_progress para completed assim que todas as submissões forem encerradas e uma tiver reportado.
Não é necessária mais nenhuma ação da tua integração após a confirmação.

Tratamento de erros