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

# Lägg till enskilda biomarkörer

> Lägg till enskilda biomarkörer i en bokning

Lägg till en eller flera enskilda biomarkörer i en bokning som à la carte-tester, utanför en
färdig panel. Dirigeringsbeslut fattas nedströms av orderlogistikflödet baserat
på varje biomarkörs mappningar per labb.

Den resulterande uppsättningen valideras synkront mot varje labbs slutenhetsregler. Vissa biomarkörer
går bara att få genom att beställa dem tillsammans med andra – en LDL/HDL-kvot levereras till
exempel av en beställning som också returnerar LDL och HDL, så att bara begära kvoten ger ingen
sammanhängande beställning. (Det är samma komponenter som kvoten *prissätts* efter – se
uppdelningen i `pricing` under [Lista biomarkörer](https://docs.anivahealth.com/sv/api/biomarkers/list-biomarkers.md).) När uppsättningen inte kan
beställas som den är returnerar anropet `400` med en `validation`-payload och **inget sparas**, så att du
kan testa dig fram till en giltig uppsättning:

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

Samma loop gäller biomarkörer som Aniva bara säljer i en position: begär en sådan ensam så
returnerar anropet `400` med `error: "biomarker_requires_position"` och de positioner som säljer den. Se
[Prissättning](https://docs.anivahealth.com/sv/concepts/pricing.md).

[Lista biomarkörer](https://docs.anivahealth.com/sv/api/biomarkers/list-biomarkers.md) anger `price_cents: null` för vissa biomarkörer.
Dessa biomarkörer är **okurerade**: Aniva har inte prissatt dem. Om du lägger till en sådan returnerar anropet
`400` med `error: "biomarker_not_priced"`. Ingen annan biomarkör löser det här felet, eftersom `null`
innebär att du saknar ett pris att köpa markören för. Kitmarkörer är undantaget. Lägg till panelen
som utgör kitet, så följer dess ingående markörer med panelen. Anropet godkänner också en ingående markör som du lägger till i
en bokning som redan innehåller den panelen.

Vid en kapillär blodprovstagning (`draw_method: capillary`) packas provet i mikrotainers. Paneler kommer först, i
bokningsordning. Enskilda biomarkörer fyller sedan det lediga utrymmet i panelernas mikrotainers. När de
behöver mer plats öppnas nya mikrotainers. Vi fördelar dem jämnt. Varje mikrotainer rymmer högst
150 µl enskilda biomarkörer. En biomarkör som behöver mer än 150 µl i en egen mikrotainer får aldrig
plats, och det får inte heller en biomarkör utan en kurerad volym. Om den resulterande uppsättningen bryter mot den här regeln
returnerar anropet `400` med ett `error`-meddelande och inget sparas.

Det här anropet är idempotent: biomarkörer som redan finns i bokningen behålls.

Kräver scopen `appointments_schedule` och `schedule_appointments_with_individual_biomarker_selection`.

> [!WARNING]
>
> Biomarkörer kan inte läggas till efter att du har anropat [Bekräfta
> blodprovstagning](https://docs.anivahealth.com/sv/api/appointments/confirm-blood-draw.md). Försök att ändra en bekräftad bokning
> returnerar `409 Conflict`.

## Förfrågan

### Sökvägsparametrar

**id** `string` *required*

Unik identifierare (UUID) för bokningen.

### Body-parametrar

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

Array med biomarkör-ID:n att lägga till. Måste innehålla minst ett objekt. Använd [Lista
biomarkörer](https://docs.anivahealth.com/sv/api/biomarkers/list-biomarkers.md) för att hitta ID:n.

## Svar

Om anropet lyckas returnerar API:et `200 OK` som bekräftelse på att biomarkörerna har lagts till.

**success** `boolean`

`true` när biomarkörerna har lagts till i bokningen.

### Så tolkar du `400`

Varje `400` vid slutenhetsvalidering eller katalogfel innehåller en mening i `message`. En `400` vid
body-validering eller mikrotainerfel innehåller enbart `error`. Förgrena på `error`. Vid ett
slutenhetsvalideringsfel är `error` en mening. Vid ett katalogfel är `error` en maskinkod:
`biomarker_not_priced` eller `biomarker_requires_position`.

**Slutenhetsvalidering** – uppsättningen kan inte beställas som den är hos något labb:

* `validation.failures[]` – finns bara med vid slutenhetsvalideringsfel (saknas vid vanliga
  body-valideringsfel). En post per biomarkörgrupp som inget labb kan hantera, med de
  `biomarker_ids` som misslyckades och `fix_options[]`, med det minsta alternativet först. Varje alternativs
  `add_biomarkers` (`{ id, name }`) är en uppsättning där du lägger till ALLA – behåll dina ursprungliga, lägg till dessa och
  försök igen. En tom `fix_options` innebär att inget tillägg hjälper; ta bort biomarkören i stället.

**Oprissatt biomarkör** – Aniva har inte prissatt den här biomarkören. [Lista
biomarkörer](https://docs.anivahealth.com/sv/api/biomarkers/list-biomarkers.md) anger den som `price_cents: null`, eller utelämnar den när den
är en kvot med en oprissatt komponent. `error` är `biomarker_not_priced` och `biomarker_id` anger
markören. Ingen annan biomarkör löser det här felet, så ta bort biomarkören. Två villkor gör en
biomarkör beställningsbar: ett labb som Aniva kan dirigera till måste leverera den, **och** Anivas katalog måste ha ett pris för
den.

**Positionsbunden biomarkör** – en biomarkör som bara säljs i en position, utan någon täckande position i
uppsättningen. `error` är `biomarker_requires_position`, `biomarker_id` anger markören och `positions[]`
listar varje position som säljer den, billigast först. Lägg till alla biomarkörer i en av dem. Se
[Prissättning](https://docs.anivahealth.com/sv/concepts/pricing.md) för modellen och `pricing.positions` i [Hämta
biomarkör](https://docs.anivahealth.com/sv/api/biomarkers/get-biomarker.md) för en positions fullständiga uppsättning av markörer.

## Felsvar

| Status | Beskrivning |
| - | - |
| `400` | `biomarker_ids` är tom eller innehåller icke-heltal, uppsättningen klarar inte slutenhetsvalideringen (`validation.failures`), den lägger till en biomarkör som Aniva inte har prissatt (`error: "biomarker_not_priced"`), den innehåller en positionsbunden biomarkör som ingen position i uppsättningen täcker (`error: "biomarker_requires_position"`), eller vid en kapillär blodprovstagning får biomarkörerna inte plats i sina mikrotainers. |
| `403` | Åtkomst nekad – saknar scope eller så ligger bokningen utanför åtkomstkontexten. |
| `404` | Bokningen eller en eller flera biomarkörer hittades inte. |
| `409` | Konflikt – biomarkörer kan inte ändras efter att blodprovstagningen har bekräftats. |
| `500` | Internt serverfel. |

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