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

# Wyświetl podgląd wizyty

> Wyświetl podgląd probówek i rachunku za wizytę

Zwraca to, czego wymaga wizyta dla dodanych do niej paneli i biomarkerów. Nic nie jest zamawiane.

* `containers`: probówki, karty lub pojemniki, które przygotowuje specjalista.
* `pricing`: rachunek według twojego cennika. [Wyceń koszyk](https://docs.anivahealth.com/pl/api/pricing/quote-cart.md) zwraca ten sam
  rachunek bez wizyty.
* `routing`: zawsze `null`.

Wymaga jednego z zakresów: `appointments_view`, `appointments_schedule`, `appointments_operate` lub `appointments_manage`.

## Żądanie

### Parametry ścieżki

**id** `string` *required*

Unikalny identyfikator (UUID) wizyty, dla której chcesz podejrzeć wymagane pojemniki.

## Odpowiedź

W przypadku powodzenia API zwraca `200 OK` z wymaganymi pojemnikami oraz polami zarezerwowanymi do przyszłego użycia.

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

Tablica wymaganych pojemników do pobierania próbek. Pusta, gdy do wizyty nie dodano żadnych paneli ani biomarkerów. Pusta również wtedy, gdy nie można jeszcze ustalić dnia w lokalizacji wizyty, na przykład gdy wizyta nie ma zaplanowanej godziny.

**pojemnik**

**type** `string`

Identyfikator typu pojemnika. Jedna z wartości: `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` lub `trace_metal`.

**name** `string`

Czytelna dla człowieka nazwa pojemnika (np. „Serum”, „EDTA”, „Li-Heparin”).

**cap\_color** `string`

Szesnastkowy kod koloru zakrętki pojemnika do wyświetlania (np. `"#A0784B"`). `null`, gdy
pojemnik nie ma zakrętki.

**volume** `string`

Pojemność pojemnika (np. `"7.5 ml"`). `null`, gdy objętość nie ma zastosowania.

**article\_number** `string`

Numer katalogowy producenta (REF), jeśli jest znany (np. `"01.1602.001"`). Pomijany dla pojemników bez przypisanego numeru artykułu.

**count** `integer`

Wymagana liczba pojemników tego typu.

**routing** `null`

Szczegóły kierowania do laboratorium — celowo nieudostępniane, zawsze `null`.

**pricing** `object | null`

Rachunek za cały koszyk dla wizyty, według twojego cennika. `null`, gdy wizyta nie ma przypisanych
badań lub gdy twój klucz nie ma zakresu `prices_view`. [Cennik](https://docs.anivahealth.com/pl/concepts/pricing.md) wyjaśnia ten
model; poszczególne kwoty są zgodne z dokumentacją [obiektów
cen](https://docs.anivahealth.com/pl/api/biomarkers/list-biomarkers.md#obiekty-cenowe).

**Pola rachunku**

**total\_cents** `integer`

Koszt koszyka według twojego cennika: wycenione pozycje plus wycenione panele plus wycenione
wiersze biomarkerów. Wiersz z `price_cents: null` nic nie dodaje, więc suma dla koszyka z takim wierszem jest niższa
niż rzeczywisty koszt.

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

Ta sama suma według zalecanego cennika detalicznego.

**fees** `object`

Opłaty, które jedno pobranie krwi dolicza według twojego cennika, w centach. Uwzględnia je miesięczna faktura. Zobacz [Pobierz
cennik](https://docs.anivahealth.com/pl/api/pricing/get-rate-card.md).

**opłaty**

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

Opłata za pobranie krwi za każdą zrealizowaną wizytę.

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

Przekąska dla pacjenta. Naliczana tylko wtedy, gdy pacjent otrzymuje przekąskę. Pomijana, gdy twoi
pacjenci ich nie otrzymują; skontaktuj się z Aniva, aby oferować przekąski.

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

Opłata kurierska za odbiór. Twoje wizyty w tej samej lokalizacji tego samego dnia dzielą jedną
opłatę.

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

Materiały zużywalne: probówki, etykiety, woreczek.

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

`total_cents` plus każda opłata z `fees`, z pełną opłatą logistyczną. Kwota jest niższa, gdy inna
z twoich wizyt dzieli ten sam odbiór.

**positions** `object[]`

Każda pozycja aktywowana w tym koszyku — rozliczana raz, w całości, dostarczająca cały zestaw
swoich elementów. Zawiera `id`, `name`, `price_cents`, `retail_cents` oraz `tier`. Pozycja, która
nie jest widoczna dla partnerów, nadal się aktywuje i rozlicza, a zwracana jest z `id` i `name`
ustawionymi na `null`.

**panels** `object[]`

Każdy dołączony panel, jako `id`, `name`, `price_cents` i `retail_cents`.

**biomarkers** `object[]`

Jeden wiersz na każdy **dostarczony** biomarker — to, co wybierasz, plus składniki dołączone
przez jego wskaźniki oraz elementy dostarczane przez jego pozycje.

**id** `number`

Identyfikator biomarkera.

**name** `string`

Wyświetlana nazwa biomarkera.

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

Ile ten wiersz kosztuje w twoim cenniku, obok `retail_cents`. `0`, gdy pokrywa go pozycja;
`null`, gdy Aniva nie może go wycenić.

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

Wskaźniki, które dołączyły ten składnik do koszyka. Pomijane, gdy żaden tego nie zrobił. Za
składnik płacisz raz na koszyk, niezależnie od tego, ile wskaźników na nim polega.

**requires** `number[]`

Obecne, gdy ten wiersz JEST wskaźnikiem: składniki, jako które jest rozliczany.

**via\_position** `string`

Pozycja pokrywająca ten marker, dlatego wiersz kosztuje `0`. Pomijane, gdy nic go nie pokrywa.
`null`, gdy pokrywająca pozycja nie jest widoczna dla partnerów.

## Odpowiedzi z błędami

| Status | Opis |
| - | - |
| `400` | Nieprawidłowy format ID — podana wartość nie jest poprawnym identyfikatorem UUID. |
| `403` | Brak dostępu — twój klucz API nie ma uprawnień do tej operacji. |
| `404` | Nie znaleziono wizyty. |
| `500` | Wewnętrzny błąd serwera. |

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