> ## 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őpontok

> Így működnek a vérvételi időpontok az Aniva laborvizsgálati API-jában: foglalás, panelek, biomarkerek, állapotváltozások és lemondás.

Az időpont egy páciensprofilhoz ütemezett, fizikai vizsgálati helyszínen, egészségügyi szakember által végzett vérvétel. A páciensnek postázott tesztkészletek nem számítanak időpontnak — lásd: [Otthoni tesztkészlet-rendelések](https://docs.anivahealth.com/hu/concepts/home-kit-orders.md).

## Mezők

**id** `string` *required*

Az Aniva által automatikusan generált UUID. Ezzel adhatsz hozzá paneleket, erősítheted meg a vérvételt, és kérheted le az eredményeket.

**profile\_id** `string` *required*

Annak a profilnak az UUID-je, amelyhez ez az időpont tartozik.

**location\_id** `string`

Annak a vizsgálati helyszínnek az UUID-je, ahol a vérvétel történik. Az otthoni tesztkészletek nem számítanak időpontnak — lásd:
[Otthoni tesztkészlet-rendelések](https://docs.anivahealth.com/hu/concepts/home-kit-orders.md).

**scheduled\_at** `string`

A vérvétel ütemezett időpontja ISO 8601 formátumban. Mindig UTC időpontként, `Z`
utótaggal tér vissza (pl. `2026-04-15T08:30:00Z`). Létrehozáskor és frissítéskor az értéknek **tartalmaznia kell időzóna-jelölést**
(vagy `Z`, vagy explicit eltolás, pl. `+02:00`) — az időzóna nélküli értékeket a rendszer elutasítja. Jövőbeli időpontnak kell lennie,
az Aniva által üzemeltetett helyszíneken pedig legalább 12 órával későbbinek ([minimális
foglalási határidő](https://docs.anivahealth.com/hu/api/appointments/create-appointment.md#minimalis-elofoglalasi-ido)).

**status** `string` *required*

Az aktuális életciklus-állapot. Lehetséges értékei: `pending`, `confirmed`, `blood_drawn` vagy `cancelled`. Lásd az
[Életciklus](#eletciklus) szakaszt alább. A laboreredmények készültségi szintje (`in_progress` vagy `completed`)
az [Eredmények lekérése](https://docs.anivahealth.com/hu/api/appointments/get-results.md) végpontból kérhető le; a szállítmány részletesebb állapotát (úton,
kézbesítve stb.) a beágyazott `shipments` tömb elemeit követve a
[Szállítmány lekérése](https://docs.anivahealth.com/hu/api/shipments/get-shipment.md) végpont adja meg.

**cancellation\_reason** `string`

Az időpont lemondásakor rögzített szabadszöveges ok (pl. meg nem jelenés, késői lemondás,
„Sikertelen. Ismétlés szükséges”). `null`, kivéve, ha a `status` értéke `cancelled`.

**results\_ready\_emails** `string[]` *required*

Címek, amelyek mindegyike egy-egy e-mailt kap, amint minden laboreredmény végleges, kisbetűvel. Kikapcsolva üres. Lásd:
[Eredmények elkészültéről szóló e-mailek](https://docs.anivahealth.com/hu/concepts/results.md#e-mailek-az-elkeszuelt-eredmenyekrol).

**draw\_method** `string` *required*

A vérvétel módja: `capillary` (ujjbegyből vagy felkarból, mikrocsövekbe) vagy `venous` (vénából,
csövekbe). Az időpontnál beállított módszer, ennek hiányában a
[helyszín](https://docs.anivahealth.com/hu/concepts/locations.md) `default_draw_method` értéke. A vérvétel után a ténylegesen használt módszer.

**created\_at** `string` *required*

Az időpont létrehozásának ISO 8601 időbélyege.

**updated\_at** `string`

A legutóbbi frissítés ISO 8601 időbélyege. Null, ha az időpontot még soha nem frissítették.

**lab\_codes** `string[]` *required*

A [Vérvétel megerősítése](https://docs.anivahealth.com/hu/api/appointments/confirm-blood-draw.md) során rögzített laborkódok (csővonalkódok),
a beolvasás sorrendjében. Üres, amíg a vérvételt meg nem erősítették. Vénás vérvételnél minden csőre ugyanaz a kód kerül;
kapilláris vérvételnél minden mikrocső saját kódot kap. Az eredmények és dokumentumok a
`lab_code` mezőn keresztül hivatkoznak ezekre.

**panels** `object[]` *required*

Az időponthoz rendelt panelek `{ panel_id, added_at }` elemekként. Lásd:
[Panelek hozzáadása](#panelek-hozzaadasa).

**individual\_biomarkers** `object[]` *required*

Az időponthoz egyedileg rendelt biomarkerek `{ biomarker_id, added_at }` elemekként. Lásd:
[Egyedi biomarkerek](#egyedi-biomarkerek).

**shipments** `object[]` *required*

Az időponthoz kapcsolt szállítmányok `{ id, added_at }` elemekként, a legrégebbi kapcsolattal kezdve. Lásd:
[Szállítmányok összekapcsolása](#kueldemenyek-oesszekapcsolasa).

**profile** `object` *required*

A páciens teljes profilobjektuma, minden időpontválaszba beágyazva. Az alábbi mezők csak egy
részhalmazt mutatnak. Az [Időpont lekérése](https://docs.anivahealth.com/hu/api/appointments/get-appointment.md) végpont mindegyiket felsorolja.

**tulajdonságok**

**id** `string`

A kapcsolódó profil UUID-je.

**first\_name** `string`

A páciens keresztneve.

**last\_name** `string`

A páciens vezetékneve.

**email** `string`

A páciens e-mail-címe.

**date\_of\_birth** `string`

Születési dátum `YYYY-MM-DD` formátumban.

**sex** `integer`

Biológiai nem az ISO/IEC 5218 szabvány szerint.

## Életciklus

Az időpontoknak négy életciklus-állapotuk van:

```
pending → confirmed → blood_drawn
   │          │             │
   └──────────┴─────────────┴──→ cancelled
```

| Állapot | Jelentés |
| - | - |
| `pending` | Az időpont le van foglalva, és megerősítésre vár. [Frissíthető](https://docs.anivahealth.com/hu/api/appointments/update-appointment.md) vagy [lemondható](https://docs.anivahealth.com/hu/api/appointments/cancel-appointment.md). |
| `confirmed` | A foglalást megerősítették (pl. a rendelő), de a vérvétel még nem történt meg. Még frissíthető vagy lemondható. |
| `blood_drawn` | A laborkódokat beküldték a [Vérvétel megerősítése](https://docs.anivahealth.com/hu/api/appointments/confirm-blood-draw.md) végponton, és elindult a laborrendelési folyamat. A panelek rögzítve vannak, az időpont már nem módosítható és nem mondható le. |
| `cancelled` | Az időpontot lemondták. Végállapot — további állapotváltás nem lehetséges. |

> [!NOTE]
>
> Az időpont állapota szándékosan nagy vonalakban követhető — a részletesebb előrehaladást
> külön végpontok adják meg:
>
> * **Laboreredmények készültsége** →
>   [Eredmények lekérése](https://docs.anivahealth.com/hu/api/appointments/get-results.md) — a legfelső szintű `status` mező értéke `in_progress` vagy
>   `completed`.
> * **Szállítmány előrehaladása** (úton, kézbesítve stb.) → kövesd az időpont beágyazott
>   `shipments` tömbjének elemeit a [Szállítmány lekérése](https://docs.anivahealth.com/hu/api/shipments/get-shipment.md) végponton — minden
>   szállítmány saját `status` mezővel és `status_updates` eseménynaplóval rendelkezik.
>
> Minden állapotváltozás küld egy `appointment.*` [webhookot](https://docs.anivahealth.com/hu/concepts/webhooks.md), például
> `appointment.confirmed`. Új időpont vagy helyszín esetén `appointment.rescheduled` eseményt küld.

> [!WARNING]
>
> Az időpont megerősítése (átállítása `blood_drawn` állapotba) **visszafordíthatatlan**. Amint beküldöd a
> laborkódo(ka)t, elindul a laborrendelési folyamat, amelyet már nem lehet visszavonni. Frissítés és lemondás
> csak akkor engedélyezett, amíg az időpont `pending` vagy `confirmed` állapotban van.

## Időpontok listázása

Kérd le az API-kulcsod számára elérhető összes időpontot:

```
GET /api/v1/appointments
```

Opcionálisan megadhatod a `?profile_id={uuid}` paramétert egy adott profil szerinti szűréshez. E paraméter nélkül az alapértelmezett időablak (az elmúlt 2 hónaptól a következő 1 hónapig) érvényes.

## Időpont frissítése

A vérvétel megerősítése előtt átütemezheted az időpontot, vagy módosíthatod a vizsgálati helyszínt:

```
PATCH /api/v1/appointments/{id}
```

A frissítéshez add meg a `scheduled_at`, `location_id`, `draw_method` és `results_ready_emails` mezők tetszőleges kombinációját. Csak azokat a mezőket add meg, amelyeket módosítani szeretnél.

## Vérvételi mód

Minden időponthoz tartozik egy `draw_method`: `capillary` (ujjbegyből vagy felkarból, mikrocsövekbe) vagy
`venous` (vénából, csövekbe). Ez kizárólag a vérvételre vonatkozik. A vizelet-, kenet- és egyéb,
nem vérminták levétele mindkét módnál ugyanúgy történik.

Alapértelmezés szerint a helyszín `default_draw_method` értékét veszi fel. Létrehozáskor vagy frissítéskor állítsd be a `draw_method` mezőt
másik mód használatához, vagy állítsd `null` értékre a helyszín alapértelmezésének visszaállításához. A helyszínnek szerepeltetnie kell
a módot a `draw_methods` listájában, és a lefoglalt teszteknek elvégezhetőnek kell lenniük vele, különben a kérés
`400` hibával tér vissza. A vérvétel után már nem módosíthatod. A vérvétel után a `draw_method` mező a ténylegesen
használt módot mutatja.

## Profilonként, helyszínenként és időpontonként egy foglalás

Egy profilhoz legfeljebb egy nem lemondott időpont tartozhat `(location_id, scheduled_at)` páronként — egy
személynél nem lehet ugyanott és ugyanabban a pillanatban kétszer vért venni, függetlenül attól, hány párhuzamos foglalást fogad el a
helyszín.

Mind az [Időpont létrehozása](https://docs.anivahealth.com/hu/api/appointments/create-appointment.md), mind az
[Időpont frissítése](https://docs.anivahealth.com/hu/api/appointments/update-appointment.md) végpont kikényszeríti ezt: `409` kóddal és a már létező időpontra mutató
`appointment_id` értékkel tér vissza. Kezeld ezt a választ már lefoglalt időpontként,
ne újrapróbálandó hibaként: kérd le, ütemezd át vagy mondd le a megadott időpontot.

A gyakorlatban ez azt jelenti, hogy az ismételt létrehozások biztonságosak. Egy hálózati időtúllépés
után újraküldött vagy egy felhasználó által kétszer elindított létrehozás két időpont helyett egyetlen
időpontot eredményez – így utólag sosem kell összeegyeztetned ugyanannak a páciensnek a duplikált foglalásait.

> [!NOTE]
>
> A módosítás csak a vérvétel előtt engedélyezett – vagyis amíg az időpont `pending` vagy
> `confirmed` státuszban van. Miután az időpont `blood_drawn` vagy `cancelled` státuszba került, már
> nem módosítható. Az egyetlen kivétel a `results_ready_emails`: ezt önmagában a vérvétel után is
> megváltoztathatod.

## Időpont lemondása

Mondj le egy már nem szükséges időpontot:

```
DELETE /api/v1/appointments/{id}
```

Ez az időpont státuszát `cancelled` értékre állítja. A válasz a lemondott időpontot adja vissza.

Opcionálisan megadhatsz egy `cancellation_reason` mezőt (legfeljebb 500 karakter) a kérés törzsében
az ok rögzítéséhez. Ezt az időpontnál tároljuk, és a későbbi lekérdezések `cancellation_reason` néven adják vissza.

> [!NOTE]
>
> A lemondás csak a vérvétel előtt engedélyezett – vagyis amíg az időpont `pending` vagy
> `confirmed` státuszban van. A már `blood_drawn` státuszba került időpontok nem mondhatók le.

## Panelek hozzáadása

A vérvétel megerősítése előtt add hozzá az elvégzendő vérvizsgálati paneleket ezzel a hívással:

```
POST /api/v1/appointments/{id}/panels
```

Adj meg egy panel-UUID-kból álló tömböt a `panel_ids` mezőben. A panelazonosítókat az Aniva biztosítja a partnerfiókodhoz.

> [!NOTE]
>
> A paneleket a vérvétel előtt kell hozzáadni – vagyis amíg az időpont `pending` vagy `confirmed`
> státuszban van. Miután az időpont `blood_drawn` státuszba került, már nem adhatsz hozzá és nem
> módosíthatsz paneleket.

## Panelek eltávolítása

Ha a vérvétel előtt paneleket kell eltávolítanod, hívd ezt:

```
DELETE /api/v1/appointments/{id}/panels
```

Adj meg egy panel-UUID-kból álló tömböt a `panel_ids` mezőben. Az eltávolítás idempotens: egy nem csatolt panel figyelmen kívül marad.

> [!NOTE]
>
> A panelek hozzáadásához hasonlóan az eltávolítás is csak a vérvétel előtt engedélyezett – vagyis
> amíg az időpont `pending` vagy `confirmed` státuszban van. Miután az időpont `blood_drawn`
> státuszba került, a panelek már nem távolíthatók el.

## Egyedi biomarkerek

Előre összeállított paneleken kívül egyedi biomarkereket is csatolhatsz egy időponthoz, à la carte vizsgálatokként. Ez akkor hasznos, ha a szakember egy előre meghatározott csomag helyett személyre szabott összeállítást szeretne. A csatolt biomarkerek az időpont válaszában az `individual_biomarkers` tömbben jelennek meg (a `panels` mező mellett). Az útválasztási döntéseket a későbbi szakaszban a rendeléslogisztikai folyamat hozza meg az egyes biomarkerek laboratóriumonkénti hozzárendelései alapján.

Biomarkerek hozzáadása (idempotens – a már csatolt biomarkerek megmaradnak):

```
PATCH /api/v1/appointments/{id}/biomarkers
```

Biomarkerek eltávolítása (idempotens – a nem csatolt biomarkerek figyelmen kívül maradnak):

```
DELETE /api/v1/appointments/{id}/biomarkers
```

Mindkét végpont egy `biomarker_ids` tömböt vár, és ellenőrzi az így létrejövő készletet az egyes laboratóriumok zártsági szabályai alapján – egy nem tisztán leadható rendelés (pl. CRP/HDL-arány CRP és HDL nélkül) `400`-as választ ad a hozzáadandó biomarkerekkel együtt, és nem ment el semmit. A biomarker-azonosítók megkereséséhez használd a [Biomarkerek listázása](https://docs.anivahealth.com/hu/api/biomarkers/list-biomarkers.md) végpontot.

> [!NOTE]
>
> A panelek módosításához hasonlóan az egyedi biomarkerek is csak a vérvétel előtt adhatók hozzá
> vagy távolíthatók el – vagyis amíg az időpont `pending` vagy `confirmed` státuszban van. Miután
> az időpont `blood_drawn` státuszba került, az egyedi összeállítás rögzítődik.

## Szükséges mintavevő edények előnézete

Panelek vagy egyedi biomarkerek hozzáadása után tekintsd meg a mintavételhez szükséges fizikai mintavevő edények előnézetét:

```
GET /api/v1/appointments/{id}/preview
```

A válasz `containers` tömbje minden szükséges edényhez tartalmazza a típust, a nevet, a kupak színét, a térfogatot, a gyártói cikkszámot és a darabszámot. Ez segít a szakembereknek a megfelelő eszközök előkészítésében a vérvétel előtt. A válasz tartalmaz egy `pricing` objektumot is – ez az időpont teljes kosár-elszámolása (az aktiválódott tételek, a csatolt panelek, valamint minden teljesített biomarkerhez egy-egy sor a te árlistád szerinti árral és mellette a fogyasztói árral; lásd: [Árazás](https://docs.anivahealth.com/hu/concepts/pricing.md)), amely akkor töltődik ki, ha az időponthoz vannak csatolt vizsgálatok és a kulcsod rendelkezik a `prices_view` scope-pal, különben `null`. A `routing` szándékosan sosem érhető el, és mindig `null`.

> [!NOTE]
>
> Az előnézet az aktuálisan csatolt paneleket és biomarkereket tükrözi. Ha az előnézet után
> paneleket adsz hozzá vagy távolítasz el, hívd meg újra az előnézeti végpontot a frissített
> edényigények lekéréséhez.

## Vérvétel megerősítése

A vérvétel után küldd be a laborkódokat (a csövek vonalkódjait) a laboratóriumi rendelési folyamat elindításához:

```
POST /api/v1/appointments/{id}/confirm
```

Küldd a `lab_code` mezőt, ha ugyanaz a kód van nyomtatva minden csőre (vénás vérvétel), vagy a
`lab_codes` mezőt kódonként egy-egy bejegyzéssel – mindegyikben a hozzá tartozó `panel_ids`
értékekkel –, ha minden panelt saját csövekbe, saját kóddal vesznek le (kapilláris vérvétel).
Ilyenkor minden panel külön laboratóriumi megrendelés a saját kódja alatt. A kódokat az időpont
`lab_codes` mezője adja vissza.

Kapilláris vérvételnél a levett vér mikrotainerekbe kerül. A panelek mennek először, foglalási
sorrendben. Az egyedi biomarkerek ezután a panelek mikrotainereinek szabad helyét töltik ki. Ha több
helyre van szükségük, új mikrotainereket nyitnak. Egyenletesen osztjuk el őket. Egy mikrotainer
legfeljebb 150 µl egyedi biomarkert fogad be. A paneleket vagy biomarkereket módosító hívások
`400`-zal válaszolnak, ha az így létrejövő összeállítás megsérti ezt a szabályt.

Ez az időpont státuszát `blood_drawn` értékre állítja, és elindítja a laboratóriumi feldolgozást. Ez a művelet nem vonható vissza.

## Küldemény felvétele

> [!WARNING]
>
> A `POST /api/v1/appointments/pickup` végpontot **eltávolítottuk**, a `shipment_picked_up`
> időpontstátusszal együtt. Most `405 Method Not Allowed` választ ad, mert az útvonal az
> azonosító szerinti időpont-útvonalra esik át. A végpont az utolsó időszakában már no-op volt,
> amely elfogadta a hívást és nem tett semmit, így az eltávolítása nem változtat meg semmilyen
> működést, amire támaszkodtál.

A vérvétel utáni folyamat nyomon követéséhez kövesd az időpont beágyazott `shipments` tömbjének
elemeit a [Küldemény lekérése](https://docs.anivahealth.com/hu/api/shipments/get-shipment.md) végponton – minden küldemény saját
`status` értékkel és `status_updates` előzményekkel rendelkezik.

## Küldemények összekapcsolása

Egy időpont egy vagy több küldeményhez kapcsolható (és fordítva – a kapcsolat több a többhöz
típusú). Az aktuális kapcsolatok mindkét oldalon beágyazva jelennek meg:

* az időponton `{ id, added_at }` elemekből álló `shipments` tömbként;
* a küldeményen `{ id, added_at }` elemekből álló `appointments` tömbként.

Mindkét tömbben a legrégebbi kapcsolat áll elöl. Minden `id` a kanonikus részletező végpontra
([Küldemény lekérése](https://docs.anivahealth.com/hu/api/shipments/get-shipment.md) /
[Időpont lekérése](https://docs.anivahealth.com/hu/api/appointments/get-appointment.md)) hivatkozik a teljes adattartalomhoz.

A küldeményeket létrehozáskor a [Küldemény létrehozása](https://docs.anivahealth.com/hu/api/shipments/create-shipment.md) végpont
`appointment_id` mezőjével kapcsolhatod össze. Létrehozás után a kapcsolatokat a küldemény oldaláról
kezelheted az [Időpontok csatolása küldeményhez](https://docs.anivahealth.com/hu/api/shipments/attach-appointments-to-shipment.md) és az
[Időpontok leválasztása küldeményről](https://docs.anivahealth.com/hu/api/shipments/detach-appointments-from-shipment.md) végpontokkal;
mindkettő az adott küldemény módosítás utáni időpontlistáját adja vissza. Egy időpont csomagjainak
teljes lekéréséhez használd a [Küldemények listázása](https://docs.anivahealth.com/hu/api/shipments/list-shipments.md) végpontot a
`?appointment_id=` paraméterrel.

A módosítási szabály: kapcsolatok akkor hozhatók létre vagy távolíthatók el, ha VAGY

* az időpont túl van a vérvételen (`blood_drawn`), vagy
* a küldemény kevesebb mint 24 órája jött létre.

Ezen az időablakon kívül a kapcsolat zárolva van, így az előzményadatok stabilak maradnak.

## Laboreredmények lekérése

Miután a laboratórium feldolgozta a vérmintákat, kérd le a klinikai és genetikai eredményeket:

```
GET /api/v1/appointments/{id}/results
```

A válasz a beérkezett eredmények mellett a tervezett teszteket (`planned` státusszal) is tartalmazza, így nyomon
követheted, mi van még függőben. A legfelső szintű `status` mező értéke `in_progress`, amíg az összes beküldés
le nem zárul, utána pedig `completed` (vagy `fault`, ha egyikről sem érkezett jelentés) — ebből állapíthatod meg,
hogy elkészült-e az időponthoz tartozó laboratóriumi munka. Egy `appointment.results.completed` [webhook](https://docs.anivahealth.com/hu/concepts/webhooks.md)
értesít, amikor ez megtörténik, így nincs szükség ismételt lekérdezésre. A
`submissions` tömb ezt laboratóriumi igénylésenként bontja le, mindegyiket a saját `lab_code` kódjával. Minden
beérkezett eredmény és dokumentum tartalmazza azt a `lab_code` kódot, amely alatt iktatták. A PDF laborjelentésekre
a `documents` tömb hivatkozik — a letöltésükhöz használd a `GET /api/v1/documents/{id}` végpontot.

## Példa időpontra

```json theme={null}
{
  "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "profile_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "location_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
  "scheduled_at": "2026-04-15T08:30:00Z",
  "status": "confirmed",
  "cancellation_reason": null,
  "results_ready_emails": [],
  "draw_method": "venous",
  "created_at": "2026-04-01T10:00:00Z",
  "updated_at": null,
  "profile": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "handle": null,
    "first_name": "Jane",
    "last_name": "Doe",
    "email": "jane.doe@example.com",
    "phone": "+4930123456789",
    "sex": 2,
    "date_of_birth": "1990-06-15",
    "height": 170,
    "weight": 62,
    "language": "en",
    "transactional_emails_enabled": true,
    "created_at": "2026-04-01T09:55:00Z",
    "updated_at": null
  },
  "panels": [
    {
      "panel_id": "f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d",
      "added_at": "2026-04-01T10:05:00Z"
    }
  ],
  "individual_biomarkers": [
    {
      "biomarker_id": 42,
      "added_at": "2026-04-01T10:07:00Z"
    }
  ],
  "shipments": [
    {
      "id": "P2611194821",
      "added_at": "2026-04-15T07:00:00Z"
    }
  ],
  "lab_codes": []
}
```


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