> ## 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 atsevišķus biomarķierus

> Pievienot atsevišķus biomarķierus pierakstam

Pievieno pierakstam vienu vai vairākus individuālus biomarķierus kā atsevišķas analīzes ārpus
gatavajiem paneļiem. Maršrutēšanas lēmumus tālāk pieņem pasūtījumu loģistikas plūsma, pamatojoties
uz katra biomarķiera piesaisti konkrētām laboratorijām.

Iegūtā kopa tiek sinhroni validēta atbilstoši katras laboratorijas noslēgtības noteikumiem. Dažus biomarķierus
var iegūt, tikai pasūtot tos kopā ar citiem — piemēram, LDL/HDL attiecību
sniedz pasūtījums, kas ietver arī LDL un HDL, tāpēc pieprasīt tikai attiecību vienu pašu nav
pilnvērtīgs pasūtījums. (Tieši šīs sastāvdaļas nosaka attiecības *cenu* — skati `pricing`
sadalījumu sadaļā [Biomarķieru saraksts](https://docs.anivahealth.com/lv/api/biomarkers/list-biomarkers.md).) Ja kopu nevar korekti
pasūtīt, izsaukums atgriež `400` ar `validation` datiem un **nekas netiek saglabāts**, tāpēc vari
izmēģināt vairākus variantus, līdz izveido derīgu kopu:

1. `PATCH … { "biomarker_ids": [45] }` (tikai LDL/HDL attiecība) → `400`;
   `validation.failures[].fix_options[].add_biomarkers` norāda LDL un HDL.
2. `PATCH … { "biomarker_ids": [45, 43, 42] }` (attiecība + LDL + HDL) → `200`.

Tas pats cikls attiecas uz biomarķieriem, kurus Aniva pārdod tikai pozīcijas ietvaros: pieprasi kādu atsevišķi, un izsaukums
atgriezīs `400` ar `error: "biomarker_requires_position"` un pozīcijām, kurās tas tiek pārdots. Skati
[Cenas](https://docs.anivahealth.com/lv/concepts/pricing.md).

[Biomarķieru saraksts](https://docs.anivahealth.com/lv/api/biomarkers/list-biomarkers.md) dažiem biomarķieriem norāda `price_cents: null`.
Šie biomarķieri ir **nekūrēti**: Aniva tiem nav noteikusi cenu. Ja pievieno kādu no tiem, izsaukums atgriež
`400` ar `error: "biomarker_not_priced"`. Neviens cits biomarķieris šo kļūdu nenovērš, jo `null`
nozīmē, ka nav cenas, par kādu šo marķieri iegādāties. Izņēmums ir komplekta marķieri. Pievieno paneli,
kas ir pats komplekts, un tā sastāvdaļas tiks pievienotas kopā ar paneli. Izsaukums pieņem arī sastāvdaļu, ko pievieno
pierakstam, kurā šis panelis jau ir iekļauts.

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. Biomarķieris, kuram atsevišķā mikrostobriņā nepieciešams vairāk nekā 150 µl, nekad
neietilpst, tāpat kā biomarķieris bez noteikta tilpuma. Ja iegūtā kopa pārkāpj šo noteikumu,
izsaukums atgriež `400` ar `error` ziņojumu un nekas netiek saglabāts.

Šis izsaukums ir idempotents: pierakstā jau esošie biomarķieri tiek saglabāti.

Nepieciešami piekļuves tvērumi `appointments_schedule` un `schedule_appointments_with_individual_biomarker_selection`.

> [!WARNING]
>
> Biomarķierus 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 mainīt apstiprinātu pierakstu atgriež
> `409 Conflict`.

## Pieprasījums

### Ceļa parametri

**id** `string` *required*

Pieraksta unikālais identifikators (UUID).

### Pieprasījuma satura parametri

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

Pievienojamo biomarķieru ID masīvs. Jāsatur vismaz viens elements. Izmanto [Biomarķieru
sarakstu](https://docs.anivahealth.com/lv/api/biomarkers/list-biomarkers.md), lai atrastu ID.

## Atbilde

Veiksmīgas izpildes gadījumā API atgriež `200 OK`, apstiprinot, ka biomarķieri ir pievienoti.

**success** `boolean`

`true`, kad biomarķieri ir veiksmīgi pievienoti pierakstam.

### Kā lasīt `400`

Katra noslēgtības validācijas un kataloga `400` atbilde ietver teikumu laukā `message`. Satura validācijas vai
mikrostobriņu `400` atbilde ietver tikai `error`. Sazaro loģiku pēc `error`. Noslēgtības
validācijas kļūdas gadījumā `error` ir teikums. Kataloga kļūdas gadījumā `error` ir mašīnlasāms kods:
`biomarker_not_priced` vai `biomarker_requires_position`.

**Noslēgtības validācija** — kopu nevar korekti pasūtīt nevienā laboratorijā:

* `validation.failures[]` — pieejams tikai noslēgtības validācijas kļūdu gadījumā (nav iekļauts parastās
  satura validācijas kļūdās). Viens ieraksts katrai biomarķieru grupai, kuru nevar apkalpot neviena laboratorija, ietverot
  `biomarker_ids`, kuriem validācija neizdevās, un `fix_options[]` ar mazāko variantu sākumā. Katra varianta
  `add_biomarkers` (`{ id, name }`) ir kopa, kas jāpievieno PILNĪBĀ — saglabā sākotnējos, pievieno šos un
  mēģini vēlreiz. Tukšs `fix_options` nozīmē, ka pievienošana nepalīdzēs; tā vietā noņem biomarķieri.

**Biomarķieris bez cenas** — Aniva šim biomarķierim nav noteikusi cenu. [Biomarķieru
saraksts](https://docs.anivahealth.com/lv/api/biomarkers/list-biomarkers.md) tam norāda `price_cents: null` vai izlaiž to, ja tā
ir attiecība ar sastāvdaļu bez cenas. `error` ir `biomarker_not_priced`, un `biomarker_id` norāda
šo marķieri. Neviens cits biomarķieris šo kļūdu nenovērš, tāpēc noņem šo biomarķieri. Biomarķieris ir
pasūtāms, ja izpildās divi nosacījumi: laboratorijai, uz kuru Aniva var novirzīt pasūtījumu, tas ir jānodrošina, **un** Aniva katalogā tam ir jābūt noteiktai
cenai.

**Ierobežots biomarķieris** — biomarķieris, ko pārdod tikai pozīcijas ietvaros, un kopā nav pozīcijas,
kas to nosegtu. `error` ir `biomarker_requires_position`, `biomarker_id` norāda marķieri, un `positions[]`
uzskaita visas pozīcijas, kurās to pārdod, sākot ar lētāko. Pievieno visus vienas pozīcijas biomarķierus. Skati
[Cenas](https://docs.anivahealth.com/lv/concepts/pricing.md), lai iepazītos ar modeli, un `pricing.positions` sadaļā [Iegūt
biomarķieri](https://docs.anivahealth.com/lv/api/biomarkers/get-biomarker.md), lai redzētu pilnu pozīcijas sastāvdaļu kopu.

## Kļūdu atbildes

| Statuss | Apraksts |
| - | - |
| `400` | `biomarker_ids` ir tukšs vai nav vesels skaitlis, kopa neiztur noslēgtības validāciju (`validation.failures`), pievieno biomarķieri, kuram Aniva nav noteikusi cenu (`error: "biomarker_not_priced"`), satur ierobežotu biomarķieri, kuru nenosedz neviena pozīcija kopā (`error: "biomarker_requires_position"`), vai kapilārajā asins paņemšanā biomarķieri neietilpst mikrostobriņos. |
| `403` | Aizliegts — trūkst piekļuves tvēruma vai pieraksts ir ārpus piekļuves konteksta. |
| `404` | Pieraksts vai viens vai vairāki biomarķieri netika atrasti. |
| `409` | Konflikts — biomarķierus nevar mainīt pēc asins paņemšanas apstiprināšanas. |
| `500` | Iekšēja servera kļūda. |

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