> ## 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/uk/api/appointments/preview-containers.md), плюс те, що додає спосіб забору зразка. За замовчуванням це забір крові в локації зі зборами за запис. Надішли `fulfilment: "home_kit"` і `country_code`, щоб натомість розрахувати вартість одного набору з поштовою доставкою до цієї країни: збір за набір, пристрої для забору, поштову доставку туди й назад, футляр і пакет із запасними ланцетами — як це виставляється у твоєму щомісячному рахунку. [Ціноутворення](https://docs.anivahealth.com/uk/concepts/pricing.md) пояснює, як Aniva розраховує ціни на аналізи.

Потрібен дозвіл `prices_view`.

## Запит

### Параметри тіла запиту

Надішли принаймні один ідентифікатор у `panel_ids` або `biomarker_ids`.

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

Панелі для розрахунку ціни, щонайбільше 50. Кожна має бути у [Список панелей](https://docs.anivahealth.com/uk/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/uk/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`. `id` та `name` дорівнюють `null` для позиції, яку Aniva ще не опублікувала.

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