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

# Náhled termínu

> Zobrazit náhled zkumavek a vyúčtování termínu

Vrací, co termín potřebuje pro přidané panely a biomarkery. Nic se neobjednává.

* `containers`: zkumavky, odběrové kartičky nebo kelímky, které zdravotník připraví.
* `pricing`: vyúčtování podle tvého ceníku. [Nacenit košík](https://docs.anivahealth.com/cs/api/pricing/quote-cart.md) vrací stejné
  vyúčtování bez termínu.
* `routing`: vždy `null`.

Vyžaduje jedno z oprávnění `appointments_view`, `appointments_schedule`, `appointments_operate` nebo `appointments_manage`.

## Požadavek

### Parametry cesty

**id** `string` *required*

Jedinečný identifikátor (UUID) termínu, pro který chceš zobrazit náhled požadavků na odběrové nádoby.

## Odpověď

Při úspěchu API vrátí `200 OK` s požadavky na odběrové nádoby a poli vyhrazenými pro budoucí použití.

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

Pole požadovaných odběrových nádob. Je prázdné, když k termínu nejsou přidané žádné panely ani biomarkery. Je prázdné také tehdy, když ještě nelze určit místo a den termínu, například když nemá naplánovaný čas.

**odběrová nádoba**

**type** `string`

Identifikátor typu odběrové nádoby. Jedna z hodnot `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` nebo `trace_metal`.

**name** `string`

Čitelný název nádoby (např. Serum, EDTA, Li-Heparin).

**cap\_color** `string`

Hex kód barvy víčka nádoby pro zobrazení (např. `"#A0784B"`). `null`, když
nádoba nemá víčko.

**volume** `string`

Objem nádoby (např. `"7.5 ml"`). `null`, pokud se objem nepoužije.

**article\_number** `string`

Katalogové číslo výrobce (REF), pokud je známé (např. `"01.1602.001"`). Vynecháno u nádob bez přiřazeného katalogového čísla.

**count** `integer`

Požadovaný počet nádob tohoto typu.

**routing** `null`

Podrobnosti směrování do laboratoře – záměrně nejsou zpřístupněné, vždy `null`.

**pricing** `object | null`

Celkové vyúčtování košíku pro termín podle tvého ceníku. `null`, když termín nemá přiřazené
žádné testy nebo když tvému klíči chybí oprávnění `prices_view`. [Ceny](https://docs.anivahealth.com/cs/concepts/pricing.md) vysvětlují
model; jednotlivé částky se řídí referencí [cenových
objektů](https://docs.anivahealth.com/cs/api/biomarkers/list-biomarkers.md#cenove-objekty).

**Pole vyúčtování**

**total\_cents** `integer`

Kolik košík stojí podle tvého ceníku: součet naceněných položek, naceněných panelů a naceněných
řádků biomarkerů. Řádek s `price_cents: null` nic nepřidává, takže košík s takovým řádkem má nižší součet,
než kolik bude stát.

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

Stejná celková částka podle doporučeného maloobchodního ceníku.

**fees** `object`

Poplatky, které jeden odběr krve podle tvého ceníku přidává, v centech. Účtují se na měsíční faktuře. Viz [Získat
ceník](https://docs.anivahealth.com/cs/api/pricing/get-rate-card.md).

**poplatky**

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

Poplatek za odběr krve za dokončený termín.

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

Občerstvení pro pacienta. Účtuje se jen tehdy, když pacient občerstvení dostane. Vynecháno, když ho tvoji
pacienti nedostávají; pokud chceš občerstvení nabízet, kontaktuj Aniva.

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

Kurýrní poplatek za vyzvednutí. Tvé termíny na stejném odběrovém místě ve stejný den sdílejí jeden
poplatek.

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

Spotřební materiál: zkumavky, štítky, sáček.

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

`total_cents` plus každý poplatek v `fees`, včetně plného poplatku za logistiku. Částka je nižší,
když se o svoz dělí další z tvých termínů.

**positions** `object[]`

Každá pozice uplatněná v tomto košíku — účtuje se jednou, v plné výši, a dodává celou svou sadu
položek. Obsahuje `id`, `name`, `price_cents`, `retail_cents` a `tier`. Pozice, která není
určená pro partnery, se stále uplatní i vyúčtuje a vrací se s `id` a `name` nastavenými na
`null`.

**panels** `object[]`

Každý připojený panel s poli `id`, `name`, `price_cents` a `retail_cents`.

**biomarkers** `object[]`

Jeden řádek pro každý **dodaný** biomarker — to, o co žádáš, plus složky vyžádané poměry a
položky dodané pozicemi.

**id** `number`

Identifikátor biomarkeru.

**name** `string`

Zobrazovaný název biomarkeru.

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

Kolik tento řádek stojí na tvé kartě, vedle něj je `retail_cents`. `0`, když ho hradí pozice;
`null`, když ho Aniva nedokáže nacenit.

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

Poměry, které tuto složku vtáhly do košíku. Vynecháno, pokud žádný. Složka se v košíku platí
jednou bez ohledu na to, kolik poměrů ji vyžaduje.

**requires** `number[]`

Přítomno, když tento řádek JE poměr: složky, jako které se účtuje.

**via\_position** `string`

Pozice, která tento marker hradí, proto řádek stojí `0`. Vynecháno, pokud ho nic nepokrývá.
`null`, když kryjící pozice není určená pro partnery.

## Chybové odpovědi

| Stav | Popis |
| - | - |
| `400` | Neplatný formát ID — zadaná hodnota není platné UUID. |
| `403` | Zakázáno — tvůj API klíč nemá přístup k této operaci. |
| `404` | Termín nebyl nalezen. |
| `500` | Interní chyba serveru. |

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