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

# Lataa dokumentti palveluun

> Lataa laboratorioraportti tai muu dokumentti profiiliin ja poimi halutessasi sen laboratorioarvot

Lähetä yksi tiedosto profiiliin. Lähetä se `multipart/form-data`-muodossa. Ilman `extract_results`-kenttää Aniva vain
tallentaa tiedoston. Arvolla `extract_results: true` Aniva lukee tiedostosta myös laboratorioarvot.

Sinun ei tarvitse kertoa, millainen raportti tiedosto on. Aniva päättää sen. Tiedosto ilman laboratoriotuloksia, kuten
lääkärinlausunto, päätyy tilaan `stored` eikä ole virhe.

Lue arvot [Hae asiakirjan tulokset](https://docs.anivahealth.com/fi/api/documents/get-document-results.md) -päätepisteellä. Sinun ei tarvitse
kysellä tilaa toistuvasti: tilaa `document.results.*`-[webhookit](https://docs.anivahealth.com/fi/concepts/webhooks.md).

Vaatii `documents_upload`-scopen jollekin profiilin profiiliryhmistä. `extract_results: true`
vaatii lisäksi `documents_extract_results`-scopen samalle ryhmälle. Pyydä Anivaa lisäämään ne.
Asiakirja kuuluu kyseiseen ryhmään: avaimet, joilla on `results_view`-scope tähän ryhmään, lukevat asiakirjan ja sen tulokset.

Lähetä valinnainen `Idempotency-Key`-otsake, jotta lähetyksen voi yrittää uudelleen turvallisesti. Katso
[Idempotenssi](https://docs.anivahealth.com/fi/concepts/idempotency.md).

## Mitä poiminta tekee

Arvolla `extract_results: true`:

1. Aniva lähettää tiedoston OCR- ja tekoälyalikäsittelijöilleen arvojen lukemista varten.
2. Arvot näkyvät jäsenen Aniva-sovelluksessa kuten kaikki muutkin tulokset.
3. Jokaisella arvolla on `origin: partner_upload` ja sama `status` kuin muillakin tuloksilla. Arvolla,
   jota Anivan automaattinen tarkistus epäilee, on tila `likely_wrong`.

Ilman sitä tiedostoa ei lähetetä ulkopuoliseen palveluun, kun lähetät myös `document_date`-kentän.

> [accordion] Tarkkuus ja tietosuoja
>
> * Automaattinen luku voi lukea arvon, yksikön tai päivämäärän väärin. Alkuperäinen tiedosto on
>   ensisijainen lähde. Tarkista arvo siitä ennen kuin käytät sitä lääketieteelliseen päätökseen. Poimitut
>   arvot eivät ole diagnoosi.
> * Alikäsittelijät ovat Mistral AI (OCR, EU) ja Google Cloud Vertex AI, jota käytetään Vercel AI
>   Gatewayn kautta (poiminta, voi käsitellä tietoja EU:n ulkopuolella). Ne käsittelevät tiedostoa vain
>   sen lukemiseksi.
> * Tarvitset oikeusperusteen jäsenen terveystietojen lataamiseen, tavallisesti jäsenen nimenomaisen
>   suostumuksen. Olet siitä vastuussa.

## Pyyntö

### Lomakekentät

**file** `file` *required*

Tiedosto. PDF, DOC, DOCX, PNG tai JPEG, enintään 4 MB.

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

Sen profiilin UUID, johon asiakirja kuuluu.

**extract\_results** `boolean` (default: false)

`true`, kun laboratorioarvot luetaan tiedostosta. Lähetä `true` tai `false`.

**document\_date** `string`

Näytteenottopäivä muodossa `YYYY-MM-DD`, jos tiedät sen. Ilman sitä Aniva lukee päivämäärän
tiedostosta.

## Vastaus

API palauttaa `201 Created`, kun se vain tallensi tiedoston, ja `202 Accepted`, kun poiminta on käynnissä.

**id** `string` *required*

Asiakirjan tunnus (UUID). Käytä sitä päätepisteissä [Hae asiakirjan tulokset](https://docs.anivahealth.com/fi/api/documents/get-document-results.md) ja
[Lataa asiakirja](https://docs.anivahealth.com/fi/api/documents/download-document.md).

**status** `string` *required*

`processing`, kun Aniva poimii arvoja, tai `stored`, kun tiedosto on vain tallennettu.

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

Profiili, johon asiakirja kuuluu.

**document\_date** `string`

Lähettämäsi näytteenottopäivä tai päivämäärä, jonka Aniva luki tallennetusta tiedostosta. Voi olla `null`.

**results\_url** `string` *required*

Tämän asiakirjan [Hae asiakirjan tulokset](https://docs.anivahealth.com/fi/api/documents/get-document-results.md) -URL.

**file\_name** `string` *required*

Näytettävä tiedostonimi, sama jonka [Lataa asiakirja](https://docs.anivahealth.com/fi/api/documents/download-document.md) lähettää.

**original\_file\_name** `string` *required*

Lataamasi tiedoston nimi.

**origin** `string` *required*

Aina `partner_upload`.

**content\_type** `string` *required*

Tiedoston mediatyyppi, esim. `application/pdf`.

**etag** `string`

Tiedoston sisällön versio. Voi olla `null`.

**size\_bytes** `integer`

Tiedoston koko tavuina. Voi olla `null`.

**lab\_code** `string`

Aina `null` ladatulle asiakirjalle.

## Virhevastaukset

| Tila | Kuvaus |
| - | - |
| `400` | Lomakekenttä on virheellinen tai pyynnön runko ei ole muodossa `multipart/form-data`. |
| `403` | API-avaimeltasi puuttuu scope, profiili ei kuulu käyttöoikeusalueeseesi tai lähetit `extract_results: true` ilman `documents_extract_results`-scopea. |
| `404` | Profiilia ei löytynyt. |
| `409` | `duplicate_document`: sama tiedosto on jo tässä profiilissa. `document_id` kertoo sen tunnuksen tai on `null`, jos et voi lukea sitä. Lähetetään myös `Idempotency-Key`-ristiriidassa. |
| `413` | `file_too_large`: tiedosto on yli 4 MB. |
| `415` | `unsupported_media_type`: tiedosto ei ole PDF, DOC, DOCX, PNG tai JPEG. Tiedostonimen on päätyttävä päätteeseen `.pdf`, `.doc`, `.docx`, `.png`, `.jpg` tai `.jpeg`. |
| `500` | Sisäinen palvelinvirhe. `extraction_not_started`: tiedosto on tallennettu tunnuksella `document_id`, mutta poimintaa ei voitu käynnistää. Ota yhteyttä Anivaan. |

```bash cURL theme={null}
curl --request POST \
  --url https://anivahealth.com/api/v1/documents \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Idempotency-Key: 5f0c2d9e-3b7a-4c1e-9f62-1d8a4e7b0c55' \
  --form 'file=@lab-report.pdf' \
  --form 'profile_id=b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e' \
  --form 'extract_results=true'
```

```json 202 theme={null}
{
  "id": "f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c",
  "status": "processing",
  "profile_id": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e",
  "document_date": null,
  "results_url": "https://anivahealth.com/api/v1/documents/f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c/results",
  "file_name": "20261023 - lab-report.pdf",
  "original_file_name": "lab-report.pdf",
  "origin": "partner_upload",
  "content_type": "application/pdf",
  "etag": "56104b36f860cfd5b41efc716fdf7b6f",
  "size_bytes": 312480,
  "lab_code": null
}
```

```json 409 theme={null}
{
  "error": "duplicate_document",
  "message": "This file is already on this profile",
  "document_id": "f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c"
}
```


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