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

# Időpont előnézete

> Egy időpont csöveinek és számlájának előnézete

Visszaadja, mire van szüksége egy időpontnak a hozzá tartozó panelekhez és biomarkerekhez. Semmit nem rendel meg.

* `containers`: a csövek, kártyák vagy poharak, amelyeket a szakember előkészít.
* `pricing`: a számla az árlistád szerint. A [Kosár árajánlata](https://docs.anivahealth.com/hu/api/pricing/quote-cart.md) ugyanezt a
  számlát adja vissza időpont nélkül.
* `routing`: mindig `null`.

Az `appointments_view`, `appointments_schedule`, `appointments_operate` vagy `appointments_manage` hatókörök egyikét igényli.

## Kérés

### Útvonalparaméterek

**id** `string` *required*

Annak az időpontnak az egyedi azonosítója (UUID), amelynek a tárolóigényét előnézetben lekéred.

## Válasz

Siker esetén az API `200 OK` választ ad vissza a tárolóigényekkel és a jövőbeli használatra fenntartott mezőkkel.

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

A szükséges mintavételi tárolók tömbje. Üres, ha még nem adtak hozzá paneleket vagy biomarkereket az időponthoz. Akkor is üres, ha az időpont helyszíni napja még nem állapítható meg, például ha még nincs megadva az ütemezett idő.

**tároló**

**type** `string`

Tárolótípus-azonosító. Lehetséges értékei: `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` vagy `trace_metal`.

**name** `string`

Ember által olvasható tárolónév (pl. Serum, EDTA, Li-Heparin).

**cap\_color** `string`

A tároló kupakjának hexadecimális színkódja megjelenítéshez (pl. `"#A0784B"`). `null`, ha a
tárolónak nincs kupakja.

**volume** `string`

A tároló űrtartalma (pl. `"7.5 ml"`). `null`, ahol az űrtartalom nem értelmezhető.

**article\_number** `string`

Gyártói katalógusszám (REF), ha ismert (pl. `"01.1602.001"`). Kimarad azoknál a tárolóknál, amelyekhez nincs hozzárendelt cikkszám.

**count** `integer`

Az ebből a típusból szükséges tárolók száma.

**routing** `null`

Laboratóriumi irányítási adatok — szándékosan nincsenek megosztva, mindig `null`.

**pricing** `object | null`

Az időpont teljes kosarára vonatkozó számla az árlistád szerint. `null`, ha az időponthoz nincsenek hozzárendelt
vizsgálatok, vagy ha a kulcsod nem rendelkezik a `prices_view` hatókörrel. Az [Árazás](https://docs.anivahealth.com/hu/concepts/pricing.md) elmagyarázza a
modellt; az egyes összegek az [árobjektumok](https://docs.anivahealth.com/hu/api/biomarkers/list-biomarkers.md#arobjektumok) leírását követik.

**Számlamezők**

**total\_cents** `integer`

Mennyibe kerül a kosár az árlistád szerint: az árazott tételek, plusz az árazott panelek, plusz az árazott
biomarkersorok. A `price_cents: null` értékű sor nem ad hozzá semmit, így egy ilyet tartalmazó kosár végösszege kevesebb,
mint amennyibe valójában kerülni fog.

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

Ugyanez a végösszeg az ajánlott fogyasztói árlista szerint.

**fees** `object`

Azok a díjak, amelyeket egy vérvétel hozzáad az árlistád szerint, centben. Ezeket a havi számla tartalmazza. Lásd: [Árlista lekérése](https://docs.anivahealth.com/hu/api/pricing/get-rate-card.md).

**díjak**

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

Vérvételi díj teljesített időpontonként.

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

Harapnivaló a páciensnek. Csak akkor számlázzuk ki, ha a páciens kap harapnivalót. Kimarad, ha a
pácienseid nem kapnak; vedd fel a kapcsolatot az Anivával, ha szeretnél harapnivalót kínálni.

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

Futárdíj az elszállításért. Az azonos napon, azonos helyszínen lévő időpontjaid egyetlen
díjon osztoznak.

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

Fogyóeszközök: csövek, címkék, tasak.

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

A `total_cents` plusz a `fees` minden díja, a teljes logisztikai díjjal. Kevesebb, ha egy másik
időpontod osztozik az elszállításon.

**positions** `object[]`

Minden tétel, amely aktiválódott ebben a kosárban — egyszer, teljes összegben számlázódik, és a
teljes tagkészletét biztosítja. Tartalmazza az `id`, `name`, `price_cents`, `retail_cents` és
`tier` mezőket. A partnerek számára nem látható tétel is aktiválódik és számlázódik, `id` és
`name` értéke pedig `null`.

**panels** `object[]`

Minden csatolt panel, `id`, `name`, `price_cents` és `retail_cents` mezőkkel.

**biomarkers** `object[]`

Egy sor minden **biztosított** biomarkerhez — amit kértél, plusz az arányai által behúzott
összetevők és a tételei által biztosított tagok.

**id** `number`

Biomarker-azonosító.

**name** `string`

A biomarker megjelenített neve.

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

Ennek a sornak az ára a kártyádon, mellette a `retail_cents` értékével. `0`, ha egy tétel
fedezi; `null`, ha az Aniva nem tudja beárazni.

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

Azok az arányok, amelyek ezt az összetevőt behúzták a kosárba. Kimarad, ha egy sem. Egy
összetevőt kosaranként egyszer fizetsz meg, függetlenül attól, hány arány épít rá.

**requires** `number[]`

Akkor szerepel, ha ez a sor MAGA egy arány: azok az összetevők, amelyekként számlázódik.

**via\_position** `string`

A markert fedező tétel, ami miatt a sor ára `0`. Kimarad, ha semmi nem fedezi. `null`, ha a
fedező tétel nem látható a partnerek számára.

## Hibaválaszok

| Státusz | Leírás |
| - | - |
| `400` | Érvénytelen azonosítóformátum — a megadott érték nem érvényes UUID. |
| `403` | Tiltott — az API-kulcsodnak nincs hozzáférése ehhez a művelethez. |
| `404` | Az időpont nem található. |
| `500` | Belső szerverhiba. |

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