> ## 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.

# Confirma l'extracció de sang

> Guia pas a pas: registra una extracció de sang a l'API d'Aniva i envia la mostra al flux de comandes de laboratori.

Fes servir aquesta guia per confirmar que s'ha fet una extracció de sang. La confirmació registra els codis de laboratori (els codis de barres dels tubs) del kit físic i activa el flux de comanda al laboratori; el progrés dels resultats es consulta després a [Obtén els resultats](https://docs.anivahealth.com/ca/api/appointments/get-results.md).

> [!WARNING]
>
> La confirmació és **irreversible**. Un cop confirmis una extracció de sang, no es podrà fer cap més modificació —
> incloent-hi afegir panells — a la cita. Assegura't que tots els panells estiguin vinculats i que
> totes les dades siguin correctes abans de continuar.

**1. Assegura't que els panells s'han afegit**

Abans de confirmar, comprova que s'hagin afegit a la cita tots els panells de proves necessaris. No pots afegir panells després de la confirmació.

Consulta la guia [Programa una cita](https://docs.anivahealth.com/ca/guides/schedule-appointment.md) per veure les instruccions per vincular panells.

Confirma el següent abans de continuar:

* Tots els panells necessaris estan vinculats a la cita.
* El `profile_id` i el `location_id` de la cita són correctes.
* El pacient ha completat l'extracció de sang i tens a mà el codi de barres de cada tub.

**2. Confirma l'extracció de sang**

Envia una sol·licitud `POST` a `/api/v1/appointments/{id}/confirm` amb els codis de laboratori del kit físic d'extracció de sang. Una extracció venosa té un codi imprès a cada tub — envia'l com a `lab_code`. Una extracció a la farmàcia té un codi per microtub — envia'ls com a `lab_codes`, una entrada per codi amb els `panel_ids` que conté el seu microtub (dels `panels` de la cita); cada codi es converteix en la seva pròpia petició de laboratori. Els biomarcadors individuals a una farmàcia omplen primer l'espai lliure dels microtubs dels panells. Envia una entrada sense `panel_ids` per a cada microtub que necessitin per separat.

> [!WARNING]
>
> Cada codi ha de ser la cadena numèrica impresa al tub físic lliurat al pacient. No el substitueixis per un altre identificador — un codi incorrecte farà que la comanda al laboratori falli. Tots els codis es validen abans d'escriure res; si se'n rebutja un, no es registra res.

```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();
```

Una sol·licitud correcta retorna `200 OK`:

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

**3. Comprova l'estat de la cita**

Després de la confirmació, recupera la cita per comprovar que el seu estat hagi canviat a `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"
```

Un cop la cita mostra `status: "blood_drawn"`, el flux de comanda al laboratori s'ha activat. L'estat de la cita es manté en `blood_drawn` a partir d'aquí; el progrés posterior més detallat s'exposa mitjançant endpoints específics: segueix cada entrada de la matriu `shipments` inclosa cap a [Obtén l'enviament](https://docs.anivahealth.com/ca/api/shipments/get-shipment.md) per als esdeveniments de missatgeria en trànsit / lliurat, i fes servir [Obtén els resultats](https://docs.anivahealth.com/ca/api/appointments/get-results.md) per a la finalització dels resultats del laboratori (`status: "in_progress"` → `"completed"`).

## Què passa després

Després de la confirmació, el flux de comanda al laboratori d'Aniva pren el relleu:

1. Cada codi de laboratori s'associa als seus tubs físics al laboratori — la petició de cada panell porta el codi dels seus propis tubs.
2. Els panells vinculats a la cita determinen quines proves es fan.
3. Quan els resultats estan llestos, s'associen al perfil del pacient i apareixen a
   [Obtén els resultats](https://docs.anivahealth.com/ca/api/appointments/get-results.md) — el camp `status` de nivell superior de la resposta canvia
   de `in_progress` a `completed` un cop totes les trameses s'han tancat i una ha informat.

No cal cap altra acció per part de la teva integració després de la confirmació.

## Gestió d'errors

| Estat | Causa | Solució |
| - | - | - |
| `400 Bad Request` | No s'ha enviat cap dels camps `lab_code` / `lab_codes` o s'han enviat tots dos, un codi no és numèric, o s'ha repetit un codi o un panell. | Envia exactament un dels dos, amb els codis numèrics exactes dels tubs físics. |
| `409 Conflict` | Un codi no es pot fer servir (ja està assignat, no està registrat, pertany a un kit de prova a casa o és d'una altra clínica), un panell no té codi, o la cita no es pot confirmar. | Llegeix `reason` i `lab_code`; escaneja un altre tub o comprova l'estat de la cita. |
| `403 Forbidden` | La teva clau API no té accés a aquesta operació. | Contacta amb Aniva per confirmar els permisos de la teva clau API. |
| `404 Not Found` | L'ID de la cita no existeix o no pertany al teu compte. | Comprova que l'ID de la cita sigui correcte. |


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