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

# Wycena

> Jak API Aniva do badań laboratoryjnych ustala ceny biomarkerów, pozycji i paneli według twojego cennika, z wyceną przed rezerwacją.

Aniva wycenia jedną rzecz: **pozycję**. Pozycja to oferta handlowa — dobrany zestaw biomarkerów, który rozliczany jest raz, w stałej cenie, i zawsze realizowany w całości. Biomarker, który możesz kupić osobno, to po prostu pozycja jednoelementowa.

Wszystko, co widzisz w `pricing`, wynika właśnie z tego. Przeczytaj tę stronę raz, a cztery poniższe stany przestaną wyglądać jak wyjątki.

## Co oznaczają liczby

Każda wartość `price_cents` to kwota, którą **ty** płacisz według cennika przypisanego do twojego klucza API. Obok niej `retail_cents` to ten sam element w sugerowanym cenniku detalicznym, dzięki czemu możesz pokazać oszczędność bez drugiego zapytania. Obie wartości to liczby całkowite w centach i obie są **netto**: VAT doliczany jest na fakturze miesięcznej według stawki wynikającej z twojego statusu VAT, a w przypadku zwolnienia nie jest doliczany. Panel sprzedawany w konsumenckiej cenie katalogowej Aniva jest podawany w tej cenie pomniejszonej o 19% niemieckiego podatku VAT.

> [!NOTE]
>
> Pole `retail_cents` jest zawsze obecne. Gdy twój klucz korzysta już z cennika detalicznego, po prostu
> równa się `price_cents`.

Ceny wymagają zakresu `prices_view`. Bez niego `pricing` ma wartość `null` na listach i w podglądzie, a endpointy Pricing zwracają `403`.

## Twój cennik

Twój cennik określa twoje ceny. Odczytasz go za pomocą [Get Rate Card](https://docs.anivahealth.com/pl/api/pricing/get-rate-card.md).

* Każda analiza ma poziom `tier`: `routine` lub `specialty`. Jej cena to cena katalogowa Aniva pomnożona przez mnożnik tego poziomu.
* Opłaty naliczane są za wizytę, a opłata logistyczna za odbiór kurierski. Twoje wizyty w tej samej lokalizacji tego samego dnia korzystają z jednego odbioru. Aniva rozlicza te opłaty na twojej fakturze miesięcznej.

## Cztery stany

Wartość `price_cents` oraz to, jaki opcjonalny blok znajduje się obok niej, określają dany stan. Nie ma osobnego pola typu.

| `price_cents` | Dodatkowo obecne | Co to oznacza |
| - | - | - |
| dodatnia | `positions?` | Można zamówić osobno w tej cenie. Wskaźnik zawiera też `requires` i rozlicza również swoje składniki. |
| `0` | `requires` | **Wskaźnik**. Sam nic nie kosztuje; płacisz za jego składniki. |
| `0` | `positions` | **Tylko w pozycji**. Sprzedawany wyłącznie w ramach jednej z wymienionych pozycji. |
| `null` | — | **Niewyceniony**. Aniva go nie wyceniła i nie można go zamówić. |

### Wartość dodatnia — do zamówienia osobno

Marker ma własną cenę. Nadal może występować w pozycjach, a `positions` wymienia je wtedy od najtańszej — zakup pozycji często jest tańszy niż kupowanie jej składników osobno.

```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` to pełny zestaw składników pozycji; `includes` to ten sam zestaw bez markera, o który pytasz — czyli to, co dostajesz dodatkowo.

### Zero z `requires` — wskaźnik

Wskaźnik jest obliczany na podstawie zmierzonych markerów. Większość wskaźników kosztuje `0`. Wskaźnik z dodatnią wartością `price_cents` dolicza tę cenę oprócz ceny swoich składników. Po zamówieniu go Aniva dodaje jego składniki do koszyka w ich własnych cenach. Za składnik płacisz **raz na koszyk**, niezależnie od tego, ile wskaźników z niego korzysta.

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

Wskaźnik łączy się z pozycjami, zamiast z nimi konkurować. Jeśli jego składniki należą do pozycji, którą już kupujesz, pozycja pokrywa ich koszt, a wskaźnik jest w cenie.

> [!WARNING]
>
> Wskaźnik, którego nie wszystkie składniki są wycenione, **nie występuje w katalogu** — nie pojawia się
> z `price_cents: null`. Wraca, gdy Aniva wyceni brakujący składnik.

### Zero z `positions` — sprzedawany wyłącznie w ramach pozycji

Marker nie ma własnej ceny, ale należy do jednej lub kilku pozycji. Kup jedną z tych pozycji, a go otrzymasz.

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

Dodanie takiego markera osobno do wizyty zostanie odrzucone — zobacz [Dodaj pojedyncze biomarkery](https://docs.anivahealth.com/pl/api/appointments/add-individual-biomarkers.md). Zamiast tego dodaj wszystkie biomarkery z jednej z wymienionych pozycji.

### Null — nieopracowany

Aniva nie ustaliła ceny tego markera, więc nie jest on w sprzedaży. `null` nie oznacza zera ani „zapytaj nas”: traktuj go jako niedostępny.

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

> [!WARNING]
>
> Aniva odrzuca marker z wartością `null` w momencie zamówienia. Aby biomarker można było zamówić, muszą być spełnione dwa warunki.
> Laboratorium, do którego Aniva może skierować zlecenie, musi wykonywać ten biomarker. Katalog Aniva musi mieć dla niego cenę. Jeśli dołączysz
> marker z wartością `null` do wizyty, API zwróci `400` z `error: "biomarker_not_priced"`. Zobacz
> [Dodaj pojedyncze biomarkery](https://docs.anivahealth.com/pl/api/appointments/add-individual-biomarkers.md). Laboratorium może wykonywać
> marker z wartością `null`, ale sama możliwość wykonania nie sprawia, że marker jest dostępny. Traktuj `null` jako niedostępny.

Niektóre markery mają wartość `null` celowo. Aniva sprzedaje badania mikrobiomu i genetyczne jako zestawy. Zestaw ma jedną
cenę, więc wchodzące w jego skład markery nie mają własnej ceny. Aby kupić te markery, zamów panel
odpowiadający zestawowi. Markery składowe są zawarte w panelu. API akceptuje też marker składowy dodany do
wizyty, która zawiera już jego panel.

Marker ma również wartość `null`, gdy Aniva sprzedaje go wyłącznie w ramach pozycji, której nie widzisz.
Efekt jest taki sam: nie masz ceny, po której możesz kupić ten marker. Marker otrzymuje cenę, gdy Aniva
udostępni tę pozycję partnerom.

## Jak najtaniej kupić zestaw

Ponieważ każda pozycja, do której należy marker, jest zwracana razem z nim, możesz to wyliczyć lokalnie, bez dodatkowych zapytań:

1. Pobierz wybrane markery z [Wyświetl biomarkery](https://docs.anivahealth.com/pl/api/biomarkers/list-biomarkers.md).
2. Dla każdego z nich porównaj jego własne `price_cents` z `price_cents` pozycji w jego bloku `positions`.
3. Pozycja jest rozliczana **raz** i obejmuje cały swój zestaw `biomarker_ids`, więc pozycja pokrywająca kilka twoich markerów jest naliczana jednorazowo. Dodatkowe markery spoza twojej listy dostajesz bez dodatkowych kosztów.

Nic się nie nakłada podwójnie: dwie pozycje ze wspólnym markerem dostarczają swoje zestawy, marker jest wymieniony raz, a pozycje nigdy nie obniżają wzajemnie swoich cen.

## Rachunek

[Podgląd wizyty](https://docs.anivahealth.com/pl/api/appointments/preview-containers.md) zwraca rachunek dla wizyty. [Wycena koszyka](https://docs.anivahealth.com/pl/api/pricing/quote-cart.md) zwraca taki sam rachunek bez wizyty. Rachunek zawiera:

* `positions[]` — każda zastosowana pozycja, rozliczona raz według swojej stałej ceny.
* `panels[]` — każdy dołączony panel.
* `biomarkers[]` — jeden wiersz na każdy **dostarczony** marker. Wiersz opłacony w ramach pozycji kosztuje `0` i wskazuje ją w `via_position`. Składnik dodany na potrzeby wskaźnika ma pole `required_by`, a sam wskaźnik ma pole `requires`.
* `total_cents` — suma wycenionych pozycji, wycenionych paneli i wycenionych wierszy biomarkerów, z polem `retail_total_cents` obok.
* `fees` i `total_with_fees_cents` — opłaty za jedną wizytę oraz łączna kwota z tymi opłatami.

Wiersz, którego Aniva nie może wycenić, ma wartość `price_cents: null`. Taki wiersz nie zwiększa sumy. Nie możesz samodzielnie dołączyć niewycenionego markera, więc ten wiersz pochodzi z pozycji lub panelu. Ta pozycja lub panel już go rozlicza.

> [!NOTE]
>
> Aniva nie opublikowała jeszcze wszystkich pozycji. Nieopublikowana pozycja nadal jest rozliczana. Pojawia się w
> `positions[]` z polami `id` i `name` ustawionymi na `null`, a wiersze jej biomarkerów mają `via_position: null`.


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