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

# Adaugă biomarkeri individuali

> Adaugă biomarkeri individuali la o programare

Adaugă unul sau mai mulți biomarkeri individuali la o programare ca teste à-la-carte, în afara
oricărui panel predefinit. Deciziile de rutare sunt luate ulterior de fluxul de logistică a
comenzilor, pe baza mapărilor per laborator ale fiecărui biomarker.

Setul rezultat este validat sincron față de regulile de închidere ale fiecărui laborator. Unii
biomarkeri pot fi obținuți doar dacă îi comanzi împreună cu alții — un raport LDL/HDL, de exemplu,
este livrat printr-o comandă care returnează și LDL și HDL, deci solicitarea raportului singur nu
este o comandă coerentă. (Aceleași componente stabilesc și *prețul* raportului — vezi structura
`pricing` în [Listare biomarkeri](https://docs.anivahealth.com/ro/api/biomarkers/list-biomarkers.md).) Când setul nu poate fi
comandat corect, apelul returnează `400` cu un payload `validation` și **nimic nu este salvat**,
astfel încât să poți ajusta setul prin încercări până devine valid:

1. `PATCH … { "biomarker_ids": [45] }` (doar raportul LDL/HDL) → `400`;
   `validation.failures[].fix_options[].add_biomarkers` listează LDL și HDL.
2. `PATCH … { "biomarker_ids": [45, 43, 42] }` (raport + LDL + HDL) → `200`.

Același mecanism acoperă biomarkerii pe care Aniva îi vinde doar într-o poziție: dacă ceri unul
singur, apelul returnează `400` cu `error: "biomarker_requires_position"` și pozițiile care îl
vând. Vezi [Prețuri](https://docs.anivahealth.com/ro/concepts/pricing.md).

[Listare biomarkeri](https://docs.anivahealth.com/ro/api/biomarkers/list-biomarkers.md) indică unii biomarkeri cu `price_cents: null`.
Acești biomarkeri sunt **neconfigurați**: Aniva nu le-a stabilit un preț. Dacă adaugi unul, apelul
returnează `400` cu `error: "biomarker_not_priced"`. Niciun alt biomarker nu rezolvă această
eroare, deoarece `null` înseamnă că nu ai un preț la care să cumperi markerul. Markerii din kituri
sunt excepția. Atașează panelul care reprezintă kitul, iar membrii săi vin odată cu panelul. Apelul
acceptă și un membru pe care îl adaugi la o programare care are deja acel panel.

La o recoltare capilară (`draw_method: capillary`), recoltarea de sânge este repartizată în
microtainere. Panelurile intră primele, în ordinea programării. Biomarkerii individuali ocupă apoi
spațiul liber din microtainerele panelurilor. Când au nevoie de mai mult spațiu, deschid
microtainere noi. Îi distribuim uniform. Fiecare microtainer poate conține cel mult 150 µl de
biomarkeri individuali. Un biomarker care necesită mai mult de 150 µl într-un microtainer propriu
nu încape niciodată, la fel și un biomarker fără un volum configurat. Dacă setul rezultat încalcă
această regulă, apelul returnează `400` cu un mesaj `error` și nimic nu este salvat.

Acest apel este idempotent: biomarkerii deja existenți în programare sunt păstrați.

Necesită scope-urile `appointments_schedule` și `schedule_appointments_with_individual_biomarker_selection`.

> [!WARNING]
>
> Biomarkerii nu pot fi adăugați după ce apelezi [Confirmare recoltare de
> sânge](https://docs.anivahealth.com/ro/api/appointments/confirm-blood-draw.md). Încercarea de a modifica o programare confirmată
> returnează `409 Conflict`.

## Cerere

### Parametri de cale

**id** `string` *required*

Identificatorul unic (UUID) al programării.

### Parametri de corp

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

Listă de ID-uri de biomarkeri de atașat. Trebuie să conțină cel puțin un element. Folosește
[Listare biomarkeri](https://docs.anivahealth.com/ro/api/biomarkers/list-biomarkers.md) pentru a afla ID-urile.

## Răspuns

În caz de succes, API-ul returnează `200 OK`, confirmând că biomarkerii au fost atașați.

**success** `boolean`

`true` când biomarkerii au fost adăugați cu succes la programare.

### Interpretarea unui `400`

Fiecare `400` de validare a închiderii sau de catalog include o propoziție în `message`. Un `400`
de validare a corpului sau de microtainer include doar `error`. Ramifică logica după `error`. La o
eroare de validare a închiderii, `error` este o propoziție. La o eroare de catalog, `error` este
un cod programatic: `biomarker_not_priced` sau `biomarker_requires_position`.

**Validarea închiderii** — setul nu poate fi comandat corect la niciun laborator:

* `validation.failures[]` — prezent doar la erorile de validare a închiderii (absent la erorile
  simple de validare a corpului). Câte o intrare pentru fiecare grup de biomarkeri pe care niciun
  laborator nu îl poate onora, conținând `biomarker_ids` care au eșuat și `fix_options[]`, cu cea
  mai mică opțiune prima. Câmpul `add_biomarkers` (`{ id, name }`) al fiecărei opțiuni este un set
  pe care îl adaugi INTEGRAL — păstrează-i pe cei inițiali, adaugă-i pe aceștia și încearcă din
  nou. Un `fix_options` gol înseamnă că nu te va ajuta să adaugi nimic; elimină în schimb
  biomarkerul.

**Biomarker fără preț** — Aniva nu a stabilit un preț pentru acest biomarker. [Listare
biomarkeri](https://docs.anivahealth.com/ro/api/biomarkers/list-biomarkers.md) îl indică cu `price_cents: null` sau îl omite când
este un raport cu o componentă fără preț. `error` este `biomarker_not_priced`, iar `biomarker_id`
indică markerul. Niciun alt biomarker nu rezolvă această eroare, așa că elimină biomarkerul. Două
condiții fac un biomarker disponibil pentru comandă: un laborator către care Aniva poate ruta
trebuie să îl livreze, **și** catalogul Aniva trebuie să îi stabilească un preț.

**Biomarker restricționat** — un biomarker vândut doar într-o poziție, fără o poziție care să îl
acopere în set. `error` este `biomarker_requires_position`, `biomarker_id` indică markerul, iar
`positions[]` listează fiecare poziție care îl vinde, începând cu cea mai ieftină. Adaugă fiecare
biomarker din una dintre ele. Vezi [Prețuri](https://docs.anivahealth.com/ro/concepts/pricing.md) pentru model și `pricing.positions`
în [Obținere biomarker](https://docs.anivahealth.com/ro/api/biomarkers/get-biomarker.md) pentru setul complet de membri al unei
poziții.

## Răspunsuri de eroare

| Status | Descriere |
| - | - |
| `400` | `biomarker_ids` este gol / nu conține numere întregi, setul nu trece validarea închiderii (`validation.failures`), adaugă un biomarker pentru care Aniva nu a stabilit un preț (`error: "biomarker_not_priced"`), conține un biomarker restricționat pe care nicio poziție din set nu îl acoperă (`error: "biomarker_requires_position"`) sau, la o recoltare capilară, biomarkerii nu încap în microtainerele lor. |
| `403` | Interzis — lipsește scope-ul sau programarea se află în afara contextului de acces. |
| `404` | Programarea sau unul ori mai mulți biomarkeri nu au fost găsiți. |
| `409` | Conflict — biomarkerii nu pot fi modificați după confirmarea recoltării de sânge. |
| `500` | Eroare internă de server. |

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