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

# Objednávky domácích testovacích sad

> Jak v Aniva API fungují objednávky domácích testovacích sad: objednání sady poštou, doprava, odeslání vzorku zpět a laboratorní výsledky.

**Objednávka domácí testovací sady** pošle pacientovi poštou testovací sadu pro domácí samoodběr. Aniva sadu odešle, pacient si doma sám odebere vzorek a pošle ho poštou zpět. Tím se liší od [termínu](https://docs.anivahealth.com/cs/concepts/appointments.md), což je žilní odběr krve prováděný zdravotníkem na fyzickém odběrovém místě.

> [!NOTE]
>
> Endpointy pro objednávky domácích testovacích sad vyžadují scope `home_kit_orders_view` (čtení)
> nebo `home_kit_orders_manage` (zápis). [Aktivovat](https://docs.anivahealth.com/cs/api/home-kit-orders/activate-home-kit.md)
> přijímá i užší scope `home_kit_orders_activate`. [Načíst výsledky](https://docs.anivahealth.com/cs/api/home-kit-orders/get-results.md)
> a [Odeslat výsledky e-mailem](https://docs.anivahealth.com/cs/api/home-kit-orders/email-results.md) navíc vyžadují `results_view`
> — laboratorní výsledky a dokumenty jsou jím vždy podmíněné.

## Pole

**id** `string` *required*

UUID, které Aniva automaticky vygeneruje. Použij ho k aktualizaci objednávky, změně panelu,
aktivaci, zrušení i k načtení výsledků.

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

UUID profilu, ke kterému tato objednávka domácí testovací sady patří.

**status** `string` *required*

Aktuální stav životního cyklu. Jedna z hodnot `pending`, `dispatched`, `activated` nebo
`cancelled`. Viz [Životní cyklus](#zivotni-cyklus) níže. Podrobnější stav dokončení laboratorních
výsledků (`in_progress` vs. `completed`) zjistíš z endpointu
[Načíst výsledky](https://docs.anivahealth.com/cs/api/home-kit-orders/get-results.md).

**delivery\_address** `object` *required*

Adresa pro doručení sady — v jednom ze dvou tvarů: buď `{location_id}` s odkazem na známé
odběrové místo, nebo pole přímé adresy (`name`, `street`, `city`, `postal_code`,
`country_code`; `company_name` / `house_number` / `address_line_2` / `state` / `phone` / `email`
jsou volitelná — stejná pole jako v API pro místa). Uveď přesně jednu variantu — odkaz na místo,
nebo přímou adresu, ne obojí.

**doručovací adresa**

> [tab] Odkaz na místo
>
> **location\_id** `string` *required*
>
> UUID odběrového místa, kam se sada odesílá.

> [tab] Přímá adresa
>
> **name** `string` *required*
>
> Jméno příjemce, název firmy nebo místa.
>
> **company\_name** `string`
>
> Firma, která zásilku převezme pro příjemce — kontaktní subjekt `c/o` nebo oddělení.
>
> **street** `string` *required*
>
> Název ulice bez čísla domu (např. `Wilhelmstraße`).
>
> **house\_number** `string`
>
> Číslo domu (např. `118` nebo `12a`).
>
> **address\_line\_2** `string`
>
> Budova, vchod nebo patro.
>
> **city** `string` *required*
>
> **state** `string`
>
> Stát nebo provincie. Volitelné.
>
> **postal\_code** `string` *required*
>
> **country\_code** `string` *required*
>
> Kód ISO 3166-1 alpha-2 (dvě písmena, např. `DE`).
>
> **phone** `string`
>
> Telefonní číslo příjemce. Dostane ho dopravce, aby mohl příjemce informovat o zásilce.
>
> **email** `string`
>
> E-mail příjemce. Dostane ho dopravce, aby mohl příjemce informovat o zásilce.

> [!NOTE]
>
> **Packstation nebo Postfiliale (pouze Německo):** do `street` zadej `Packstation` nebo
> `Postfiliale`, do `house_number` trojmístné číslo stanice nebo pobočky a do `address_line_2`
> číslo DHL Postnummer příjemce (6–10 číslic, mezery jsou povolené). Bez čísla Postnummer nelze
> zásilku objednat. Postfach není podporován.

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

Časové razítko ve formátu ISO 8601, kdy byla objednávka domácí testovací sady vytvořena.

**updated\_at** `string`

Časové razítko poslední aktualizace ve formátu ISO 8601. Hodnota null, pokud objednávka domácí
testovací sady ještě nebyla aktualizována.

**profile** `object`

Úplný objekt profilu pacienta, vložený v každé odpovědi objednávky domácí testovací sady.

**vlastnosti**

**id** `string`

UUID přiřazeného profilu.

**handle** `string`

Identifikátor profilu nebo uživatelské jméno. Může být `null`.

**first\_name** `string`

Křestní jméno pacienta. Může být `null`.

**last\_name** `string`

Příjmení pacienta. Může být `null`.

**email** `string`

E-mailová adresa pacienta. Může být `null`.

**phone** `string`

Telefonní číslo ve formátu E.164. Může být `null`.

**sex** `integer`

Biologické pohlaví podle ISO/IEC 5218. Může být `null`.

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

Datum narození ve formátu `YYYY-MM-DD`. Může být `null`.

**height** `number`

Výška v centimetrech. Může být `null`.

**weight** `number`

Hmotnost v kilogramech. Může být `null`.

**language** `string`

Preferovaný jazyk: jeden z 32 kódů uvedených u [Vytvořit profil](https://docs.anivahealth.com/cs/api/profiles/create-profile.md).

**transactional\_emails\_enabled** `boolean`

Zda tento profil přijímá transakční (automatické) e-maily. Může být `null`.

**created\_at** `string`

Časové razítko vytvoření profilu ve formátu ISO 8601.

**updated\_at** `string`

Časové razítko poslední aktualizace profilu ve formátu ISO 8601. Může být `null`.

**panels** `object[]`

Panel připojený k objednávce domácí testovací sady — vždy přesně jedna položka
`{ panel_id, added_at }`, protože domácí testovací sada odpovídá fyzickému produktu v poměru 1:1.
Hodnotu `panel_id` porovnej s endpointem [Vypsat panely](https://docs.anivahealth.com/cs/api/panels/list-panels.md).

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

Biomarkery přidané k objednávce domácí testovací sady mimo její panel. Každá položka má tvar
`{ biomarker_id, added_at }`. Každé `biomarker_id` porovnej s endpointem
[Vypsat biomarkery](https://docs.anivahealth.com/cs/api/biomarkers/list-biomarkers.md) s parametrem `home_kit=true`. U běžné objednávky jde o jednotlivé testy
nad rámec panelu; u [náhradní sady](#nahradni-sady) jde o testy, které laboratoř
opakuje.

**replaces\_home\_kit\_order\_id** `string`

Objednávka domácí testovací sady, kterou tato nahrazuje, pokud jde o
[náhradní sadu](#nahradni-sady). U běžné objednávky má hodnotu `null`.

**replacement\_reason** `string`

Důvod odeslání náhradní sady v jedné větě. U běžné objednávky má hodnotu `null`.

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

Adresy malými písmeny, na které přijde po jednom e-mailu, jakmile jsou všechny laboratorní
výsledky konečné. Pole je vždy přítomné — když je vypnuté, je prázdné. Nastavíš ho přes
[Vytvořit](https://docs.anivahealth.com/cs/api/home-kit-orders/create-home-kit.md) nebo
[Aktualizovat](https://docs.anivahealth.com/cs/api/home-kit-orders/update-home-kit.md). Viz
[E-maily o připravených výsledcích](https://docs.anivahealth.com/cs/concepts/results.md#e-maily-o-pripravenych-vysledcich).

**metadata** `object`

Tvé vlastní páry klíč/hodnota, které se vracejí beze změny a Aniva je nijak neinterpretuje. Při
čtení je pole vždy přítomné — pokud nic nenastavíš, obsahuje `{}`. Maximálně 20 klíčů; klíče
odpovídají `[A-Za-z0-9_-]` a mají nejvýše 40 znaků; hodnoty jsou řetězec, číslo nebo boolean,
přičemž řetězce mohou mít nejvýše 500 znaků; celkem 16 384 bajtů po serializaci. Klíče
začínající na `aniva_` jsou vyhrazené. Při volání
[Aktualizovat](https://docs.anivahealth.com/cs/api/home-kit-orders/update-home-kit.md) se metadata **slučují**: vynechané klíče
zůstávají, klíč poslaný s hodnotou `null` se smaže a `{}` vymaže vše. Validace probíhá stylem
vše, nebo nic. Nikdy do `metadata` nevkládej osobní ani klinické údaje — nezpracovávají se jako
data pacienta.

**lab\_code** `string`

Laboratorní kód vzorku. Jeden kód, tři role: pod tímto kódem se hlásí laboratorní výsledky, je
vytištěný na fyzické sadě a pacient ho opíše z krabičky jako aktivační kód. Přidělí se při
balení sady — dokud je objednávka ve stavu `pending`, má hodnotu `null`, s výjimkou situace, kdy
Aniva sadu odešle znovu (viz [Životní cyklus](#zivotni-cyklus)). Vždy jen pro čtení. Objednávku k
fyzické sadě dohledáš pomocí `GET /api/v1/home-kit-orders?lab_code=…`.

**activated\_at** `string`

Časové razítko odběru nahlášené přes [Aktivovat](https://docs.anivahealth.com/cs/api/home-kit-orders/activate-home-kit.md) — tedy
okamžik v UTC, kdy si pacient vzorek skutečně odebral. Dokud není sada aktivovaná, má hodnotu
`null`. Tento čas odběru se uvádí v laboratorní zprávě.

**shipments** `object[]`

Zásilky navázané na tuto objednávku, seřazené od nejstarší vazby, každá ve tvaru
`{ id, added_at }` — sada na cestě k pacientovi a u sad se sledovanou zpětnou cestou také vzorek
na cestě zpět do laboratoře, přičemž se objeví v okamžiku vytištění štítků. Dokud je objednávka
ve stavu `pending`, je pole prázdné, kromě případu, kdy Aniva sadu odešle znovu. Úplné údaje o
zásilkách načteš jedním voláním `GET /api/v1/shipments?home_kit_order_id={id}` — viz
[Zásilky](https://docs.anivahealth.com/cs/concepts/shipments.md).

## Životní cyklus

Objednávky domácích testovacích sad mají čtyři stavy životního cyklu:

```
pending → dispatched → activated
   │          │
   │          ├──→ pending    (Aniva re-ships a lost kit)
   │          └──→ cancelled  (Aniva: the box came back undelivered)
   │
   └──→ cancelled
```

| Stav | Význam |
| - | - |
| `pending` | Objednávka byla vytvořena, ale sada ještě nebyla zabalena. Lze ji [upravit](https://docs.anivahealth.com/cs/api/home-kit-orders/update-home-kit.md) (adresa, výměna panelu, metadata) nebo [zrušit](https://docs.anivahealth.com/cs/api/home-kit-orders/cancel-home-kit.md). |
| `dispatched` | Sada je zabalená a má štítek — je na cestě k pacientovi (nebo už u něj). Její panel a složení biomarkerů jsou teď **uzamčené** a objednávku už nemůžeš [zrušit](https://docs.anivahealth.com/cs/api/home-kit-orders/cancel-home-kit.md). Aniva ji ale stále může přesunout: zpět do `pending`, když se sada ztratí a Aniva pošle novou, nebo do `cancelled`, když se balíček vrátí jako nedoručený a znovu se neposílá. |
| `activated` | Pacient odebral vzorek a bylo to nahlášeno přes [Aktivovat](https://docs.anivahealth.com/cs/api/home-kit-orders/activate-home-kit.md) s časem odběru. Laboratorní objednávka je zadána pod `lab_code` sady. Koncový stav — obdoba `blood_drawn` u termínu. |
| `cancelled` | Objednávka domácí testovací sady byla zrušena: tebou ze stavu `pending`, nebo ji zrušila Aniva ze stavu `dispatched`, když se balíček vrátil nedoručený. Koncový stav — žádné další přechody a opakované zrušení nic nezmění a jen vrátí objednávku. |

Když Aniva znovu posílá ztracenou sadu, objednávka se vrátí do stavu `pending`, ale zachová si svůj `lab_code` i
dřívější balíčky v `shipments`. Nová sada má stejný kód. Do nového balíčku se vloží
nepoužitý zpětný štítek. Tyto dva přechody provádí pouze Aniva; API je nenabízí. Každý přechod odešle
[webhook](https://docs.anivahealth.com/cs/concepts/webhooks.md) `home_kit_order.pending` nebo `home_kit_order.cancelled`.

> [!NOTE]
>
> Stavy objednávky domácí testovací sady jsou záměrně obecné. Průběh doručení k pacientovi a zpět
> se sleduje na [zásilkách](https://docs.anivahealth.com/cs/concepts/shipments.md) objednávky — `dispatched` znamená, že sada
> má štítek a laboratorní kód, ne že už vyrazila; to ukazuje `status` odchozí
> zásilky. Zpracování laboratorních výsledků probíhá na podáních. Dokončení výsledků (`in_progress` vs.
> `completed`) najdeš přes [Získat výsledky](https://docs.anivahealth.com/cs/api/home-kit-orders/get-results.md) — pole `status` na nejvyšší
> úrovni je `in_progress`, dokud se neuzavřou všechna podání, potom `completed` — nebo `fault`, když
> všechna podání selhala bez výsledku.

## Sledování balíčků

```
GET /api/v1/shipments?home_kit_order_id={id}
```

Co se vrátí, závisí na sadě. Jakmile Aniva zabalí krevní sadu, vzniknou dvě zásilky:
balíček od Aniva k pacientovi a balíček od pacienta
do laboratoře (jeho `destination` je laboratoř), spárované přes `paired_with`.
Zpětný balíček zůstává ve stavu `pending` — už se známým sledovacím číslem — dokud ho pacient
neodešle. Sada pro střevní mikrobiom má jen jednu zásilku: sadu k pacientovi. Její zpětná obálka je
předplacená a nesledovaná, takže se pro cestu zpět nic neobjednává. Pole `booked_by` říká, kdo
objednal štítek: `"aniva"` nebo `"external"`. Tady lze měnit jen balíček `"aniva"`, a jakmile
je štítek vytištěný, tak pouze jeho `notes`. Každý balíček nese kompletní `status_updates` dopravce,
včetně DHL kódu `detail_code` pro přesměrování na poštu.

Pole `home_kit_orders` na zásilce vypisuje jen objednávky v rámci tvého přístupu. Viz
[Přístup](https://docs.anivahealth.com/cs/concepts/shipments.md#pristup).

> [!WARNING]
>
> Složení objednávky domácí testovací sady můžeš měnit jen ve stavu `pending`. Jakmile je objednávka
> `dispatched` (nebo dál — `activated`/`cancelled`), výměna panelu i endpointy `/biomarkers`
> vrátí `409 Conflict`: fyzická sada je zabalená podle zvoleného panelu, takže její obsah je
> uzamčený ve chvíli, kdy míří k pacientovi. Pokud potřebuješ změnit testy u už uzamčené
> objednávky, kontaktuj přímo Aniva — většinou to ještě jde a změnu uděláme za
> tebe, aby obsah sady zůstal v souladu. Pokud už byla sada použitá a
> nemohla dodat výsledky, objednej místo toho [náhradní sadu](#nahradni-sady).

## Výpis objednávek domácích testovacích sad

Načti všechny objednávky domácích testovacích sad dostupné pro tvůj API klíč:

```
GET /api/v1/home-kit-orders
```

Volitelně předej `?profile_id={uuid}` pro filtrování podle konkrétního profilu, nebo `?lab_code={code}` pro
dohledání objednávky podle fyzické sady v ruce — přirozený první krok při aktivaci.

## Vytvoření objednávky domácí testovací sady

Zadej objednávku domácí testovací sady pro profil pacienta:

```
POST /api/v1/home-kit-orders
```

Předej `profile_id`, `delivery_address` a jedno `panel_id`. Objednávka se vytvoří ve stavu `pending`.

Předej volitelnou hlavičku `Idempotency-Key`, aby opakovaný požadavek neobjednal druhou sadu — viz [Idempotence](https://docs.anivahealth.com/cs/concepts/idempotency.md).

Přesně jeden panel, protože domácí testovací sada odpovídá 1:1 fyzickému produktu — panel je samotná sada. Objednat lze jen panely, které Aniva nastavila jako domácí testovací sady; jakýkoli jiný panel vrátí `422`. Při vytvoření je povinný, protože objednávka jde hned do balicí fronty a balení může začít okamžitě. Dokud je objednávka ve stavu `pending`, můžeš panel vyměnit přes [Upravit](https://docs.anivahealth.com/cs/api/home-kit-orders/update-home-kit.md).

Pokud posíláš druhou sadu za tu, ze které nešlo získat výsledky, předej místo výběru panelu `replaces_home_kit_order_id` — viz [Náhradní sady](#nahradni-sady).

## Náhradní sady

Někdy ze sady nelze získat výsledky: pacient nedokázal naplnit zkumavku, vzorek dorazil s příliš malým množstvím materiálu, nebo laboratoř nemohla část z něj analyzovat. Objednej za ni **náhradu**:

```
POST /api/v1/home-kit-orders
{
  "profile_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "delivery_address": { "...": "..." },
  "replaces_home_kit_order_id": "d1e2f3a4-5b6c-4d7e-8f9a-0b1c2d3e4f5a",
  "replacement_reason": "Too little material, HbA1c could not be analysed",
  "biomarker_ids": [103]
}
```

Náhrada je **nová objednávka s novým laboratorním kódem**, i když první sada nikdy nebyla aktivovaná: laboratoř potřebuje novou žádanku a dva vzorky pod jedním kódem od sebe nelze rozlišit. Obě objednávky zůstávají čitelné a jsou propojené přes `replaces_home_kit_order_id`.

**Nahrazovaná objednávka zůstává nedotčená.** Zachová si svůj stav, laboratorní kód i všechny výsledky už k ní přiřazené, takže pacient, který první sadu přece jen odešle, dostane vše, co z ní laboratoř dokáže vyčíst.

**Panel se dědí.** Vynech `panel_id` a náhrada převezme panel nahrazované objednávky — to je to, co si pacient koupil a jak je označená krabička. Jiný panel pošli jen při náhradě celého panelu; kombinace panelu a podmnožiny markerů se zamítne s `422`, protože podmnožina dává smysl jen v rámci panelu, ze kterého byla vybrána. Panel náhradní objednávky pak už nelze ani později vyměnit.

**Vybereš si, co se zopakuje.** Pošli `biomarker_ids` s markery, které selhaly, a laboratoř zopakuje jen ty, takže sada dorazí jen se zkumavkami, které jsou pro ně potřeba. Když pole vynecháš, zopakuje se celý panel — správná volba, když se nepodařilo analyzovat vůbec nic. Nevyžaduje to žádný extra scope: opakování markerů, za které pacient už zaplatil, není výběr à la carte. Tyto markery pak už nejde odebrat, protože tvoří celou žádanku.

> [!NOTE]
>
> Markery se opakují po **skupinách** panelu, ne po jednom. Uvedením jednoho markeru ze skupiny se
> zopakuje celá skupina, protože nelze zadat laboratorní objednávku, která vrátí víc, než bylo
> objednáno. Náhrada pro jediný marker se proto může vrátit s více než jedním výsledkem a
> počet zkumavek může být vyšší, než naznačuje seznam markerů.

Pro jednu sadu může být na cestě vždy jen jedna náhrada — dokud je náhrada ve stavu `pending` nebo `dispatched`, druhé vytvoření pro stejnou objednávku vrátí `409` s jejím uvedením. Výsledky dorazí pod vlastním `lab_code` náhrady, přes její vlastní [Získat výsledky](https://docs.anivahealth.com/cs/api/home-kit-orders/get-results.md).

Náhrada není řešení pro balíček, který nikdy nedorazil. Místo toho kontaktuj Aniva: jde o opětovné odeslání stejné objednávky pod stejným laboratorním kódem, ne o novou.

## Úprava objednávky domácí testovací sady

Změň doručovací adresu, vyměň panel, uprav svá metadata nebo nahraď e-maily pro oznámení o výsledcích:

```
PATCH /api/v1/home-kit-orders/{id}
```

Uveď jen pole, která chceš změnit. Pole `panel_id` **nahradí** připojený panel — při přesně jednom panelu na sadu je výměna jediná smysluplná operace s panelem, proto neexistují endpointy pro přidání nebo odebrání panelu. Adresu a panel lze měnit jen ve stavu `pending`; pole `metadata` zůstává zapisovatelné po celou dobu života objednávky. Pole `results_ready_emails` zůstává zapisovatelné, dokud není objednávka ve stavu `cancelled`.

## Zrušení objednávky domácí testovací sady

Zruš objednávku domácí testovací sady, která už není potřeba:

```
DELETE /api/v1/home-kit-orders/{id}
```

Tím se nastaví stav objednávky domácí testovací sady na `cancelled`. V odpovědi se vrátí zrušená objednávka domácí testovací sady.

Zrušit lze jen objednávku ve stavu `pending`. Od stavu `dispatched` dál je sada zabalená a má štítek — automatické stažení neexistuje — a volání vrátí `409`. Pokud potřebuješ zastavit už odeslanou sadu, kontaktuj přímo Aniva.

Zrušení objednávky ve stavu `pending`, jejíž sada už byla objednána u expedice, ji zruší i tam a volání uspěje jen tehdy, když to expedice přijme:

* `409` — sada už byla zabalená a opatřená štítkem, takže ji nelze stáhnout zpět, i když objednávka stále ukazuje `pending`.
* `502` — expedice zrušení odmítla (chyba obsahuje její důvod) nebo nebyla dostupná. **Nic se nezměnilo** — objednávka stále platí a můžeš ji zkusit zrušit znovu.

Zrušení, které vrátí chybu, nechá objednávku přesně tak, jak byla, takže `200` je jediné potvrzení, že žádná sada nepřijde.

Zrušení objednávky, která už je ve stavu `cancelled`, vrátí stejnou odpověď `200`, bez ohledu na to, z jakého stavu byla zrušena.

## Aktivace objednávky domácí testovací sady

Jakmile pacient odebere vzorek, nahlas to:

```
POST /api/v1/home-kit-orders/{id}/activate
```

Předej `activated_at` — okamžik, kdy pacient vzorek skutečně odebral, jako časový údaj v UTC. Tento čas odběru bude uvedený v laboratorní zprávě, proto pošli skutečný okamžik odběru, ne čas svého zpracování. Aktivace je nevratná: objednávka přejde do stavu `activated` a už ji nelze zrušit ani změnit. Jde o obdobu [Potvrdit odběr krve](https://docs.anivahealth.com/cs/api/appointments/confirm-blood-draw.md) pro domácí testovací sady, ale bez čárového kódu — kód sady se přikládá při balení, takže ho nikdy nepotřebuješ znát. Objednávka v tu chvíli už musí mít svůj `lab_code`; bez něj vrátí `409`.

Aktivace zároveň zadá laboratorní objednávku: panel sady se objedná v laboratoři pod jejím `lab_code`, takže laboratoř vrácený vzorek očekává a výsledky se k němu přiřadí, jakmile je nahlásí. Probíhá to až po odeslání odpovědi a případný problém na straně laboratoře řeší Aniva, nepropisuje se do tvého požadavku.

## Jednotlivé biomarkery

K objednávce domácí testovací sady můžeš přidat jednotlivé biomarkery jako testy à la carte mimo panel. Hodí se to, když chceš k sadě výběr na míru. Přidané biomarkery se v odpovědi objednávky domácí testovací sady zobrazí jako pole `individual_biomarkers` (na stejné úrovni jako `panels`).

Oba endpointy pro biomarkery vyžadují kromě `home_kit_orders_manage` i scope `home_kit_orders_individual_biomarker_selection` — domácí testovací sady se objednávají po panelech, takže jednotlivé markery se povolují pro každého partnera zvlášť. Pokud to tvoje integrace potřebuje, obrať se na Aniva.

Přidej biomarkery (idempotentní – už připojené biomarkery zůstanou):

```
PATCH /api/v1/home-kit-orders/{id}/biomarkers
```

Odeber biomarkery (idempotentní — nepřiřazené ID se ignoruje):

```
DELETE /api/v1/home-kit-orders/{id}/biomarkers
```

Oba endpointy přijímají pole `biomarker_ids`. ID biomarkerů zjistíš přes [Vypsat biomarkery](https://docs.anivahealth.com/cs/api/biomarkers/list-biomarkers.md) s `home_kit=true`. Biomarkery můžeš měnit jen dokud je sada ve stavu `pending` (viz [Životní cyklus](#zivotni-cyklus)).

## Načtení laboratorních výsledků

Jakmile laboratoř zpracuje vrácený vzorek, načti klinické a genetické výsledky:

```
GET /api/v1/home-kit-orders/{id}/results
```

Odpověď obsahuje plánované testy (stav `planned`) spolu s již doručenými výsledky, takže můžeš sledovat, na co se ještě čeká. Výsledky se přiřazují pod `lab_code` objednávky a chodí marker po markeru, jak je laboratoř postupně analyzuje, takže částečné payloady jsou normální. Pole `status` na nejvyšší úrovni má až do konečné zprávy hodnotu `in_progress`, potom `completed` (nebo `fault`, pokud všechny laboratorní objednávky selhaly bez výsledků) — podle něj poznáš, jestli je laboratorní zpracování objednávky domácí testovací sady hotové. Když k tomu dojde, upozorní tě [webhook](https://docs.anivahealth.com/cs/concepts/webhooks.md) `home_kit_order.results.completed`, takže se nemusíš pravidelně dotazovat. Odkazy na PDF s laboratorními zprávami najdeš v poli `documents` — stáhneš je pomocí `GET /api/v1/documents/{id}`.

## Příklad objednávky domácí testovací sady

```json theme={null}
{
  "id": "d1e2f3a4-5b6c-4d7e-8f9a-0b1c2d3e4f5a",
  "profile_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "dispatched",
  "delivery_address": {
    "name": "Jane Doe",
    "street": "Friedrichstraße",
    "house_number": "123",
    "postal_code": "10117",
    "city": "Berlin",
    "country_code": "DE",
    "phone": "+4930123456789",
    "email": "jane.doe@example.com"
  },
  "created_at": "2026-04-01T10:00:00Z",
  "updated_at": "2026-04-02T08:00:00Z",
  "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": "de",
    "transactional_emails_enabled": true,
    "created_at": "2026-04-01T09:30: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"
    }
  ],
  "metadata": { "your_order_ref": "ORD-10482" },
  "replaces_home_kit_order_id": null,
  "replacement_reason": null,
  "results_ready_emails": [],
  "lab_code": "7642000123",
  "activated_at": null,
  "shipments": [
    { "id": "K2604021FQ7", "added_at": "2026-04-02T08:00:00Z" },
    { "id": "K260402P3XD", "added_at": "2026-04-02T08:00:00Z" }
  ]
}
```


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