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

# Cenas

> Kā Aniva laboratorijas analīžu API nosaka cenas biomarķieriem, pozīcijām un paneļiem tavā cenrādī, ar cenu piedāvājumiem pirms pieteikšanas.

Aniva nosaka cenu vienai lietai: **pozīcijai**. Pozīcija ir komerciāls piedāvājums — atlasīts biomarķieru kopums, par kuru rēķinu izraksta vienreiz par fiksētu cenu un kuru vienmēr izpilda pilnībā. Biomarķieris, ko vari nopirkt atsevišķi, vienkārši ir viena biomarķiera pozīcija.

Viss, ko redzi laukā `pricing`, izriet no tā. Izlasi šo lapu vienreiz, un četri tālāk aprakstītie stāvokļi vairs neizskatīsies pēc īpašiem gadījumiem.

## Ko nozīmē skaitļi

Katrs `price_cents` ir tas, ko maksā **tu**, saskaņā ar tavai API atslēgai piesaistīto cenrādi. Tam blakus esošais `retail_cents` ir tā pati vienība pēc ieteicamā mazumtirdzniecības cenrāža, lai tu varētu parādīt ietaupījumu bez otra pieprasījuma. Abas vērtības ir veselos centos, un abas ir **neto**: PVN tiek pievienots tavam ikmēneša rēķinam pēc tava PVN režīma likmes, bet ar PVN neapliekamā režīmā tas netiek pievienots. Panelim, ko pārdod par Aniva patērētāju kataloga cenu, tiek norādīta šī cena bez 19% Vācijas PVN.

> [!NOTE]
>
> `retail_cents` vienmēr ir norādīts. Ja tavai atslēgai jau ir piesaistīts mazumtirdzniecības
> cenrādis, tas vienkārši ir vienāds ar `price_cents`.

Cenām nepieciešams `prices_view` tvērums. Bez tā `pricing` sarakstos un priekšskatījumā ir `null`, un cenu galapunkti atgriež `403`.

## Tavs cenrādis

Tavs cenrādis nosaka tavas cenas. Nolasi to, izmantojot [Iegūt cenrādi](https://docs.anivahealth.com/lv/api/pricing/get-rate-card.md).

* Katrai analīzei ir `tier`: `routine` vai `specialty`. Tās cena ir Aniva kataloga cena, reizināta ar attiecīgā līmeņa reizinātāju.
* Maksas tiek piemērotas par katru pierakstu, bet loģistikas maksa — par katru kurjera izbraukumu. Tavi pieraksti tajā pašā atrašanās vietā tajā pašā dienā dala vienu izbraukumu. Aniva iekļauj šīs maksas tavā ikmēneša rēķinā.

## Četri stāvokļi

`price_cents` kopā ar to, kurš neobligātais bloks atrodas tam blakus, nosaka stāvokli. Atsevišķa tipa lauka nav.

| `price_cents` | Norādīts arī | Ko tas nozīmē |
| - | - | - |
| pozitīvs | `positions?` | Pasūtāms atsevišķi par šo cenu. Attiecībai ir arī `requires`, un rēķinā tiek iekļautas arī tās komponentes. |
| `0` | `requires` | **Attiecība**. Pati par sevi tā nemaksā neko; tu maksā par tās komponentēm. |
| `0` | `positions` | **Tikai pozīcijā**. Pārdod tikai kādā no norādītajām pozīcijām. |
| `null` | — | **Neatlasīts**. Aniva tam nav noteikusi cenu, un to nevar pasūtīt. |

### Pozitīva vērtība — pasūtāms atsevišķi

Marķierim ir sava cena. Tas tik un tā var būt iekļauts pozīcijās, un tad `positions` tās sakārto, sākot ar lētāko — pirkt pozīciju bieži ir lētāk nekā pirkt tās elementus pa vienam.

```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` ir viss pozīcijas elementu kopums; `includes` ir šis kopums bez marķiera, ko tu vaicāji — viss pārējais, kas nāk līdzi.

### Nulle ar `requires` — attiecība

Attiecību aprēķina no izmērītajiem marķieriem. Lielākā daļa attiecību maksā `0`. Attiecībai ar pozitīvu `price_cents` šī cena tiek pieskaitīta papildus tās komponentēm. Pasūti to, un Aniva pievieno grozam tās komponentes par to cenām. Par katru komponenti maksā **vienreiz par grozu**, neatkarīgi no tā, cik attiecību uz to balstās.

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

Attiecība papildina pozīcijas, nevis konkurē ar tām. Ja tās komponentes jau ir iekļautas pozīcijā, ko tu pērc, pozīcija tās jau apmaksā, un attiecība ir iekļauta.

> [!WARNING]
>
> Attiecība, kurai nav noteikta cena visām komponentēm, **nav atrodama katalogā** — tā neparādās ar
> `price_cents: null`. Tā atgriežas, tiklīdz Aniva nosaka cenu trūkstošajai komponentei.

### Nulle ar `positions` — pārdod tikai pozīcijā

Šim marķierim nav savas cenas, bet tas ietilpst vienā vai vairākās pozīcijās. Nopērc vienu no šīm pozīcijām, un tu to saņemsi.

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

Ja kādu no šiem pievieno pierakstam atsevišķi, pieprasījums tiek noraidīts — skat. [Pievienot atsevišķus biomarķierus](https://docs.anivahealth.com/lv/api/appointments/add-individual-biomarkers.md). Tā vietā pievieno visus biomarķierus no vienas no norādītajām pozīcijām.

### Null — neizvērtēts

Aniva nav noteikusi šī marķiera cenu, tāpēc tas netiek pārdots. `null` nav nulle un nav "pajautā mums": uztver to kā nepieejamu.

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

> [!WARNING]
>
> Pasūtīšanas brīdī Aniva noraida `null` marķieri. Biomarķieri var pasūtīt, ja izpildās divi
> nosacījumi. Laboratorijai, uz kuru Aniva var novirzīt pasūtījumu, ir jānodrošina šis biomarķieris.
> Tam ir jābūt ar cenu Aniva katalogā. Ja pievieno `null` marķieri pierakstam, API atgriež `400` ar
> `error: "biomarker_not_priced"`. Skat.
> [Pievienot atsevišķus biomarķierus](https://docs.anivahealth.com/lv/api/appointments/add-individual-biomarkers.md). Laboratorija var
> nodrošināt `null` marķieri, taču tas vien nepadara marķieri pieejamu. Uztver `null` kā nepieejamu.

Dažiem marķieriem vērtība `null` ir noteikta apzināti. Aniva pārdod mikrobioma un ģenētikas testus
kā komplektus. Komplektam ir viena cena, tāpēc tajā ietilpstošajiem marķieriem nav savas cenas. Lai
nopirktu šos marķierus, pasūti paneli, kas atbilst komplektam. Tajā esošie marķieri ir iekļauti
panelī. API pieņem arī tajā ietilpstošu marķieri, ko pievieno pierakstam, kurā jau ir tā panelis.

Marķierim ir `null` arī tad, ja Aniva to pārdod tikai pozīcijā, kuru tu neredzi. Rezultāts ir
tāds pats: tev nav cenas, par kuru šo marķieri nopirkt. Marķieris iegūst cenu, kad Aniva padara šo
pozīciju redzamu partneriem.

## Kā atrast lētāko veidu kopas iegādei

Tā kā katra pozīcija, kurā marķieris ietilpst, tiek nodota kopā ar marķieri, to vari aprēķināt lokāli bez papildu pieprasījumiem:

1. Atlasi vajadzīgos marķierus no [Biomarķieru saraksta](https://docs.anivahealth.com/lv/api/biomarkers/list-biomarkers.md).
2. Katram marķierim salīdzini tā `price_cents` ar pozīciju `price_cents` tā `positions` blokā.
3. Par pozīciju jāmaksā **vienreiz**, un tā nodrošina visu savu `biomarker_ids` kopu, tāpēc par pozīciju, kas ietver vairākus tavus marķierus, maksa tiek iekasēta vienu reizi. Papildu marķieri, kurus nepieprasīji, nāk līdzi, un par tiem nav papildus jāmaksā.

Nekas nepārklājas divreiz: divas pozīcijas ar kopīgu elementu katra nodrošina savu kopu, kopīgais elements tiek norādīts vienreiz, un tās nekad nesamazina viena otras cenu.

## Rēķins

[Priekšskatīt pierakstu](https://docs.anivahealth.com/lv/api/appointments/preview-containers.md) atgriež pieraksta rēķinu. [Aprēķināt groza cenu](https://docs.anivahealth.com/lv/api/pricing/quote-cart.md) atgriež to pašu rēķinu bez pieraksta. Rēķinā ir:

* `positions[]` — katra piemērotā pozīcija, par kuru maksa tiek iekasēta vienreiz pēc tās fiksētās cenas.
* `panels[]` — katrs pievienotais panelis.
* `biomarkers[]` — viena rinda katram **nodrošinātajam** marķierim. Rinda, kuru sedz pozīcija, maksā `0` un norāda to laukā `via_position`. Komponentam, ko iekļauj attiecība, ir `required_by`; pašai attiecībai ir `requires`.
* `total_cents` — pozīcijas ar cenu plus paneļi ar cenu plus biomarķieru rindas ar cenu, blakus norādot `retail_total_cents`.
* `fees` un `total_with_fees_cents` — viena pieraksta maksas un kopsumma ar tām.

Rindai, kurai Aniva nevar noteikt cenu, ir `price_cents: null`. Šī rinda neko nepieskaita kopsummai. Marķieri bez cenas nevari pievienot atsevišķi, tāpēc šo rindu ir nodrošinājusi pozīcija vai panelis. Šī pozīcija vai panelis par to jau iekasē maksu.

> [!NOTE]
>
> Aniva vēl nav publicējusi visas pozīcijas. Par nepublicētu pozīciju tik un tā tiek iekasēta maksa.
> Tā parādās `positions[]` ar `id` un `name` vērtībām `null`, un tās biomarķieru rindās ir
> `via_position: null`.


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