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

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

> Lépésről lépésre útmutató: rögzíts vérvételt az Aniva API-ban, és küldd el a mintát a laborrendelési folyamatba.

Ezzel az útmutatóval erősítheted meg, hogy a vérvétel megtörtént. A megerősítés rögzíti a fizikai készlet laborkódjait (a csövek vonalkódjait), és elindítja a laborrendelési folyamatot; az eredmények előrehaladását ezután az [Eredmények lekérése](https://docs.anivahealth.com/hu/api/appointments/get-results.md) végpontból olvashatod ki.

> [!WARNING]
>
> A megerősítés **visszafordíthatatlan**. Miután megerősítesz egy vérvételt, az időponton már nem
> végezhető további módosítás – panelek hozzáadása sem. Folytatás előtt győződj meg róla, hogy minden
> panel hozzá van rendelve, és minden adat helyes.

**1. Panelek hozzáadásának ellenőrzése**

Megerősítés előtt ellenőrizd, hogy minden szükséges vizsgálati panel hozzá van-e adva az időponthoz. A megerősítés után már nem tudsz paneleket hozzáadni.

A panelek hozzárendeléséről az [Időpont foglalása](https://docs.anivahealth.com/hu/guides/schedule-appointment.md) útmutatóban találsz leírást.

Folytatás előtt ellenőrizd a következőket:

* Minden szükséges panel hozzá van rendelve az időponthoz.
* Az időpont `profile_id` és `location_id` értéke helyes.
* A páciens vérvétele megtörtént, és minden cső vonalkódja kéznél van.

**2. Vérvétel megerősítése**

Küldj egy `POST` kérést a `/api/v1/appointments/{id}/confirm` végpontra a fizikai vérvételi készlet laborkódjaival. Vénás vérvétel esetén egyetlen kód van nyomtatva minden csőre – ezt `lab_code` mezőként küldd el. Gyógyszertári vérvétel esetén mikrocsövenként külön kód szerepel – ezeket `lab_codes` mezőként küldd el, kódonként egy elemmel és a mikrocsőhöz tartozó `panel_ids` értékekkel (az időpont `panels` mezőjéből); minden kódból külön laboratóriumi vizsgálatkérés készül. A gyógyszertárban az egyedi biomarkerek először a panelek mikrocsöveinek szabad helyét töltik ki. Küldj egy `panel_ids` nélküli elemet minden olyan mikrocsőhöz, amelyre önállóan szükségük van.

> [!WARNING]
>
> Minden kódnak a páciensnek átadott fizikai csőre nyomtatott, számokból álló karakterláncnak kell lennie. Ne helyettesítsd más azonosítóval – a hibás kód miatt a laborrendelés sikertelen lesz. A rendszer minden kódot ellenőriz, mielőtt bármit kiírna; ha egyet elutasít, semmi nem rögzül.

```bash cURL (venous draw, one code) theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12/confirm \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "lab_code": "7642001234"
  }'
```

```bash cURL (pharmacy draw, one code per panel) theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12/confirm \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "lab_codes": [
      { "lab_code": "7642001234", "panel_ids": ["f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d"] },
      { "lab_code": "7642001235", "panel_ids": ["0a9b8c7d-6e5f-4a3b-2c1d-0e9f8a7b6c5d"] }
    ]
  }'
```

```javascript JavaScript theme={null}
const response = await fetch(
  'https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12/confirm',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY',
    },
    body: JSON.stringify({
      lab_codes: [
        { lab_code: '7642001234', panel_ids: ['f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d'] },
        { lab_code: '7642001235', panel_ids: ['0a9b8c7d-6e5f-4a3b-2c1d-0e9f8a7b6c5d'] },
      ],
    }),
  }
);

const result = await response.json();
```

A sikeres kérés `200 OK` válasszal tér vissza:

```json theme={null}
{
  "success": true
}
```

**3. Időpont állapotának ellenőrzése**

A megerősítés után kérd le az időpontot, és ellenőrizd, hogy az állapota `blood_drawn` értékre változott-e.

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12 \
  --header 'x-api-key: YOUR_API_KEY'
```

```javascript JavaScript theme={null}
const response = await fetch(
  'https://anivahealth.com/api/v1/appointments/c9d4e827-3b6f-4a1c-8d2e-5f0b9c7e3a12',
  {
    headers: {
      'x-api-key': 'YOUR_API_KEY',
    },
  }
);

const appointment = await response.json();
console.log(appointment.status); // "blood_drawn"
```

Amint az időpontnál a `status: "blood_drawn"` jelenik meg, a laborrendelési folyamat elindult. Maga az időpont állapota innentől `blood_drawn` marad; a további, részletesebb előrehaladás külön végpontokon érhető el: a beágyazott `shipments` tömb minden elemét kövesd a [Szállítmány lekérése](https://docs.anivahealth.com/hu/api/shipments/get-shipment.md) végponton a futár úton lévő / kézbesített eseményeihez, a laboreredmények elkészüléséhez (`status: "in_progress"` → `"completed"`) pedig használd az [Eredmények lekérése](https://docs.anivahealth.com/hu/api/appointments/get-results.md) végpontot.

## Mi történik ezután

A megerősítés után az Aniva laborrendelési folyamata veszi át a munkát:

1. A laborban minden laborkódot párosítanak a hozzá tartozó fizikai csövekkel – minden panel vizsgálatkérése a saját csövein lévő kódot viseli.
2. Az időponthoz rendelt panelek határozzák meg, mely vizsgálatokat végzik el.
3. Amikor az eredmények elkészülnek, a páciens profiljához kapcsolódnak, és megjelennek az
   [Eredmények lekérése](https://docs.anivahealth.com/hu/api/appointments/get-results.md) végpontban – a válasz legfelső szintű `status` mezője
   `in_progress` értékről `completed` értékre vált, amint minden beküldés lezárult, és legalább egyből érkezett eredmény.

A megerősítés után az integrációdnak nincs további teendője.

## Hibakezelés

| Státusz | Ok | Megoldás |
| - | - | - |
| `400 Bad Request` | A `lab_code` és a `lab_codes` közül egyik sincs vagy mindkettő meg van adva, egy kód nem numerikus, vagy egy kód vagy panel ismétlődik. | Küldd el a kettő közül pontosan az egyiket, a fizikai kémcsöveken szereplő pontos numerikus kódokkal. |
| `409 Conflict` | Egy kód nem használható (már hozzá van rendelve, nincs regisztrálva, otthoni tesztkészlethez tartozik, rossz klinika), egy panelhez nincs kód, vagy az időpont nem erősíthető meg. | Nézd meg a `reason` és a `lab_code` mezőt; olvass be egy másik kémcsövet, vagy ellenőrizd az időpont státuszát. |
| `403 Forbidden` | Az API-kulcsodnak nincs jogosultsága ehhez a művelethez. | Vedd fel a kapcsolatot az Anivával az API-kulcsod jogosultságainak ellenőrzéséhez. |
| `404 Not Found` | Az időpont-azonosító nem létezik, vagy nem a fiókodhoz tartozik. | Ellenőrizd, hogy az időpont-azonosító helyes-e. |


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