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

# Mājas testa komplektu pasūtījumi

> Kā darbojas mājas testa komplektu pasūtījumi Aniva API: pa pastu sūtāma komplekta pasūtīšana, piegāde, parauga nosūtīšana atpakaļ un laboratorijas rezultāti.

**Mājas testa komplekta pasūtījums** nosūta pacientam pa pastu mājās lietojamu testa komplektu. Aniva izsūta komplektu, pacients pats mājās paņem paraugu un nosūta to atpakaļ pa pastu. Tas atšķiras no [pieraksta](https://docs.anivahealth.com/lv/concepts/appointments.md), kas ir venozo asiņu paņemšana fiziskā testēšanas vietā, ko veic veselības aprūpes speciālists.

> [!NOTE]
>
> Mājas testa komplekta pasūtījumu galapunktiem nepieciešams `home_kit_orders_view` (lasīšana) vai
> `home_kit_orders_manage` (rakstīšana) piekļuves apjoms.
> [Aktivizēt](https://docs.anivahealth.com/lv/api/home-kit-orders/activate-home-kit.md) pieņem arī šaurāko
> `home_kit_orders_activate` piekļuves apjomu.
> [Iegūt rezultātus](https://docs.anivahealth.com/lv/api/home-kit-orders/get-results.md) un
> [Nosūtīt rezultātus e-pastā](https://docs.anivahealth.com/lv/api/home-kit-orders/email-results.md) papildus prasa `results_view` —
> laboratorijas rezultāti un dokumenti vienmēr ir aizsargāti ar to.

## Lauki

**id** `string` *required*

Aniva automātiski ģenerēts UUID. Izmanto to, lai atjauninātu pasūtījumu, nomainītu tā paneli,
aktivizētu to, atceltu to un iegūtu rezultātus.

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

Profila UUID, kuram pieder šis mājas testa komplekta pasūtījums.

**status** `string` *required*

Pašreizējais dzīves cikla statuss. Viens no: `pending`, `dispatched`, `activated` vai
`cancelled`. Skati sadaļu [Dzīves cikls](#dzives-cikls) zemāk. Detalizēts laboratorijas rezultātu
izpildes statuss (`in_progress` pret `completed`) tiek iegūts no
[Iegūt rezultātus](https://docs.anivahealth.com/lv/api/home-kit-orders/get-results.md).

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

Adrese, uz kuru nosūtīt komplektu — viens no diviem variantiem: vai nu `{location_id}`, kas
atsaucas uz zināmu testēšanas vietu, vai tiešie adreses lauki (`name`, `street`, `city`,
`postal_code`, `country_code`; `company_name` / `house_number` / `address_line_2` / `state` /
`phone` / `email` ir neobligāti — tie paši nosaukumi kā atrašanās vietu API). Norādi tieši vienu
— atsauci uz atrašanās vietu vai tiešo adresi, nevis abus.

**piegādes adrese**

> [tab] Atsauce uz atrašanās vietu
>
> **location\_id** `string` *required*
>
> Testēšanas vietas UUID, uz kuru tiek nosūtīts komplekts.

> [tab] Tiešā adrese
>
> **name** `string` *required*
>
> Saņēmēja, uzņēmuma vai atrašanās vietas nosaukums.
>
> **company\_name** `string`
>
> Uzņēmums, kas pieņem sūtījumu saņēmēja vārdā — `c/o` persona vai nodaļa.
>
> **street** `string` *required*
>
> Ielas nosaukums bez mājas numura (piem., `Wilhelmstraße`).
>
> **house\_number** `string`
>
> Mājas numurs (piem., `118` vai `12a`).
>
> **address\_line\_2** `string`
>
> Ēka, kāpņutelpa vai stāvs.
>
> **city** `string` *required*
>
> **state** `string`
>
> Štats vai province. Neobligāts.
>
> **postal\_code** `string` *required*
>
> **country\_code** `string` *required*
>
> ISO 3166-1 alpha-2 kods (divi burti, piem., `DE`).
>
> **phone** `string`
>
> Saņēmēja tālruņa numurs. Pārvadātājs to saņem, lai informētu saņēmēju par sūtījumu.
>
> **email** `string`
>
> Saņēmēja e-pasts. Pārvadātājs to saņem, lai informētu saņēmēju par sūtījumu.

> [!NOTE]
>
> **Packstation vai Postfiliale (tikai Vācijā):** laukā `street` norādi `Packstation` vai
> `Postfiliale`, laukā `house_number` — trīsciparu stacijas numuru, bet laukā `address_line_2` —
> saņēmēja DHL Postnummer (6–10 cipari, atstarpes atļautas). Bez Postnummer sūtījumu nevar
> noformēt. Postfach netiek atbalstīts.

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

ISO 8601 laikspiedols, kad tika izveidots mājas testa komplekta pasūtījums.

**updated\_at** `string`

Pēdējās atjaunināšanas ISO 8601 laika zīmogs. Null, ja mājas testa komplekta pasūtījums nekad
nav ticis atjaunināts.

**profile** `object`

Pilns pacienta profila objekts, kas iekļauts katrā mājas testa komplekta pasūtījuma atbildē.

**īpašības**

**id** `string`

Saistītā profila UUID.

**handle** `string`

Profila segvārds vai lietotājvārds. Var būt `null`.

**first\_name** `string`

Pacienta vārds. Var būt `null`.

**last\_name** `string`

Pacienta uzvārds. Var būt `null`.

**email** `string`

Pacienta e-pasta adrese. Var būt `null`.

**phone** `string`

Tālruņa numurs E.164 formātā. Var būt `null`.

**sex** `integer`

Bioloģiskais dzimums saskaņā ar ISO/IEC 5218. Var būt `null`.

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

Dzimšanas datums formātā `YYYY-MM-DD`. Var būt `null`.

**height** `number`

Augums centimetros. Var būt `null`.

**weight** `number`

Svars kilogramos. Var būt `null`.

**language** `string`

Vēlamā valoda: viens no 32 kodiem sadaļā [Izveidot profilu](https://docs.anivahealth.com/lv/api/profiles/create-profile.md).

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

Vai šis profils saņem darījumu (automātiskos) e-pastus. Var būt `null`.

**created\_at** `string`

Profila izveides ISO 8601 laika zīmogs.

**updated\_at** `string`

Pēdējās profila atjaunināšanas ISO 8601 laika zīmogs. Var būt `null`.

**panels** `object[]`

Mājas testa komplekta pasūtījumam piesaistītais panelis — vienmēr tieši viens ieraksts
`{ panel_id, added_at }`, jo mājas testa komplekts atbilst 1:1 fiziskam komplekta produktam.
Salīdzini `panel_id` ar [Paneļu sarakstu](https://docs.anivahealth.com/lv/api/panels/list-panels.md).

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

Biomarķieri, kas piesaistīti mājas testa komplekta pasūtījumam ārpus tā paneļa. Katrs ieraksts ir
`{ biomarker_id, added_at }`. Salīdzini katru `biomarker_id` ar
[Biomarķieru sarakstu](https://docs.anivahealth.com/lv/api/biomarkers/list-biomarkers.md), norādot `home_kit=true`. Parastā
pasūtījumā tie ir atsevišķi pievienoti testi papildus panelim;
[aizstāšanas komplektā](#aizvietosanas-komplekti) tie ir testi, ko laboratorija veic atkārtoti.

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

Mājas testa komplekta pasūtījums, ko šis aizstāj, ja tas ir
[aizstāšanas komplekts](#aizvietosanas-komplekti). Parastam pasūtījumam vērtība ir `null`.

**replacement\_reason** `string`

Kāpēc tika nosūtīts aizstāšanas komplekts — vienā teikumā. Parastam pasūtījumam vērtība ir
`null`.

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

Adreses mazajiem burtiem — katra saņem vienu e-pastu, tiklīdz visi laboratorijas rezultāti ir
galīgi. Vienmēr ir iekļauts — tukšs, kad izslēgts. Iestati to pieprasījumā
[Izveidot](https://docs.anivahealth.com/lv/api/home-kit-orders/create-home-kit.md) vai
[Atjaunināt](https://docs.anivahealth.com/lv/api/home-kit-orders/update-home-kit.md). Skati
[E-pasti par gataviem rezultātiem](https://docs.anivahealth.com/lv/concepts/results.md#e-pasti-par-gataviem-rezultatiem).

**metadata** `object`

Tavi atslēgas/vērtības pāri, kas tiek atgriezti bez izmaiņām un kurus Aniva nekad neinterpretē.
Vienmēr iekļauts lasīšanas atbildē — `{}`, ja neesi iestatījis nevienu. Ne vairāk kā 20 atslēgas;
atslēgas atbilst `[A-Za-z0-9_-]` un ir ne garākas par 40 rakstzīmēm; vērtības ir virkne, skaitlis
vai būla vērtība, virknēm nepārsniedzot 500 rakstzīmes; kopā līdz 16 384 baitiem serializētā
veidā. Atslēgas, kas sākas ar `aniva_`, ir rezervētas. Pieprasījumā
[Atjaunināt](https://docs.anivahealth.com/lv/api/home-kit-orders/update-home-kit.md) metadati tiek **apvienoti**: izlaistās atslēgas
saglabājas, atslēga ar vērtību `null` tiek dzēsta, bet `{}` notīra visu. Validācija darbojas pēc
principa viss vai nekas. Nekad neievieto personas vai klīniskos datus laukā `metadata` — tie
netiek apstrādāti kā pacienta dati.

**lab\_code** `string`

Laboratorijas parauga kods. Viens kods, trīs lomas: ar to tiek iesniegti laboratorijas rezultāti,
tas ir uzdrukāts uz fiziskā komplekta, un pacients to nolasa no kastītes kā aktivizācijas kodu.
Piešķirts, kad komplekts tiek iepakots — `null`, kamēr pasūtījuma statuss ir `pending`, izņemot
pēc tam, kad Aniva atkārtoti izsūta komplektu (skati [Dzīves cikls](#dzives-cikls)). Vienmēr tikai
lasāms. Atrodi pasūtījumu pēc rokās esošā komplekta ar `GET /api/v1/home-kit-orders?lab_code=…`.

**activated\_at** `string`

Parauga paņemšanas laika zīmogs, kas paziņots ar [Aktivizēt](https://docs.anivahealth.com/lv/api/home-kit-orders/activate-home-kit.md)
— brīdis UTC laikā, kad pacients faktiski paņēma paraugu. `null`, līdz komplekts tiek aktivizēts.
Šis ir parauga paņemšanas laiks, kas tiek norādīts laboratorijas pārskatā.

**shipments** `object[]`

Ar šo pasūtījumu saistītie sūtījumi, sākot ar vissenāk piesaistīto, katrs formātā
`{ id, added_at }` — komplekts ceļā pie pacienta un, komplektiem ar izsekojamu atpakaļceļu,
paraugs ceļā atpakaļ uz laboratoriju, parādoties brīdī, kad tiek izdrukātas uzlīmes. Tukšs, kamēr
pasūtījuma statuss ir `pending`, izņemot pēc tam, kad Aniva atkārtoti izsūta komplektu. Iegūsti
pilnus sūtījumu datus vienā pieprasījumā ar `GET /api/v1/shipments?home_kit_order_id={id}` — skati
[Sūtījumi](https://docs.anivahealth.com/lv/concepts/shipments.md).

## Dzīves cikls

Mājas testa komplekta pasūtījumiem ir četri dzīves cikla stāvokļi:

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

| Statuss | Nozīme |
| - | - |
| `pending` | Pasūtījums ir izveidots, bet komplekts vēl nav iepakots. To var [atjaunināt](https://docs.anivahealth.com/lv/api/home-kit-orders/update-home-kit.md) (adrese, paneļa maiņa, metadati) vai [atcelt](https://docs.anivahealth.com/lv/api/home-kit-orders/cancel-home-kit.md). |
| `dispatched` | Komplekts ir iepakots un marķēts — tas ir ceļā pie pacienta (vai jau pie viņa). Tā paneļa un biomarķieru sastāvs tagad ir **slēgts**, un tu to vairs nevari [atcelt](https://docs.anivahealth.com/lv/api/home-kit-orders/cancel-home-kit.md). Aniva joprojām var mainīt tā statusu: atpakaļ uz `pending`, ja komplekts ir nozaudēts un Aniva nosūta jaunu, vai uz `cancelled`, ja sūtījums atgriežas nepiegādāts un netiek nosūtīts atkārtoti. |
| `activated` | Pacients ir paņēmis paraugu, un par to ir paziņots, izmantojot [Aktivizēt](https://docs.anivahealth.com/lv/api/home-kit-orders/activate-home-kit.md) ar parauga paņemšanas laika zīmogu. Laboratorijas pasūtījums tiek veikts ar komplekta `lab_code`. Galastāvoklis — analoģisks `blood_drawn` pierakstam. |
| `cancelled` | Mājas testa komplekta pasūtījums ir atcelts: tu to atcēli no `pending` vai Aniva to atcēla no `dispatched`, kad sūtījums atgriezās nepiegādāts. Galastāvoklis — tālāku pāreju nav, un atkārtota atcelšana neveic izmaiņas, bet atgriež pasūtījumu. |

Kad Aniva atkārtoti nosūta nozaudētu komplektu, pasūtījums atgriežas statusā `pending`, bet saglabā savu `lab_code` un
iepriekšējās pakas laukā `shipments`. Jaunajam komplektam ir tas pats kods. Jaunajā kastē tiek ielikta
neizmantota atgriešanas uzlīme. Tikai Aniva veic šīs divas pārejas; API tās nepiedāvā. Katra pāreja nosūta
`home_kit_order.pending` vai `home_kit_order.cancelled` [webhook paziņojumu](https://docs.anivahealth.com/lv/concepts/webhooks.md).

> [!NOTE]
>
> Mājas testa komplekta pasūtījuma statusu sistēma apzināti ir vispārīga. Piegādes gaita pie pacienta un
> no viņa tiek izsekota pasūtījuma [sūtījumos](https://docs.anivahealth.com/lv/concepts/shipments.md) — `dispatched` nozīmē, ka komplektam
> ir uzlīme un laboratorijas kods, nevis ka tas jau ir ceļā; to, vai tā ir, rāda izejošā sūtījuma `status`.
> Laboratorijas rezultātu apstrāde notiek iesniegumos. Laboratorijas rezultātu gatavība (`in_progress` vai
> `completed`) ir pieejama ar [Iegūt rezultātus](https://docs.anivahealth.com/lv/api/home-kit-orders/get-results.md) — augšējā līmeņa
> lauks `status` ir `in_progress`, līdz visi iesniegumi ir noslēgti, tad `completed` — vai `fault`, ja
> visi iesniegumi beidzās bez rezultātu iesniegšanas.

## Paku izsekošana

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

Tas, kas tiek atgriezts, ir atkarīgs no komplekta. Asins analīžu komplekts, tiklīdz Aniva to ir iepakojusi,
sastāv no diviem sūtījumiem: paka no Aniva pacientam un paka no
pacienta laboratorijai (tās `destination` ir laboratorija), kas savienotas ar `paired_with`. Atgriešanas
paka paliek statusā `pending` — ar jau zināmu izsekošanas numuru —, līdz pacients to
nosūta. Zarnu mikrobioma komplekts sastāv no viena sūtījuma: komplekts pacientam. Tā atgriešanas aploksne ir
priekšapmaksāta un netiek izsekota, tāpēc atpakaļceļam nekas netiek rezervēts. `booked_by` norāda, kas rezervēja
uzlīmi: `"aniva"` vai `"external"`. Šeit var mainīt tikai `"aniva"` paku, un pēc uzlīmes izdrukāšanas — tikai tās
`notes`. Katrai pakai ir pievienoti pilni pārvadātāja `status_updates`,
tostarp DHL `detail_code` novirzīšanai uz pasta nodaļu.

`home_kit_orders` sūtījumā uzskaita tikai tos pasūtījumus, kas ir tavā piekļuves kontekstā. Skatīt
[Piekļuve](https://docs.anivahealth.com/lv/concepts/shipments.md#piekluve).

> [!WARNING]
>
> Mājas testa komplekta pasūtījuma sastāvu var mainīt tikai tad, kad tas ir statusā `pending`. Tiklīdz pasūtījums ir
> `dispatched` (vai vēlāk — `activated`/`cancelled`), paneļa maiņa un `/biomarkers` galapunkti
> atgriež `409 Conflict`: fiziskais komplekts tiek iepakots atbilstoši izvēlētajam panelim, tāpēc tā saturs ir
> fiksēts brīdī, kad tas dodas pie pacienta. Ja tev tomēr jāmaina analīzes pasūtījumā, kas
> jau ir slēgts, sazinies ar Aniva tieši — parasti tas vēl ir iespējams, un mēs veiksim
> izmaiņas tavā vietā, lai komplekta saturs paliktu saskaņots. Ja komplekts jau ir izmantots un nevarēja
> sniegt rezultātus, tā vietā pasūti [aizstāšanas komplektu](#aizvietosanas-komplekti).

## Mājas testa komplektu pasūtījumu saraksts

Iegūsti visus mājas testa komplektu pasūtījumus, kas pieejami tavai API atslēgai:

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

Pēc izvēles padod `?profile_id={uuid}`, lai filtrētu pēc konkrēta profila, vai `?lab_code={code}`, lai
rokās esošu fizisku komplektu sasaistītu ar tā pasūtījumu — tas ir loģisks pirmais solis aktivizēšanas plūsmā.

## Mājas testa komplekta pasūtījuma izveide

Pieprasi mājas testa komplekta pasūtījumu pacienta profilam:

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

Padod `profile_id`, `delivery_address` un vienu `panel_id`. Pasūtījums tiek izveidots statusā `pending`.

Pēc izvēles padod galveni `Idempotency-Key`, lai atkārtots mēģinājums nepasūtītu otru komplektu — skatīt [Idempotence](https://docs.anivahealth.com/lv/concepts/idempotency.md).

Tieši vienu paneli, jo mājas testa komplekts atbilst 1:1 fiziskam komplekta produktam — panelis ir komplekts. Pasūtīt var tikai tos paneļus, kurus Aniva ir konfigurējusi kā mājas testa komplektus; jebkurš cits panelis tiek noraidīts ar `422`. Tas ir obligāts izveides brīdī, jo pasūtījums uzreiz nonāk iepakošanas rindā un iepakošana var sākties nekavējoties. Kamēr pasūtījums ir statusā `pending`, tu vari nomainīt paneli, izmantojot [Atjaunināt](https://docs.anivahealth.com/lv/api/home-kit-orders/update-home-kit.md).

Lai nosūtītu otru komplektu tā vietā, kurš nevarēja sniegt rezultātus, paneļa izvēles vietā padod `replaces_home_kit_order_id` — skatīt [Aizstāšanas komplekti](#aizvietosanas-komplekti).

## Aizvietošanas komplekti

Dažkārt komplekts nevar sniegt rezultātus: pacients nevarēja piepildīt stobriņu, paraugs pienāca ar pārāk mazu materiāla daudzumu vai laboratorija nevarēja analizēt daļu no tā. Pasūti tam **aizstājēju**:

```
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]
}
```

Aizstājējs ir **jauns pasūtījums ar jaunu laboratorijas kodu**, arī tad, ja pirmais komplekts nekad netika aktivizēts: laboratorijai ir nepieciešams jauns nosūtījums, un divus paraugus ar vienu kodu nevar atšķirt. Abi pasūtījumi paliek lasāmi, savienoti ar `replaces_home_kit_order_id`.

**Aizstājamais pasūtījums netiek aiztikts.** Tas saglabā savu statusu, laboratorijas kodu un visus rezultātus, kas tajā jau reģistrēti, tāpēc pacients, kurš tomēr nosūta pirmo komplektu, saņem visu, ko laboratorija no tā var nolasīt.

**Panelis tiek mantots.** Nenorādi `panel_id`, un aizstājējs pārņems aizstājamā pasūtījuma paneli — to, ko pacients iegādājās un kā ir noformēta kaste. Sūti citu paneli tikai visa paneļa aizstāšanai; panelis kopā ar marķieru apakškopu tiek noraidīts ar `422`, jo apakškopai ir nozīme tikai tajā panelī, no kura tā izvēlēta. Arī aizstājēja paneli vēlāk nevar nomainīt.

**Tu izvēlies, ko atkārtot.** Nosūti `biomarker_ids` ar marķieriem, kas neizdevās, un laboratorija atkārtos tikai tos, tāpēc komplektā būs tikai tiem nepieciešamie stobriņi. Nenorādi to, lai atkārtotu visu paneli — tā ir pareizā izvēle, ja nekas vispār netika analizēts. Tam nav nepieciešams papildu scope: to marķieru atkārtošana, par kuriem pacients jau samaksāja, nav à-la-carte izvēle. Šos marķierus vēlāk nevar noņemt, jo tie veido visu nosūtījumu.

> [!NOTE]
>
> Marķieri tiek atkārtoti pa paneļa **grupām**, nevis pa vienam. Norādot vienu grupas marķieri, tiek atkārtota
> visa šī grupa, jo nevar veikt laboratorijas pasūtījumu, kas ziņo vairāk, nekā pieprasīts.
> Tāpēc viena marķiera aizstājējs var atgriezt vairāk nekā vienu rezultātu, un
> tā stobriņu skaits var būt lielāks, nekā liecina marķieru saraksts.

Vienam komplektam vienlaikus ceļā var būt tikai viens aizstājējs — kamēr aizstājējs ir statusā `pending` vai `dispatched`, otrs izveides pieprasījums tam pašam pasūtījumam atgriež `409`, norādot esošo aizstājēju. Rezultāti pienāk ar aizstājēja paša `lab_code`, izmantojot tā [Iegūt rezultātus](https://docs.anivahealth.com/lv/api/home-kit-orders/get-results.md).

Aizstājējs nav paredzēts pakām, kas nekad nepienāca. Tā vietā sazinies ar Aniva: tas ir tā paša pasūtījuma atkārtots sūtījums ar to pašu laboratorijas kodu, nevis jauns pasūtījums.

## Mājas testa komplekta pasūtījuma atjaunināšana

Maini piegādes adresi, nomaini paneli, atjaunini metadatus vai aizstāj e-pasta adreses paziņojumiem par gataviem rezultātiem:

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

Iekļauj tikai tos laukus, kurus vēlies mainīt. `panel_id` **aizstāj** pievienoto paneli — tā kā vienam komplektam ir tieši viens panelis, maiņa ir vienīgā jēgpilnā operācija ar paneli, tāpēc nav paneļu pievienošanas/noņemšanas galapunktu. Adresi un paneli var mainīt tikai statusā `pending`; `metadata` var rakstīt visā pasūtījuma dzīves ciklā. `results_ready_emails` var rakstīt, līdz pasūtījums ir `cancelled`.

## Mājas testa komplekta pasūtījuma atcelšana

Atcel mājas testa komplekta pasūtījumu, kas vairs nav nepieciešams:

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

Tas iestata mājas testa komplekta pasūtījuma statusu uz `cancelled`. Atbildē tiek atgriezts atceltais mājas testa komplekta pasūtījums.

Atcelt var tikai pasūtījumu statusā `pending`. Sākot no `dispatched`, komplekts ir iepakots un marķēts — automātiskas atsaukšanas nav — un izsaukums atgriež `409`. Ja jāaptur komplekts, kas jau ir izsūtīts, sazinies ar Aniva tieši.

Atceļot `pending` pasūtījumu, kura komplekts jau ir pasūtīts izpildes centrā, tas tiek atcelts arī tur, un izsaukums izdodas tikai tad, ja izpildes centrs to apstiprina:

* `409` — komplekts jau tika iepakots un marķēts, tāpēc to vairs nevar atsaukt, lai gan pasūtījumam joprojām rādās `pending`.
* `502` — izpildes centrs atteica atcelšanu (kļūdā ir norādīts tā iemesls) vai nebija sasniedzams. **Nekas netika mainīts** — pasūtījums joprojām ir aktīvs, un to var atcelt atkārtoti.

Atcelšana, kas atgriež kļūdu, atstāj pasūtījumu tieši tādu, kāds tas bija, tāpēc `200` ir vienīgais apstiprinājums, ka komplekts netiks sūtīts.

Atceļot pasūtījumu, kas jau ir statusā `cancelled`, tiek atgriezts tas pats `200`, neatkarīgi no statusa, no kura tas tika atcelts.

## Mājas testa komplekta pasūtījuma aktivizēšana

Kad pacients ir paņēmis paraugu, paziņo par to:

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

Padod `activated_at` — brīdi, kad pacients faktiski paņēma paraugu, UTC formātā. Šis ir parauga paņemšanas laiks, kas parādīsies laboratorijas pārskatā, tāpēc sūti faktisko paņemšanas brīdi, nevis apstrādes laiku. Aktivizēšana ir galastāvoklis: pasūtījums pāriet uz `activated`, un to vairs nevar atcelt vai mainīt. Šis ir mājas testa komplekta ekvivalents [Apstiprināt asins paņemšanu](https://docs.anivahealth.com/lv/api/appointments/confirm-blood-draw.md) bez svītrkoda — komplekta kods tiek piešķirts iepakošanas laikā, tāpēc tev tas nekad nav jāzina. Līdz tam brīdim pasūtījumam jau jābūt `lab_code`; pasūtījums bez tā atgriež `409`.

Aktivizēšana arī veic laboratorijas pasūtījumu: komplekta panelis tiek pasūtīts laboratorijā ar tā `lab_code`, tāpēc atgrieztais paraugs tiek gaidīts un rezultāti tiek pievienoti, tiklīdz laboratorija tos iesniedz. Tas notiek pēc atbildes nosūtīšanas, un problēmas laboratorijas pusē risina Aniva, nevis tās tiek atgrieztas tavā pieprasījumā.

## Atsevišķi biomarķieri

Mājas testa komplekta pasūtījumam vari pievienot atsevišķus biomarķierus kā à la carte analīzes ārpus paneļa. Tas ir noderīgi, ja papildus komplektam vēlies pielāgotu izvēli. Pievienotie biomarķieri mājas testa komplekta pasūtījuma atbildē parādās masīvā `individual_biomarkers` (līdzās `panels`).

Abiem biomarķieru galapunktiem papildus `home_kit_orders_manage` nepieciešams `home_kit_orders_individual_biomarker_selection` atļaujas tvērums — mājas testa komplektus pasūta pa paneļiem, tāpēc atsevišķus marķierus ieslēdz katram partnerim atsevišķi. Jautā Aniva, ja tavai integrācijai tas ir nepieciešams.

Pievieno biomarķierus (idempotenti — jau piesaistītie biomarķieri tiek saglabāti):

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

Noņemt biomarķierus (idempotenti — nepiesaistīts ID tiek ignorēts):

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

Abi galapunkti pieņem masīvu `biomarker_ids`. Izmanto [Biomarķieru sarakstu](https://docs.anivahealth.com/lv/api/biomarkers/list-biomarkers.md) ar `home_kit=true`, lai atrastu biomarķieru ID. Biomarķierus var mainīt tikai tad, kamēr komplektam ir statuss `pending` (sk. [Dzīves cikls](#dzives-cikls)).

## Laboratorijas rezultātu iegūšana

Kad laboratorija ir apstrādājusi atgriezto paraugu, izgūsti klīniskos un ģenētiskos rezultātus:

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

Atbildē līdzās saņemtajiem rezultātiem ir iekļauti plānotie testi (statuss `planned`), lai tu varētu sekot, kas vēl gaida izpildi. Rezultāti tiek pievienoti pasūtījuma `lab_code` un pienāk pa vienam marķierim, laboratorijai tos analizējot, tāpēc daļēji dati ir normāla parādība. Augstākā līmeņa lauks `status` līdz galīgajam pārskatam ir `in_progress`, pēc tam `completed` (vai `fault`, ja visi laboratorijas pasūtījumi neizdevās bez rezultātu iesniegšanas) — izmanto to, lai noteiktu, vai mājas testa komplekta pasūtījuma laboratorijas darbs ir pabeigts. `home_kit_order.results.completed` [webhook](https://docs.anivahealth.com/lv/concepts/webhooks.md) tev paziņo, kad tas notiek, tāpēc tev nav nepārtraukti jāveic vaicājumi. Atsauces uz laboratorijas pārskatu PDF failiem ir masīvā `documents` — izmanto `GET /api/v1/documents/{id}`, lai tos lejupielādētu.

## Mājas testa komplekta pasūtījuma piemērs

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