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

# Laske ostoskorin hinta-arvio

> Hinnoittele paneelit ja biomarkkerit ilman ajanvarausta

Palauttaa paneelien ja biomarkkereiden laskun hinnastollasi. Et tarvitse ajanvarausta. Mitään ei
varata.

Lasku on sama kuin `pricing` kutsussa [Esikatsele ajanvaraus](https://docs.anivahealth.com/fi/api/appointments/preview-containers.md),
lisättynä näytteenottotavan mukaisilla kuluilla. Oletuksena tämä on verinäytteenotto toimipisteessä,
johon lisätään ajanvarausmaksut. Lähetä `fulfilment: "home_kit"` ja `country_code`, jos haluat
hinnoitella sen sijaan yhden kyseiseen maahan postitetun pakkauksen: pakkausmaksun,
näytteenottovälineet, meno- ja paluupostikulut, suojakuoren sekä varalansettipussin sen mukaan,
miten kuukausilaskusi ne veloittaa.
[Hinnoittelu](https://docs.anivahealth.com/fi/concepts/pricing.md) selittää, miten Aniva hinnoittelee testit.

Vaatii `prices_view`-käyttöoikeuden.

## Pyyntö

### Runkoparametrit

Lähetä vähintään yksi tunniste kentässä `panel_ids` tai `biomarker_ids`.

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

Hinnoiteltavat paneelit, enintään 50. Jokaisen on oltava avaimellasi kutsussa [Listaa
paneelit](https://docs.anivahealth.com/fi/api/panels/list-panels.md).

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

Hinnoiteltavat biomarkkerit, enintään 500.

**sex** `integer`

Biologinen sukupuoli standardin ISO/IEC 5218 mukaan: `1` = mies, `2` = nainen. Jotkin paneelit
lisäävät biomarkkereita vain tietylle sukupuolelle tai iälle. Lähetä `sex` ja `date_of_birth`
yhdessä, jotta nämä säännöt tulevat käyttöön. Ilman niitä sääntöjä ei sovelleta.

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

Syntymäaika muodossa `YYYY-MM-DD`. Lähetä se yhdessä kentän `sex` kanssa.

**rate\_card** `string`

Hinnoittelussa käytettävä hinnasto: `retail` tai `id` kutsusta [Hae
hinnasto](https://docs.anivahealth.com/fi/api/pricing/get-rate-card.md). Oletus: API-avaimesi hinnasto, muuten vähittäishinnasto.

**fulfilment** `string`

Näytteenottotapa. `draw` (oletus): verinäytteenotto toimipisteessä, mikä lisää ajanvarausmaksut.
`home_kit`: yksi maahan `country_code` postitettu pakkaus, joka lisää sen sijaan pakkausrivit.
Kotitestipakkaus sisältää tarkalleen yhden paneelin, ja paneelin on oltava myynnissä
kotitestipakkauksena.

**country\_code** `string`

Pakkauksen toimitusmaa, ISO 3166-1 alpha-2 (`DE`, `SE`). Pakollinen arvolla
`fulfilment: "home_kit"`, ja vain silloin. Määrittää postikulurivit.

## Vastaus

**total\_cents** `integer`

Testien hinta hinnastollasi: jokainen hinnoiteltu positio-, paneeli- ja biomarkkeririvi. Rivi,
jossa `price_cents: null`, ei lisää hintaa.

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

Sama hinta suositellulla vähittäishinnastolla.

**fees** `object`

Yhden ajanvarauksen maksut sentteinä. Aniva veloittaa ne kuukausilaskullasi. Ne koskevat
`draw`-toimitustapaa; `home_kit` veloittaa sen sijaan kentän `fulfilment` rivit.

**maksut**

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

Toteutunutta ajanvarausta kohden.

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

Ajanvarausta kohden, jossa potilas saa välipalan. Puuttuu, jos potilaasi eivät saa välipalaa.
Jos haluat tarjota välipaloja, ota yhteyttä Anivaan.

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

Kuriirinoutoa kohden. Saman päivän ajanvarauksesi samassa toimipisteessä jakavat yhden noudon.

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

Toteutunutta ajanvarausta kohden. Kattaa putket, tarrat ja pussin.

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

`total_cents` lisättynä toimitustavan kuluilla. `draw`-tavalla: jokainen `fees`-kentän maksu.
Mukana on täysi logistiikkamaksu, ja jaettu nouto pienentää todellista summaa. `home_kit`-tavalla:
`fulfilment.total_cents`.

**fulfilment** `object`

Näytteenottotapa ja sen lisäämät kulut. `kind` on `draw` tai `home_kit`. `draw`-tavalla ei ole
muita kenttiä.

**home\_kit**

**country\_code** `string`

Toimitusmaa, jolle postikulut hinnoiteltiin.

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

Pakkaus, jona paneeli toimitetaan. `null`, kun Aniva ei ole vielä määrittänyt pakkausta;
silloin hinta-arvio ei laske mukaan yhtään välinettä.

**devices** `integer`

Pakkauksen näytteenottovälineet, joista jokainen veloitetaan välinemaksulla.

**lines** `object[]`

Pakkausrivit, jotka yksi tilaus lisää kuukausilaskullesi; jokaisella on `description`,
`quantity`, `unit`, `unit_cents` ja `amount_cents`. Postikulut hinnoitellaan niiden
palveluiden mukaan, jotka lähetysvaihe varaa tälle maalle. Jos maksu on hinnastollasi 0,
riviä ei luoda. Ennakkoon maksettua materiaalihyvitystä ei vähennetä tässä.

**total\_cents** `integer`

Kentän `lines` nettosumma.

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

Veloitetaan erikseen nettona, jos et aktivoi pakkausta ennen kuin se saapuu laboratorioon ja
laboratorio aktivoi sen. Se ei sisälly kenttiin `lines` tai `total_cents`. 0 tarkoittaa,
ettei hinnastossasi ole tällaista maksua.

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

Suunnat (`out`, `back`), jotka hinnastosi hinnoittelee maakohtaisesti, mutta joille ei ole
hintaa tässä maassa. Niissä käytettiin kiinteää postimaksua tai arvoa 0, jos hinnastossa ei
ole sellaista. Tyhjä, kun jokaiselle suunnalle löytyi hinta.

**positions** `object[]`

Laskun positiot. Positio on yhden hinnan biomarkkerijoukko. Sillä on `id`, `name`,
`price_cents`, `retail_cents` ja `tier`. `id` ja `name` ovat `null` positiolle, jota Aniva ei ole
vielä julkaissut.

**panels** `object[]`

Laskun paneelit kentillä `id`, `name`, `price_cents` ja `retail_cents`.

**biomarkers** `object[]`

Yksi rivi jokaista saamaasi biomarkkeria kohden. Tämä sisältää suhdeluvun osatekijät ja jokaisen
position jäsenen.

**biomarkkeririvi**

**id** `number`

Biomarkkerin tunniste.

**name** `string`

Biomarkkerin nimi.

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

Tämän rivin hinta ja sen rinnalla `retail_cents`. `0`, kun positio tai paneeli kattaa sen.

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

Suhdeluvut, jotka tarvitsevat tämän biomarkkerin. Maksat siitä vain kerran.

**requires** `number[]`

Vain suhdeluvuilla: biomarkkerit, joista se lasketaan.

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

Positio, joka kattaa tämän rivin. `null`, kun positiota ei ole vielä julkaistu.

## Virhevastaukset

| Tila | Kuvaus |
| - | - |
| `400` | Runko on virheellinen, tai avaimesi ei saa käyttää tätä `rate_card`-hinnastoa. |
| `400` | `home_kit`-hinta-arvio vaatii tarkalleen yhden paneelin, kotitestipakkauksena myytävän paneelin ja maakoodin. |
| `400` | `biomarker_not_available`: mikään avaimellesi sallittu laboratorio ei tee tätä biomarkkeria. |
| `400` | `biomarker_not_priced`: biomarkkerilla ei ole hintaa. |
| `400` | `biomarker_requires_position`: biomarkkeria myydään vain osana positiota. Runko listaa positiot. |
| `403` | API-avaimellasi ei ole `prices_view`-käyttöoikeutta. |
| `404` | `Panels not found`: paneelia ei ole olemassa, tai avaimesi ei voi listata sitä. |
| `404` | `Biomarkers not found`: biomarkkeria ei ole olemassa. |
| `500` | Sisäinen palvelinvirhe. |

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