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

# Рассчитать стоимость корзины

> Рассчитать стоимость панелей и биомаркеров без записи

Возвращает расчёт стоимости панелей и биомаркеров по твоей тарифной карте. Запись не нужна. Ничего не
бронируется.

Расчёт совпадает с `pricing` в [Предпросмотре записи](https://docs.anivahealth.com/ru/api/appointments/preview-containers.md),
плюс стоимость выбранного способа сдачи образца. По умолчанию это забор крови в локации со
сборами за запись. Передай `fulfilment: "home_kit"` и `country_code`, чтобы вместо этого рассчитать стоимость одного набора с почтовой доставкой
в эту страну: сбор за набор, устройства для сбора образца, пересылку туда и обратно, защитный чехол
и запасной пакет с ланцетами — так, как они выставляются в твоём ежемесячном счёте.
В [Ценообразовании](https://docs.anivahealth.com/ru/concepts/pricing.md) описано, как Aniva рассчитывает цены на анализы.

Требуется разрешение `prices_view`.

## Запрос

### Параметры тела запроса

Передай хотя бы один идентификатор в `panel_ids` или `biomarker_ids`.

**panel\_ids** `string[]`

Панели для расчёта, не более 50. Каждая должна быть в [Списке панелей](https://docs.anivahealth.com/ru/api/panels/list-panels.md) для твоего ключа.

**biomarker\_ids** `number[]`

Биомаркеры для расчёта, не более 500.

**sex** `integer`

Биологический пол по ISO/IEC 5218: `1` = мужской, `2` = женский. Некоторые панели добавляют биомаркеры только для одного
пола или возраста. Передай `sex` и `date_of_birth` вместе, чтобы применить эти правила. Без них правила
не применяются.

**date\_of\_birth** `string`

Дата рождения, `YYYY-MM-DD`. Передай вместе с `sex`.

**rate\_card** `string`

Тарифная карта для расчёта: `retail` или `id` из [Получить тарифную карту](https://docs.anivahealth.com/ru/api/pricing/get-rate-card.md).
По умолчанию: тарифная карта твоего API-ключа, иначе — розничная.

**fulfilment** `string`

Способ сдачи образца. `draw` (по умолчанию): забор крови в локации, что добавляет сборы за
запись. `home_kit`: один набор, отправленный почтой в `country_code`, что вместо этого добавляет позиции набора. Набор для домашнего теста
включает ровно одну панель, и эта панель должна продаваться как набор для домашнего теста.

**country\_code** `string`

Страна доставки набора, ISO 3166-1 alpha-2 (`DE`, `SE`). Обязательно при
`fulfilment: "home_kit"` и только в этом случае. Определяет позиции почтовой пересылки.

## Ответ

**total\_cents** `integer`

Стоимость анализов по твоей тарифной карте: все оценённые позиции, панели и строки биомаркеров. Строка
с `price_cents: null` ничего не добавляет.

**retail\_total\_cents** `integer`

Та же стоимость по рекомендованной розничной тарифной карте.

**fees** `object`

Сборы за одну запись в центах. Aniva включает их в твой ежемесячный счёт. Они применяются к
`draw`; для `home_kit` вместо этого выставляются позиции из `fulfilment`.

**сборы**

**phlebotomy\_fee\_cents** `integer`

За каждую завершённую запись.

**snack\_fee\_cents** `integer`

За запись, на которой пациент получает перекус. Отсутствует, если твои пациенты не получают перекус. Чтобы
предлагать перекусы, свяжись с Aniva.

**logistics\_fee\_cents** `integer`

За один выезд курьера. Твои записи в одной локации в один день делят один выезд.

**material\_fee\_cents** `integer`

За каждую завершённую запись. Покрывает пробирки, этикетки и пакет.

**total\_with\_fees\_cents** `integer`

`total_cents` плюс стоимость выбранного способа сдачи. Для `draw`: все сборы из `fees`. Учитывается полный
логистический сбор, а общий выезд курьера снижает реальную сумму. Для `home_kit`:
`fulfilment.total_cents`.

**fulfilment** `object`

Способ сдачи образца и что он добавляет к стоимости. `kind` — `draw` или `home_kit`. У `draw` других
полей нет.

**home\_kit**

**country\_code** `string`

Страна доставки, для которой рассчитана почтовая пересылка.

**kit\_ref** `string | null`

Набор, в виде которого отправляется панель. `null`, если Aniva ещё не сформировала набор; тогда устройства в расчёте
не учитываются.

**devices** `integer`

Устройства для сбора образца в коробке; каждое тарифицируется по сбору за устройство.

**lines** `object[]`

Позиции набора, которые один заказ добавляет в твой ежемесячный счёт; у каждой есть `description`, `quantity`,
`unit`, `unit_cents` и `amount_cents`. Почтовая пересылка рассчитывается по тарифам служб, которые этап отправки бронирует
для этой страны. Сбор со значением 0 в твоей карте не создаёт строку. Предоплаченный кредит на материалы здесь не
вычитается.

**total\_cents** `integer`

Сумма `lines`, нетто.

**activation\_fee\_cents** `integer`

Начисляется дополнительно, нетто, если ты не активируешь набор до его поступления в лабораторию и его
активирует лаборатория. Не входит в `lines` и `total_cents`. 0 означает, что в твоей карте такого сбора нет.

**unpriced\_postage\_legs** `string[]`

Направления (`out`, `back`), которые твоя карта тарифицирует по странам, но для этой страны цены нет. Для них
использован фиксированный почтовый сбор или 0, если в карте его нет. Список пуст, если цена нашлась для каждого
направления.

**positions** `object[]`

Позиции в расчёте. Позиция — это набор биомаркеров с единой ценой. У неё есть `id`, `name`,
`price_cents`, `retail_cents` и `tier`. Для позиции, которую Aniva ещё не
опубликовала, `id` и `name` равны `null`.

**panels** `object[]`

Панели в расчёте, с полями `id`, `name`, `price_cents` и `retail_cents`.

**biomarkers** `object[]`

По одной строке на каждый получаемый биомаркер. Сюда входят компоненты соотношений и все биомаркеры в составе
позиции.

**строка биомаркера**

**id** `number`

Идентификатор биомаркера.

**name** `string`

Название биомаркера.

**price\_cents** `integer | null`

Цена этой строки, рядом с `retail_cents`. `0`, если её покрывает позиция или
панель.

**required\_by** `number[]`

Соотношения, которым нужен этот биомаркер. Ты платишь за него один раз.

**requires** `number[]`

Только для соотношения: биомаркеры, из которых оно рассчитывается.

**via\_position** `string | null`

Позиция, которая покрывает эту строку. `null`, если позиция ещё не опубликована.

## Ответы с ошибками

| Статус | Описание |
| - | - |
| `400` | Тело запроса некорректно, или твой ключ не может использовать этот `rate_card`. |
| `400` | Для расчёта `home_kit` нужны ровно одна панель, продающаяся как набор для домашнего теста, и код страны. |
| `400` | `biomarker_not_available`: ни одна доступная твоему ключу лаборатория не выполняет этот биомаркер. |
| `400` | `biomarker_not_priced`: у биомаркера нет цены. |
| `400` | `biomarker_requires_position`: биомаркер продаётся только в составе позиции. Список позиций указан в теле ответа. |
| `403` | У твоего API-ключа нет разрешения `prices_view`. |
| `404` | `Panels not found`: панель не существует или недоступна твоему ключу. |
| `404` | `Biomarkers not found`: биомаркер не существует. |
| `500` | Внутренняя ошибка сервера. |

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/pricing/quote \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "biomarker_ids": [63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 204, 206, 207, 209, 249]
  }'
```

```bash cURL (home kit) theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/pricing/quote \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "panel_ids": ["4d0423c5-6538-48f6-ac93-435f61e456e9"],
    "fulfilment": "home_kit",
    "country_code": "DE"
  }'
```

```json 200 theme={null}
{
  "total_cents": 210,
  "retail_total_cents": 451,
  "fees": {
    "phlebotomy_fee_cents": 2500,
    "logistics_fee_cents": 2000,
    "material_fee_cents": 250
  },
  "total_with_fees_cents": 4960,
  "fulfilment": { "kind": "draw" },
  "positions": [
    { "id": null, "name": null, "price_cents": 210, "retail_cents": 451, "tier": "routine" }
  ],
  "panels": [],
  "biomarkers": [
    { "id": 63, "name": "Eosinophils", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 64, "name": "Lymphocytes", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 65, "name": "Neutrophils", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 66, "name": "Monocytes", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 67, "name": "White Blood Cells (WBC)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 68, "name": "Basophils", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 69, "name": "Hematocrit", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 70, "name": "Red Blood Cells (RBC)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 71, "name": "Hemoglobin", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 72, "name": "Platelets", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 73, "name": "Mean Corpuscular Hemoglobin Concentration (MCHC)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 74, "name": "Mean Corpuscular Volume (MCV)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 75, "name": "Red Cell Distribution Width (RDW)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 76, "name": "Mean Corpuscular Hemoglobin (MCH)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 204, "name": "Lymphocytes (%)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 206, "name": "Eosinophils (%)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 207, "name": "Basophils (%)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 209, "name": "Monocytes (%)", "price_cents": 0, "retail_cents": 0, "via_position": null },
    { "id": 249, "name": "Neutrophils (%)", "price_cents": 0, "retail_cents": 0, "via_position": null }
  ]
}
```

```json 200 (home kit) theme={null}
{
  "total_cents": 2081,
  "retail_total_cents": 6702,
  "fees": {
    "phlebotomy_fee_cents": 2000,
    "logistics_fee_cents": 2000,
    "material_fee_cents": 0
  },
  "total_with_fees_cents": 4971,
  "fulfilment": {
    "kind": "home_kit",
    "country_code": "DE",
    "kit_ref": "TAS-1-1S1E",
    "devices": 1,
    "lines": [
      { "description": "Home kit (per order)", "quantity": 1, "unit": "kits", "unit_cents": 720, "amount_cents": 720 },
      { "description": "Collection device (per device)", "quantity": 1, "unit": "devices", "unit_cents": 1250, "amount_cents": 1250 },
      { "description": "Postage to the customer (per kit sent)", "quantity": 1, "unit": "kits sent", "unit_cents": 370, "amount_cents": 370 },
      { "description": "Return postage (per kit sent)", "quantity": 1, "unit": "kits sent", "unit_cents": 400, "amount_cents": 400 },
      { "description": "Spare lancet bag (per kit sent with one)", "quantity": 1, "unit": "bags", "unit_cents": 150, "amount_cents": 150 }
    ],
    "total_cents": 2890,
    "activation_fee_cents": 100,
    "unpriced_postage_legs": []
  },
  "positions": [],
  "panels": [
    { "id": "4d0423c5-6538-48f6-ac93-435f61e456e9", "name": "Doctrinus - Gesundheitsprofil 6 (Männer)", "price_cents": 2081, "retail_cents": 6702 }
  ],
  "biomarkers": []
}
```

```json 404 theme={null}
{
  "error": "Panels not found: f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d"
}
```


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