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

> Ghid pas cu pas: înregistrează o recoltare de sânge în API-ul Aniva și trimite proba în fluxul de comenzi de laborator.

Folosește acest ghid pentru a confirma că a avut loc o recoltare de sânge. Confirmarea înregistrează codurile de laborator (codurile de bare ale eprubetelor) din kitul fizic și declanșează fluxul de comenzi de laborator; progresul rezultatelor se citește apoi din [Obține rezultatele](https://docs.anivahealth.com/ro/api/appointments/get-results.md).

> [!WARNING]
>
> Confirmarea este **ireversibilă**. După ce confirmi o recoltare de sânge, nu mai poți face nicio modificare —
> inclusiv adăugarea de paneluri — la programare. Asigură-te că toate panelurile sunt atașate și
> toate detaliile sunt corecte înainte de a continua.

**1. Asigură-te că panelurile sunt adăugate**

Înainte de confirmare, verifică dacă toate panelurile de teste necesare au fost adăugate la programare. Nu poți adăuga paneluri după confirmare.

Consultă ghidul [Creează o programare](https://docs.anivahealth.com/ro/guides/schedule-appointment.md) pentru instrucțiuni despre atașarea panelurilor.

Confirmă următoarele înainte de a continua:

* Toate panelurile necesare sunt atașate la programare.
* Câmpurile `profile_id` și `location_id` din programare sunt corecte.
* Pacientul a efectuat recoltarea de sânge și ai la îndemână codul de bare al fiecărei eprubete.

**2. Confirmă recoltarea de sânge**

Trimite o cerere `POST` către `/api/v1/appointments/{id}/confirm` cu codurile de laborator din kitul fizic de recoltare de sânge. O recoltare venoasă are un singur cod tipărit pe fiecare eprubetă — trimite-l ca `lab_code`. O recoltare la farmacie are câte un cod pe fiecare microtainer — trimite-le ca `lab_codes`, câte o intrare per cod împreună cu `panel_ids` conținute de microtainerul respectiv (din `panels` al programării); fiecare cod devine propria cerere de laborator. Biomarkerii individuali dintr-o farmacie ocupă mai întâi spațiul liber din microtainerele panelurilor. Trimite câte o intrare fără `panel_ids` pentru fiecare microtainer separat de care au nevoie aceștia.

> [!WARNING]
>
> Fiecare cod trebuie să fie șirul numeric tipărit pe eprubeta fizică înmânată pacientului. Nu îl înlocui cu un alt identificator — un cod incorect va duce la eșecul comenzii de laborator. Fiecare cod este validat înainte de a salva ceva; dacă unul este respins, nu se înregistrează nimic.

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

O cerere reușită returnează `200 OK`:

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

**3. Verifică statusul programării**

După confirmare, preia programarea pentru a verifica dacă statusul acesteia s-a schimbat în `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"
```

Odată ce programarea afișează `status: "blood_drawn"`, fluxul de comenzi de laborator a fost declanșat. Statusul programării rămâne la `blood_drawn` din acest moment; evoluția ulterioară detaliată este disponibilă prin endpoint-uri dedicate: urmărește fiecare intrare din lista inline `shipments` în [Obține expedierea](https://docs.anivahealth.com/ro/api/shipments/get-shipment.md) pentru evenimentele de curier în tranzit / livrat și folosește [Obține rezultatele](https://docs.anivahealth.com/ro/api/appointments/get-results.md) pentru finalizarea rezultatelor de laborator (`status: "in_progress"` → `"completed"`).

## Ce se întâmplă în continuare

După confirmare, fluxul de comenzi de laborator Aniva preia procesul:

1. Fiecare cod de laborator este asociat cu eprubetele sale fizice la laborator — cererea fiecărui panel poartă codul de pe propriile eprubete.
2. Panelurile atașate la programare determină ce teste sunt efectuate.
3. Când rezultatele sunt gata, ele sunt asociate cu profilul pacientului și apar în
   [Obține rezultatele](https://docs.anivahealth.com/ro/api/appointments/get-results.md) — câmpul `status` de la nivelul superior al răspunsului trece
   de la `in_progress` la `completed` după ce fiecare trimitere s-a închis și una a raportat.

Nu este necesară nicio altă acțiune din partea integrării tale după confirmare.

## Gestionarea erorilor

| Status | Cauză | Soluție |
| - | - | - |
| `400 Bad Request` | Nu ai trimis nici `lab_code`, nici `lab_codes` sau le-ai trimis pe ambele, un cod nu este numeric ori un cod sau un panel se repetă. | Trimite exact unul dintre cele două, cu codurile numerice exacte de pe eprubetele fizice. |
| `409 Conflict` | Un cod nu poate fi folosit (este deja asociat, neînregistrat, aparține unui kit de testare la domiciliu sau altei clinici), un panel nu are cod ori programarea nu poate fi confirmată. | Citește `reason` și `lab_code`; scanează o altă eprubetă sau verifică statusul programării. |
| `403 Forbidden` | Cheia ta API nu are acces la această operațiune. | Contactează Aniva pentru a confirma permisiunile cheii tale API. |
| `404 Not Found` | ID-ul programării nu există sau nu aparține contului tău. | Verifică dacă ID-ul programării este corect. |


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