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

# Confirmă recoltarea de sânge

> Înregistrează că recoltarea de sânge a avut loc și declanșează fluxul comenzii de laborator

Înregistrează finalizarea unei recoltări de sânge și declanșează fluxul de comenzi de laborator. Trimite codurile de laborator (codurile de bare de pe eprubete) din kitul de recoltare pentru a asocia probele fizice cu programarea.

O recoltare de sânge are codurile într-unul din două moduri:

* **Un singur cod pentru întreaga recoltare** — o recoltare venoasă, unde același cod de bare este tipărit pe fiecare eprubetă. Trimite-l ca `lab_code`.
* **Câte un cod per microtainer** — o recoltare capilară, unde fiecare microtainer are propriul cod de bare. Trimite-le ca `lab_codes`, câte o intrare per cod cu valorile `panel_ids` pe care le conține microtainerul respectiv. Fiecare cod devine propria cerere de laborator — codul de bare de pe eprubetă este numărul de comandă al laboratorului. O intrare fără `panel_ids` este o intrare generală pentru toate panelurile nemenționate în altă parte. O recoltare venoasă are cel mult una.

Trimite exact una dintre cele două variante. Fiecare panel asociat trebuie să ajungă sub un singur cod (propria intrare sau intrarea generală). La o recoltare venoasă, biomarkerii à la carte au nevoie de intrarea generală. La o recoltare capilară, menționează fiecare panel pe codul microtainerului său. Biomarkerii à la carte umplu spațiul liber din microtainerele panelurilor și deschid microtainere noi doar când este necesar. Îi distribuim uniform. În fiecare microtainer încap cel mult 150 µl din aceștia. Trimite o intrare fără `panel_ids` pentru fiecare microtainer de care au nevoie separat, și nu mai mult. Un cod care rămâne fără niciun panel și fără niciun biomarker este respins cu `409` și `reason: "panel_coverage"`. Fiecare cod este validat înainte de a scrie ceva; dacă vreun cod nu poate fi folosit sau un panel rămâne neacoperit, nu se înregistrează nimic, iar răspunsul indică problema.

Necesită scope-ul `appointments_schedule`, `appointments_manage` sau `appointments_operate`.

> [!WARNING]
>
> Această acțiune este ireversibilă. După ce confirmi recoltarea de sânge, programarea este
> blocată — nu mai sunt posibile modificări, inclusiv adăugarea de paneluri.

## Cerere

### Parametri de cale

**id** `string` *required*

Identificatorul unic (UUID) al programării de confirmat.

### Parametri de corp

**lab\_code** `string`

Codul numeric de laborator tipărit pe kitul de recoltare de sânge, când un singur cod acoperă
toate eprubetele. Se exclude reciproc cu `lab_codes`.

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

Toate codurile de laborator ale recoltării de sânge, în ordinea scanării (cel puțin o intrare). Se
exclude reciproc cu `lab_code`. Un cod poate apărea o singură dată; un panel poate fi menționat
într-o singură intrare.

**intrare cod de laborator**

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

Codul numeric de laborator tipărit pe eprubetele acestor paneluri.

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

Panelurile asociate ale căror eprubete poartă acest cod — valori `panel_id` din câmpul
`panels` al programării. Omite sau trimite `[]` pentru intrarea generală care acoperă toate
panelurile nemenționate în altă parte plus biomarkerii à la carte. O recoltare venoasă are cel
mult o intrare generală. La o recoltare capilară, o intrare generală conține doar biomarkeri
à la carte și trimiți câte una pentru fiecare microtainer de care au nevoie.

## Răspuns

În caz de succes, API-ul returnează `200 OK`, confirmând declanșarea fluxului de comenzi de laborator.

**success** `boolean`

`true` când recoltarea de sânge a fost înregistrată și fluxul comenzii de laborator a fost declanșat.

**warning** `string`

Prezent doar când recoltarea a fost înregistrată în altă zi decât cea a programării. Cheile obișnuite
nu pot face asta — primesc `409` cu `reason: "appointment_not_today"`. Mută
programarea în ziua recoltării, apoi confirmă.

Codurile înregistrate sunt returnate ca `lab_codes` în [Obține programarea](https://docs.anivahealth.com/ro/api/appointments/get-appointment.md), iar fiecare rezultat și document din [Obține rezultatele](https://docs.anivahealth.com/ro/api/appointments/get-results.md) include codul `lab_code` sub care a fost înregistrat.

## Răspunsuri de eroare

| Status | Descriere |
| - | - |
| `400` | Eroare de validare — nu a fost trimis niciunul dintre `lab_code` și `lab_codes` sau au fost trimise ambele, un cod nu este numeric ori un cod sau un panel se repetă. |
| `403` | Interzis — cheia ta API nu are acces la această operațiune. |
| `404` | Programarea nu a fost găsită. |
| `409` | Un cod nu poate fi folosit (`reason`: `unregistered`, `already_assigned`, `home_kit_code`, `location_unknown`, `cross_location`), un panel rămâne fără cod, un `panel_id` nu este atașat, o recoltare venoasă are două intrări fără `panel_ids`, o recoltare capilară are mai multe intrări decât microtuburi sau mai multe intrări fără `panel_ids` decât microtuburi doar pentru markeri, sau un cod capilar nu corespunde microtuburilor sale (toate cu `panel_coverage`), un cod înregistrat înainte de o resetare indică acum alte paneluri (`remapped`) sau trebuie să rămână pe această recoltare deoarece laboratorul poate avea deja comanda lui (`sent_to_lab`, `order_in_flight`), un cod indică un panel care nu este planificat în programare (`unknown_panel`), sau programarea nu poate fi confirmată (`appointment_cancelled`, `appointment_already_drawn`, `appointment_not_ready`, `appointment_not_today`). `lab_code` indică codul care a cauzat eroarea, dacă există unul. |
| `500` | Eroare internă de server. |

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