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

# Prissetting

> Slik priser Anivas API for labtester biomarkører, posisjoner og paneler på prislisten din, med pristilbud før du bestiller.

Aniva priser én ting: **posisjonen**. En posisjon er et kommersielt tilbud – et kuratert sett med biomarkører som faktureres én gang, til en fast pris, og alltid leveres samlet. En biomarkør du kan kjøpe alene, er rett og slett en posisjon på én.

Alt du ser i `pricing` følger av dette. Les denne siden én gang, så slutter de fire tilstandene nedenfor å se ut som spesialtilfeller.

## Hva tallene betyr

Hver `price_cents` er det **du** betaler, etter prislisten på API-nøkkelen din. Ved siden av er `retail_cents` den samme varen etter veiledende utsalgsprisliste, slik at du kan vise en besparelse uten en ekstra forespørsel. Begge er heltall i cent, og begge er **netto**: MVA legges til på månedsfakturaen din med satsen som gjelder for din MVA-behandling, og ved fritak legges ingenting til. Et panel som selges til Anivas katalogpris for forbrukere, oppgis til den prisen fratrukket 19 % tysk MVA.

> [!NOTE]
>
> `retail_cents` er alltid med. Når nøkkelen din allerede bruker utsalgsprislisten, er den rett og
> slett lik `price_cents`.

Priser krever scopet `prices_view`. Uten det er `pricing` `null` i listene og forhåndsvisningen, og Pricing-endepunktene returnerer `403`.

## Prislisten din

Prislisten din bestemmer prisene dine. Les den fra [Get Rate Card](https://docs.anivahealth.com/no/api/pricing/get-rate-card.md).

* Hver analyse har en `tier`: `routine` eller `specialty`. Prisen er Anivas katalogpris ganget med multiplikatoren for det nivået.
* Gebyrene gjelder per time, og logistikkgebyret gjelder per budhenting. Timene dine på samme sted samme dag deler én henting. Aniva fakturerer gebyrene på månedsfakturaen din.

## De fire tilstandene

`price_cents`, sammen med hvilken valgfri blokk som står ved siden av, utgjør tilstanden. Det finnes ikke noe eget typefelt.

| `price_cents` | Også med | Hva det betyr |
| - | - | - |
| positiv | `positions?` | Kan bestilles alene til den prisen. En ratio har også `requires` og fakturerer komponentene sine i tillegg. |
| `0` | `requires` | En **ratio**. Den koster ingenting i seg selv; du betaler for komponentene. |
| `0` | `positions` | **Posisjonsbegrenset**. Selges bare i en av de oppførte posisjonene. |
| `null` | — | **Ikke-kuratert**. Aniva har ikke priset den, og den kan ikke bestilles. |

### Positiv – kan bestilles alene

Markøren har en egen pris. Den kan fortsatt inngå i posisjoner, og `positions` lister dem da opp med den billigste først – å kjøpe posisjonen er ofte billigere enn å kjøpe delene én etter én.

```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` er hele settet av biomarkører i posisjonen; `includes` er det settet minus markøren du spurte om – det som følger med.

### Null med `requires` – en ratio

En ratio beregnes ut fra målte markører. De fleste ratioer koster `0`. En ratio med positiv `price_cents` fakturerer den prisen i tillegg til komponentene. Bestiller du den, legger Aniva komponentene i handlekurven til sine egne priser. En komponent betales **én gang per handlekurv**, uansett hvor mange ratioer som bruker den.

```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 }
    ]
  }
}
```

En ratio spiller sammen med posisjoner i stedet for å konkurrere med dem. Hvis komponentene inngår i en posisjon du allerede kjøper, dekker posisjonen dem og ratioen følger med uten ekstra kostnad.

> [!WARNING]
>
> En ratio der ikke alle komponentene er priset, er **fraværende fra katalogen** – den vises ikke
> med `price_cents: null`. Den kommer tilbake så snart Aniva priser den manglende komponenten.

### Null med `positions` – selges bare i en posisjon

Markøren har ingen egen pris, men inngår i én eller flere posisjoner. Kjøp en av disse posisjonene, så får du den.

```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]
      }
    ]
  }
}
```

Å legge til en av disse alene i en time blir avvist – se [Legg til enkeltbiomarkører](https://docs.anivahealth.com/no/api/appointments/add-individual-biomarkers.md). Legg i stedet til alle biomarkørene i en av de oppførte posisjonene.

### Null – ikke kuratert

Aniva har ikke bestemt hva denne markøren koster, så den er ikke til salgs. `null` betyr ikke null og ikke «spør oss»: behandle det som utilgjengelig.

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

> [!WARNING]
>
> Aniva avviser en `null`-markør ved bestilling. To vilkår gjør en biomarkør bestillbar. Et
> laboratorium Aniva kan rute til, må levere biomarkøren. Aniva-katalogen må ha en pris for den.
> Hvis du knytter en `null`-markør til en time, returnerer API-et `400` med
> `error: "biomarker_not_priced"`. Se
> [Legg til enkeltbiomarkører](https://docs.anivahealth.com/no/api/appointments/add-individual-biomarkers.md). Et laboratorium kan
> levere en `null`-markør, men levering alene gjør ikke markøren tilgjengelig. Behandle `null` som
> utilgjengelig.

Noen markører er `null` med hensikt. Aniva selger mikrobiom- og genetikktester som testsett. Et
testsett har én pris, så markørene som inngår, har ingen egen pris. For å kjøpe disse markørene
bestiller du panelet som utgjør testsettet. Markørene følger med panelet. API-et godtar også en
markør du legger til i en time som allerede inneholder panelet den tilhører.

En markør viser også `null` når Aniva bare selger den i en posisjon du ikke kan se. Resultatet er
det samme: du har ingen pris du kan kjøpe markøren til. Markøren får en pris når Aniva gjør den
posisjonen synlig for partnere.

## Finne den billigste måten å kjøpe et sett på

Fordi hver posisjon en markør tilhører, følger med markøren, kan du løse dette lokalt uten ekstra forespørsler:

1. Samle markørene du ønsker fra [List opp biomarkører](https://docs.anivahealth.com/no/api/biomarkers/list-biomarkers.md).
2. For hver enkelt sammenligner du dens egen `price_cents` med `price_cents` for posisjonene i `positions`-blokken dens.
3. En posisjon faktureres **én gang** og leverer hele `biomarker_ids`-settet sitt, så en posisjon som dekker flere av markørene dine, blir belastet bare én gang. Ekstra markører du ikke ba om, følger med uten ekstra kostnad.

Ingenting overlapper to ganger: to posisjoner som deler en markør, leverer hvert sitt sett, markøren oppføres én gang, og de gir aldri rabatt på hverandre.

## Regningen

[Forhåndsvis time](https://docs.anivahealth.com/no/api/appointments/preview-containers.md) returnerer regningen for en time. [Beregn pris for handlekurv](https://docs.anivahealth.com/no/api/pricing/quote-cart.md) returnerer den samme regningen uten en time. Regningen inneholder:

* `positions[]` – hver posisjon som ble utløst, fakturert én gang til sin faste pris.
* `panels[]` – hvert tilknyttet panel.
* `biomarkers[]` – én rad per **levert** markør. En rad som en posisjon dekker, koster `0` og oppgir den i `via_position`. En komponent som hentes inn av et forholdstall, har `required_by`; selve forholdstallet har `requires`.
* `total_cents` – de prisede posisjonene pluss de prisede panelene pluss de prisede biomarkørradene, med `retail_total_cents` ved siden av.
* `fees` og `total_with_fees_cents` – gebyrene for én time, og totalen med gebyrene.

En rad Aniva ikke kan prise, har `price_cents: null`. Raden legger ingenting til totalen. Du kan ikke legge til en upriset markør alene, så en posisjon eller et panel har levert denne raden. Den posisjonen eller det panelet fakturerer allerede for den.

> [!NOTE]
>
> Aniva har ikke publisert alle posisjoner ennå. En upublisert posisjon faktureres likevel. Den
> vises i `positions[]` med `id` og `name` satt til `null`, og biomarkørradene dens har
> `via_position: null`.


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