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

# Pievienot paneļus

> Pievienot asins analīžu paneļus pierakstam

Pievieno esošam pierakstam vienu vai vairākus asins analīžu paneļus. Šo galapunktu vari izsaukt vairākas reizes, lai izveidotu paneļu izvēli pirms asins paņemšanas apstiprināšanas.

Nepieciešams piekļuves tvērums `appointments_schedule`.

> [!WARNING]
>
> Paneļus nevar pievienot pēc tam, kad izsauc [Apstiprināt asins paņemšanu](https://docs.anivahealth.com/lv/api/appointments/confirm-blood-draw.md).
> Mēģinājums pievienot paneļus apstiprinātam pierakstam atgriež `409 Conflict`.

Kapilārajā asins paņemšanā (`draw_method: capillary`) paņemtās asinis tiek sadalītas mikrostobriņos. Vispirms tiek ievietoti paneļi
rezervācijas secībā. Pēc tam individuālie biomarķieri aizpilda brīvo vietu paneļu mikrostobriņos. Ja tiem
nepieciešams vairāk vietas, tiek atvērti jauni mikrostobriņi. Mēs tos sadalām vienmērīgi. Katrā mikrostobriņā var būt ne vairāk kā
150 µl individuālo biomarķieru. Ja iegūtā paneļu kopa pārkāpj šo noteikumu, izsaukums atgriež `400` ar
`error` ziņojumu un neviens panelis netiek pievienots.

## Pieprasījums

### Ceļa parametri

**id** `string` *required*

Unikālais identifikators (UUID) pierakstam, kuram pievienot paneļus.

### Pieprasījuma satura parametri

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

Pierakstam pievienojamo paneļu UUID masīvs. Jāsatur vismaz viens elements.

## Atbilde

Veiksmīgas izpildes gadījumā API atgriež `200 OK`, apstiprinot, ka paneļi ir pievienoti.

**success** `boolean`

`true`, kad paneļi ir veiksmīgi pievienoti pierakstam.

## Kļūdu atbildes

| Statuss | Apraksts |
| - | - |
| `400` | Validācijas kļūda — piemēram, `panel_ids` ir tukšs vai satur nederīgu UUID — vai kapilārajā asins paņemšanā individuālie biomarķieri vairs neietilpst mikrostobriņos. |
| `403` | Aizliegts — tavai API atslēgai nav piekļuves šai darbībai. |
| `404` | Pieraksts vai viens vai vairāki paneļi netika atrasti. |
| `409` | Konflikts — paneļus nevar pievienot pēc asins paņemšanas apstiprināšanas, vai kāds panelis ir mājas testa komplekts (`error_name: "home_kit_appointment_mismatch_error"`). Pasūti mājas testa komplektu kā [mājas testa komplekta pasūtījumu](https://docs.anivahealth.com/lv/api/home-kit-orders/create-home-kit.md). |
| `500` | Iekšēja servera kļūda. |

### Mājas testa komplekta panelis

Mājas testa komplekts tiek nosūtīts pacientam, un tam netiek veikta asins paņemšana pierakstā. Ja kāds panelis laukā `panel_ids` ir
mājas testa komplekts, izsaukums atgriež `409` un nepievieno nevienu paneli. Atbildes saturs ietver šādus laukus:

**error** `string`

Cilvēkam lasāms iemesls.

**error\_name** `string`

Vienmēr `home_kit_appointment_mismatch_error`.

**appointment\_id** `string`

Pieraksts, kuram panelis netika pievienots.

**panel\_id** `string`

Mājas testa komplekta panelis.

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

Paneļa mājas testa komplekta piegādātājs vai `null`, ja tas nav zināms.

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