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

# Tilføj individuelle biomarkører

> Tilføj individuelle biomarkører til en tid

Tilføj en eller flere individuelle biomarkører til en tid som à la carte-tests uden for et
foruddefineret panel. Routingbeslutninger træffes nedstrøms af ordrelogistik-pipelinen baseret
på hver biomarkørs tilknytninger pr. laboratorium.

Det resulterende sæt valideres synkront mod hvert laboratoriums closure-regler. Nogle biomarkører
kan kun fås ved at bestille dem sammen med andre — en LDL/HDL-ratio leveres for eksempel
af en ordre, der også returnerer LDL og HDL, så en anmodning om ratioen alene ikke er en
sammenhængende ordre. (Det er de samme komponenter, ratioen *prissættes* ud fra — se `pricing`-
oversigten på [Vis biomarkører](https://docs.anivahealth.com/da/api/biomarkers/list-biomarkers.md).) Når sættet ikke kan bestilles
korrekt, returnerer kaldet `400` med en `validation`-payload, og **intet gemmes**, så du
kan prøve dig frem til et gyldigt sæt:

1. `PATCH … { "biomarker_ids": [45] }` (LDL/HDL-ratio alene) → `400`;
   `validation.failures[].fix_options[].add_biomarkers` viser LDL og HDL.
2. `PATCH … { "biomarker_ids": [45, 43, 42] }` (ratio + LDL + HDL) → `200`.

Det samme loop dækker biomarkører, som Aniva kun sælger som del af en position: Bed om en alene, og kaldet
returnerer `400` med `error: "biomarker_requires_position"` og de positioner, der sælger den. Se
[Prissætning](https://docs.anivahealth.com/da/concepts/pricing.md).

[Vis biomarkører](https://docs.anivahealth.com/da/api/biomarkers/list-biomarkers.md) angiver nogle biomarkører med `price_cents: null`.
Disse biomarkører er **ukuraterede**: Aniva har ikke prissat dem. Hvis du tilføjer en, returnerer kaldet
`400` med `error: "biomarker_not_priced"`. Ingen anden biomarkør løser denne fejl, fordi `null`
betyder, at du ikke har nogen pris at købe markøren til. Kitmarkører er undtagelsen. Tilknyt det panel,
der er kittet, så følger dets medlemmer med panelet. Kaldet accepterer også et medlem, som du tilføjer til
en tid, der allerede har det pågældende panel.

Ved en kapillær blodprøvetagning (`draw_method: capillary`) pakkes den i microtainere. Paneler kommer først i
bookingrækkefølge. Individuelle biomarkører fylder derefter den ledige plads i panelmicrotainerne. Når de
har brug for mere plads, åbner de nye microtainere. Vi fordeler dem jævnt. Hver microtainer rummer højst
150 µl individuelle biomarkører. En biomarkør, der kræver mere end 150 µl i sin egen microtainer, passer aldrig,
og det gør en biomarkør uden en kurateret volumen heller ikke. Hvis det resulterende sæt bryder denne regel,
returnerer kaldet `400` med en `error`-besked, og intet gemmes.

Dette kald er idempotent: Biomarkører, der allerede er på tiden, beholdes.

Kræver scopes `appointments_schedule` og `schedule_appointments_with_individual_biomarker_selection`.

> [!WARNING]
>
> Biomarkører kan ikke tilføjes, efter du har kaldt [Bekræft
> blodprøvetagning](https://docs.anivahealth.com/da/api/appointments/confirm-blood-draw.md). Forsøg på at ændre en bekræftet tid returnerer
> `409 Conflict`.

## Forespørgsel

### Stiparametre

**id** `string` *required*

Unikt id (UUID) for tiden.

### Body-parametre

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

Array af biomarkør-id'er, der skal tilknyttes. Skal indeholde mindst ét element. Brug [Vis
biomarkører](https://docs.anivahealth.com/da/api/biomarkers/list-biomarkers.md) til at finde id'er.

## Svar

Ved succes returnerer API'et `200 OK` som bekræftelse på, at biomarkørerne er tilknyttet.

**success** `boolean`

`true`, når biomarkørerne er tilføjet til tiden.

### Sådan læser du en `400`

Hver `400` fra closure-validering og katalog indeholder en sætning i `message`. En `400` fra body-validering eller
microtainer indeholder kun `error`. Skeln ud fra `error`. Ved en
closure-valideringsfejl er `error` en sætning. Ved en katalogfejl er `error` en maskinkode:
`biomarker_not_priced` eller `biomarker_requires_position`.

**Closure-validering** — sættet kan ikke bestilles korrekt hos noget laboratorium:

* `validation.failures[]` — findes kun ved closure-valideringsfejl (ikke ved almindelige
  body-valideringsfejl). Ét element pr. biomarkørgruppe, som intet laboratorium kan levere, med de
  `biomarker_ids`, der fejlede, og `fix_options[]` med den mindste løsning først. Hver løsnings
  `add_biomarkers` (`{ id, name }`) er et sæt, hvor du skal tilføje ALLE — behold dine oprindelige, tilføj disse, og
  prøv igen. En tom `fix_options` betyder, at det ikke hjælper at tilføje noget; fjern biomarkøren i stedet.

**Ikke-prissat biomarkør** — Aniva har ikke prissat denne biomarkør. [Vis
biomarkører](https://docs.anivahealth.com/da/api/biomarkers/list-biomarkers.md) angiver den som `price_cents: null` eller udelader den, når det
er en ratio med en ikke-prissat komponent. `error` er `biomarker_not_priced`, og `biomarker_id` angiver
markøren. Ingen anden biomarkør løser denne fejl, så fjern biomarkøren. To betingelser gør en
biomarkør mulig at bestille: Et laboratorium, som Aniva kan route til, skal levere den, **og** Aniva-kataloget skal prissætte
den.

**Begrænset biomarkør** — en biomarkør, der kun sælges som del af en position, uden nogen dækkende position i
sættet. `error` er `biomarker_requires_position`, `biomarker_id` angiver markøren, og `positions[]`
viser alle positioner, der sælger den, billigste først. Tilføj alle biomarkører fra en af dem. Se
[Prissætning](https://docs.anivahealth.com/da/concepts/pricing.md) for modellen og `pricing.positions` på [Hent
biomarkør](https://docs.anivahealth.com/da/api/biomarkers/get-biomarker.md) for en positions fulde medlemssæt.

## Fejlsvar

| Status | Beskrivelse |
| - | - |
| `400` | `biomarker_ids` er tom eller indeholder ikke-heltal, sættet fejler closure-validering (`validation.failures`), det tilføjer en biomarkør, Aniva ikke har prissat (`error: "biomarker_not_priced"`), det indeholder en begrænset biomarkør, som ingen position i sættet dækker (`error: "biomarker_requires_position"`), eller ved en kapillær blodprøvetagning kan biomarkørerne ikke være i deres microtainere. |
| `403` | Forbudt — manglende scope eller tid uden for adgangskonteksten. |
| `404` | Tiden eller en eller flere biomarkører blev ikke fundet. |
| `409` | Konflikt — biomarkører kan ikke ændres, efter blodprøvetagningen er bekræftet. |
| `500` | Intern serverfejl. |

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