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

# Árazás

> Így árazza az Aniva laborvizsgálati API-ja a biomarkereket, tételeket és paneleket az árlistád alapján, foglalás előtti árajánlattal.

Az Aniva egyetlen dolgot áraz: a **tételt**. A tétel egy kereskedelmi ajánlat – biomarkerek válogatott készlete, amelyet egyszer, fix áron számláznak, és mindig egyben teljesül. Az önállóan megvásárolható biomarker egyszerűen egyetlen elemből álló tétel.

Minden, amit a `pricing` mezőben látsz, ebből következik. Olvasd el egyszer ezt az oldalt, és az alábbi négy állapot már nem tűnik különleges esetnek.

## Mit jelentenek a számok

Minden `price_cents` érték az, amit **te** fizetsz az API-kulcsodhoz tartozó árlista alapján. Mellette a `retail_cents` ugyanez a tétel az ajánlott kiskereskedelmi árlistán, így egy második kérés nélkül is meg tudod mutatni a megtakarítást. Mindkettő egész centben megadott, és mindkettő **nettó**: az áfa a havi számládra kerül fel az áfastátuszodnak megfelelő kulccsal, áfamentesség esetén pedig nem kerül rá áfa. Az Aniva fogyasztói katalógusárán értékesített panel ára a 19%-os német áfa nélkül szerepel.

> [!NOTE]
>
> A `retail_cents` mindig szerepel. Ha a kulcsod már a kiskereskedelmi árlistán van, egyszerűen
> megegyezik a `price_cents` értékkel.

Az árakhoz szükséges a `prices_view` scope. Enélkül a `pricing` értéke `null` a listázásoknál és az előnézetnél, a Pricing végpontok pedig `403`-at adnak vissza.

## Az árlistád

Az árlistád határozza meg az áraidat. A [Get Rate Card](https://docs.anivahealth.com/hu/api/pricing/get-rate-card.md) végpontról olvashatod ki.

* Minden elemzésnek van egy `tier` besorolása: `routine` vagy `specialty`. Az ára az Aniva katalógusár szorozva az adott szint szorzójával.
* A díjak időpontonként, a logisztikai díj pedig futáros felvételenként értendő. Az ugyanazon a helyszínen, ugyanazon a napon lévő időpontjaid egyetlen felvételen osztoznak. A díjakat az Aniva a havi számládon számlázza ki.

## A négy állapot

A `price_cents` értéke, valamint a mellette lévő opcionális blokk határozza meg az állapotot. Nincs külön típusmező.

| `price_cents` | Emellett szerepel | Jelentése |
| - | - | - |
| pozitív | `positions?` | Önállóan rendelhető ezen az áron. Az arány a `requires` mezőt is tartalmazza, és az összetevőit is felszámítja. |
| `0` | `requires` | **Arány**. Önmagában nem kerül semmibe; az összetevőiért fizetsz. |
| `0` | `positions` | **Tételhez kötött**. Csak a felsorolt tételek valamelyikén belül kapható. |
| `null` | — | **Nem árazott**. Az Aniva nem árazta be, és nem rendelhető. |

### Pozitív – önállóan rendelhető

A markernek saját ára van. Ettől még szerepelhet tételekben, ilyenkor a `positions` a legolcsóbbtól kezdve sorolja fel őket – a tétel megvásárlása gyakran olcsóbb, mint az elemeit egyenként megvenni.

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

A `biomarker_ids` a tétel teljes elemkészlete; az `includes` ugyanez a készlet a lekérdezett marker nélkül – vagyis ami még jár hozzá.

### Nulla `requires` mezővel – arány

Az arányt mért markerekből számítják ki. A legtöbb arány ára `0`. A pozitív `price_cents` értékű arány az összetevői mellett ezt az árat is felszámítja. Ha megrendeled, az Aniva az összetevőit a saját árukon a kosárba teszi. Egy összetevőt **kosaranként egyszer** fizetsz ki, bármennyi arány támaszkodik is rá.

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

Az arány jól kombinálható a tételekkel, nem pedig verseng velük. Ha az összetevői elemei egy olyan tételnek, amelyet már megvásárolsz, a tétel fedezi őket, az arány pedig külön díj nélkül jár hozzá.

> [!WARNING]
>
> Az olyan arány, amelynek nem minden összetevője van beárazva, **hiányzik a katalógusból** – nem
> jelenik meg `price_cents: null` értékkel. Akkor tér vissza, amikor az Aniva beárazza a hiányzó
> összetevőt.

### Nulla `positions` mezővel – csak tételen belül kapható

A markernek nincs saját ára, de egy vagy több tétel része. Vegyél meg egyet ezek közül a tételek közül, és megkapod.

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

Ha egy ilyet önállóan adsz hozzá egy időponthoz, a rendszer elutasítja – lásd: [Egyéni biomarkerek hozzáadása](https://docs.anivahealth.com/hu/api/appointments/add-individual-biomarkers.md). Ehelyett add hozzá valamelyik felsorolt tétel összes biomarkerét.

### Null – nem beárazott

Az Aniva még nem döntötte el, mennyibe kerül ez a marker, ezért nem megvásárolható. A `null` nem nulla és nem „kérdezz minket”: kezeld nem elérhetőként.

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

> [!WARNING]
>
> Az Aniva rendeléskor elutasítja a `null` értékű markert. Két feltétel szükséges ahhoz, hogy egy
> biomarker rendelhető legyen. Egy olyan laboratóriumnak kell teljesítenie a biomarkert, amelyhez az
> Aniva át tudja irányítani a rendelést. Az Aniva katalógusának tartalmaznia kell az árát. Ha `null`
> értékű markert csatolsz egy időponthoz, az API `400` kóddal és `error: "biomarker_not_priced"`
> hibával válaszol. Lásd: [Egyéni biomarkerek hozzáadása](https://docs.anivahealth.com/hu/api/appointments/add-individual-biomarkers.md).
> Egy laboratórium teljesíthet `null` értékű markert, de a teljesítés önmagában nem teszi elérhetővé
> a markert. Kezeld a `null` értéket nem elérhetőként.

Néhány marker szándékosan `null` értékű. Az Aniva a mikrobiom- és genetikai teszteket
tesztkészletként értékesíti. Egy tesztkészletnek egyetlen ára van, ezért az ahhoz tartozó markereknek
nincs saját áruk. Ezeknek a markereknek a megvásárlásához rendeld meg a tesztkészletnek megfelelő
panelt. Az elemek a panellel együtt járnak. Az API olyan elemet is elfogad, amelyet olyan
időponthoz adsz hozzá, amely már tartalmazza a paneljét.

A marker akkor is `null` értéket mutat, ha az Aniva csak olyan tételen belül értékesíti, amelyet
nem látsz. Az eredmény ugyanaz: nincs olyan ár, amelyen megvehetnéd a markert. A marker akkor kap
árat, amikor az Aniva láthatóvá teszi az adott tételt a partnerek számára.

## Egy összeállítás megvásárlásának legolcsóbb módja

Mivel minden tétel, amelyhez egy marker tartozik, együtt érkezik a markerrel, ezt helyben, további kérések nélkül is megoldhatod:

1. Gyűjtsd össze a kívánt markereket innen: [Biomarkerek listázása](https://docs.anivahealth.com/hu/api/biomarkers/list-biomarkers.md).
2. Mindegyiknél hasonlítsd össze a saját `price_cents` értékét a `positions` blokkjában lévő tételek `price_cents` értékével.
3. Egy tétel **egyszer** kerül számlázásra, és a teljes `biomarker_ids` halmazát biztosítja, így egy több markeredet is lefedő tételt csak egyszer számlázunk ki. A nem kért extra markerek további költség nélkül járnak hozzá.

Semmi sem duplázódik: ha két tételnek van közös eleme, mindkettő biztosítja a saját halmazát, az elem egyszer szerepel a listában, és soha nem csökkentik egymás árát.

## A számla

Az [Időpont előnézete](https://docs.anivahealth.com/hu/api/appointments/preview-containers.md) visszaadja egy időpont számláját. A [Kosár árajánlata](https://docs.anivahealth.com/hu/api/pricing/quote-cart.md) ugyanezt a számlát adja vissza időpont nélkül. A számla a következőket tartalmazza:

* `positions[]` – minden aktiválódott tétel, egyszer számlázva az átalányárán.
* `panels[]` – minden csatolt panel.
* `biomarkers[]` – egy sor minden **teljesített** markerhez. Egy tétel által fedezett sor ára `0`, és a `via_position` mezőben megnevezi a tételt. Egy arány által behúzott összetevő tartalmazza a `required_by` mezőt; maga az arány pedig a `requires` mezőt.
* `total_cents` – az árazott tételek, az árazott panelek és az árazott biomarkersorok összege, mellette a `retail_total_cents` értékkel.
* `fees` és `total_with_fees_cents` – egy időpont díjai, valamint a velük együtt számított végösszeg.

Az a sor, amelyet az Aniva nem tud beárazni, `price_cents: null` értéket tartalmaz. A sor nem ad hozzá semmit a végösszeghez. Árazatlan markert önállóan nem csatolhatsz, így ezt a sort egy tétel vagy egy panel adta hozzá. Az adott tétel vagy panel már kiszámlázza.

> [!NOTE]
>
> Az Aniva még nem tett közzé minden tételt. A nem közzétett tételek továbbra is számlázásra
> kerülnek. Ezek a `positions[]` tömbben `null` értékű `id` és `name` mezővel jelennek meg,
> biomarkersoraiknál pedig `via_position: null` szerepel.


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