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

# Dodaj pojedyncze biomarkery

> Dodaj pojedyncze biomarkery do wizyty

Dodaj jeden lub więcej pojedynczych biomarkerów do wizyty jako badania à la carte, poza
gotowym panelem. Decyzje o kierowaniu zleceń zapadają na dalszym etapie w potoku logistyki zamówień na podstawie
mapowań każdego biomarkera w poszczególnych laboratoriach.

Wynikowy zestaw jest walidowany synchronicznie pod kątem reguł domknięcia każdego laboratorium. Niektóre biomarkery
można uzyskać tylko wtedy, gdy zamówisz je razem z innymi — na przykład wskaźnik LDL/HDL
jest realizowany w ramach zlecenia, które zwraca również LDL i HDL, więc zamówienie samego wskaźnika nie tworzy
spójnego zlecenia. (To właśnie na podstawie tych samych składników wskaźnik jest *wyceniany* — zobacz strukturę `pricing`
w [Liście biomarkerów](https://docs.anivahealth.com/pl/api/biomarkers/list-biomarkers.md).) Gdy zestawu nie da się poprawnie
zamówić, wywołanie zwraca `400` z obiektem `validation` i **nic nie zostaje zapisane**, dzięki czemu
możesz metodą prób i błędów dojść do poprawnego zestawu:

1. `PATCH … { "biomarker_ids": [45] }` (sam wskaźnik LDL/HDL) → `400`;
   `validation.failures[].fix_options[].add_biomarkers` wymienia LDL i HDL.
2. `PATCH … { "biomarker_ids": [45, 43, 42] }` (wskaźnik + LDL + HDL) → `200`.

Ten sam mechanizm dotyczy biomarkerów, które Aniva sprzedaje wyłącznie w ramach pozycji: zamów taki biomarker osobno, a wywołanie
zwróci `400` z `error: "biomarker_requires_position"` oraz pozycjami, w których jest dostępny. Zobacz
[Cennik](https://docs.anivahealth.com/pl/concepts/pricing.md).

[Lista biomarkerów](https://docs.anivahealth.com/pl/api/biomarkers/list-biomarkers.md) podaje niektóre biomarkery z wartością `price_cents: null`.
Te biomarkery są **nieopracowane**: Aniva ich nie wyceniła. Jeśli dodasz taki biomarker, wywołanie zwróci
`400` z `error: "biomarker_not_priced"`. Żaden inny biomarker nie naprawi tego błędu, ponieważ `null`
oznacza, że nie ma ceny, po której możesz kupić ten marker. Wyjątkiem są markery z zestawów. Dodaj panel
będący zestawem, a jego składniki zostaną dołączone razem z panelem. Wywołanie akceptuje też składnik, który dodajesz do
wizyty zawierającej już ten panel.

Przy pobraniu kapilarnym (`draw_method: capillary`) pobranie jest rozdzielane do mikroprobówek. Najpierw trafiają tam panele, w
kolejności rezerwacji. Następnie pojedyncze biomarkery wypełniają wolne miejsce w mikroprobówkach paneli. Gdy potrzebują
więcej miejsca, otwierają nowe mikroprobówki. Rozkładamy je równomiernie. Każda mikroprobówka mieści maksymalnie
150 µl pojedynczych biomarkerów. Biomarker, który potrzebuje ponad 150 µl we własnej mikroprobówce, nigdy się nie
zmieści, podobnie jak biomarker bez określonej objętości. Jeśli wynikowy zestaw łamie tę regułę,
wywołanie zwraca `400` z komunikatem `error` i nic nie zostaje zapisane.

To wywołanie jest idempotentne: biomarkery już przypisane do wizyty zostają zachowane.

Wymaga zakresów `appointments_schedule` oraz `schedule_appointments_with_individual_biomarker_selection`.

> [!WARNING]
>
> Nie można dodawać biomarkerów po wywołaniu [Potwierdź pobranie
> krwi](https://docs.anivahealth.com/pl/api/appointments/confirm-blood-draw.md). Próba zmiany potwierdzonej wizyty zwraca
> `409 Conflict`.

## Żądanie

### Parametry ścieżki

**id** `string` *required*

Unikalny identyfikator (UUID) wizyty.

### Parametry treści

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

Tablica identyfikatorów biomarkerów do dodania. Musi zawierać co najmniej jeden element. Użyj [Listy
biomarkerów](https://docs.anivahealth.com/pl/api/biomarkers/list-biomarkers.md), aby znaleźć identyfikatory.

## Odpowiedź

W przypadku powodzenia API zwraca `200 OK`, potwierdzając dodanie biomarkerów.

**success** `boolean`

`true`, gdy biomarkery zostały pomyślnie dodane do wizyty.

### Odczytywanie `400`

Każdy błąd `400` związany z walidacją domknięcia lub katalogiem zawiera zdanie w polu `message`. Błąd `400` dotyczący walidacji treści lub
mikroprobówek zawiera samo pole `error`. Rozgałęziaj logikę na podstawie `error`. Przy
błędzie walidacji domknięcia `error` jest zdaniem. Przy błędzie katalogu `error` jest kodem maszynowym:
`biomarker_not_priced` lub `biomarker_requires_position`.

**Walidacja domknięcia** — zestawu nie da się poprawnie zamówić w żadnym laboratorium:

* `validation.failures[]` — obecne tylko przy błędach walidacji domknięcia (brak przy zwykłych
  błędach walidacji treści). Jeden wpis na każdą grupę biomarkerów, której żadne laboratorium nie obsługuje, zawierający
  błędne `biomarker_ids` oraz `fix_options[]`, od najmniejszej opcji. Pole
  `add_biomarkers` (`{ id, name }`) w każdej opcji to zestaw, który musisz dodać W CAŁOŚCI — zachowaj pierwotne biomarkery, dodaj te i
  spróbuj ponownie. Puste `fix_options` oznacza, że dodanie innych biomarkerów nie pomoże; zamiast tego usuń ten biomarker.

**Biomarker bez wyceny** — Aniva nie wyceniła tego biomarkera. [Lista
biomarkerów](https://docs.anivahealth.com/pl/api/biomarkers/list-biomarkers.md) podaje go jako `price_cents: null` lub go pomija, jeśli
jest wskaźnikiem z niewycenionym składnikiem. `error` ma wartość `biomarker_not_priced`, a `biomarker_id` wskazuje
ten marker. Żaden inny biomarker nie naprawi tego błędu, więc usuń ten biomarker. O możliwości zamówienia
biomarkera decydują dwa warunki: laboratorium, do którego Aniva może skierować zlecenie, musi go wykonywać, **oraz** katalog Aniva musi mieć jego
wycenę.

**Biomarker wymagający pozycji** — biomarker sprzedawany wyłącznie w ramach pozycji, dla którego w zestawie brakuje odpowiedniej
pozycji. `error` ma wartość `biomarker_requires_position`, `biomarker_id` wskazuje ten marker, a `positions[]`
wymienia każdą pozycję, w której jest dostępny, od najtańszej. Dodaj wszystkie biomarkery z jednej z nich. Zobacz
[Cennik](https://docs.anivahealth.com/pl/concepts/pricing.md), aby poznać ten model, oraz `pricing.positions` w [Pobierz
biomarker](https://docs.anivahealth.com/pl/api/biomarkers/get-biomarker.md), aby zobaczyć pełny zestaw składników pozycji.

## Odpowiedzi z błędami

| Status | Opis |
| - | - |
| `400` | Pole `biomarker_ids` jest puste lub nie zawiera liczb całkowitych, zestaw nie przechodzi walidacji domknięcia (`validation.failures`), dodaje biomarker niewyceniony przez Aniva (`error: "biomarker_not_priced"`), zawiera biomarker wymagający pozycji, którego nie obejmuje żadna pozycja w zestawie (`error: "biomarker_requires_position"`), albo przy pobraniu kapilarnym biomarkery nie mieszczą się w swoich mikroprobówkach. |
| `403` | Brak dostępu — brakujący zakres lub wizyta poza kontekstem dostępu. |
| `404` | Nie znaleziono wizyty lub co najmniej jednego biomarkera. |
| `409` | Konflikt — nie można zmieniać biomarkerów po potwierdzeniu pobrania krwi. |
| `500` | Wewnętrzny błąd serwera. |

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