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

# Încarcă un document

> Încarcă un raport de laborator sau orice alt document într-un profil și, opțional, extrage valorile de laborator din el

Încarcă un fișier pe un profil. Trimite-l ca `multipart/form-data`. Fără `extract_results`, Aniva doar
stochează fișierul. Cu `extract_results: true`, Aniva citește și valorile de laborator din fișier.

Nu spui ce fel de raport este fișierul. Aniva decide. Un fișier fără rezultate de laborator, cum ar fi
o scrisoare medicală, ajunge în starea `stored` și nu este o eroare.

Citește valorile cu [Obține rezultatele documentului](https://docs.anivahealth.com/ro/api/documents/get-document-results.md). Nu trebuie să
faci polling: abonează-te la [webhook-urile](https://docs.anivahealth.com/ro/concepts/webhooks.md) `document.results.*`.

Necesită scope-ul `documents_upload` pe un grup de profiluri al profilului. `extract_results: true`
necesită și scope-ul `documents_extract_results` pe același grup. Cere echipei Aniva să le adauge. Documentul
aparține acelui grup: cheile cu `results_view` pe acesta citesc documentul și rezultatele lui.

Trimite un antet opțional `Idempotency-Key` pentru a putea reîncerca încărcarea în siguranță. Vezi
[Idempotență](https://docs.anivahealth.com/ro/concepts/idempotency.md).

## Ce face extragerea

Cu `extract_results: true`:

1. Aniva trimite fișierul către subprocesatorii săi OCR și AI pentru a citi valorile.
2. Valorile apar în aplicația Aniva a membrului, la fel ca orice alt rezultat.
3. Fiecare valoare are `origin: partner_upload` și același `status` ca orice alt rezultat. O valoare
   pe care verificarea automată a Aniva o pune la îndoială are statusul `likely_wrong`.

Fără ea, fișierul nu ajunge la niciun serviciu extern dacă trimiți și `document_date`.

> [accordion] Acuratețe și protecția datelor
>
> * Citirea automată poate interpreta greșit o valoare, o unitate sau o dată. Fișierul original
>   rămâne sursa de adevăr. Verifică o valoare față de el înainte să o folosești pentru o decizie
>   medicală. Valorile extrase nu reprezintă un diagnostic.
> * Subprocesatorii sunt Mistral AI (OCR, UE) și Google Cloud Vertex AI, accesat prin
>   Vercel AI Gateway (extragere, poate procesa în afara UE). Aceștia procesează fișierul doar
>   pentru a-l citi.
> * Ai nevoie de un temei legal pentru a încărca datele de sănătate ale unui membru, de obicei
>   consimțământul explicit al membrului. Ești responsabil pentru acesta.

## Cerere

### Câmpurile formularului

**file** `file` *required*

Fișierul. PDF, DOC, DOCX, PNG sau JPEG, cel mult 4 MB.

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

UUID-ul profilului căruia îi aparține documentul.

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

`true` pentru a citi valorile de laborator din fișier. Trimite `true` sau `false`.

**document\_date** `string`

Data probei în format `YYYY-MM-DD`, când o știi. Fără ea, Aniva citește data din
fișier.

## Răspuns

API-ul returnează `201 Created` când doar a stocat fișierul și `202 Accepted` când rulează extragerea.

**id** `string` *required*

ID-ul documentului (UUID). Folosește-l cu [Obține rezultatele documentului](https://docs.anivahealth.com/ro/api/documents/get-document-results.md) și
[Descarcă documentul](https://docs.anivahealth.com/ro/api/documents/download-document.md).

**status** `string` *required*

`processing` cât timp Aniva extrage valorile sau `stored` când fișierul este doar stocat.

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

Profilul căruia îi aparține documentul.

**document\_date** `string`

Data probei pe care ai trimis-o sau cea citită de Aniva dintr-un fișier stocat. Poate fi `null`.

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

URL-ul [Obține rezultatele documentului](https://docs.anivahealth.com/ro/api/documents/get-document-results.md) al acestui document.

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

Numele fișierului pentru afișare, același pe care îl trimite [Descarcă documentul](https://docs.anivahealth.com/ro/api/documents/download-document.md).

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

Numele fișierului pe care l-ai încărcat.

**origin** `string` *required*

Întotdeauna `partner_upload`.

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

Tipul media al fișierului, de ex. `application/pdf`.

**etag** `string`

Versiunea conținutului fișierului. Poate fi `null`.

**size\_bytes** `integer`

Dimensiunea fișierului în octeți. Poate fi `null`.

**lab\_code** `string`

Întotdeauna `null` pentru un document încărcat.

## Răspunsuri de eroare

| Status | Descriere |
| - | - |
| `400` | Un câmp de formular este invalid sau corpul cererii nu este `multipart/form-data`. |
| `403` | Cheii tale API îi lipsește un scope, profilul este în afara contextului tău de acces sau ai trimis `extract_results: true` fără `documents_extract_results`. |
| `404` | Profilul nu a fost găsit. |
| `409` | `duplicate_document`: același fișier există deja în acest profil. `document_id` îl indică sau este `null` când nu îl poți citi. Este trimis și în cazul unui conflict `Idempotency-Key`. |
| `413` | `file_too_large`: fișierul depășește 4 MB. |
| `415` | `unsupported_media_type`: fișierul nu este PDF, DOC, DOCX, PNG sau JPEG. Numele fișierului trebuie să se termine în `.pdf`, `.doc`, `.docx`, `.png`, `.jpg` sau `.jpeg`. |
| `500` | Eroare internă de server. `extraction_not_started`: fișierul este stocat ca `document_id`, dar extragerea nu a putut începe. Contactează Aniva. |

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