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

# Vahvista verinäytteenotto

> Kirjaa verinäytteenotto tehdyksi ja käynnistä laboratoriotilausprosessi

Kirjaa verinäytteenotto tehdyksi ja käynnistä laboratoriotilausputki. Lähetä verinäytteenottopakkauksen laboratoriokoodit (putkien viivakoodit) fyysisten näytteiden linkittämiseksi ajanvaraukseen.

Verinäytteenoton koodit annetaan jommallakummalla kahdesta tavasta:

* **Yksi koodi koko verinäytteenotolle** — laskimonäytteenotto, jossa sama viivakoodi on painettu jokaiseen putkeen. Lähetä se kentässä `lab_code`.
* **Yksi koodi mikroputkea kohti** — kapillaarinäytteenotto, jossa jokaisella mikroputkella on oma viivakoodinsa. Lähetä ne kentässä `lab_codes`, yksi merkintä koodia kohti sekä `panel_ids`-arvot, jotka kyseinen mikroputki sisältää. Jokaisesta koodista tulee oma laboratoriolähetteensä — putken viivakoodi on laboratorion tilausnumero. Merkintä ilman `panel_ids`-kenttää toimii yleismerkintänä kaikille paneeleille, joita ei ole nimetty muualla. Laskimonäytteenotossa niitä on enintään yksi.

Lähetä täsmälleen toinen näistä kahdesta. Jokaisen liitetyn paneelin on päädyttävä täsmälleen yhden koodin alle (oman merkintänsä tai yleismerkinnän). Laskimonäytteenotossa yksittäiset biomarkkerit tarvitsevat yleismerkinnän. Kapillaarinäytteenotossa nimeä jokainen paneeli sen mikroputken koodin kohdalla. Yksittäiset biomarkkerit täyttävät paneelimikroputkien vapaan tilan, ja uusia mikroputkia otetaan käyttöön vain tarvittaessa. Jaamme ne tasaisesti. Kuhunkin mikroputkeen mahtuu niitä enintään 150 µl. Lähetä yksi merkintä ilman `panel_ids`-kenttää kutakin niiden yksin tarvitsemaa mikroputkea kohti, älä enempää. Koodi, jolle ei päädy yhtään paneelia eikä biomarkkeria, hylätään vastauksella `409` ja `reason: "panel_coverage"`. Jokainen koodi tarkistetaan ennen kuin mitään kirjoitetaan; jos jotakin koodia ei voi käyttää tai paneeli jää kattamatta, mitään ei kirjata ja vastaus kertoo ongelman.

Vaatii `appointments_schedule`-, `appointments_manage`- tai `appointments_operate`-käyttöoikeuden.

> [!WARNING]
>
> Tätä toimintoa ei voi perua. Kun vahvistat verinäytteenoton, ajanvaraus lukitaan —
> siihen ei voi enää tehdä muutoksia, ei myöskään lisätä paneeleita.

## Pyyntö

### Polkuparametrit

**id** `string` *required*

Vahvistettavan ajanvarauksen yksilöllinen tunniste (UUID).

### Runkoparametrit

**lab\_code** `string`

Verinäytteenottopakkaukseen painettu numeerinen laboratoriokoodi, kun yksi koodi kattaa kaikki putket.
Toisensa poissulkeva kentän `lab_codes` kanssa.

**lab\_codes** `object[]`

Kaikki verinäytteenoton laboratoriokoodit skannausjärjestyksessä (vähintään yksi merkintä). Toisensa
poissulkeva kentän `lab_code` kanssa. Koodi saa esiintyä vain kerran, ja paneelin saa nimetä vain yhdessä merkinnässä.

**laboratoriokoodimerkintä**

**lab\_code** `string` *required*

Näiden paneelien putkiin painettu numeerinen laboratoriokoodi.

**panel\_ids** `string[]`

Liitetyt paneelit, joiden putkissa on tämä koodi — ajanvarauksen `panels`-kentän
`panel_id`-arvot. Jätä pois tai lähetä `[]` yleismerkintää varten, joka kattaa kaikki muualla
nimeämättömät paneelit sekä yksittäiset biomarkkerit. Laskimonäytteenotossa on enintään yksi
yleismerkintä. Kapillaarinäytteenotossa yleismerkintä sisältää vain yksittäisiä biomarkkereita,
ja lähetät yhden kutakin niiden tarvitsemaa mikroputkea kohti.

## Vastaus

Onnistuessaan API palauttaa `200 OK` vahvistuksena siitä, että laboratoriotilausputki on käynnistetty.

**success** `boolean`

`true`, kun verinäytteenotto on kirjattu ja laboratoriotilausprosessi on käynnistetty.

**warning** `string`

Mukana vain, kun verinäytteenotto kirjattiin muuna kuin ajanvarauspäivänä. Tavalliset avaimet
eivät voi tehdä tätä — ne saavat vastauksen `409`, jossa on `reason: "appointment_not_today"`.
Siirrä ajanvaraus verinäytteenottopäivälle ja vahvista se sitten.

Kirjatut koodit palautetaan kentässä `lab_codes` kutsussa [Hae ajanvaraus](https://docs.anivahealth.com/fi/api/appointments/get-appointment.md), ja jokaisessa kutsun [Hae tulokset](https://docs.anivahealth.com/fi/api/appointments/get-results.md) tuloksessa ja asiakirjassa on se `lab_code`, jolla se on kirjattu.

## Virhevastaukset

| Tila | Kuvaus |
| - | - |
| `400` | Validointivirhe — kentistä `lab_code` ja `lab_codes` puuttuvat molemmat tai molemmat on annettu, koodi ei ole numeerinen tai koodi tai paneeli toistuu. |
| `403` | Estetty — API-avaimellasi ei ole oikeutta tähän toimintoon. |
| `404` | Ajanvarausta ei löytynyt. |
| `409` | Koodia ei voi käyttää (`reason`: `unregistered`, `already_assigned`, `home_kit_code`, `location_unknown`, `cross_location`), paneeli jää ilman koodia, `panel_id` ei ole liitettynä, laskimoverinäytteenotossa on kaksi merkintää ilman `panel_ids`-kenttää, kapillaariverinäytteenotossa on enemmän merkintöjä kuin mikroputkia tai enemmän merkintöjä ilman `panel_ids`-kenttää kuin vain markkereille tarkoitettuja mikroputkia, tai kapillaarikoodi ei vastaa sen mikroputkia (kaikki `panel_coverage`), ennen nollausta kirjattu koodi nimeää nyt muita paneeleja (`remapped`) tai sen on pysyttävä tässä verinäytteenotossa, koska laboratoriolla voi olla sen tilaus (`sent_to_lab`, `order_in_flight`), koodi nimeää paneelin, jota ei ole suunniteltu ajanvaraukselle (`unknown_panel`), tai ajanvarausta ei voi vahvistaa (`appointment_cancelled`, `appointment_already_drawn`, `appointment_not_ready`, `appointment_not_today`). `lab_code` kertoo koodin, jos vika on tietyssä koodissa. |
| `500` | Sisäinen palvelinvirhe. |

```bash cURL (one code, every tube) theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/confirm \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "lab_code": "7642001234"
  }'
```

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

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

```json 400 theme={null}
{
  "error": "lab_codes: Provide exactly one of `lab_code` or `lab_codes`"
}
```

```json 404 theme={null}
{
  "error": "Appointment not found"
}
```

```json 409 theme={null}
{
  "error": "This barcode has already been assigned to another patient. Please use a different tube.",
  "reason": "already_assigned",
  "lab_code": "7642001235"
}
```

```json 409 (capillary empty code) theme={null}
{
  "error": "Barcode 7642001236 carries no panel and no biomarker.",
  "reason": "panel_coverage",
  "lab_code": null
}
```

```json 409 (cancelled) theme={null}
{
  "error": "This appointment was cancelled, so a blood draw can’t be recorded for it. Reactivate the appointment first if this is a mistake.",
  "reason": "appointment_cancelled",
  "lab_code": "7642001234"
}
```

```json 409 (wrong day) theme={null}
{
  "error": "Recording a blood draw is only available on the appointment day (Oct 13, 2026). Reschedule the appointment to today, then confirm.",
  "reason": "appointment_not_today",
  "lab_code": null
}
```


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