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

# Izveidot pierakstu

> Ieplānot asins paņemšanas pierakstu profilam analīžu nodošanas vietā

Ieplāno asins paņemšanas pierakstu pacienta profilam konkrētā testēšanas vietā. Pēc izveides pieraksts pēc noklusējuma iegūst statusu `confirmed` (dažās vietās noklusējuma statuss var būt `pending` — tas ir katras vietas iestatījums). Izmanto [Pievienot paneļus](https://docs.anivahealth.com/lv/api/appointments/add-panels.md), lai piesaistītu asins analīžu paneļus pirms [asins paņemšanas apstiprināšanas](https://docs.anivahealth.com/lv/api/appointments/confirm-blood-draw.md).

> [!NOTE]
>
> Profilam var būt ne vairāk kā **viens** pieraksts vienā vietā un laikā. Izveidojot pierakstu laikā,
> kuru profils jau aizņem, otra pieraksta vietā tiek atgriezts `409` ar esošo `appointment_id` —
> tāpēc atkārtots vai nejauši dublēts pieprasījums nekad neizveidos dubultu pierakstu. Skati
> [Dublēti pieraksti](#dubleti-pieraksti).

Nosūti neobligātu `Idempotency-Key` galveni, lai šo izveides pieprasījumu varētu droši atkārtot — atkārtojot to pašu atslēgu, tiek atgriezta sākotnējā atbilde, nevis izveidots otrs pieraksts. Skati [Idempotence](https://docs.anivahealth.com/lv/concepts/idempotency.md).

Nepieciešams piekļuves tvērums `appointments_schedule`.

## Pieprasījums

### Pieprasījuma satura parametri

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

Pacienta profila UUID, kuram izveidot pierakstu.

**location\_id** `string` *required*

Testēšanas vietas UUID, kur notiks asins paņemšana. Izmanto [Vietu
saraksts](https://docs.anivahealth.com/lv/api/locations/list-locations.md), lai atrastu pieejamos vietu ID.

**scheduled\_at** `string` *required*

Pieraksta datums un laiks ISO 8601 formātā (piem., `2026-05-15T10:30:00Z` vai
`2026-05-15T12:30:00+02:00`). **Jāiekļauj laika joslas norāde** — `Z` vai skaidra nobīde,
piemēram, `+02:00`; datumi bez laika joslas tiek noraidīti. Jābūt nākotnē.

Tam jāatbilst precīzam laika intervāla sākumam vietas grafikā, un tajā vēl jābūt brīvām vietām —
vispirms skati [Iegūt pieejamību](https://docs.anivahealth.com/lv/api/locations/get-availability.md). Grafikam neatbilstoši laiki
atgriež `400`; aizpildīts laika intervāls atgriež `409`. Aniva pārvaldītajās vietās tam jābūt arī
vismaz 12 stundas uz priekšu — skati [Minimālais pieteikšanas laiks](#minimalais-pieteiksanas-laiks).

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

Līdz 5 adresēm, no kurām katra saņem vienu e-pastu, kad visi laboratorijas rezultāti ir galīgi.
E-pastā ir saite uz rezultātu lapu Aniva administrēšanas panelī. Tavai atslēgai nepieciešama
`results_view` piekļuve pacientam, pretējā gadījumā tiks atgriezts `403`. Izlaid šo lauku, lai
izmantotu pacienta grupai iestatītās noklusējuma adreses. Tukšs saraksts izslēdz šos e-pastus.
Skati [E-pasti par gataviem rezultātiem](https://docs.anivahealth.com/lv/concepts/results.md#e-pasti-par-gataviem-rezultatiem).

**draw\_method** `string`

Asins paņemšanas metode: `capillary` vai `venous`. Izlaid šo lauku, lai izmantotu vietas
`default_draw_method`. Vietai šī metode ir jānorāda savā `draw_methods` sarakstā, pretējā
gadījumā tiks atgriezts `400`.

## Atbilde

Veiksmīgā gadījumā API atgriež `201 Created` ar jauno pierakstu.

**id** `string` *required*

Unikāls pieraksta identifikators (UUID).

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

Profila UUID, kuram pieder šis pieraksts.

**location\_id** `string`

Analīžu vietas UUID, kur notiek asins paņemšana.

**scheduled\_at** `string`

Ieplānotais pieraksta datums un laiks UTC formātā (ISO 8601 ar `Z` piedēkli, piem.,
`2026-05-15T10:30:00Z`). Var būt `null`.

**status** `string` *required*

Pašreizējais pieraksta statuss. Viens no: `pending`, `confirmed`, `blood_drawn` vai `cancelled`.
Detalizētu laboratorijas rezultātu gatavības informāciju var iegūt ar
[Iegūt rezultātus](https://docs.anivahealth.com/lv/api/appointments/get-results.md); detalizētāku sūtījuma gaitu — no katra ieraksta
iebūvētajā `shipments` masīvā (skati zemāk), tālāk izmantojot
[Iegūt sūtījumu](https://docs.anivahealth.com/lv/api/shipments/get-shipment.md).

**cancellation\_reason** `string`

Brīva teksta iemesls, kas fiksēts pieraksta atcelšanas brīdī (piem., neierašanās, vēla atcelšana,
'Neizdevās. Nepieciešams atkārtot'). Ir `null`, ja vien `status` nav `cancelled`.

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

Adreses mazajiem burtiem, no kurām katra saņem vienu e-pastu, tiklīdz visi laboratorijas rezultāti ir galīgi. Tukšs, kad izslēgts. Skatīt
[E-pasti par gataviem rezultātiem](https://docs.anivahealth.com/lv/concepts/results.md#e-pasti-par-gataviem-rezultatiem).

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

Asins paņemšanas metode: `capillary` (no pirksta gala vai augšdelma mikrostobriņos) vai `venous` (no vēnas
stobriņos). Tā ir metode, ko nosaka pieraksts, vai arī tā [vietas](https://docs.anivahealth.com/lv/concepts/locations.md) `default_draw_method`.
Pēc asins paņemšanas tā ir izmantotā metode.

**profile** `object` *required*

Ar šo pierakstu saistītais pacienta profils.

**profils**

**id** `string`

Unikāls profila identifikators (UUID).

**handle** `string`

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

**first\_name** `string`

Vārds. Var būt `null`.

**last\_name** `string`

Uzvārds. Var būt `null`.

**email** `string`

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 `YYYY-MM-DD` formātā. 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 pieprasījumā [Izveidot profilu](https://docs.anivahealth.com/lv/api/profiles/create-profile.md).

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

Vai šis profils saņem transakciju (programmatiskos) e-pastus. Var būt `null`.

**panels** `AppointmentPanel[]` *required*

Paneļi, kas pašlaik piesaistīti šim pierakstam. Jaunizveidotiem pierakstiem šis saraksts ir tukšs
— pievieno ar [Pievienot paneļus](https://docs.anivahealth.com/lv/api/appointments/add-panels.md). Paneļu informāciju (nosaukumu,
biomarķierus) skati ar [Paneļu saraksts](https://docs.anivahealth.com/lv/api/panels/list-panels.md).

**Paneļa piesaistes lauki**

**panel\_id** `string`

Paneļa UUID — salīdzini ar [Paneļu saraksts](https://docs.anivahealth.com/lv/api/panels/list-panels.md).

**added\_at** `string`

ISO 8601 laikspiedols, kad panelis pirmo reizi tika piesaistīts šim pierakstam.

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

Atsevišķie biomarķieri, kas piesaistīti šim pierakstam ārpus paneļiem. Jaunizveidotiem pierakstiem
šis saraksts ir tukšs — pievieno ar
[Pievienot atsevišķus biomarķierus](https://docs.anivahealth.com/lv/api/appointments/add-individual-biomarkers.md). Katru
`biomarker_id` salīdzini ar [Biomarķieru saraksts](https://docs.anivahealth.com/lv/api/biomarkers/list-biomarkers.md), lai iegūtu
attēlošanas datus.

**Individuālo biomarķieru lauki**

**biomarker\_id** `integer`

Biomarķiera identifikators — salīdzini ar
[Biomarķieru saraksts](https://docs.anivahealth.com/lv/api/biomarkers/list-biomarkers.md).

**added\_at** `string`

ISO 8601 laikspiedols, kad biomarķieris pirmo reizi tika piesaistīts šim pierakstam.

**shipments** `AppointmentShipmentLink[]` *required*

Šim pierakstam piesaistītie sūtījumi, sākot ar vecāko piesaisti. Jaunizveidotiem pierakstiem šis
saraksts ir tukšs — piesaisti ar [Izveidot sūtījumu](https://docs.anivahealth.com/lv/api/shipments/create-shipment.md) (norādot
`appointment_id`) vai
[Piesaistīt pierakstus sūtījumam](https://docs.anivahealth.com/lv/api/shipments/attach-appointments-to-shipment.md).

**Sūtījuma saites lauki**

**id** `string`

Sūtījuma atsauces identifikators — salīdzini ar
[Iegūt sūtījumu](https://docs.anivahealth.com/lv/api/shipments/get-shipment.md).

**added\_at** `string`

ISO 8601 laikspiedols, kad sūtījums pirmo reizi tika piesaistīts šim pierakstam.

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

Šim pierakstam reģistrētie laboratorijas kodi (stobriņu svītrkodi) skenēšanas secībā. Tukšs, līdz asins paņemšana
ir apstiprināta. Venozai asins paņemšanai ir viens kods, kas uzdrukāts uz katra stobriņa; kapilārai asins paņemšanai ir viens
kods katram mikrostobriņam. Rezultāti un dokumenti sadaļā [Iegūt rezultātus](https://docs.anivahealth.com/lv/api/appointments/get-results.md) atsaucas
uz šiem kodiem ar `lab_code`.

## Minimālais pieteikšanas laiks

Pieraksti Aniva pārvaldītajās vietās jāpiesaka vismaz **12 stundas** iepriekš; pieteikšana šajā
laika logā atgriež `400`. [Iegūt pieejamību](https://docs.anivahealth.com/lv/api/locations/get-availability.md) jau neiekļauj šos
laika intervālus, tāpēc visu, ko redzi šajā grafikā, var pieteikt.

Tevis pārvaldītajām vietām minimālā pieteikšanas laika nav — pieteikšana tajā pašā dienā un bez iepriekšēja pieraksta paliek nemainīga.

## Dublēti pieraksti

Profilam var būt ne vairāk kā viens neatcelts pieraksts vienā vietā un vienā brīdī — vienai personai
nevar veikt asins paņemšanu divreiz vienā vietā un vienā mirklī, neatkarīgi no tā, cik krēslu ir
šajā vietā.

Izveidojot pierakstu laikā, kuru profils jau aizņem, tiek atgriezts `409` ar `appointment_id`, kas
norāda jau esošo pierakstu:

```json theme={null}
{
  "error": "This profile already has an appointment at this location and time. Reschedule or cancel the existing appointment instead of creating a second one.",
  "appointment_id": "03e916d2-7fd6-4414-8276-8532a105edc3"
}
```

Apstrādā to, uzskatot pieprasījumu par jau izpildītu: iegūsti pierakstu ar
[Iegūt pierakstu](https://docs.anivahealth.com/lv/api/appointments/get-appointment.md), pārcel to ar
[Atjaunināt pierakstu](https://docs.anivahealth.com/lv/api/appointments/update-appointment.md) vai atcel to ar
[Atcelt pierakstu](https://docs.anivahealth.com/lv/api/appointments/cancel-appointment.md). Neatkārto izveides pieprasījumu — tas
turpinās atgriezt `409`.

Tas padara atkārtotus izveides pieprasījumus drošus: pieprasījums, ko nosūti atkārtoti pēc noildzes,
vai divreiz iesniegta forma nevar izveidot divus pierakstus vienam pacientam vienā un tajā pašā
laikā.

> [!NOTE]
>
> `appointment_id` tiek atgriezts tikai dublēta pieraksta `409` atbildē. Ietilpības `409` — kad
> laika intervāls ir pilns, jo to aizņem *citi* pacienti — atgriež tikai `error`, un pareizais
> risinājums šādā gadījumā ir izvēlēties citu laiku no
> [Iegūt pieejamību](https://docs.anivahealth.com/lv/api/locations/get-availability.md).

## Kļūdu atbildes

| Statuss | Apraksts |
| - | - |
| `400` | Validācijas kļūda — piemēram, `scheduled_at` ir pagātnē, līdz tam Aniva pārvaldītā vietā ir mazāk nekā 12 stundas, tas nav precīzs laika loga sākums vietas grafikā vai vietā nav konteineru metodei `draw_method`. |
| `403` | Aizliegts — tavai API atslēgai nav piekļuves šai darbībai, vai `results_ready_emails` ir iestatīts bez `results_view` piekļuves pacientam. |
| `404` | Nav atrasts profils vai vieta, vai vieta nav aktīva. |
| `409` | Šim profilam jau ir pieraksts šajā vietā un laikā (satur `appointment_id`), laika logs ir pilns, vieta tajā datumā ir slēgta, `Idempotency-Key` tika izmantots atkārtoti ar citu pieprasījuma saturu vai tā sākotnējais pieprasījums vēl nav pabeigts. |
| `500` | Iekšēja servera kļūda. |

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
    "scheduled_at": "2026-05-15T10:30:00Z"
  }'
```

```json 201 theme={null}
{
  "id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
  "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
  "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
  "scheduled_at": "2026-05-15T10:30:00Z",
  "status": "confirmed",
  "cancellation_reason": null,
  "results_ready_emails": [],
  "draw_method": "venous",
  "created_at": "2026-04-01T09:45:00Z",
  "updated_at": null,
  "profile": {
    "id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "handle": null,
    "first_name": "Maria",
    "last_name": "Schmidt",
    "email": "maria.schmidt@example.com",
    "phone": "+4930123456789",
    "sex": 2,
    "date_of_birth": "1985-03-22",
    "height": 168,
    "weight": 65,
    "language": "de",
    "transactional_emails_enabled": true,
    "created_at": "2026-04-01T09:14:32Z",
    "updated_at": null
  },
  "panels": [],
  "individual_biomarkers": [],
  "shipments": [],
  "lab_codes": []
}
```

```json 400 theme={null}
{
  "error": "Appointments must be booked at least 12 hours in advance. Please pick a later time."
}
```

```json 404 theme={null}
{
  "error": "Location not found or inactive"
}
```

```json 409 theme={null}
{
  "error": "This profile already has an appointment at this location and time. Reschedule or cancel the existing appointment instead of creating a second one.",
  "appointment_id": "03e916d2-7fd6-4414-8276-8532a105edc3"
}
```


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