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

# Prijs voor winkelwagen berekenen

> Prijzen voor panels en biomarkers berekenen zonder afspraak

Geeft de rekening voor panels en biomarkers volgens je tariefkaart terug. Je hebt geen afspraak
nodig. Er wordt niets geboekt.

De rekening is gelijk aan `pricing` in [Afspraak vooraf bekijken](https://docs.anivahealth.com/nl/api/appointments/preview-containers.md),
plus wat de manier van afname toevoegt. Standaard is dat een bloedafname op een locatie, met de
afspraakkosten. Stuur `fulfilment: "home_kit"` en een `country_code` mee om in plaats daarvan de
prijs te berekenen voor één kit die naar dat land wordt verzonden: de kitkosten, de
afnamehulpmiddelen, verzendkosten heen en terug, de hoes en een zakje met reservelancetten, zoals
ze op je maandelijkse factuur staan.
Op [Prijzen](https://docs.anivahealth.com/nl/concepts/pricing.md) staat hoe Aniva de prijzen van de tests bepaalt.

Vereist de scope `prices_view`.

## Verzoek

### Bodyparameters

Stuur minstens één id mee in `panel_ids` of `biomarker_ids`.

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

Panels om de prijs van te berekenen, maximaal 50. Elk panel moet in [Panels weergeven](https://docs.anivahealth.com/nl/api/panels/list-panels.md) staan voor je sleutel.

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

Biomarkers om de prijs van te berekenen, maximaal 500.

**sex** `integer`

Biologisch geslacht volgens ISO/IEC 5218: `1` = man, `2` = vrouw. Sommige panels voegen biomarkers
alleen toe voor één geslacht of leeftijd. Stuur `sex` en `date_of_birth` samen mee om deze regels
toe te passen. Zonder deze velden gelden de regels niet.

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

Geboortedatum, `YYYY-MM-DD`. Stuur deze samen met `sex` mee.

**rate\_card** `string`

De tariefkaart voor de prijsberekening: `retail`, of het `id` uit [Tariefkaart ophalen](https://docs.anivahealth.com/nl/api/pricing/get-rate-card.md).
Standaard: de tariefkaart van je API-sleutel, anders retail.

**fulfilment** `string`

Hoe het monster wordt afgenomen. `draw` (standaard): een bloedafname op een locatie, wat de
afspraakkosten toevoegt. `home_kit`: één kit verzonden naar `country_code`, wat in plaats daarvan
de kitregels toevoegt. Een thuistestkit bevat precies één panel, en het panel moet als
thuistestkit worden verkocht.

**country\_code** `string`

Het bezorgland van de kit, ISO 3166-1 alpha-2 (`DE`, `SE`). Verplicht bij
`fulfilment: "home_kit"`, en alleen dan. Dit bepaalt de verzendregels.

## Respons

**total\_cents** `integer`

De prijs van de tests volgens je tariefkaart: elke geprijsde positie, elk panel en elke
biomarkerrij. Een rij met `price_cents: null` telt niet mee.

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

Dezelfde prijs volgens de aanbevolen retailtariefkaart.

**fees** `object`

De kosten van één afspraak, in centen. Aniva zet ze op je maandelijkse factuur. Ze gelden voor
een `draw`; bij een `home_kit` worden in plaats daarvan de regels in `fulfilment` gefactureerd.

**kosten**

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

Per voltooide afspraak.

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

Per afspraak waarbij de patiënt een snack krijgt. Ontbreekt als je patiënten geen snack
krijgen. Neem contact op met Aniva om snacks aan te bieden.

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

Per koeriersophaling. Je afspraken op dezelfde locatie op dezelfde dag delen één ophaling.

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

Per voltooide afspraak. Dekt buisjes, labels en het zakje.

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

`total_cents` plus wat de afhandeling toevoegt. Voor een `draw`: alle kosten in `fees`. Hierbij
worden de volledige logistieke kosten meegerekend, en een gedeelde ophaling maakt het echte bedrag
lager. Voor een `home_kit`: `fulfilment.total_cents`.

**fulfilment** `object`

Hoe het monster wordt afgenomen en wat dat toevoegt. `kind` is `draw` of `home_kit`. Een `draw`
heeft geen ander veld.

**home\_kit**

**country\_code** `string`

Het bezorgland waarvoor de verzendkosten zijn berekend.

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

De kit waarin het panel wordt verzonden. `null` als Aniva er nog geen heeft samengesteld; de
prijsopgave rekent dan geen hulpmiddel mee.

**devices** `integer`

Afnamehulpmiddelen in de doos, elk gefactureerd tegen het tarief per hulpmiddel.

**lines** `object[]`

De kitregels die één bestelling toevoegt aan je maandelijkse factuur, elk met `description`,
`quantity`, `unit`, `unit_cents` en `amount_cents`. Verzendkosten worden berekend volgens de
diensten die de verzendstap voor dit land boekt. Een tarief van 0 op je kaart levert geen
regel op. Vooruitbetaald materiaaltegoed wordt hier niet afgetrokken.

**total\_cents** `integer`

De som van `lines`, netto.

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

Wordt extra gefactureerd, netto, als je de kit niet activeert voordat deze het lab bereikt en
het lab deze activeert. Dit zit niet in `lines` of `total_cents`. 0 betekent dat je kaart deze
kosten niet heeft.

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

Trajecten (`out`, `back`) die je kaart per land prijst, maar waarvoor dit land geen prijs
heeft. Deze zijn teruggevallen op het vaste verzendtarief, of op 0 als de kaart dat niet
heeft. Leeg als voor elk traject een prijs is gevonden.

**positions** `object[]`

De posities op de rekening. Een positie is een set biomarkers met één prijs. Deze heeft `id`,
`name`, `price_cents`, `retail_cents` en `tier`. `id` en `name` zijn `null` voor een positie die
Aniva nog niet heeft gepubliceerd.

**panels** `object[]`

De panels op de rekening, met `id`, `name`, `price_cents` en `retail_cents`.

**biomarkers** `object[]`

Eén rij per biomarker die je ontvangt. Dit omvat de onderdelen van een ratio en elk onderdeel van
een positie.

**biomarkerrij**

**id** `number`

Biomarker-id.

**name** `string`

Biomarkernaam.

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

De prijs van deze rij, met `retail_cents` ernaast. `0` wanneer een positie of een panel ervoor
betaalt.

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

De ratio's die deze biomarker nodig hebben. Je betaalt er één keer voor.

**requires** `number[]`

Alleen bij een ratio: de biomarkers waaruit deze wordt berekend.

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

De positie die voor deze rij betaalt. `null` als de positie nog niet is gepubliceerd.

## Foutresponsen

| Status | Beschrijving |
| - | - |
| `400` | De body is ongeldig, of je sleutel mag de `rate_card` niet gebruiken. |
| `400` | Een prijsopgave voor `home_kit` vereist precies één panel, een panel dat als thuistestkit wordt verkocht en een landcode. |
| `400` | `biomarker_not_available`: geen enkel lab dat je sleutel mag gebruiken voert deze biomarker uit. |
| `400` | `biomarker_not_priced`: de biomarker heeft geen prijs. |
| `400` | `biomarker_requires_position`: de biomarker wordt alleen in een positie verkocht. De body bevat de posities. |
| `403` | Je API-sleutel heeft de scope `prices_view` niet. |
| `404` | `Panels not found`: het panel bestaat niet, of je sleutel kan het niet weergeven. |
| `404` | `Biomarkers not found`: de biomarker bestaat niet. |
| `500` | Interne serverfout. |

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