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

# Potvrdit odběr krve

> Návod krok za krokem: zaznamenej odběr krve v Aniva API a odešli vzorek do zpracování laboratorních objednávek.

Podle tohoto návodu potvrdíš, že odběr krve proběhl. Potvrzení zaznamená laboratorní kódy (čárové kódy zkumavek) fyzické sady a spustí proces laboratorní objednávky; stav výsledků pak načteš přes [Získat výsledky](https://docs.anivahealth.com/cs/api/appointments/get-results.md).

> [!WARNING]
>
> Potvrzení je **nevratné**. Jakmile odběr krve potvrdíš, v termínu už nebudou možné žádné další úpravy —
> včetně přidání panelů. Než budeš pokračovat, ujisti se, že jsou připojené všechny panely a
> všechny údaje jsou správně.

**1. Zkontroluj přidané panely**

Před potvrzením zkontroluj, že jsou k termínu přidané všechny potřebné testovací panely. Po potvrzení už panely přidat nemůžeš.

Postup, jak panely připojit, najdeš v návodu [Naplánovat termín](https://docs.anivahealth.com/cs/guides/schedule-appointment.md).

Než budeš pokračovat, ověř následující:

* K termínu jsou připojené všechny potřebné panely.
* `profile_id` a `location_id` u termínu jsou správné.
* Pacient má odběr krve za sebou a čárový kód každé zkumavky je po ruce.

**2. Potvrď odběr krve**

Pošli `POST` požadavek na `/api/v1/appointments/{id}/confirm` s laboratorními kódy z fyzické sady pro odběr krve. Žilní odběr má jeden kód vytištěný na každé zkumavce — pošli ho jako `lab_code`. Odběr v lékárně má jeden kód na každou mikrozkumavku — pošli je jako `lab_codes`, jednu položku pro každý kód spolu s `panel_ids`, které daná mikrozkumavka obsahuje (z `panels` daného termínu); z každého kódu vznikne samostatná laboratorní žádanka. Jednotlivé biomarkery v lékárně nejprve zaplní volné místo v mikrozkumavkách pro panely. Za každou mikrozkumavku, kterou potřebují samostatně, pošli jednu položku bez `panel_ids`.

> [!WARNING]
>
> Každý kód musí být číselný řetězec vytištěný na fyzické zkumavce předané pacientovi. Nenahrazuj ho jiným identifikátorem — nesprávný kód způsobí selhání laboratorní objednávky. Každý kód se ověří před jakýmkoli zápisem; pokud se některý zamítne, nic se neuloží.

```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();
```

Úspěšný požadavek vrátí `200 OK`:

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

**3. Ověř stav termínu**

Po potvrzení načti termín a ověř, že se jeho stav změnil na `blood_drawn`.

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

Jakmile termín zobrazuje `status: "blood_drawn"`, spustil se proces laboratorní objednávky. Samotný stav termínu od této chvíle zůstává `blood_drawn`; podrobnější další průběh najdeš na vyhrazených endpointech: každou položku ve vloženém poli `shipments` sleduj přes [Získat zásilku](https://docs.anivahealth.com/cs/api/shipments/get-shipment.md) pro události kurýra na cestě / doručeno a použij [Získat výsledky](https://docs.anivahealth.com/cs/api/appointments/get-results.md) pro dokončení laboratorních výsledků (`status: "in_progress"` → `"completed"`).

## Co se děje dál

Po potvrzení vše přebírá proces laboratorní objednávky Aniva:

1. Každý laboratorní kód se v laboratoři spáruje se svými fyzickými zkumavkami — žádanka každého panelu nese kód z jeho vlastních zkumavek.
2. Panely připojené k termínu určují, které testy se provedou.
3. Jakmile jsou výsledky připravené, přiřadí se k profilu pacienta a objeví se
   v [Získat výsledky](https://docs.anivahealth.com/cs/api/appointments/get-results.md) — pole `status` na nejvyšší úrovni odpovědi se přepne
   z `in_progress` na `completed`, jakmile se všechna podání uzavřou a jedno dodá výsledky.

Po potvrzení už z tvé integrace není potřeba žádná další akce.

## Zpracování chyb

| Stav | Příčina | Řešení |
| - | - | - |
| `400 Bad Request` | Chybí obě pole `lab_code` / `lab_codes` nebo jsou zadána obě, kód není číselný, nebo se kód či panel opakuje. | Pošli přesně jedno z nich s přesnými číselnými kódy z fyzických zkumavek. |
| `409 Conflict` | Kód nelze použít (už je přiřazený, neregistrovaný, patří k domácí testovací sadě, jiná klinika), panel nemá kód, nebo termín nelze potvrdit. | Přečti si `reason` a `lab_code`; naskenuj jinou zkumavku nebo zkontroluj stav termínu. |
| `403 Forbidden` | Tvůj API klíč nemá přístup k této operaci. | Kontaktuj Aniva a ověř oprávnění svého API klíče. |
| `404 Not Found` | ID termínu neexistuje nebo nepatří k tvému účtu. | Ověř, že je ID termínu správné. |


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