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

# Warenkorb-Preis berechnen

> Preise für Panels und Biomarker ohne Termin berechnen

Gibt die Abrechnung für Panels und Biomarker nach deiner Preisliste zurück. Du brauchst keinen
Termin. Es wird nichts gebucht.

Die Abrechnung entspricht `pricing` in [Terminvorschau](https://docs.anivahealth.com/de/api/appointments/preview-containers.md),
zuzüglich der Kosten für die Art der Probenahme. Standardmäßig ist das eine Blutabnahme an einem
Standort mit den Termingebühren. Sende `fulfilment: "home_kit"` und einen `country_code`, um
stattdessen ein in dieses Land verschicktes Kit zu berechnen: die Kit-Gebühr, die Probenahmegeräte,
Porto für Hin- und Rückversand, die Hülle und einen Ersatz-Lanzettenbeutel, so wie deine
Monatsrechnung sie abrechnet.
[Preise](https://docs.anivahealth.com/de/concepts/pricing.md) erklärt, wie Aniva die Tests berechnet.

Erfordert den Scope `prices_view`.

## Anfrage

### Body-Parameter

Sende mindestens eine ID in `panel_ids` oder `biomarker_ids`.

**panel\_ids** `string[]`

Zu berechnende Panels, höchstens 50. Jedes muss unter [Panels auflisten](https://docs.anivahealth.com/de/api/panels/list-panels.md)
für deinen Schlüssel verfügbar sein.

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

Zu berechnende Biomarker, höchstens 500.

**sex** `integer`

Biologisches Geschlecht nach ISO/IEC 5218: `1` = männlich, `2` = weiblich. Manche Panels fügen
Biomarker nur für ein bestimmtes Geschlecht oder Alter hinzu. Sende `sex` und `date_of_birth`
zusammen, um diese Regeln anzuwenden. Ohne sie gelten die Regeln nicht.

**date\_of\_birth** `string`

Geburtsdatum, `YYYY-MM-DD`. Sende es zusammen mit `sex`.

**rate\_card** `string`

Die Preisliste für die Berechnung: `retail` oder die `id` aus [Preisliste
abrufen](https://docs.anivahealth.com/de/api/pricing/get-rate-card.md). Standard: die Preisliste deines API-Schlüssels, sonst
Listenpreis.

**fulfilment** `string`

Wie die Probe genommen wird. `draw` (Standard): eine Blutabnahme an einem Standort, die die
Termingebühren hinzufügt. `home_kit`: ein Kit, das an `country_code` verschickt wird und
stattdessen die Kit-Posten hinzufügt. Ein Heimtest-Kit enthält genau ein Panel, und das Panel muss
als Heimtest-Kit verkauft werden.

**country\_code** `string`

Das Lieferland des Kits, ISO 3166-1 alpha-2 (`DE`, `SE`). Erforderlich bei
`fulfilment: "home_kit"` und nur dann. Es bestimmt die Portoposten.

## Antwort

**total\_cents** `integer`

Der Preis der Tests nach deiner Preisliste: jede bepreiste Position, jedes Panel und jede
Biomarker-Zeile. Eine Zeile mit `price_cents: null` fügt nichts hinzu.

**retail\_total\_cents** `integer`

Derselbe Preis nach der empfohlenen Listenpreisliste.

**fees** `object`

Die Gebühren eines Termins in Cent. Aniva rechnet sie auf deiner Monatsrechnung ab. Sie gelten für
`draw`; bei `home_kit` werden stattdessen die Posten in `fulfilment` berechnet.

**Gebühren**

**phlebotomy\_fee\_cents** `integer`

Pro abgeschlossenem Termin.

**snack\_fee\_cents** `integer`

Pro Termin, bei dem der Patient einen Snack bekommt. Fehlt, wenn deine Patienten keinen Snack
bekommen. Um Snacks anzubieten, kontaktiere Aniva.

**logistics\_fee\_cents** `integer`

Pro Kurierabholung. Deine Termine am selben Standort am selben Tag teilen sich eine Abholung.

**material\_fee\_cents** `integer`

Pro abgeschlossenem Termin. Deckt Röhrchen, Etiketten und den Beutel ab.

**total\_with\_fees\_cents** `integer`

`total_cents` plus die Kosten der Abwicklung. Bei `draw`: jede Gebühr in `fees`. Die
Logistikgebühr wird voll gezählt; eine geteilte Abholung senkt den tatsächlichen Betrag. Bei
`home_kit`: `fulfilment.total_cents`.

**fulfilment** `object`

Wie die Probe genommen wird und was dazukommt. `kind` ist `draw` oder `home_kit`. Bei `draw` gibt
es kein weiteres Feld.

**home\_kit**

**country\_code** `string`

Das Lieferland, für das das Porto berechnet wurde.

**kit\_ref** `string | null`

Das Kit, als das das Panel verschickt wird. `null`, wenn Aniva noch keines zusammengestellt
hat; das Angebot zählt dann kein Gerät.

**devices** `integer`

Probenahmegeräte in der Box, jeweils zur Gerätegebühr berechnet.

**lines** `object[]`

Die Kit-Posten, die eine Bestellung deiner Monatsrechnung hinzufügt, jeweils mit
`description`, `quantity`, `unit`, `unit_cents` und `amount_cents`. Das Porto richtet sich
nach den Versandarten, die im Versandschritt für dieses Land gebucht werden. Eine Gebühr von 0
auf deiner Preisliste erzeugt keinen Posten. Ein im Voraus bezahltes Materialguthaben wird
hier nicht abgezogen.

**total\_cents** `integer`

Die Summe aus `lines`, netto.

**activation\_fee\_cents** `integer`

Wird netto zusätzlich berechnet, wenn du das Kit nicht vor Eintreffen im Labor aktivierst und
das Labor es aktiviert. Ist nicht in `lines` oder `total_cents` enthalten. 0 bedeutet, dass
deine Preisliste keine solche Gebühr hat.

**unpriced\_postage\_legs** `string[]`

Versandwege (`out`, `back`), die deine Preisliste pro Land berechnet, für die aber in diesem
Land kein Preis hinterlegt ist. Sie sind auf die pauschale Portogebühr zurückgefallen oder auf
0, wenn deine Preisliste keine hat. Leer, wenn für jeden Versandweg ein Preis gefunden wurde.

**positions** `object[]`

Die Positionen in der Abrechnung. Eine Position ist eine Gruppe von Biomarkern mit einem Preis.
Sie hat `id`, `name`, `price_cents`, `retail_cents` und `tier`. `id` und `name` sind `null` bei
einer Position, die Aniva noch nicht veröffentlicht hat.

**panels** `object[]`

Die Panels in der Abrechnung, mit `id`, `name`, `price_cents` und `retail_cents`.

**biomarkers** `object[]`

Eine Zeile pro Biomarker, den du erhältst. Dazu gehören die Bestandteile eines Verhältnisses und
jedes Element einer Position.

**Biomarker-Zeile**

**id** `number`

Biomarker-ID.

**name** `string`

Biomarker-Name.

**price\_cents** `integer | null`

Der Preis dieser Zeile, mit `retail_cents` daneben. `0`, wenn eine Position oder ein Panel sie
abdeckt.

**required\_by** `number[]`

Die Verhältnisse, die diesen Biomarker benötigen. Du bezahlst ihn einmal.

**requires** `number[]`

Nur bei einem Verhältnis: die Biomarker, aus denen es berechnet wird.

**via\_position** `string | null`

Die Position, die diese Zeile abdeckt. `null`, wenn die Position noch nicht veröffentlicht
ist.

## Fehlerantworten

| Status | Beschreibung |
| - | - |
| `400` | Der Body ist ungültig oder dein Schlüssel darf die `rate_card` nicht nutzen. |
| `400` | Ein `home_kit`-Angebot erfordert genau ein Panel, das als Heimtest-Kit verkauft wird, und einen Ländercode. |
| `400` | `biomarker_not_available`: Kein Labor, das dein Schlüssel nutzen darf, führt den Biomarker durch. |
| `400` | `biomarker_not_priced`: Der Biomarker hat keinen Preis. |
| `400` | `biomarker_requires_position`: Der Biomarker wird nur in einer Position verkauft. Der Body listet die Positionen auf. |
| `403` | Dein API-Schlüssel hat den Scope `prices_view` nicht. |
| `404` | `Panels not found`: Das Panel existiert nicht oder dein Schlüssel kann es nicht auflisten. |
| `404` | `Biomarkers not found`: Der Biomarker existiert nicht. |
| `500` | Interner Serverfehler. |

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/pricing/quote \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "biomarker_ids": [63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 204, 206, 207, 209, 249]
  }'
```

```bash cURL (home kit) theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/pricing/quote \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "panel_ids": ["4d0423c5-6538-48f6-ac93-435f61e456e9"],
    "fulfilment": "home_kit",
    "country_code": "DE"
  }'
```

```json 200 theme={null}
{
  "total_cents": 210,
  "retail_total_cents": 451,
  "fees": {
    "phlebotomy_fee_cents": 2500,
    "logistics_fee_cents": 2000,
    "material_fee_cents": 250
  },
  "total_with_fees_cents": 4960,
  "fulfilment": { "kind": "draw" },
  "positions": [
    { "id": null, "name": null, "price_cents": 210, "retail_cents": 451, "tier": "routine" }
  ],
  "panels": [],
  "biomarkers": [
    { "id": 63, "name": "Eosinophils", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 64, "name": "Lymphocytes", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 65, "name": "Neutrophils", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 66, "name": "Monocytes", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 67, "name": "White Blood Cells (WBC)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 68, "name": "Basophils", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 69, "name": "Hematocrit", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 70, "name": "Red Blood Cells (RBC)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 71, "name": "Hemoglobin", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 72, "name": "Platelets", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 73, "name": "Mean Corpuscular Hemoglobin Concentration (MCHC)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 74, "name": "Mean Corpuscular Volume (MCV)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 75, "name": "Red Cell Distribution Width (RDW)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 76, "name": "Mean Corpuscular Hemoglobin (MCH)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 204, "name": "Lymphocytes (%)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 206, "name": "Eosinophils (%)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 207, "name": "Basophils (%)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 209, "name": "Monocytes (%)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 249, "name": "Neutrophils (%)", "price_cents": 0, "retail_cents": 0, "via_position": null }
  ]
}
```

```json 200 (home kit) theme={null}
{
  "total_cents": 2081,
  "retail_total_cents": 6702,
  "fees": {
    "phlebotomy_fee_cents": 2000,
    "logistics_fee_cents": 2000,
    "material_fee_cents": 0
  },
  "total_with_fees_cents": 4971,
  "fulfilment": {
    "kind": "home_kit",
    "country_code": "DE",
    "kit_ref": "TAS-1-1S1E",
    "devices": 1,
    "lines": [
      { "description": "Home kit (per order)", "quantity": 1, "unit": "kits", "unit_cents": 720, "amount_cents": 720 },
      { "description": "Collection device (per device)", "quantity": 1, "unit": "devices", "unit_cents": 1250, "amount_cents": 1250 },
      { "description": "Postage to the customer (per kit sent)", "quantity": 1, "unit": "kits sent", "unit_cents": 370, "amount_cents": 370 },
      { "description": "Return postage (per kit sent)", "quantity": 1, "unit": "kits sent", "unit_cents": 400, "amount_cents": 400 },
      { "description": "Spare lancet bag (per kit sent with one)", "quantity": 1, "unit": "bags", "unit_cents": 150, "amount_cents": 150 }
    ],
    "total_cents": 2890,
    "activation_fee_cents": 100,
    "unpriced_postage_legs": []
  },
  "positions": [],
  "panels": [
    { "id": "4d0423c5-6538-48f6-ac93-435f61e456e9", "name": "Doctrinus - Gesundheitsprofil 6 (Männer)", "price_cents": 2081, "retail_cents": 6702 }
  ],
  "biomarkers": []
}
```

```json 404 theme={null}
{
  "error": "Panels not found: f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.