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

# Přidat panely

> Přidat panely krevních testů k termínu

Přidej jeden nebo více panelů krevních testů k existujícímu termínu. Tento endpoint můžeš před potvrzením odběru krve volat opakovaně a postupně tak sestavit výběr panelů.

Vyžaduje rozsah `appointments_schedule`.

> [!WARNING]
>
> Panely nelze přidávat poté, co zavoláš [Potvrzení odběru krve](https://docs.anivahealth.com/cs/api/appointments/confirm-blood-draw.md).
> Pokus o přidání panelů k potvrzenému termínu vrátí `409 Conflict`.

Při kapilárním odběru krve (`draw_method: capillary`) se odběr rozděluje do mikrozkumavek. Jako první přijdou na řadu panely,
a to v pořadí rezervace. Jednotlivé biomarkery pak zaplní volné místo v mikrozkumavkách pro panely. Když
potřebují víc místa, otevřou se nové mikrozkumavky. Rozdělujeme je rovnoměrně. Každá mikrozkumavka pojme nejvýše
150 µl jednotlivých biomarkerů. Pokud výsledná sada panelů toto pravidlo poruší, volání vrátí `400` se
zprávou `error` a žádný panel se nepřidá.

## Požadavek

### Parametry cesty

**id** `string` *required*

Jedinečný identifikátor (UUID) termínu, ke kterému chceš přidat panely.

### Parametry těla

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

Pole UUID panelů, které chceš k termínu přidat. Musí obsahovat alespoň jednu položku.

## Odpověď

Při úspěchu vrátí API `200 OK` s potvrzením, že panely byly přidány.

**success** `boolean`

`true`, když byly panely úspěšně přidány k termínu.

## Chybové odpovědi

| Stav | Popis |
| - | - |
| `400` | Chyba validace — např. pole `panel_ids` je prázdné nebo obsahuje neplatné UUID — nebo se jednotlivé biomarkery při kapilárním odběru krve už nevejdou do mikrozkumavek. |
| `403` | Zakázáno — tvůj API klíč nemá k této operaci přístup. |
| `404` | Nebyl nalezen termín nebo jeden či více panelů. |
| `409` | Konflikt — po potvrzení odběru krve nelze panely přidávat, nebo je panel domácí testovací sada (`error_name: "home_kit_appointment_mismatch_error"`). Domácí testovací sadu objednej jako [objednávku domácí testovací sady](https://docs.anivahealth.com/cs/api/home-kit-orders/create-home-kit.md). |
| `500` | Interní chyba serveru. |

### Panel domácí testovací sady

Domácí testovací sada se posílá pacientovi a odběr krve neprobíhá na termínu. Pokud je některý panel v `panel_ids`
domácí testovací sada, volání vrátí `409` a žádný panel nepřidá. Tělo odpovědi obsahuje tato pole:

**error** `string`

Důvod čitelný pro člověka.

**error\_name** `string`

Vždy `home_kit_appointment_mismatch_error`.

**appointment\_id** `string`

Termín, ke kterému panel nebyl přidán.

**panel\_id** `string`

Panel domácí testovací sady.

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

Poskytovatel domácí testovací sady panelu, nebo `null`, pokud není znám.

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