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

# Ceny

> Jak Aniva API pro laboratorní testy stanovuje ceny biomarkerů, položek a panelů podle tvého ceníku, s cenovou nabídkou před rezervací.

Aniva oceňuje jedinou věc: **pozici**. Pozice je obchodní nabídka – vybraná sada biomarkerů, která se účtuje jednou, za pevnou cenu, a vždy se dodává jako celek. Biomarker, který si můžeš koupit samostatně, je jednoduše pozice o jednom prvku.

Všechno, co vidíš v `pricing`, z toho vychází. Přečti si tuto stránku jednou a čtyři stavy níže ti přestanou připadat jako zvláštní případy.

## Co znamenají čísla

Každá hodnota `price_cents` je částka, kterou platíš **ty**, podle ceníku u tvého API klíče. Vedle ní je `retail_cents` stejná položka podle doporučeného maloobchodního ceníku, takže můžeš zobrazit úsporu bez druhého požadavku. Obě hodnoty jsou celočíselné centy a obě jsou **bez DPH**: DPH se připočítá na tvé měsíční faktuře v sazbě podle tvého režimu DPH, a u osvobozeného režimu se žádná nepřipočítá. Panel, který se prodává za spotřebitelskou katalogovou cenu Aniva, se uvádí v této ceně očištěné o 19 % německé DPH.

> [!NOTE]
>
> Pole `retail_cents` je vždy přítomné. Když už tvůj klíč používá maloobchodní ceník, jednoduše se rovná
> `price_cents`.

Ceny vyžadují scope `prices_view`. Bez něj je `pricing` ve výpisech i v náhledu `null` a endpointy Pricing vracejí `403`.

## Tvůj ceník

Tvůj ceník určuje tvé ceny. Načti ho přes [Get Rate Card](https://docs.anivahealth.com/cs/api/pricing/get-rate-card.md).

* Každá analýza má `tier`: `routine` nebo `specialty`. Její cena odpovídá katalogové ceně Aniva vynásobené koeficientem dané úrovně.
* Poplatky se účtují za termín a logistický poplatek za jeden kurýrní svoz. Tvé termíny na stejné pobočce ve stejný den sdílejí jeden svoz. Aniva poplatky vyúčtuje na tvé měsíční faktuře.

## Čtyři stavy

Stav určuje `price_cents` spolu s tím, jaký volitelný blok vedle něj stojí. Žádné samostatné pole pro typ neexistuje.

| `price_cents` | Také přítomné | Co to znamená |
| - | - | - |
| kladné | `positions?` | Lze objednat samostatně za tuto cenu. Poměr má také `requires` a účtuje i své složky. |
| `0` | `requires` | **Poměr**. Sám o sobě nic nestojí; platíš za jeho složky. |
| `0` | `positions` | **Vázáno na pozici**. Prodává se jen v rámci jedné z uvedených pozic. |
| `null` | — | **Nezařazeno**. Aniva mu nestanovila cenu a nedá se objednat. |

### Kladná hodnota – objednatelné samostatně

Marker má vlastní cenu. Přesto se může objevovat v pozicích a pole `positions` je pak seřadí od nejlevnější – koupit pozici často vyjde levněji než kupovat její prvky jeden po druhém.

```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` je celá sada prvků pozice; `includes` je tato sada bez dotazovaného markeru – tedy to, co s ním dostaneš.

### Nula s `requires` – poměr

Poměr se vypočítává ze změřených markerů. Většina poměrů stojí `0`. U poměru s kladným `price_cents` se tato cena účtuje navíc k jeho složkám. Když ho objednáš, Aniva vloží jeho složky do košíku za jejich vlastní ceny. Složku zaplatíš **jednou za košík**, bez ohledu na to, kolik poměrů na ní závisí.

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

Poměr se s pozicemi doplňuje, místo aby s nimi soupeřil. Pokud jsou jeho složky součástí pozice, kterou už kupuješ, zaplatí je pozice a poměr máš v ceně.

> [!WARNING]
>
> Poměr, u kterého nemají všechny složky stanovenou cenu, **v katalogu chybí** – neobjeví se
> s `price_cents: null`. Vrátí se, jakmile Aniva chybějící složku ocení.

### Nula s `positions` – prodává se jen v rámci pozice

Marker nemá vlastní cenu, ale je součástí jedné nebo více pozic. Když jednu z těchto pozic koupíš, získáš ho.

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

Samostatné přidání takového markeru k termínu je zamítnuto — viz [Přidat jednotlivé biomarkery](https://docs.anivahealth.com/cs/api/appointments/add-individual-biomarkers.md). Místo toho přidej všechny biomarkery jedné z uvedených pozic.

### Null — nezařazený

Aniva zatím nestanovila cenu tohoto markeru, takže není na prodej. `null` neznamená nula ani „zeptej se nás“: ber ho jako nedostupný.

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

> [!WARNING]
>
> Aniva při objednání marker s hodnotou `null` zamítne. Aby šel biomarker objednat, musí být
> splněny dvě podmínky. Laboratoř, do které může Aniva objednávku směrovat, musí biomarker dodávat.
> Katalog Aniva mu musí přiřadit cenu. Pokud k termínu připojíš marker s hodnotou `null`, API vrátí
> `400` s `error: "biomarker_not_priced"`. Viz
> [Přidat jednotlivé biomarkery](https://docs.anivahealth.com/cs/api/appointments/add-individual-biomarkers.md). Laboratoř může
> marker s hodnotou `null` dodávat, ale samotné dodávání z něj nedělá dostupný marker. Hodnotu
> `null` ber jako nedostupnou.

Některé markery mají hodnotu `null` záměrně. Aniva prodává testy mikrobiomu a genetické testy jako
sady. Sada má jednu cenu, takže její dílčí markery nemají vlastní cenu. Pokud chceš tyto markery
koupit, objednej panel, který tuto sadu představuje. Jednotlivé markery jsou součástí panelu. API
přijme i dílčí marker přidaný k termínu, který už jeho panel obsahuje.

Marker má hodnotu `null` také tehdy, když ho Aniva prodává jen v rámci pozice, kterou nevidíš.
Výsledek je stejný: nemáš cenu, za kterou marker koupíš. Marker získá cenu, jakmile Aniva tuto
pozici zpřístupní partnerům.

## Jak koupit sadu co nejlevněji

Protože se s každým markerem vrací všechny pozice, do kterých patří, můžeš to vyřešit lokálně bez dalších požadavků:

1. Vyber markery, které chceš, pomocí [Vypsat biomarkery](https://docs.anivahealth.com/cs/api/biomarkers/list-biomarkers.md).
2. U každého porovnej jeho vlastní `price_cents` s `price_cents` pozic v jeho bloku `positions`.
3. Pozice se účtuje **jednou** a dodá celou svou sadu `biomarker_ids`, takže pozice pokrývající několik tvých markerů se účtuje jen jednou. Markery navíc, které nepožaduješ, jsou v ceně.

Nic se nepřekrývá dvakrát: dvě pozice se společným markerem dodají každá svou sadu, společný marker se uvede jednou a nikdy se navzájem nezlevňují.

## Vyúčtování

[Náhled termínu](https://docs.anivahealth.com/cs/api/appointments/preview-containers.md) vrací vyúčtování termínu. [Nacenit košík](https://docs.anivahealth.com/cs/api/pricing/quote-cart.md) vrací stejné vyúčtování bez termínu. Vyúčtování obsahuje:

* `positions[]` — každá uplatněná pozice, účtovaná jednou za svou paušální cenu.
* `panels[]` — každý připojený panel.
* `biomarkers[]` — jeden řádek na každý **dodaný** marker. Řádek hrazený pozicí stojí `0` a uvádí ji v `via_position`. Složka vyžádaná poměrem obsahuje `required_by`; samotný poměr obsahuje `requires`.
* `total_cents` — oceněné pozice plus oceněné panely plus oceněné řádky biomarkerů, vedle toho je `retail_total_cents`.
* `fees` a `total_with_fees_cents` — poplatky za jeden termín a celková částka včetně poplatků.

Řádek, který Aniva nedokáže ocenit, má `price_cents: null`. Tento řádek k celkové částce nic nepřičítá. Neoceněný marker nejde připojit samostatně, takže tento řádek dodala pozice nebo panel. Tato pozice nebo panel ho už účtuje.

> [!NOTE]
>
> Aniva zatím nezveřejnila všechny pozice. Nezveřejněná pozice se přesto účtuje. Objeví se v
> `positions[]` s `id` a `name` nastavenými na `null` a řádky jejích biomarkerů mají `via_position: null`.


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