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

# Egyedi biomarkerek hozzáadása

> Egyedi biomarkerek hozzáadása egy időponthoz

Adj hozzá egy vagy több egyéni biomarkert egy időponthoz külön választható tesztként, bármely
előre összeállított panelen kívül. A továbbítási döntéseket később a rendeléslogisztikai folyamat hozza meg,
az egyes biomarkerek laboronkénti hozzárendelései alapján.

Az így kapott halmazt a rendszer szinkron módon ellenőrzi az egyes laborok zártsági szabályai alapján. Egyes biomarkerek
csak másokkal együtt rendelhetők meg – az LDL/HDL-arányt például olyan rendelés
adja vissza, amely az LDL-t és a HDL-t is tartalmazza, így az arány önmagában történő kérése nem
érvényes rendelés. (Az arány *árazása* is ugyanezek alapján az összetevők alapján történik – lásd a `pricing`
bontást a [Biomarkerek listázása](https://docs.anivahealth.com/hu/api/biomarkers/list-biomarkers.md) oldalon.) Ha a halmaz nem rendelhető meg
hibátlanul, a hívás `400`-as választ ad egy `validation` tartalommal, és **semmi nem kerül mentésre**, így
próbálgatással eljuthatsz egy érvényes halmazhoz:

1. `PATCH … { "biomarker_ids": [45] }` (csak az LDL/HDL-arány) → `400`;
   a `validation.failures[].fix_options[].add_biomarkers` felsorolja az LDL-t és a HDL-t.
2. `PATCH … { "biomarker_ids": [45, 43, 42] }` (arány + LDL + HDL) → `200`.

Ugyanez a folyamat vonatkozik azokra a biomarkerekre is, amelyeket az Aniva csak tétel részeként értékesít: ha egyet önmagában kérsz, a hívás
`400`-as választ ad `error: "biomarker_requires_position"` hibával és az azt értékesítő tételekkel. Lásd:
[Árazás](https://docs.anivahealth.com/hu/concepts/pricing.md).

A [Biomarkerek listázása](https://docs.anivahealth.com/hu/api/biomarkers/list-biomarkers.md) egyes biomarkereknél `price_cents: null` értéket ad meg.
Ezek a biomarkerek **nem kuráltak**: az Aniva nem árazta be őket. Ha hozzáadsz egyet, a hívás
`400`-as választ ad `error: "biomarker_not_priced"` hibával. Ezt a hibát egyetlen másik biomarker sem oldja meg, mert a `null`
azt jelenti, hogy nincs megadott ár, amelyen a markert megvásárolhatnád. A készlethez tartozó markerek kivételt jelentenek. Add hozzá a készletnek
megfelelő panelt, és annak elemei a panellel együtt érkeznek. A hívás olyan elemet is elfogad, amelyet egy
ezt a panelt már tartalmazó időponthoz adsz hozzá.

Kapilláris vérvételnél (`draw_method: capillary`) a minta mikrocsövekbe kerül. Először a panelek kerülnek sorra, a
foglalás sorrendjében. Az egyéni biomarkerek ezután a panelek mikrocsöveiben maradt szabad helyet töltik ki. Ha több
helyre van szükségük, új mikrocsöveket nyitnak. Egyenletesen osztjuk el őket. Egy mikrocsőbe legfeljebb
150 µl egyéni biomarker fér. Az a biomarker, amely önálló mikrocsőben több mint 150 µl-t igényel, soha nem
fér el, ahogy a kurált térfogat nélküli biomarker sem. Ha az így kapott halmaz megszegi ezt a szabályt,
a hívás `400`-as választ ad egy `error` üzenettel, és semmi nem kerül mentésre.

Ez a hívás idempotens: az időponthoz már hozzáadott biomarkerek megmaradnak.

Az `appointments_schedule` és a `schedule_appointments_with_individual_biomarker_selection` jogosultsági körök szükségesek hozzá.

> [!WARNING]
>
> A [Vérvétel megerősítése](https://docs.anivahealth.com/hu/api/appointments/confirm-blood-draw.md) hívása után már nem adhatók hozzá biomarkerek.
> Ha egy megerősített időpontot próbálsz módosítani, a hívás `409 Conflict` választ ad.

## Kérés

### Útvonalparaméterek

**id** `string` *required*

Az időpont egyedi azonosítója (UUID).

### Törzsparaméterek

**biomarker\_ids** `number[]` *required*

A hozzáadni kívánt biomarker-azonosítók tömbje. Legalább egy elemet tartalmaznia kell. Az azonosítók lekérdezéséhez használd a [Biomarkerek
listázása](https://docs.anivahealth.com/hu/api/biomarkers/list-biomarkers.md) végpontot.

## Válasz

Siker esetén az API `200 OK` válasszal erősíti meg, hogy a biomarkereket hozzáadta.

**success** `boolean`

`true`, ha a biomarkerek hozzáadása az időponthoz sikeres volt.

### A `400`-as válasz értelmezése

Minden zártság-ellenőrzési és katalógus-`400` egy mondatot tartalmaz a `message` mezőben. A törzsellenőrzési vagy
mikrocső-`400` csak az `error` mezőt tartalmazza. Az `error` alapján ágazz el. Zártság-ellenőrzési
hiba esetén az `error` egy mondat. Katalógushiba esetén az `error` egy gépi kód:
`biomarker_not_priced` vagy `biomarker_requires_position`.

**Zártság-ellenőrzés** – a halmaz egyetlen laborban sem rendelhető meg hibátlanul:

* `validation.failures[]` – csak zártság-ellenőrzési hibáknál szerepel (egyszerű
  törzsellenőrzési hibáknál nincs jelen). Minden olyan biomarkercsoporthoz egy bejegyzés tartozik, amelyet egyik labor sem tud kiszolgálni, a
  sikertelen `biomarker_ids` értékekkel és a `fix_options[]` listával, a legkisebb opcióval kezdve. Minden opció
  `add_biomarkers` (`{ id, name }`) mezője egy olyan halmaz, amelynek az ÖSSZES elemét hozzá kell adnod – tartsd meg az eredetieket, add hozzá ezeket, és
  próbáld újra. Az üres `fix_options` azt jelenti, hogy semmilyen hozzáadás nem segít; ehelyett távolítsd el a biomarkert.

**Árazatlan biomarker** – az Aniva nem árazta be ezt a biomarkert. A [Biomarkerek
listázása](https://docs.anivahealth.com/hu/api/biomarkers/list-biomarkers.md) `price_cents: null` értékkel adja meg, vagy kihagyja, ha olyan
arányról van szó, amelynek van árazatlan összetevője. Az `error` értéke `biomarker_not_priced`, a `biomarker_id` pedig
megnevezi a markert. Ezt a hibát egyetlen másik biomarker sem oldja meg, ezért távolítsd el a biomarkert. Két feltétel tesz
rendelhetővé egy biomarkert: egy olyan labornak kell elvégeznie, ahová az Aniva továbbítani tud, **és** az Aniva katalógusának be kell
áraznia.

**Tételhez kötött biomarker** – olyan biomarker, amelyet csak tétel részeként értékesítenek, és nincs azt lefedő tétel a
halmazban. Az `error` értéke `biomarker_requires_position`, a `biomarker_id` megnevezi a markert, a `positions[]` pedig
felsorolja az összes olyan tételt, amely értékesíti, a legolcsóbbtól kezdve. Add hozzá ezek egyikének minden biomarkerét. A modell részleteit lásd
az [Árazás](https://docs.anivahealth.com/hu/concepts/pricing.md) oldalon, egy tétel teljes elemkészletét pedig a [Biomarker
lekérése](https://docs.anivahealth.com/hu/api/biomarkers/get-biomarker.md) végpont `pricing.positions` mezőjében.

## Hibaválaszok

| Státusz | Leírás |
| - | - |
| `400` | A `biomarker_ids` üres vagy nem egész szám, a halmaz elbukik a zártság-ellenőrzésen (`validation.failures`), olyan biomarkert ad hozzá, amelyet az Aniva nem árazott be (`error: "biomarker_not_priced"`), olyan tételhez kötött biomarkert tartalmaz, amelyet a halmaz egyetlen tétele sem fed le (`error: "biomarker_requires_position"`), vagy kapilláris vérvételnél a biomarkerek nem férnek el a mikrocsövekben. |
| `403` | Tiltott – hiányzó jogosultsági kör vagy a hozzáférési kontextuson kívüli időpont. |
| `404` | Az időpont vagy egy vagy több biomarker nem található. |
| `409` | Ütközés – a vérvétel megerősítése után a biomarkerek nem módosíthatók. |
| `500` | Belső szerverhiba. |

```bash cURL theme={null}
curl --request PATCH \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/biomarkers \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "biomarker_ids": [45, 43, 42]
  }'
```

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

```json 400 (closure validation) theme={null}
{
  "error": "LDL / HDL Ratio cannot be ordered cleanly with this set — add LDL Cholesterol / HDL Cholesterol (see validation.failures for every option).",
  "message": "LDL / HDL Ratio cannot be ordered cleanly with this set — add LDL Cholesterol / HDL Cholesterol (see validation.failures for every option).",
  "validation": {
    "failures": [
      {
        "biomarker_ids": [45],
        "fix_options": [
          {
            "add_biomarkers": [
              { "id": 43, "name": "LDL Cholesterol" },
              { "id": 42, "name": "HDL Cholesterol" }
            ]
          }
        ]
      }
    ]
  }
}
```

```json 400 (biomarker Aniva has not priced) theme={null}
{
  "error": "biomarker_not_priced",
  "message": "Adrenaline, 24h urine carries no price in the catalog you can order from — GET /api/v1/biomarkers/1465 reports price_cents: null for it, and a marker with no price cannot be ordered.",
  "biomarker_id": 1465
}
```

```json 400 (biomarker sold only inside a position) theme={null}
{
  "error": "biomarker_requires_position",
  "message": "Mean Platelet Volume (MPV) is not sold on its own — it comes only inside a position. Add every biomarker of one of the positions listed here; the cheapest is \"Blood Count (extended)\".",
  "biomarker_id": 77,
  "positions": [
    {
      "id": "3f1a8c22-64bd-4e57-8a90-1c2d3e4f5a6b",
      "name": "Blood Count (extended)",
      "price_cents": 460,
      "retail_cents": 529
    }
  ]
}
```

```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": "Individual biomarkers cannot be modified after blood draw has been confirmed"
}
```

```json 404 theme={null}
{
  "error": "Biomarkers not found: 99999"
}
```


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