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

# Prijzen

> Hoe de Aniva API voor labtests biomarkers, posities en panels prijst op je tariefkaart, met prijsopgaven voordat je boekt.

Aniva prijst één ding: de **positie**. Een positie is een commercieel aanbod — een samengestelde set biomarkers die één keer wordt gefactureerd tegen een vaste prijs en altijd als geheel wordt geleverd. Een biomarker die je los kunt kopen is simpelweg een positie van één.

Alles wat je in `pricing` ziet volgt daaruit. Lees deze pagina één keer en de vier statussen hieronder lijken niet langer op uitzonderingen.

## Wat de getallen betekenen

Elke `price_cents` is wat **jij** betaalt, volgens de tariefkaart van je API-sleutel. Daarnaast is `retail_cents` hetzelfde item volgens de aanbevolen verkoopprijskaart, zodat je een besparing kunt tonen zonder een tweede verzoek. Beide zijn hele centen en beide zijn **netto**: btw wordt op je maandfactuur toegevoegd tegen het tarief dat bij jouw btw-regeling hoort, en bij een vrijstelling wordt er niets toegevoegd. Een panel dat tegen de consumentencatalogusprijs van Aniva wordt verkocht, wordt opgegeven tegen die prijs zonder de 19 % Duitse btw.

> [!NOTE]
>
> `retail_cents` is altijd aanwezig. Wanneer je sleutel al op de verkoopprijskaart staat, is die gewoon gelijk aan
> `price_cents`.

Voor prijzen heb je de scope `prices_view` nodig. Zonder deze scope is `pricing` gelijk aan `null` in de overzichten en de preview, en geven de Pricing-endpoints `403` terug.

## Je tariefkaart

Je tariefkaart bepaalt je prijzen. Lees deze uit via [Get Rate Card](https://docs.anivahealth.com/nl/api/pricing/get-rate-card.md).

* Elke analyse heeft een `tier`: `routine` of `specialty`. De prijs ervan is de Aniva-catalogusprijs keer de vermenigvuldigingsfactor van die tier.
* De kosten gelden per afspraak en de logistieke kosten per ophaling door de koerier. Je afspraken op dezelfde locatie op dezelfde dag delen één ophaling. Aniva factureert de kosten op je maandfactuur.

## De vier statussen

`price_cents`, plus welk optioneel blok ernaast staat, vormt de status. Er is geen apart typeveld.

| `price_cents` | Ook aanwezig | Wat het betekent |
| - | - | - |
| positief | `positions?` | Los te bestellen voor die prijs. Een ratio bevat ook `requires` en brengt ook de onderdelen in rekening. |
| `0` | `requires` | Een **ratio**. Kost zelf niets; je betaalt voor de onderdelen. |
| `0` | `positions` | **Positiegebonden**. Alleen te koop binnen een van de vermelde posities. |
| `null` | — | **Niet opgenomen**. Aniva heeft er geen prijs voor vastgesteld en het kan niet worden besteld. |

### Positief — los te bestellen

De marker heeft een eigen prijs. Hij kan nog steeds in posities voorkomen, en `positions` somt ze dan op met de goedkoopste eerst — de positie kopen is vaak goedkoper dan de onderdelen één voor één kopen.

```json theme={null}
{
  "id": 71,
  "name": "Hemoglobin",
  "pricing": {
    "price_cents": 350,
    "retail_cents": 403,
    "tier": "routine",
    "positions": [
      {
        "id": "b7d4c2e1-9a3f-4c8b-91d2-5e6f7a8b9c0d",
        "name": "Aniva Blood Count",
        "price_cents": 452,
        "retail_cents": 520,
        "biomarker_ids": [71, 72, 73],
        "includes": [72, 73]
      }
    ]
  }
}
```

`biomarker_ids` is de volledige set onderdelen van de positie; `includes` is die set min de marker die je opvroeg — wat er verder bij zit.

### Nul met `requires` — een ratio

Een ratio wordt berekend uit gemeten markers. De meeste ratio's kosten `0`. Bij een ratio met een positieve `price_cents` wordt die prijs boven op de onderdelen in rekening gebracht. Bestel je hem, dan zet Aniva de onderdelen voor hun eigen prijs in de winkelwagen. Een onderdeel betaal je **één keer per winkelwagen**, ongeacht hoeveel ratio's ervan gebruikmaken.

```json theme={null}
{
  "id": 279,
  "name": "hs-CRP / HDL Ratio",
  "pricing": {
    "price_cents": 0,
    "retail_cents": 0,
    "requires": [
      { "id": 42, "name": "HDL Cholesterol", "price_cents": 233, "retail_cents": 268 },
      { "id": 84, "name": "High-Sensitivity C-Reactive Protein (hs-CRP)", "price_cents": 1166, "retail_cents": 1341 }
    ]
  }
}
```

Een ratio werkt samen met posities in plaats van ermee te concurreren. Als de onderdelen ervan deel uitmaken van een positie die je al koopt, dekt de positie ze en is de ratio zonder extra kosten inbegrepen.

> [!WARNING]
>
> Een ratio waarvan niet alle onderdelen een prijs hebben, **ontbreekt in de catalogus** — hij verschijnt niet
> met `price_cents: null`. Hij komt terug zodra Aniva een prijs vaststelt voor het ontbrekende onderdeel.

### Nul met `positions` — alleen te koop binnen een positie

De marker heeft geen eigen prijs, maar is onderdeel van een of meer posities. Koop een van die posities en je krijgt hem erbij.

```json theme={null}
{
  "id": 77,
  "name": "Mean Platelet Volume (MPV)",
  "pricing": {
    "price_cents": 0,
    "retail_cents": 0,
    "positions": [
      {
        "id": "3f1a8c22-64bd-4e57-8a90-1c2d3e4f5a6b",
        "name": "Blood Count (extended)",
        "price_cents": 460,
        "retail_cents": 529,
        "biomarker_ids": [71, 72, 73, 77],
        "includes": [71, 72, 73]
      }
    ]
  }
}
```

Een van deze markers los toevoegen aan een afspraak wordt geweigerd — zie [Individuele biomarkers toevoegen](https://docs.anivahealth.com/nl/api/appointments/add-individual-biomarkers.md). Voeg in plaats daarvan alle biomarkers van een van de vermelde posities toe.

### Null — niet gecureerd

Aniva heeft nog niet bepaald wat deze marker kost, dus hij is niet te koop. `null` betekent niet nul en niet "vraag het ons": beschouw hem als niet beschikbaar.

```json theme={null}
{ "id": 555, "name": "Poppy Seeds (Pap s)", "pricing": { "price_cents": null, "retail_cents": null } }
```

> [!WARNING]
>
> Aniva weigert een `null`-marker bij het bestellen. Een biomarker is bestelbaar onder twee
> voorwaarden. Een laboratorium waar Aniva naartoe kan routeren moet de biomarker leveren. De
> catalogus van Aniva moet er een prijs voor hebben. Als je een `null`-marker aan een afspraak
> toevoegt, geeft de API `400` terug met `error: "biomarker_not_priced"`. Zie
> [Individuele biomarkers toevoegen](https://docs.anivahealth.com/nl/api/appointments/add-individual-biomarkers.md). Een laboratorium
> kan een `null`-marker leveren, maar levering alleen maakt de marker nog niet beschikbaar.
> Beschouw `null` als niet beschikbaar.

Sommige markers zijn bewust `null`. Aniva verkoopt microbioom- en genetische tests als kits. Een
kit heeft één prijs, dus de bijbehorende markers hebben geen eigen prijs. Om deze markers te kopen,
bestel je het panel dat de kit vormt. De markers zijn bij het panel inbegrepen. De API accepteert
ook een bijbehorende marker die je toevoegt aan een afspraak die dat panel al bevat.

Een marker geeft ook `null` aan wanneer Aniva deze alleen verkoopt binnen een positie die je niet
kunt zien. Het resultaat is hetzelfde: je hebt geen prijs om de marker voor te kopen. De marker
krijgt een prijs zodra Aniva die positie zichtbaar maakt voor partners.

## De goedkoopste manier vinden om een set te kopen

Omdat elke positie waar een marker bij hoort met de marker meekomt, kun je dit lokaal oplossen, zonder extra verzoeken:

1. Verzamel de gewenste markers via [Biomarkers opvragen](https://docs.anivahealth.com/nl/api/biomarkers/list-biomarkers.md).
2. Vergelijk voor elke marker de eigen `price_cents` met de `price_cents` van de posities in het `positions`-blok.
3. Een positie wordt **één keer** in rekening gebracht en levert de volledige `biomarker_ids`-set, dus een positie die meerdere van jouw markers dekt wordt maar eenmaal gefactureerd. Extra markers waar je niet om hebt gevraagd zijn zonder extra kosten inbegrepen.

Niets overlapt dubbel: twee posities die een marker delen leveren elk hun eigen set, de marker wordt één keer vermeld en ze geven nooit korting op elkaar.

## De rekening

[Voorbeeld van afspraak](https://docs.anivahealth.com/nl/api/appointments/preview-containers.md) geeft de rekening van een afspraak terug. [Prijsopgave winkelwagen](https://docs.anivahealth.com/nl/api/pricing/quote-cart.md) geeft dezelfde rekening terug zonder afspraak. De rekening bevat:

* `positions[]` — elke toegepaste positie, één keer in rekening gebracht tegen de vaste prijs.
* `panels[]` — elk gekoppeld panel.
* `biomarkers[]` — één rij per **geleverde** marker. Een rij die door een positie wordt gedekt kost `0` en vermeldt die positie in `via_position`. Een onderdeel dat door een ratio wordt meegenomen bevat `required_by`; de ratio zelf bevat `requires`.
* `total_cents` — de geprijsde posities plus de geprijsde panels plus de geprijsde biomarker-rijen, met `retail_total_cents` ernaast.
* `fees` en `total_with_fees_cents` — de kosten van één afspraak, en het totaal inclusief die kosten.

Een rij waar Aniva geen prijs voor kan bepalen bevat `price_cents: null`. De rij telt niet mee voor het totaal. Je kunt een niet-geprijsde marker niet los toevoegen, dus deze rij komt uit een positie of een panel. Die positie of dat panel brengt de kosten al in rekening.

> [!NOTE]
>
> Aniva heeft nog niet elke positie gepubliceerd. Een niet-gepubliceerde positie wordt wel in
> rekening gebracht. Deze verschijnt in `positions[]` met `id` en `name` op `null`, en de
> bijbehorende biomarker-rijen hebben `via_position: null`.


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