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

> Vaiheittainen opas: kirjaa verinäytteenotto Aniva API:ssa ja lähetä näyte laboratoriotilausten käsittelyputkeen.

Käytä tätä ohjetta vahvistaaksesi, että verinäytteenotto on tehty. Vahvistus tallentaa fyysisen pakkauksen laboratoriokoodit (putkien viivakoodit) ja käynnistää laboratoriotilausprosessin; tulosten eteneminen luetaan sen jälkeen [Hae tulokset](https://docs.anivahealth.com/fi/api/appointments/get-results.md) -päätepisteestä.

> [!WARNING]
>
> Vahvistus on **peruuttamaton**. Kun olet vahvistanut verinäytteenoton, ajanvaraukseen ei voi enää tehdä muutoksia –
> et voi myöskään lisätä paneeleja. Varmista ennen jatkamista, että kaikki paneelit on liitetty ja
> kaikki tiedot ovat oikein.

**1. Varmista, että paneelit on lisätty**

Tarkista ennen vahvistamista, että kaikki tarvittavat testipaneelit on lisätty ajanvaraukseen. Et voi lisätä paneeleja vahvistuksen jälkeen.

Katso paneelien liittämisohjeet oppaasta [Ajanvarauksen tekeminen](https://docs.anivahealth.com/fi/guides/schedule-appointment.md).

Varmista seuraavat asiat ennen jatkamista:

* Kaikki tarvittavat paneelit on liitetty ajanvaraukseen.
* Ajanvarauksen `profile_id` ja `location_id` ovat oikein.
* Potilaan verinäytteenotto on tehty, ja jokaisen putken viivakoodi on käsillä.

**2. Vahvista verinäytteenotto**

Lähetä `POST`-pyyntö osoitteeseen `/api/v1/appointments/{id}/confirm` fyysisen verinäytteenottopakkauksen laboratoriokoodeilla. Laskimoverinäytteenotossa on yksi koodi painettuna jokaiseen putkeen – lähetä se `lab_code`-kentässä. Apteekin verinäytteenotossa on yksi koodi mikroputkea kohden – lähetä ne `lab_codes`-kentässä, yksi merkintä koodia kohden ja mukana kyseisen mikroputken sisältämät `panel_ids`-tunnisteet (ajanvarauksen `panels`-kentästä); jokaisesta koodista tulee oma laboratoriolähetteensä. Apteekissa yksittäiset biomarkkerit täyttävät ensin paneelien mikroputkien vapaan tilan. Lähetä yksi merkintä ilman `panel_ids`-kenttää jokaisesta mikroputkesta, jonka ne tarvitsevat erikseen.

> [!WARNING]
>
> Jokaisen koodin on oltava potilaalle annettuun fyysiseen putkeen painettu numeromerkkijono. Älä korvaa sitä muulla tunnisteella – virheellinen koodi saa laboratoriotilauksen epäonnistumaan. Jokainen koodi tarkistetaan ennen tallentamista; jos yksikin hylätään, mitään ei tallenneta.

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

Onnistunut pyyntö palauttaa `200 OK`:

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

**3. Tarkista ajanvarauksen tila**

Hae ajanvaraus vahvistuksen jälkeen ja tarkista, että sen tila on muuttunut arvoon `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"
```

Kun ajanvarauksessa näkyy `status: "blood_drawn"`, laboratoriotilausprosessi on käynnistynyt. Itse ajanvarauksen tila pysyy tästä eteenpäin arvossa `blood_drawn`; tarkempi eteneminen on saatavilla omista päätepisteistään: seuraa jokaisen vastaukseen sisältyvän `shipments`-taulukon kohteen osalta [Hae lähetys](https://docs.anivahealth.com/fi/api/shipments/get-shipment.md) -päätepisteestä kuriirin kuljetus- ja toimitustapahtumia ja käytä [Hae tulokset](https://docs.anivahealth.com/fi/api/appointments/get-results.md) -päätepistettä laboratoriotulosten valmistumiseen (`status: "in_progress"` → `"completed"`).

## Mitä tapahtuu seuraavaksi

Vahvistuksen jälkeen Anivan laboratoriotilausprosessi ottaa käsittelyn hoitaakseen:

1. Jokainen laboratoriokoodi yhdistetään fyysisiin putkiinsa laboratoriossa – jokaisen paneelin lähetteessä on sen omien putkien koodi.
2. Ajanvaraukseen liitetyt paneelit määrittävät, mitkä testit tehdään.
3. Kun tulokset ovat valmiit, ne yhdistetään potilasprofiiliin ja tulevat näkyviin
   [Hae tulokset](https://docs.anivahealth.com/fi/api/appointments/get-results.md) -päätepisteessä – vastauksen ylätason `status`-kenttä vaihtuu
   arvosta `in_progress` arvoon `completed`, kun jokainen lähete on suljettu ja yksi on raportoitu.

Integraatioltasi ei vaadita muita toimia vahvistuksen jälkeen.

## Virheenkäsittely

| Tila | Syy | Ratkaisu |
| - | - | - |
| `400 Bad Request` | Kumpaakaan kentistä `lab_code` / `lab_codes` ei ole annettu tai molemmat on annettu, koodi ei ole numeerinen tai koodi tai paneeli toistuu. | Lähetä täsmälleen toinen kentistä ja käytä fyysisten putkien täsmällisiä numeerisia koodeja. |
| `409 Conflict` | Koodia ei voi käyttää (jo liitetty, rekisteröimätön, kuuluu kotitestipakkaukseen, väärä klinikka), paneelilla ei ole koodia tai ajanvarausta ei voi vahvistaa. | Lue `reason` ja `lab_code`; skannaa toinen putki tai tarkista ajanvarauksen tila. |
| `403 Forbidden` | API-avaimellasi ei ole oikeutta tähän toimintoon. | Ota yhteyttä Anivaan API-avaimesi käyttöoikeuksien vahvistamiseksi. |
| `404 Not Found` | Ajanvaraustunnusta ei ole olemassa tai se ei kuulu tilillesi. | Tarkista, että ajanvaraustunnus on oikein. |


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