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

# Ціноутворення

> Як API лабораторних аналізів Aniva визначає ціни на біомаркери, позиції та панелі за твоїм прайс-листом — із розрахунком вартості до запису.

Aniva встановлює ціну на одне: **позицію**. Позиція — це комерційна пропозиція: підібраний набір біомаркерів, який оплачується один раз за фіксованою ціною і завжди надається цілком. Біомаркер, який ти можеш купити окремо, — це просто позиція з одного біомаркера.

Усе, що ти бачиш у `pricing`, випливає з цього. Прочитай цю сторінку один раз — і чотири стани нижче перестануть здаватися особливими випадками.

## Що означають числа

Кожне `price_cents` — це сума, яку платиш **ти** за тарифною сіткою свого API-ключа. Поруч `retail_cents` — та сама позиція за рекомендованою роздрібною тарифною сіткою, тож ти можеш показати економію без другого запиту. Обидва значення вказані в цілих центах і обидва є **нетто**: ПДВ додається у твоєму щомісячному рахунку за ставкою твого режиму ПДВ, а при звільненні від ПДВ не нараховується. Панель, що продається за споживчою ціною каталогу Aniva, зазначається за цією ціною за вирахуванням 19% німецького ПДВ.

> [!NOTE]
>
> Поле `retail_cents` є завжди. Коли твій ключ уже працює за роздрібною тарифною сіткою, воно
> просто дорівнює `price_cents`.

Для перегляду цін потрібен дозвіл `prices_view`. Без нього поле `pricing` має значення `null` у списках і попередньому перегляді, а ендпоїнти Pricing повертають `403`.

## Твоя тарифна сітка

Твоя тарифна сітка визначає твої ціни. Отримай її через [Get Rate Card](https://docs.anivahealth.com/uk/api/pricing/get-rate-card.md).

* Кожен аналіз має `tier`: `routine` або `specialty`. Його ціна дорівнює ціні каталогу Aniva, помноженій на коефіцієнт цього рівня.
* Збори нараховуються за кожен запис, а логістичний збір — за кожен виїзд кур’єра. Твої записи в одній локації в той самий день об’єднуються в один виїзд кур’єра. Aniva виставляє ці збори у твоєму щомісячному рахунку.

## Чотири стани

Значення `price_cents` разом із тим, який необов’язковий блок стоїть поруч, і визначає стан. Окремого поля типу немає.

| `price_cents` | Також присутнє | Що це означає |
| - | - | - |
| додатне | `positions?` | Можна замовити окремо за цією ціною. Співвідношення також містить `requires` і додатково тарифікує свої компоненти. |
| `0` | `requires` | **Співвідношення**. Саме по собі воно нічого не коштує — ти платиш за його компоненти. |
| `0` | `positions` | **Лише у складі позиції**. Продається тільки всередині однієї з перелічених позицій. |
| `null` | — | **Без ціни**. Aniva не встановила на нього ціну, і його не можна замовити. |

### Додатне — можна замовити окремо

Маркер має власну ціну. Він усе одно може входити до позицій, і тоді `positions` наводить їх від найдешевшої — купити позицію часто дешевше, ніж купувати її складові окремо.

```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` — це повний набір складових позиції; `includes` — цей самий набір без запитаного маркера, тобто те, що йде в комплекті.

### Нуль із `requires` — співвідношення

Співвідношення обчислюється на основі виміряних маркерів. Більшість співвідношень коштують `0`. Для співвідношення з додатним `price_cents` ця сума нараховується додатково до вартості його компонентів. Замов його — і Aniva додасть його компоненти до кошика за їхніми власними цінами. Компонент оплачується **один раз на кошик**, скільки б співвідношень на нього не спиралося.

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

Співвідношення поєднується з позиціями, а не конкурує з ними. Якщо його компоненти входять до позиції, яку ти вже купуєш, позиція покриває їхню вартість, а співвідношення додається без доплати.

> [!WARNING]
>
> Співвідношення, у якого не всі компоненти мають ціну, **відсутнє в каталозі** — воно не
> відображається з `price_cents: null`. Воно повертається, щойно Aniva встановить ціну на
> відсутній компонент.

### Нуль із `positions` — продається лише у складі позиції

У цього маркера немає власної ціни, але він входить до однієї або кількох позицій. Купи одну з цих позицій — і отримаєш його.

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

Додавання одного з них до запису окремо буде відхилено — див. [Додавання окремих біомаркерів](https://docs.anivahealth.com/uk/api/appointments/add-individual-biomarkers.md). Натомість додай усі біомаркери однієї з перелічених позицій.

### Null — неопрацьований

Aniva не визначила ціну цього маркера, тому він не продається. `null` — це не нуль і не «запитай нас»: вважай його недоступним.

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

> [!WARNING]
>
> Aniva відхиляє маркер зі значенням `null` під час замовлення. Щоб біомаркер можна було замовити,
> потрібні дві умови. Лабораторія, до якої Aniva може спрямувати замовлення, має виконувати цей
> біомаркер. У каталозі Aniva для нього має бути вказана ціна. Якщо ти додаси маркер зі значенням
> `null` до запису, API поверне `400` з `error: "biomarker_not_priced"`. Див. [Додавання окремих
> біомаркерів](https://docs.anivahealth.com/uk/api/appointments/add-individual-biomarkers.md). Лабораторія може виконувати маркер зі
> значенням `null`, але саме по собі це не робить його доступним. Вважай `null` недоступним.

Деякі маркери мають значення `null` за задумом. Aniva продає тести мікробіому та генетичні тести як
набори. Набір має одну ціну, тому маркери в його складі не мають власної ціни. Щоб купити ці
маркери, замов панель, яка відповідає цьому набору. Усі маркери входять до панелі. API також
приймає маркер зі складу набору, якщо ти додаєш його до запису, у якому вже є ця панель.

Маркер також має значення `null`, коли Aniva продає його лише в межах позиції, яку ти не бачиш.
Результат той самий: у тебе немає ціни, за якою можна купити цей маркер. Маркер отримає ціну, коли
Aniva відкриє цю позицію для партнерів.

## Як знайти найдешевший спосіб купити набір

Оскільки кожна позиція, до якої входить маркер, передається разом із ним, ти можеш розрахувати це локально, без додаткових запитів:

1. Збери потрібні маркери через [Список біомаркерів](https://docs.anivahealth.com/uk/api/biomarkers/list-biomarkers.md).
2. Для кожного з них порівняй його власне значення `price_cents` зі значенням `price_cents` позицій у його блоці `positions`.
3. Позиція оплачується **один раз** і містить увесь свій набір `biomarker_ids`, тому за позицію, що охоплює кілька твоїх маркерів, плата стягується лише один раз. Додаткові маркери, що не входять до твого запиту, додаються без доплати.

Ніщо не перекривається двічі: дві позиції зі спільним маркером видають кожна свій набір, маркер вказується один раз, і вони ніколи не зменшують ціну одна одної.

## Рахунок

[Попередній перегляд запису](https://docs.anivahealth.com/uk/api/appointments/preview-containers.md) повертає рахунок запису. [Розрахунок кошика](https://docs.anivahealth.com/uk/api/pricing/quote-cart.md) повертає той самий рахунок без запису. Рахунок містить:

* `positions[]` — кожна позиція, що спрацювала, оплачена один раз за її фіксованою ціною.
* `panels[]` — кожна додана панель.
* `biomarkers[]` — один рядок на кожен **наданий** маркер. Рядок, оплачений позицією, коштує `0` і вказує її в `via_position`. Компонент, підтягнутий співвідношенням, містить `required_by`; саме співвідношення містить `requires`.
* `total_cents` — позиції з ціною плюс панелі з ціною плюс рядки біомаркерів із ціною, а поруч — `retail_total_cents`.
* `fees` і `total_with_fees_cents` — збори за один запис і підсумкова сума з ними.

Рядок, для якого Aniva не може визначити ціну, має `price_cents: null`. Цей рядок нічого не додає до підсумку. Ти не можеш додати маркер без ціни окремо, тому цей рядок надійшов із позиції або панелі. Ця позиція або панель уже оплачує його.

> [!NOTE]
>
> Aniva ще не опублікувала всі позиції. Неопублікована позиція все одно оплачується. Вона
> з’являється в `positions[]` зі значеннями `null` для `id` і `name`, а її рядки біомаркерів мають
> `via_position: null`.


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