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

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

Твоя тарифная сетка определяет твои цены. Запроси её через [Получение тарифной сетки](https://docs.anivahealth.com/ru/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/ru/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/ru/api/appointments/add-individual-biomarkers.md). Лаборатория может выполнять маркер с
> `null`, но само по себе это не делает его доступным. Считай `null` недоступным.

У некоторых маркеров `null` задан намеренно. Aniva продаёт тесты микробиома и генетические тесты в
виде наборов. У набора единая цена, поэтому у входящих в него маркеров нет собственной цены. Чтобы
купить эти маркеры, закажи панель, соответствующую этому набору. Входящие маркеры идут вместе с
панелью. API также примет отдельный маркер, если ты добавишь его в запись, в которой уже есть эта
панель.

Маркер также показывает `null`, если Aniva продаёт его только в составе позиции, которую ты не
видишь. Результат тот же: у тебя нет цены, по которой можно купить этот маркер. У маркера появится
цена, когда Aniva откроет эту позицию для партнёров.

## Поиск самого дешёвого способа купить набор

Поскольку каждая позиция, в которую входит маркер, передаётся вместе с ним, ты можешь решить эту задачу локально, без лишних запросов:

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

Ничто не дублируется: каждая из двух позиций с общим маркером отдаёт свой набор, маркер указывается один раз, и они никогда не снижают цену друг друга.

## Счёт

[Предпросмотр записи](https://docs.anivahealth.com/ru/api/appointments/preview-containers.md) возвращает счёт за запись. [Расчёт корзины](https://docs.anivahealth.com/ru/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.