> ## 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 jednotlivé biomarkery

> Přidat jednotlivé biomarkery k termínu

Přidej k termínu jeden nebo více jednotlivých biomarkerů jako samostatné testy mimo jakýkoli
předpřipravený panel. O směrování rozhoduje navazující pipeline pro logistiku objednávek
podle mapování každého biomarkeru pro jednotlivé laboratoře.

Výsledná sada se synchronně ověřuje podle pravidel uzavřenosti jednotlivých laboratoří. Některé
biomarkery lze získat jen tehdy, když je objednáš společně s jinými — například poměr LDL/HDL
se dodává v rámci objednávky, která vrací také LDL a HDL, takže požadovat samotný poměr není
ucelená objednávka. (Podle stejných složek je poměr také *oceněn* — podívej se na rozpis `pricing`
ve [Výpisu biomarkerů](https://docs.anivahealth.com/cs/api/biomarkers/list-biomarkers.md).) Když sadu nelze čistě objednat,
volání vrátí `400` s payloadem `validation` a **nic se neuloží**, takže se k platné sadě můžeš
dopracovat metodou pokus–omyl:

1. `PATCH … { "biomarker_ids": [45] }` (samotný poměr LDL/HDL) → `400`;
   `validation.failures[].fix_options[].add_biomarkers` uvádí LDL a HDL.
2. `PATCH … { "biomarker_ids": [45, 43, 42] }` (poměr + LDL + HDL) → `200`.

Stejný postup platí pro biomarkery, které Aniva prodává jen v rámci pozice: když požádáš jen o jeden
samostatně, volání vrátí `400` s `error: "biomarker_requires_position"` a pozicemi, které ho
prodávají. Podívej se na [Ceny](https://docs.anivahealth.com/cs/concepts/pricing.md).

[Výpis biomarkerů](https://docs.anivahealth.com/cs/api/biomarkers/list-biomarkers.md) u některých biomarkerů uvádí `price_cents: null`.
Tyto biomarkery jsou **nekurované**: Aniva jim nestanovila cenu. Pokud některý přidáš, volání vrátí
`400` s `error: "biomarker_not_priced"`. Žádný jiný biomarker tuto chybu nevyřeší, protože `null`
znamená, že pro tento marker nemáš nákupní cenu. Výjimkou jsou markery ze sady. Připoj panel,
který tuto sadu představuje, a jeho součásti se přidají společně s ním. Volání přijme i součást,
kterou přidáš k termínu, který už tento panel obsahuje.

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ů. Biomarker, který ve vlastní mikrozkumavce potřebuje víc než 150 µl, se nikdy
nevejde, stejně jako biomarker bez stanoveného objemu. Pokud výsledná sada toto pravidlo poruší,
volání vrátí `400` se zprávou `error` a nic se neuloží.

Toto volání je idempotentní: biomarkery, které už u termínu jsou, zůstanou zachovány.

Vyžaduje rozsahy `appointments_schedule` a `schedule_appointments_with_individual_biomarker_selection`.

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

## Požadavek

### Parametry cesty

**id** `string` *required*

Jedinečný identifikátor (UUID) termínu.

### Parametry těla

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

Pole ID biomarkerů k připojení. Musí obsahovat alespoň jednu položku. K nalezení ID použij
[Výpis biomarkerů](https://docs.anivahealth.com/cs/api/biomarkers/list-biomarkers.md).

## Odpověď

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

**success** `boolean`

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

### Jak číst `400`

Každá `400` z validace uzavřenosti a katalogu obsahuje větu v `message`. Chyba `400` z validace těla
nebo mikrozkumavek obsahuje jen `error`. Větvi podle `error`. Při selhání
validace uzavřenosti je `error` věta. Při chybě katalogu je `error` strojový kód:
`biomarker_not_priced` nebo `biomarker_requires_position`.

**Validace uzavřenosti** — sadu nelze čistě objednat v žádné laboratoři:

* `validation.failures[]` — přítomno jen při selhání validace uzavřenosti (u běžných chyb
  validace těla chybí). Jeden záznam pro každou skupinu biomarkerů, kterou žádná laboratoř neumí
  zpracovat, s hodnotami `biomarker_ids`, které selhaly, a `fix_options[]` od nejmenší možnosti.
  `add_biomarkers` (`{ id, name }`) každé možnosti je sada, kterou přidáš CELOU — ponech
  původní, přidej tyto a zkus to znovu. Prázdné `fix_options` znamená, že žádné přidání nepomůže;
  místo toho biomarker odeber.

**Neoceněný biomarker** — Aniva tomuto biomarkeru nestanovila cenu. [Výpis
biomarkerů](https://docs.anivahealth.com/cs/api/biomarkers/list-biomarkers.md) ho uvádí jako `price_cents: null`, případně ho
vynechá, pokud jde o poměr s neoceněnou složkou. `error` má hodnotu `biomarker_not_priced` a
`biomarker_id` označuje daný marker. Žádný jiný biomarker tuto chybu nevyřeší, takže biomarker
odeber. Biomarker lze objednat za dvou podmínek: musí ho dodávat laboratoř, do které umí Aniva
směrovat, **a** katalog Aniva mu musí stanovit cenu.

**Vázaný biomarker** — biomarker prodávaný jen v rámci pozice, přičemž v sadě žádná pokrývající
pozice není. `error` má hodnotu `biomarker_requires_position`, `biomarker_id` označuje daný marker a
`positions[]` uvádí všechny pozice, které ho prodávají, od nejlevnější. Přidej všechny biomarkery
z jedné z nich. Model najdeš v části [Ceny](https://docs.anivahealth.com/cs/concepts/pricing.md) a úplnou sadu součástí pozice v
`pricing.positions` v [Získání biomarkeru](https://docs.anivahealth.com/cs/api/biomarkers/get-biomarker.md).

## Chybové odpovědi

| Stav | Popis |
| - | - |
| `400` | `biomarker_ids` je prázdné / neobsahuje celá čísla, sada neprošla validací uzavřenosti (`validation.failures`), přidává biomarker, kterému Aniva nestanovila cenu (`error: "biomarker_not_priced"`), obsahuje vázaný biomarker bez pokrývající pozice v sadě (`error: "biomarker_requires_position"`), nebo se biomarkery při kapilárním odběru krve nevejdou do mikrozkumavek. |
| `403` | Zakázáno — chybějící rozsah nebo termín mimo přístupový kontext. |
| `404` | Nebyl nalezen termín nebo jeden či více biomarkerů. |
| `409` | Konflikt — po potvrzení odběru krve nelze biomarkery upravovat. |
| `500` | Interní chyba serveru. |

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