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

# Dodaj panele

> Dodaj panele badań krwi do wizyty

Dodaj jeden lub więcej paneli badań krwi do istniejącej wizyty. Możesz wywołać ten endpoint wielokrotnie, aby skompletować wybór paneli przed potwierdzeniem pobrania krwi.

Wymaga zakresu `appointments_schedule`.

> [!WARNING]
>
> Nie można dodawać paneli po wywołaniu [Potwierdź pobranie krwi](https://docs.anivahealth.com/pl/api/appointments/confirm-blood-draw.md).
> Próba dodania paneli do potwierdzonej wizyty zwraca `409 Conflict`.

Przy pobraniu kapilarnym (`draw_method: capillary`) pobranie jest rozdzielane do mikroprobówek. Najpierw trafiają tam panele, w
kolejności rezerwacji. Następnie pojedyncze biomarkery wypełniają wolne miejsce w mikroprobówkach paneli. Gdy potrzebują
więcej miejsca, otwierają nowe mikroprobówki. Rozkładamy je równomiernie. Każda mikroprobówka mieści maksymalnie
150 µl pojedynczych biomarkerów. Jeśli wynikowy zestaw paneli łamie tę regułę, wywołanie zwraca `400` z
komunikatem `error` i żaden panel nie zostaje dodany.

## Żądanie

### Parametry ścieżki

**id** `string` *required*

Unikalny identyfikator (UUID) wizyty, do której chcesz dodać panele.

### Parametry treści

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

Tablica identyfikatorów UUID paneli do dodania do wizyty. Musi zawierać co najmniej jeden element.

## Odpowiedź

W przypadku powodzenia API zwraca `200 OK`, potwierdzając dodanie paneli.

**success** `boolean`

`true`, gdy panele zostały pomyślnie dodane do wizyty.

## Odpowiedzi z błędami

| Status | Opis |
| - | - |
| `400` | Błąd walidacji — np. pole `panel_ids` jest puste lub zawiera nieprawidłowy UUID — albo przy pobraniu kapilarnym pojedyncze biomarkery nie mieszczą się już w swoich mikroprobówkach. |
| `403` | Brak dostępu — twój klucz API nie ma uprawnień do tej operacji. |
| `404` | Nie znaleziono wizyty lub co najmniej jednego panelu. |
| `409` | Konflikt — nie można dodawać paneli po potwierdzeniu pobrania krwi lub panel jest domowym zestawem testowym (`error_name: "home_kit_appointment_mismatch_error"`). Zamów domowy zestaw testowy jako [zamówienie domowego zestawu testowego](https://docs.anivahealth.com/pl/api/home-kit-orders/create-home-kit.md). |
| `500` | Wewnętrzny błąd serwera. |

### Panel domowego zestawu testowego

Domowy zestaw testowy jest wysyłany do pacjenta, a krew nie jest pobierana podczas wizyty. Jeśli któryś panel w `panel_ids` jest
domowym zestawem testowym, wywołanie zwraca `409` i nie dodaje żadnego panelu. Treść odpowiedzi zawiera następujące pola:

**error** `string`

Czytelny dla człowieka powód.

**error\_name** `string`

Zawsze `home_kit_appointment_mismatch_error`.

**appointment\_id** `string`

Wizyta, do której panel nie został dodany.

**panel\_id** `string`

Panel domowego zestawu testowego.

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

Dostawca domowego zestawu testowego dla tego panelu lub `null`, gdy nie jest znany.

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