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

> Registra que s'ha fet l'extracció de sang i activa el flux de comandes de laboratori

Registra que s'ha completat una extracció de sang i activa el procés de comanda al laboratori. Envia els codis de laboratori (codis de barres dels tubs) del kit d'extracció de sang per vincular les mostres físiques a la cita.

Una extracció de sang porta els seus codis d'una d'aquestes dues maneres:

* **Un sol codi per a tota l'extracció** — una extracció venosa, on el mateix codi de barres està imprès a cada tub. Envia'l com a `lab_code`.
* **Un codi per microtub** — una extracció capil·lar, on cada microtub té el seu propi codi de barres. Envia'ls com a `lab_codes`, una entrada per codi amb els `panel_ids` que conté el seu microtub. Cada codi es converteix en la seva pròpia sol·licitud al laboratori — el codi de barres del tub és el número de comanda del laboratori. Una entrada sense `panel_ids` és un comodí per a tots els panells no indicats enlloc més. Una extracció venosa en té com a màxim un.

Envia exactament una de les dues opcions. Cada panell associat ha de quedar sota un únic codi (la seva pròpia entrada o el comodí). En una extracció venosa, els biomarcadors a la carta necessiten el comodí. En una extracció capil·lar, indica cada panell al codi del seu microtub. Els biomarcadors a la carta omplen l'espai lliure dels microtubs dels panells i només obren microtubs nous quan cal. Els repartim de manera uniforme. Cada microtub en pot contenir com a màxim 150 µl. Envia una entrada sense `panel_ids` per cada microtub que necessitin per si sols, i ni una més. Un codi que quedi sense cap panell ni biomarcador es rebutja amb `409` i `reason: "panel_coverage"`. Tots els codis es validen abans d'escriure res; si algun codi no es pot fer servir o algun panell queda sense cobrir, no es registra res i la resposta indica el problema.

Requereix l'àmbit `appointments_schedule`, `appointments_manage` o `appointments_operate`.

> [!WARNING]
>
> Aquesta acció és irreversible. Un cop confirmis l'extracció de sang, la cita queda bloquejada — no es
> podrà fer cap altra modificació, incloent-hi afegir panells.

## Sol·licitud

### Paràmetres de ruta

**id** `string` *required*

Identificador únic (UUID) de la cita que vols confirmar.

### Paràmetres del cos

**lab\_code** `string`

Codi de laboratori numèric imprès al kit d'extracció de sang, quan un sol codi cobreix tots els tubs. Mútuament
excloent amb `lab_codes`.

**lab\_codes** `object[]`

Tots els codis de laboratori de l'extracció de sang, per ordre d'escaneig (almenys una entrada). Mútuament excloent amb `lab_code`. Cada
codi només pot aparèixer una vegada; cada panell només es pot indicar en una entrada.

**entrada de codi de laboratori**

**lab\_code** `string` *required*

Codi de laboratori numèric imprès als tubs d'aquests panells.

**panel\_ids** `string[]`

Els panells associats amb tubs que porten aquest codi — valors `panel_id` dels
`panels` de la cita. Omet-lo o envia `[]` per al comodí que cobreix tots els panells no indicats enlloc més i
els biomarcadors a la carta. Una extracció venosa té com a màxim un comodí. En una extracció capil·lar, un comodí
només conté biomarcadors a la carta, i n'has d'enviar un per cada microtub que necessitin.

## Resposta

Si té èxit, l'API retorna `200 OK` confirmant que s'ha activat el procés de comanda al laboratori.

**success** `boolean`

`true` quan s'ha registrat l'extracció de sang i s'ha activat el flux de comanda al laboratori.

**warning** `string`

Només és present quan l'extracció s'ha registrat un dia diferent del dia de la cita. Les claus
ordinàries no poden fer-ho — reben un `409` amb `reason: "appointment_not_today"`. Reprograma la
cita per al dia de l'extracció i després confirma-la.

Els codis registrats es retornen com a `lab_codes` a [Obtén la cita](https://docs.anivahealth.com/ca/api/appointments/get-appointment.md), i cada resultat i document a [Obtén els resultats](https://docs.anivahealth.com/ca/api/appointments/get-results.md) inclou el `lab_code` amb què s'ha arxivat.

## Respostes d'error

| Estat | Descripció |
| - | - |
| `400` | Error de validació — no s'ha indicat ni `lab_code` ni `lab_codes` o s'han indicat tots dos, un codi no és numèric, o un codi o panell està repetit. |
| `403` | Prohibit — la teva clau d'API no té accés a aquesta operació. |
| `404` | No s'ha trobat la cita. |
| `409` | Un codi no es pot fer servir (`reason`: `unregistered`, `already_assigned`, `home_kit_code`, `location_unknown`, `cross_location`), un panell queda sense codi, un `panel_id` no està associat, una extracció venosa té dues entrades sense `panel_ids`, una extracció capil·lar té més entrades que microtainers o més entrades sense `panel_ids` que microtainers només per a marcadors, o un codi capil·lar no coincideix amb els seus microtainers (tots són `panel_coverage`), un codi registrat abans d'un restabliment ara indica altres panells (`remapped`) o ha de romandre en aquesta extracció perquè el laboratori pot tenir-ne la comanda (`sent_to_lab`, `order_in_flight`), un codi indica un panell que no està previst a la cita (`unknown_panel`), o la cita no es pot confirmar (`appointment_cancelled`, `appointment_already_drawn`, `appointment_not_ready`, `appointment_not_today`). `lab_code` indica el codi quan n'hi ha un que causa l'error. |
| `500` | Error intern del servidor. |

```bash cURL (one code, every tube) theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/confirm \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "lab_code": "7642001234"
  }'
```

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

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

```json 400 theme={null}
{
  "error": "lab_codes: Provide exactly one of `lab_code` or `lab_codes`"
}
```

```json 404 theme={null}
{
  "error": "Appointment not found"
}
```

```json 409 theme={null}
{
  "error": "This barcode has already been assigned to another patient. Please use a different tube.",
  "reason": "already_assigned",
  "lab_code": "7642001235"
}
```

```json 409 (capillary empty code) theme={null}
{
  "error": "Barcode 7642001236 carries no panel and no biomarker.",
  "reason": "panel_coverage",
  "lab_code": null
}
```

```json 409 (cancelled) theme={null}
{
  "error": "This appointment was cancelled, so a blood draw can’t be recorded for it. Reactivate the appointment first if this is a mistake.",
  "reason": "appointment_cancelled",
  "lab_code": "7642001234"
}
```

```json 409 (wrong day) theme={null}
{
  "error": "Recording a blood draw is only available on the appointment day (Oct 13, 2026). Reschedule the appointment to today, then confirm.",
  "reason": "appointment_not_today",
  "lab_code": null
}
```


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