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

# Hinnoittelu

> Näin Anivan laboratoriotestien API hinnoittelee hinnastosi biomarkkerit, nimikkeet ja paneelit sekä tarjoaa hinta-arviot ennen kuin varaat.

Aniva hinnoittelee yhden asian: **position**. Positio on kaupallinen kokonaisuus – kuratoitu joukko biomarkkereita, joka laskutetaan kerran kiinteällä hinnalla ja toimitetaan aina kokonaisena. Yksittäin ostettava biomarkkeri on yksinkertaisesti yhden biomarkkerin positio.

Kaikki, mitä näet `pricing`-kentässä, seuraa tästä. Lue tämä sivu kerran, niin alla olevat neljä tilaa eivät enää näytä poikkeustapauksilta.

## Mitä luvut tarkoittavat

Jokainen `price_cents` on hinta, jonka **sinä** maksat API-avaimeesi liitetyn hinnaston mukaan. Sen vieressä oleva `retail_cents` on sama tuote suositellun vähittäishinnaston mukaan, joten voit näyttää säästön ilman toista pyyntöä. Molemmat ovat kokonaislukuja sentteinä, ja molemmat ovat **nettohintoja**: arvonlisävero lisätään kuukausilaskullesi ALV-kohtelusi mukaisella verokannalla, eikä verovapaassa kohtelussa lisätä veroa lainkaan. Paneeli, joka myydään Anivan kuluttajahinnaston hinnalla, ilmoitetaan kyseisellä hinnalla ilman Saksan 19 %:n arvonlisäveroa.

> [!NOTE]
>
> `retail_cents` on aina mukana. Kun avaimesi käyttää jo vähittäishinnastoa, se on yksinkertaisesti
> sama kuin `price_cents`.

Hinnat vaativat `prices_view`-käyttöoikeuden. Ilman sitä `pricing` on `null` listauksissa ja esikatselussa, ja Pricing-päätepisteet palauttavat tilakoodin `403`.

## Hinnastosi

Hinnastosi määrittää hintasi. Lue se päätepisteestä [Get Rate Card](https://docs.anivahealth.com/fi/api/pricing/get-rate-card.md).

* Jokaisella analyysilla on `tier`: `routine` tai `specialty`. Sen hinta on Anivan hinnastohinta kerrottuna kyseisen tason kertoimella.
* Maksut ovat ajanvarauskohtaisia, ja logistiikkamaksu on kuriirinoutokohtainen. Saman päivän ajanvarauksesi samassa toimipisteessä jakavat yhden noudon. Aniva laskuttaa maksut kuukausilaskullasi.

## Neljä tilaa

`price_cents` ja sen vieressä oleva valinnainen lohko määrittävät tilan. Erillistä tyyppikenttää ei ole.

| `price_cents` | Lisäksi mukana | Mitä se tarkoittaa |
| - | - | - |
| positiivinen | `positions?` | Tilattavissa erikseen tällä hinnalla. Suhdeluvussa on myös `requires`, ja lisäksi sen osatekijät laskutetaan. |
| `0` | `requires` | **Suhdeluku**. Se ei maksa itse mitään; maksat sen osatekijöistä. |
| `0` | `positions` | **Positiosidonnainen**. Myydään vain jonkin listatun position osana. |
| `null` | — | **Kuratoimaton**. Aniva ei ole hinnoitellut sitä, eikä sitä voi tilata. |

### Positiivinen – tilattavissa erikseen

Markkerilla on oma hinta. Se voi silti esiintyä positioissa, jolloin `positions` listaa ne halvimmasta alkaen – position ostaminen on usein halvempaa kuin sen osien ostaminen yksitellen.

```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` on position koko markkerijoukko; `includes` on sama joukko ilman hakemaasi markkeria – eli se, mikä tulee mukana.

### Nolla ja `requires` – suhdeluku

Suhdeluku lasketaan mitatuista markkereista. Useimmat suhdeluvut maksavat `0`. Suhdeluvusta, jonka `price_cents` on positiivinen, laskutetaan kyseinen hinta osatekijöiden lisäksi. Kun tilaat sen, Aniva lisää sen osatekijät ostoskoriin niiden omilla hinnoilla. Osatekijä maksetaan **kerran ostoskoria kohden**, riippumatta siitä, kuinka moni suhdeluku käyttää sitä.

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

Suhdeluku yhdistyy positioihin eikä kilpaile niiden kanssa. Jos sen osatekijät kuuluvat jo ostamaasi positioon, positio kattaa ne ja suhdeluku sisältyy hintaan.

> [!WARNING]
>
> Suhdeluku, jonka kaikkia osatekijöitä ei ole hinnoiteltu, **puuttuu luettelosta** – se ei näy
> arvolla `price_cents: null`. Se palaa takaisin, kun Aniva hinnoittelee puuttuvan osatekijän.

### Nolla ja `positions` – myydään vain position osana

Markkerilla ei ole omaa hintaa, mutta se kuuluu yhteen tai useampaan positioon. Osta yksi näistä positioista, niin saat sen.

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

Tällaisen lisääminen ajanvaraukseen yksinään hylätään — katso [Lisää yksittäisiä biomarkkereita](https://docs.anivahealth.com/fi/api/appointments/add-individual-biomarkers.md). Lisää sen sijaan jokainen biomarkkeri jostakin luetelluista positioista.

### Null — kuratoimaton

Aniva ei ole päättänyt tämän markkerin hintaa, joten se ei ole myynnissä. `null` ei tarkoita nollaa eikä "kysy meiltä": käsittele sitä niin, ettei se ole saatavilla.

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

> [!WARNING]
>
> Aniva hylkää `null`-markkerin tilaushetkellä. Biomarkkerin tilattavuudella on kaksi ehtoa.
> Laboratorion, johon Aniva voi reitittää, on toimitettava biomarkkeri. Anivan luettelossa sille
> on oltava hinta. Jos liität `null`-markkerin ajanvaraukseen, API palauttaa `400` ja
> `error: "biomarker_not_priced"`. Katso
> [Lisää yksittäisiä biomarkkereita](https://docs.anivahealth.com/fi/api/appointments/add-individual-biomarkers.md). Laboratorio voi
> toimittaa `null`-markkerin, mutta pelkkä toimitus ei tee markkerista saatavilla olevaa. Käsittele
> `null`-arvoa niin, ettei markkeri ole saatavilla.

Jotkin markkerit ovat tarkoituksella `null`. Aniva myy mikrobiomi- ja geenitestit
testipakkauksina. Testipakkauksella on yksi hinta, joten siihen kuuluvilla markkereilla ei ole
omaa hintaa. Osta nämä markkerit tilaamalla testipakkausta vastaava paneeli. Markkerit tulevat
paneelin mukana. API hyväksyy myös paneeliin kuuluvan markkerin, jonka lisäät ajanvaraukseen,
jossa kyseinen paneeli jo on.

Markkerin arvo on `null` myös silloin, kun Aniva myy sitä vain sellaisen position sisällä, jota et
näe. Lopputulos on sama: sinulla ei ole hintaa, jolla voisit ostaa markkerin. Markkeri saa hinnan,
kun Aniva tekee kyseisestä positiosta kumppaneille näkyvän.

## Halvin tapa ostaa kokonaisuus

Koska jokainen positio, johon markkeri kuuluu, kulkee markkerin mukana, voit ratkaista tämän paikallisesti ilman lisäpyyntöjä:

1. Kerää haluamasi markkerit kohdasta [Listaa biomarkkerit](https://docs.anivahealth.com/fi/api/biomarkers/list-biomarkers.md).
2. Vertaa kunkin markkerin omaa `price_cents`-arvoa sen `positions`-lohkon positioiden `price_cents`-arvoihin.
3. Positio laskutetaan **kerran** ja se toimittaa koko `biomarker_ids`-joukkonsa, joten useita markkereitasi kattava positio veloitetaan vain kerran. Ylimääräiset markkerit, joita et pyytänyt, tulevat mukana ilman lisäkustannuksia.

Mikään ei tule kahdesti: kaksi positiota, joilla on yhteinen markkeri, toimittavat kumpikin oman joukkonsa, markkeri listataan kerran, eivätkä ne koskaan alenna toistensa hintaa.

## Lasku

[Esikatsele ajanvaraus](https://docs.anivahealth.com/fi/api/appointments/preview-containers.md) palauttaa ajanvarauksen laskun. [Laske ostoskorin hinta](https://docs.anivahealth.com/fi/api/pricing/quote-cart.md) palauttaa saman laskun ilman ajanvarausta. Lasku sisältää:

* `positions[]` — jokainen aktivoitunut positio, laskutettuna kerran kiinteään hintaansa.
* `panels[]` — jokainen liitetty paneeli.
* `biomarkers[]` — yksi rivi jokaista **toimitettua** markkeria kohden. Position kattama rivi maksaa `0` ja nimeää position kentässä `via_position`. Suhdeluvun mukaan tuoma osatekijä sisältää kentän `required_by`; suhdeluku itse sisältää kentän `requires`.
* `total_cents` — hinnoitellut positiot, hinnoitellut paneelit ja hinnoitellut biomarkkeririvit yhteenlaskettuna, ja sen rinnalla `retail_total_cents`.
* `fees` ja `total_with_fees_cents` — yhden ajanvarauksen maksut sekä kokonaissumma ne mukaan lukien.

Rivi, jota Aniva ei voi hinnoitella, saa arvon `price_cents: null`. Rivi ei lisää mitään kokonaissummaan. Et voi liittää hinnoittelematonta markkeria yksinään, joten tämän rivin on tuonut mukanaan positio tai paneeli. Kyseinen positio tai paneeli laskuttaa siitä jo.

> [!NOTE]
>
> Aniva ei ole vielä julkaissut kaikkia positioita. Julkaisematon positio laskutetaan silti. Se
> näkyy taulukossa `positions[]` siten, että `id` ja `name` ovat `null`, ja sen biomarkkeririveillä
> on `via_position: null`.


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