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

# Aprēķināt groza cenu

> Aprēķināt paneļu un biomarķieru cenu bez pieraksta

Atgriež aprēķinu paneļiem un biomarķieriem pēc tava cenrāža. Pieraksts nav nepieciešams. Nekas netiek
rezervēts.

Aprēķins ir tāds pats kā `pricing` galapunktā [Priekšskatīt pierakstu](https://docs.anivahealth.com/lv/api/appointments/preview-containers.md),
pieskaitot parauga paņemšanas veida izmaksas. Pēc noklusējuma tā ir asins paņemšana klātienē ar
pieraksta maksām. Nosūti `fulfilment: "home_kit"` un `country_code`, lai tā vietā aprēķinātu cenu
vienam uz šo valsti nosūtītam komplektam: komplekta maksu, paraugu paņemšanas ierīces, pasta izdevumus
turp un atpakaļ, apvalku un rezerves lancešu maisiņu, kā tos iekļauj tavā ikmēneša rēķinā.
[Cenas](https://docs.anivahealth.com/lv/concepts/pricing.md) paskaidro, kā Aniva nosaka testu cenas.

Nepieciešama `prices_view` piekļuves joma.

## Pieprasījums

### Pieprasījuma satura parametri

Nosūti vismaz vienu ID laukā `panel_ids` vai `biomarker_ids`.

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

Paneļi cenas aprēķinam, ne vairāk kā 50. Katram jābūt [Paneļu sarakstā](https://docs.anivahealth.com/lv/api/panels/list-panels.md) tavai atslēgai.

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

Biomarķieri cenas aprēķinam, ne vairāk kā 500.

**sex** `integer`

Bioloģiskais dzimums saskaņā ar ISO/IEC 5218: `1` = vīrietis, `2` = sieviete. Daži paneļi pievieno
biomarķierus tikai vienam dzimumam vai vecumam. Nosūti `sex` un `date_of_birth` kopā, lai piemērotu
šos noteikumus. Bez tiem noteikumi netiek piemēroti.

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

Dzimšanas datums, `YYYY-MM-DD`. Nosūti kopā ar `sex`.

**rate\_card** `string`

Cenrādis cenas aprēķinam: `retail` vai `id` no [Iegūt cenrādi](https://docs.anivahealth.com/lv/api/pricing/get-rate-card.md).
Pēc noklusējuma: tavas API atslēgas cenrādis, citādi mazumtirdzniecības.

**fulfilment** `string`

Parauga paņemšanas veids. `draw` (pēc noklusējuma): asins paņemšana klātienē, kas pievieno pieraksta
maksas. `home_kit`: viens komplekts, nosūtīts uz `country_code`, kas tā vietā pievieno komplekta
rindas. Mājas testa komplektā ietilpst tieši viens panelis, un šis panelis jāpārdod kā mājas testa
komplekts.

**country\_code** `string`

Komplekta piegādes valsts, ISO 3166-1 alpha-2 (`DE`, `SE`). Obligāts ar
`fulfilment: "home_kit"`, un tikai tad. Tas nosaka pasta izdevumu rindas.

## Atbilde

**total\_cents** `integer`

Testu cena pēc tava cenrāža: katra pozīcija, panelis un biomarķiera rinda, kam ir cena. Rinda ar
`price_cents: null` neko nepievieno.

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

Tā pati cena pēc ieteicamā mazumtirdzniecības cenrāža.

**fees** `object`

Viena pieraksta maksas centos. Aniva tās iekļauj tavā ikmēneša rēķinā. Tās attiecas uz `draw`;
`home_kit` gadījumā tā vietā iekļauj rindas no `fulfilment`.

**maksas**

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

Par pabeigtu pierakstu.

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

Par pierakstu, kurā pacients saņem uzkodu. Nav norādīts, ja tavi pacienti uzkodu nesaņem. Lai
piedāvātu uzkodas, sazinies ar Aniva.

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

Par kurjera savākšanu. Tavi pieraksti vienā vietā tajā pašā dienā dala vienu savākšanu.

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

Par pabeigtu pierakstu. Sedz mēģenes, etiķetes un maisiņu.

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

`total_cents` plus izpildes izmaksas. `draw` gadījumā: visas maksas no `fees`. Tajā ierēķināta pilna
loģistikas maksa, bet koplietota savākšana padara faktisko summu mazāku. `home_kit` gadījumā:
`fulfilment.total_cents`.

**fulfilment** `object`

Kā paraugs tiek paņemts un ko tas pievieno. `kind` ir `draw` vai `home_kit`. `draw` nav citu
lauku.

**home\_kit**

**country\_code** `string`

Piegādes valsts, kurai aprēķināti pasta izdevumi.

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

Komplekts, kādā panelis tiek nosūtīts. `null`, ja Aniva tādu vēl nav izveidojusi; aprēķinā tad
netiek ieskaitīta neviena ierīce.

**devices** `integer`

Paraugu paņemšanas ierīces kastītē; par katru tiek piemērota ierīces maksa.

**lines** `object[]`

Komplekta rindas, ko viens pasūtījums pievieno tavam ikmēneša rēķinam, katra ar `description`,
`quantity`, `unit`, `unit_cents` un `amount_cents`. Pasta izdevumi tiek aprēķināti pēc
pakalpojumiem, ko nosūtīšanas solis rezervē šai valstij. Maksa 0 tavā cenrādī neizveido rindu.
Priekšapmaksas materiālu kredīts šeit netiek atskaitīts.

**total\_cents** `integer`

`lines` summa, neto.

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

Tiek piemērota papildus, neto, ja neaktivizē komplektu, pirms tas nonāk laboratorijā, un to
aktivizē laboratorija. Tā nav iekļauta `lines` vai `total_cents`. 0 nozīmē, ka tavā cenrādī
šādas maksas nav.

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

Virzieni (`out`, `back`), kuriem tavā cenrādī cenas tiek noteiktas pa valstīm, bet šai valstij
cenas nav. Tiem piemērota fiksētā pasta maksa vai 0, ja cenrādī tādas nav. Tukšs, ja katram
virzienam ir atrasta cena.

**positions** `object[]`

Pozīcijas aprēķinā. Pozīcija ir biomarķieru kopums ar vienu cenu. Tai ir `id`, `name`,
`price_cents`, `retail_cents` un `tier`. Pozīcijai, ko Aniva vēl nav publicējusi, `id` un `name`
ir `null`.

**panels** `object[]`

Paneļi aprēķinā ar `id`, `name`, `price_cents` un `retail_cents`.

**biomarkers** `object[]`

Viena rinda katram biomarķierim, ko saņem. Tas ietver attiecības sastāvdaļas un katru pozīcijas
elementu.

**biomarķiera rinda**

**id** `number`

Biomarķiera ID.

**name** `string`

Biomarķiera nosaukums.

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

Šīs rindas cena ar `retail_cents` blakus. `0`, ja to sedz pozīcija vai panelis.

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

Attiecības, kurām nepieciešams šis biomarķieris. Par to maksā vienreiz.

**requires** `number[]`

Tikai attiecībai: biomarķieri, no kuriem to aprēķina.

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

Pozīcija, kas sedz šo rindu. `null`, ja pozīcija vēl nav publicēta.

## Kļūdu atbildes

| Statuss | Apraksts |
| - | - |
| `400` | Pieprasījuma pamatteksts ir nederīgs, vai tava atslēga nedrīkst izmantot `rate_card`. |
| `400` | `home_kit` aprēķinam nepieciešams tieši viens panelis, ko pārdod kā mājas testa komplektu, un valsts kods. |
| `400` | `biomarker_not_available`: neviena laboratorija, ko tava atslēga drīkst izmantot, nenosaka šo biomarķieri. |
| `400` | `biomarker_not_priced`: biomarķierim nav cenas. |
| `400` | `biomarker_requires_position`: biomarķieri pārdod tikai pozīcijā. Pamattekstā uzskaitītas pozīcijas. |
| `403` | Tavai API atslēgai nav `prices_view` piekļuves jomas. |
| `404` | `Panels not found`: panelis neeksistē, vai tava atslēga nevar to skatīt. |
| `404` | `Biomarkers not found`: biomarķieris neeksistē. |
| `500` | Iekšēja servera kļūda. |

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