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

# Lisää paneeleja

> Lisää verikoepaneeleja ajanvaraukseen

Lisää yksi tai useampi verikoepaneeli olemassa olevaan ajanvaraukseen. Voit kutsua tätä päätepistettä useita kertoja paneelivalikoiman kokoamiseksi ennen verinäytteenoton vahvistamista.

Vaatii scope-oikeuden `appointments_schedule`.

> [!WARNING]
>
> Paneeleja ei voi lisätä sen jälkeen, kun olet tehnyt [Vahvista verinäytteenotto](https://docs.anivahealth.com/fi/api/appointments/confirm-blood-draw.md) -kutsun.
> Paneelien lisäämisyritys vahvistettuun ajanvaraukseen palauttaa `409 Conflict`.

Kapillaarinäytteenotossa (`draw_method: capillary`) verinäyte pakataan mikroputkiin. Paneelit
menevät ensin varausjärjestyksessä. Yksittäiset biomarkkerit täyttävät sitten paneelien
mikroputkien vapaan tilan. Kun ne tarvitsevat lisää tilaa, ne avaavat uusia mikroputkia. Jaamme ne
tasaisesti. Jokaiseen mikroputkeen mahtuu enintään 150 µl yksittäisiä biomarkkereita. Jos
muodostuva paneelijoukko rikkoo tätä sääntöä, kutsu palauttaa `400` ja `error`-viestin eikä yhtään
paneelia lisätä.

## Pyyntö

### Polkuparametrit

**id** `string` *required*

Sen ajanvarauksen yksilöllinen tunniste (UUID), johon paneelit lisätään.

### Runkoparametrit

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

Taulukko ajanvaraukseen lisättävien paneelien UUID-tunnisteista. Täytyy sisältää vähintään yksi alkio.

## Vastaus

Onnistuessaan API palauttaa `200 OK` vahvistuksena siitä, että paneelit on lisätty.

**success** `boolean`

`true`, kun paneelit on lisätty ajanvaraukseen onnistuneesti.

## Virhevastaukset

| Tila | Kuvaus |
| - | - |
| `400` | Validointivirhe — esim. `panel_ids` on tyhjä tai sisältää virheellisen UUID-tunnisteen — tai kapillaarinäytteenotossa yksittäiset biomarkkerit eivät enää mahdu mikroputkiinsa. |
| `403` | Kielletty — API-avaimellasi ei ole käyttöoikeutta tähän toimintoon. |
| `404` | Ajanvarausta tai yhtä tai useampaa paneelia ei löytynyt. |
| `409` | Ristiriita — paneeleja ei voi lisätä verinäytteenoton vahvistamisen jälkeen tai paneeli on kotitestipakkaus (`error_name: "home_kit_appointment_mismatch_error"`). Tilaa kotitestipakkaus [kotitestipakkaustilauksena](https://docs.anivahealth.com/fi/api/home-kit-orders/create-home-kit.md). |
| `500` | Sisäinen palvelinvirhe. |

### Kotitestipakkauspaneeli

Kotitestipakkaus lähetetään potilaalle, eikä sen näytettä oteta ajanvarauksella. Jos jokin
`panel_ids`-taulukon paneeleista on kotitestipakkaus, kutsu palauttaa `409` eikä lisää yhtään
paneelia. Runko sisältää nämä kentät:

**error** `string`

Ihmisen luettavissa oleva syy.

**error\_name** `string`

Aina `home_kit_appointment_mismatch_error`.

**appointment\_id** `string`

Ajanvaraus, johon paneelia ei lisätty.

**panel\_id** `string`

Kotitestipakkauspaneeli.

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

Paneelin kotitestipakkauksen toimittaja tai `null`, jos se ei ole tiedossa.

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