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

# Попередній перегляд запису

> Попередньо переглянути пробірки та рахунок для запису

Повертає те, що потрібно для запису з урахуванням його панелей і біомаркерів. Нічого не замовляється.

* `containers`: пробірки, картки або ємності, які готує фахівець.
* `pricing`: рахунок за твоїм прайс-листом. [Розрахувати кошик](https://docs.anivahealth.com/uk/api/pricing/quote-cart.md) повертає такий самий
  рахунок без запису.
* `routing`: завжди `null`.

Потребує одного з дозволів `appointments_view`, `appointments_schedule`, `appointments_operate` або `appointments_manage`.

## Запит

### Параметри шляху

**id** `string` *required*

Унікальний ідентифікатор (UUID) запису, для якого потрібно переглянути вимоги до контейнерів.

## Відповідь

У разі успіху API повертає `200 OK` із вимогами до контейнерів і полями, зарезервованими для майбутнього використання.

**containers** `object[]` *required*

Масив необхідних контейнерів для збору біоматеріалу. Порожній, якщо до запису не додано жодної панелі чи біомаркера. Також порожній, якщо день і локацію запису ще неможливо визначити, наприклад коли не призначено час.

**контейнер**

**type** `string`

Ідентифікатор типу контейнера. Одне зі значень: `serum`, `serum_capillary`, `serum_capillary_plain`, `edta`, `edta_capillary`, `citrate`, `lihep`, `lihep_capillary`, `glucoexact`, `fluoride`, `fluoride_capillary`, `homocysteine`, `urine`, `dried_blood_spot`, `swab`, `stool`, `saliva`, `hair` або `trace_metal`.

**name** `string`

Читабельна назва контейнера (наприклад, «Serum», «EDTA», «Li-Heparin»).

**cap\_color** `string`

HEX-код кольору кришки контейнера для відображення (наприклад, `"#A0784B"`). `null`, якщо
контейнер не має кришки.

**volume** `string`

Об’єм контейнера (наприклад, `"7.5 ml"`). `null`, якщо об’єм не застосовується.

**article\_number** `string`

Каталожний номер виробника (REF), якщо відомий (наприклад, `"01.1602.001"`). Не передається для контейнерів без прив’язаного артикулу.

**count** `integer`

Необхідна кількість контейнерів цього типу.

**routing** `null`

Деталі маршрутизації до лабораторії — навмисно не розкриваються, завжди `null`.

**pricing** `object | null`

Загальний рахунок за весь кошик запису за твоїм прайс-листом. `null`, якщо до запису не прив’язано
аналізів або твій ключ не має дозволу `prices_view`. [Ціноутворення](https://docs.anivahealth.com/uk/concepts/pricing.md) пояснює
модель; окремі суми відповідають довіднику [об’єктів
ціни](https://docs.anivahealth.com/uk/api/biomarkers/list-biomarkers.md#ob-yekti-tsin).

**Поля рахунку**

**total\_cents** `integer`

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

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

Та сама сума за рекомендованим роздрібним прайс-листом.

**fees** `object`

Збори, які один забір крові додає за твоїм прайс-листом, у центах. Вони виставляються в щомісячному рахунку. Див. [Отримати
прайс-лист](https://docs.anivahealth.com/uk/api/pricing/get-rate-card.md).

**збори**

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

Збір за забір крові за кожен завершений запис.

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

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

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

Кур’єрський збір за передачу зразків. Твої записи в тій самій локації того самого дня ділять один
збір.

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

Витратні матеріали: пробірки, етикетки, пакет.

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

`total_cents` плюс усі збори з `fees`, включно з повною вартістю логістики. Сума менша, якщо інший
твій запис ділить той самий виїзд кур’єра.

**positions** `object[]`

Кожна позиція, що спрацювала в цьому кошику — оплачується один раз у повному обсязі й надає весь
свій набір складників. Містить `id`, `name`, `price_cents`, `retail_cents` і `tier`. Позиція, яка
не призначена для партнерів, усе одно спрацьовує й оплачується, але повертається зі значеннями
`null` для `id` та `name`.

**panels** `object[]`

Кожна додана панель із полями `id`, `name`, `price_cents` та `retail_cents`.

**biomarkers** `object[]`

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

**id** `number`

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

**name** `string`

Відображувана назва біомаркера.

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

Сума до списання з твоєї картки за цей рядок, поруч із `retail_cents`. `0`, коли його оплачує
позиція; `null`, коли Aniva не може визначити ціну.

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

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

**requires** `number[]`

Присутнє, коли цей рядок Є співвідношенням: компоненти, за які він оплачується.

**via\_position** `string`

Позиція, яка оплачує цей маркер, через що рядок коштує `0`. Поле відсутнє, якщо нічого його не
покриває. `null`, якщо позиція, що його покриває, не призначена для партнерів.

## Відповіді з помилками

| Статус | Опис |
| - | - |
| `400` | Недійсний формат ID — передане значення не є коректним UUID. |
| `403` | Доступ заборонено — твій API-ключ не має доступу до цієї операції. |
| `404` | Запис не знайдено. |
| `500` | Внутрішня помилка сервера. |

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/preview \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "containers": [
    {
      "type": "serum",
      "name": "Serum",
      "cap_color": "#A0784B",
      "volume": "7.5 ml",
      "article_number": "01.1602.001",
      "count": 3
    },
    {
      "type": "edta",
      "name": "EDTA",
      "cap_color": "#D13438",
      "volume": "3.4 ml",
      "article_number": "04.1914.001",
      "count": 2
    },
    {
      "type": "glucoexact",
      "name": "GlucoEXACT",
      "cap_color": "#9E9E9E",
      "volume": "3.1 ml",
      "article_number": "05.1074.001",
      "count": 1
    }
  ],
  "routing": null,
  "pricing": {
    "total_cents": 13751,
    "retail_total_cents": 17029,
    "fees": {
      "phlebotomy_fee_cents": 2500,
      "snack_fee_cents": 500,
      "logistics_fee_cents": 2000,
      "material_fee_cents": 250
    },
    "total_with_fees_cents": 19001,
    "positions": [
      {
        "id": "b7d4c2e1-9a3f-4c8b-91d2-5e6f7a8b9c0d",
        "name": "Aniva Blood Count",
        "price_cents": 452,
        "retail_cents": 520,
        "tier": "routine"
      }
    ],
    "panels": [
      {
        "id": "f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d",
        "name": "Hormones (Female)",
        "price_cents": 11900,
        "retail_cents": 14900
      }
    ],
    "biomarkers": [
      { "id": 42, "name": "HDL Cholesterol", "price_cents": 233, "retail_cents": 268, "required_by": [279] },
      {
        "id": 71,
        "name": "Hemoglobin",
        "price_cents": 0,
        "retail_cents": 0,
        "via_position": "b7d4c2e1-9a3f-4c8b-91d2-5e6f7a8b9c0d"
      },
      { "id": 84, "name": "High-Sensitivity C-Reactive Protein (hs-CRP)", "price_cents": 1166, "retail_cents": 1341, "required_by": [279] },
      { "id": 279, "name": "hs-CRP / HDL Ratio", "price_cents": 0, "retail_cents": 0, "requires": [42, 84] }
    ]
  }
}
```

```json 200 (no panels) theme={null}
{
  "containers": [],
  "routing": null,
  "pricing": null
}
```

```json 200 (one item without a price) theme={null}
{
  "containers": [],
  "routing": null,
  "pricing": {
    "total_cents": 11900,
    "retail_total_cents": 14900,
    "fees": {
      "phlebotomy_fee_cents": 2500,
      "snack_fee_cents": 500,
      "logistics_fee_cents": 2000,
      "material_fee_cents": 250
    },
    "total_with_fees_cents": 17150,
    "positions": [],
    "panels": [
      {
        "id": "f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d",
        "name": "Hormones (Female)",
        "price_cents": 11900,
        "retail_cents": 14900
      }
    ],
    "biomarkers": [{ "id": 555, "name": "Poppy Seeds (Pap s)", "price_cents": null, "retail_cents": null }]
  }
}
```

```json 404 theme={null}
{
  "error": "Appointment not found"
}
```


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