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

# Prześlij dokument

> Prześlij raport laboratoryjny lub dowolny inny dokument do profilu i opcjonalnie wyodrębnij z niego wartości laboratoryjne

Prześlij jeden plik do profilu. Wyślij go jako `multipart/form-data`. Bez `extract_results` Aniva tylko
zapisuje plik. Z `extract_results: true` Aniva dodatkowo odczytuje z pliku wartości laboratoryjne.

Nie wskazujesz, jakiego rodzaju raportem jest plik. Decyduje o tym Aniva. Plik bez wyników laboratoryjnych, taki jak
list od lekarza, kończy ze statusem `stored` i nie jest błędem.

Odczytaj wartości za pomocą [Pobierz wyniki dokumentu](https://docs.anivahealth.com/pl/api/documents/get-document-results.md). Nie musisz cyklicznie
odpytywać API: zasubskrybuj [webhooki](https://docs.anivahealth.com/pl/concepts/webhooks.md) `document.results.*`.

Wymaga zakresu `documents_upload` w grupie profili, do której należy profil. `extract_results: true`
wymaga dodatkowo zakresu `documents_extract_results` w tej samej grupie. Poproś Aniva o ich dodanie.
Dokument należy do tej grupy: klucze z zakresem `results_view` w tej grupie odczytują dokument i jego wyniki.

Wyślij opcjonalny nagłówek `Idempotency-Key`, aby przesyłanie można było bezpiecznie ponawiać. Zobacz
[Idempotentność](https://docs.anivahealth.com/pl/concepts/idempotency.md).

## Co robi wyodrębnianie

Z `extract_results: true`:

1. Aniva wysyła plik do swoich podwykonawców OCR i AI, aby odczytać wartości.
2. Wartości pojawiają się w aplikacji Aniva członka, jak każdy inny wynik.
3. Każda wartość ma `origin: partner_upload` oraz taki sam `status` jak każdy inny wynik. Wartość
   budząca wątpliwości automatycznej kontroli Aniva ma status `likely_wrong`.

Bez tego plik nie trafia do żadnej zewnętrznej usługi, jeśli wyślesz też `document_date`.

> [accordion] Dokładność i ochrona danych
>
> * Automatyczny odczyt może błędnie odczytać wartość, jednostkę lub datę. Oryginalny plik pozostaje
>   źródłem prawdy. Porównaj z nim wartość, zanim użyjesz jej do decyzji medycznej. Odczytane
>   wartości nie stanowią diagnozy.
> * Podwykonawcy to Mistral AI (OCR, UE) oraz Google Cloud Vertex AI, dostępny przez Vercel AI
>   Gateway (ekstrakcja, może przetwarzać poza UE). Przetwarzają plik wyłącznie w celu jego
>   odczytania.
> * Potrzebujesz podstawy prawnej, aby przesłać dane zdrowotne członka, zazwyczaj jego wyraźnej
>   zgody. Ponosisz za to odpowiedzialność.

## Żądanie

### Pola formularza

**file** `file` *required*

Plik. PDF, DOC, DOCX, PNG lub JPEG, maksymalnie 4 MB.

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

UUID profilu, do którego należy dokument.

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

`true`, aby odczytać wartości laboratoryjne z pliku. Wyślij `true` lub `false`.

**document\_date** `string`

Data pobrania próbki w formacie `YYYY-MM-DD`, jeśli ją znasz. Bez niej Aniva odczyta datę z
pliku.

## Odpowiedź

API zwraca `201 Created`, gdy tylko zapisało plik, oraz `202 Accepted`, gdy trwa ekstrakcja.

**id** `string` *required*

ID dokumentu (UUID). Użyj go w [Pobierz wyniki dokumentu](https://docs.anivahealth.com/pl/api/documents/get-document-results.md) i
[Pobierz dokument](https://docs.anivahealth.com/pl/api/documents/download-document.md).

**status** `string` *required*

`processing`, gdy Aniva odczytuje wartości, lub `stored`, gdy plik jest tylko zapisany.

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

Profil, do którego należy dokument.

**document\_date** `string`

Wysłana przez ciebie data pobrania próbki lub data odczytana przez Aniva z zapisanego pliku. Może mieć wartość `null`.

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

Adres URL [Pobierz wyniki dokumentu](https://docs.anivahealth.com/pl/api/documents/get-document-results.md) dla tego dokumentu.

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

Nazwa pliku do wyświetlenia, taka sama, jaką wysyła [Pobierz dokument](https://docs.anivahealth.com/pl/api/documents/download-document.md).

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

Nazwa przesłanego przez ciebie pliku.

**origin** `string` *required*

Zawsze `partner_upload`.

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

Typ MIME pliku, np. `application/pdf`.

**etag** `string`

Wersja zawartości pliku. Może mieć wartość `null`.

**size\_bytes** `integer`

Rozmiar pliku w bajtach. Może mieć wartość `null`.

**lab\_code** `string`

Zawsze `null` dla przesłanego dokumentu.

## Odpowiedzi z błędami

| Status | Opis |
| - | - |
| `400` | Pole formularza jest nieprawidłowe lub treść żądania nie ma typu `multipart/form-data`. |
| `403` | Twojemu kluczowi API brakuje zakresu, profil jest poza twoim kontekstem dostępu lub przesyłasz `extract_results: true` bez `documents_extract_results`. |
| `404` | Nie znaleziono profilu. |
| `409` | `duplicate_document`: ten sam plik jest już na tym profilu. `document_id` wskazuje ten plik lub ma wartość `null`, gdy nie możesz go odczytać. Zwracany także przy konflikcie `Idempotency-Key`. |
| `413` | `file_too_large`: plik ma ponad 4 MB. |
| `415` | `unsupported_media_type`: plik nie jest w formacie PDF, DOC, DOCX, PNG ani JPEG. Nazwa pliku musi kończyć się na `.pdf`, `.doc`, `.docx`, `.png`, `.jpg` lub `.jpeg`. |
| `500` | Wewnętrzny błąd serwera. `extraction_not_started`: plik został zapisany jako `document_id`, ale nie udało się uruchomić ekstrakcji. Skontaktuj się z 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.