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

# Adaugă paneluri

> Adaugă paneluri de analize de sânge la o programare

Adaugă unul sau mai multe paneluri de analize de sânge la o programare existentă. Poți apela acest endpoint de mai multe ori pentru a construi selecția de paneluri înainte de a confirma recoltarea de sânge.

Necesită scope-ul `appointments_schedule`.

> [!WARNING]
>
> Panelurile nu pot fi adăugate după ce apelezi [Confirmare recoltare de sânge](https://docs.anivahealth.com/ro/api/appointments/confirm-blood-draw.md).
> Încercarea de a adăuga paneluri la o programare confirmată returnează `409 Conflict`.

La o recoltare capilară (`draw_method: capillary`), recoltarea de sânge este repartizată în
microtainere. Panelurile intră primele, în ordinea programării. Biomarkerii individuali ocupă apoi
spațiul liber din microtainerele panelurilor. Când au nevoie de mai mult spațiu, deschid
microtainere noi. Îi distribuim uniform. Fiecare microtainer poate conține cel mult 150 µl de
biomarkeri individuali. Dacă setul rezultat de paneluri încalcă această regulă, apelul returnează
`400` cu un mesaj `error` și niciun panel nu este adăugat.

## Cerere

### Parametri de cale

**id** `string` *required*

Identificatorul unic (UUID) al programării la care se adaugă paneluri.

### Parametri de corp

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

Listă de UUID-uri de paneluri de adăugat la programare. Trebuie să conțină cel puțin un element.

## Răspuns

În caz de succes, API-ul returnează `200 OK`, confirmând că panelurile au fost adăugate.

**success** `boolean`

`true` când panelurile au fost adăugate cu succes la programare.

## Răspunsuri de eroare

| Status | Descriere |
| - | - |
| `400` | Eroare de validare — de ex., `panel_ids` este gol sau conține un UUID invalid — sau, la o recoltare capilară, biomarkerii individuali nu mai încap în microtainerele lor. |
| `403` | Interzis — cheia ta API nu are acces la această operațiune. |
| `404` | Programarea sau unul ori mai multe paneluri nu au fost găsite. |
| `409` | Conflict — panelurile nu pot fi adăugate după confirmarea recoltării de sânge sau un panel este un kit de testare la domiciliu (`error_name: "home_kit_appointment_mismatch_error"`). Comandă un kit de testare la domiciliu ca [comandă de kit de testare la domiciliu](https://docs.anivahealth.com/ro/api/home-kit-orders/create-home-kit.md). |
| `500` | Eroare internă de server. |

### Panel de tip kit de testare la domiciliu

Un kit de testare la domiciliu este trimis pacientului și nu presupune recoltare de sânge la o
programare. Dacă un panel din `panel_ids` este un kit de testare la domiciliu, apelul returnează
`409` și nu adaugă niciun panel. Corpul are aceste câmpuri:

**error** `string`

Motiv în format lizibil.

**error\_name** `string`

Întotdeauna `home_kit_appointment_mismatch_error`.

**appointment\_id** `string`

Programarea la care nu a fost adăugat panelul.

**panel\_id** `string`

Panelul de tip kit de testare la domiciliu.

**home\_kit\_provider** `string | null`

Furnizorul kitului de testare la domiciliu pentru panel sau `null` când nu este cunoscut.

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/panels \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "panel_ids": [
      "d4e5f6a7-b8c9-4d1e-a2f3-b4c5d6e7f8a9",
      "e5f6a7b8-c9d0-4e2f-b3a4-c5d6e7f8a9b0"
    ]
  }'
```

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

```json 400 (capillary, does not fit) theme={null}
{
  "error": "Some individual biomarkers need more than 150 µl of one lab's microtainer. Remove some of them."
}
```

```json 409 theme={null}
{
  "error": "Panels cannot be added after blood draw has been confirmed"
}
```

```json 409 (home kit panel) theme={null}
{
  "error": "Panel e5f6a7b8-c9d0-4e2f-b3a4-c5d6e7f8a9b0 is a home kit (biomes) and cannot attach to appointment c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a — order it via home-kit orders",
  "error_name": "home_kit_appointment_mismatch_error",
  "appointment_id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
  "panel_id": "e5f6a7b8-c9d0-4e2f-b3a4-c5d6e7f8a9b0",
  "home_kit_provider": "biomes"
}
```

```json 404 theme={null}
{
  "error": "Panels not found: e5f6a7b8-c9d0-4e2f-b3a4-c5d6e7f8a9b0"
}
```


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