> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anivahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Confirmar colheita de sangue

> Guia passo a passo: registar uma colheita de sangue na API da Aniva e enviar a amostra para o fluxo de pedidos laboratoriais.

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](https://docs.anivahealth.com/pt/api/appointments/get-results.md).

> [!WARNING]
>
> 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](https://docs.anivahealth.com/pt/guides/schedule-appointment.md) 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.

> [!WARNING]
>
> 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.

```bash cURL (venous draw, one code) theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12/confirm \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "lab_code": "7642001234"
  }'
```

```bash cURL (pharmacy draw, one code per panel) theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12/confirm \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "lab_codes": [
      { "lab_code": "7642001234", "panel_ids": ["f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d"] },
      { "lab_code": "7642001235", "panel_ids": ["0a9b8c7d-6e5f-4a3b-2c1d-0e9f8a7b6c5d"] }
    ]
  }'
```

```javascript JavaScript theme={null}
const response = await fetch(
  'https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12/confirm',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY',
    },
    body: JSON.stringify({
      lab_codes: [
        { lab_code: '7642001234', panel_ids: ['f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d'] },
        { lab_code: '7642001235', panel_ids: ['0a9b8c7d-6e5f-4a3b-2c1d-0e9f8a7b6c5d'] },
      ],
    }),
  }
);

const result = await response.json();
```

Um pedido bem-sucedido devolve `200 OK`:

```json theme={null}
{
  "success": true
}
```

**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`.

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12 \
  --header 'x-api-key: YOUR_API_KEY'
```

```javascript JavaScript theme={null}
const response = await fetch(
  'https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12',
  {
    headers: {
      'x-api-key': 'YOUR_API_KEY',
    },
  }
);

const appointment = await response.json();
console.log(appointment.status); // "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](https://docs.anivahealth.com/pt/api/shipments/get-shipment.md) para eventos de trânsito / entrega da transportadora, e usa [Obter resultados](https://docs.anivahealth.com/pt/api/appointments/get-results.md) 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](https://docs.anivahealth.com/pt/api/appointments/get-results.md) — 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

| Estado | Causa | Resolução |
| - | - | - |
| `400 Bad Request` | Não foi indicado nenhum ou foram indicados ambos os campos `lab_code` / `lab_codes`, um código não é numérico, ou um código ou painel está repetido. | Envia exatamente um dos dois, com os códigos numéricos exatos dos tubos físicos. |
| `409 Conflict` | Um código não pode ser usado (já atribuído, não registado, pertence a um kit de teste em casa, clínica errada), um painel não tem código ou a marcação não pode ser confirmada. | Lê `reason` e `lab_code`; digitaliza outro tubo ou verifica o estado da marcação. |
| `403 Forbidden` | A tua chave API não tem acesso a esta operação. | Contacta a Aniva para confirmar as permissões da tua chave API. |
| `404 Not Found` | O ID da marcação não existe ou não pertence à tua conta. | Verifica se o ID da marcação está correto. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.