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

# Puja un document

> Puja un informe de laboratori o qualsevol altre document a un perfil i, opcionalment, extreu-ne els valors de laboratori

Puja un fitxer a un perfil. Envia'l com a `multipart/form-data`. Sense `extract_results`, Aniva només
desa el fitxer. Amb `extract_results: true`, Aniva també llegeix els valors de laboratori del fitxer.

No cal que indiquis quin tipus d'informe és el fitxer. Aniva ho decideix. Un fitxer sense resultats de laboratori, com ara
una carta mèdica, acaba com a `stored` i no és un error.

Llegeix els valors amb [Obtén els resultats del document](https://docs.anivahealth.com/ca/api/documents/get-document-results.md). No cal que
facis consultes periòdiques: subscriu-te als [webhooks](https://docs.anivahealth.com/ca/concepts/webhooks.md) `document.results.*`.

Requereix l'àmbit `documents_upload` en un grup de perfils del perfil. `extract_results: true`
també requereix l'àmbit `documents_extract_results` al mateix grup. Demana a Aniva que els afegeixi. El
document pertany a aquest grup: les claus amb `results_view` en aquest grup llegeixen el document i els seus resultats.

Envia una capçalera opcional `Idempotency-Key` perquè la pujada es pugui reintentar de manera segura. Consulta
[Idempotència](https://docs.anivahealth.com/ca/concepts/idempotency.md).

## Què fa l'extracció

Amb `extract_results: true`:

1. Aniva envia el fitxer als seus subencarregats d'OCR i IA per llegir-ne els valors.
2. Els valors apareixen a l'app d'Aniva del membre, com qualsevol altre resultat.
3. Cada valor porta `origin: partner_upload` i el mateix `status` que qualsevol altre resultat. Un
   valor que la comprovació automàtica d'Aniva posa en dubte té l'estat `likely_wrong`.

Sense això, el fitxer no s'envia a cap servei extern si també envies `document_date`.

> [accordion] Precisió i protecció de dades
>
> * La lectura automàtica pot llegir malament un valor, una unitat o una data. El fitxer original
>   continua sent la font de referència. Contrasta-hi el valor abans de fer-lo servir per a una
>   decisió mèdica. Els valors extrets no són un diagnòstic.
> * Els subencarregats són Mistral AI (OCR, UE) i Google Cloud Vertex AI, als quals s'accedeix a
>   través de Vercel AI Gateway (extracció, pot processar dades fora de la UE). Només processen el
>   fitxer per llegir-lo.
> * Necessites una base jurídica per pujar les dades de salut d'un membre, normalment el seu
>   consentiment explícit. N'ets responsable.

## Sol·licitud

### Camps del formulari

**file** `file` *required*

El fitxer. PDF, DOC, DOCX, PNG o JPEG, de com a màxim 4 MB.

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

UUID del perfil al qual pertany el document.

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

`true` per llegir els valors de laboratori del fitxer. Envia `true` o `false`.

**document\_date** `string`

La data de la mostra en format `YYYY-MM-DD`, si la saps. Sense aquesta dada, Aniva llegeix la data
del fitxer.

## Resposta

L'API retorna `201 Created` quan només ha desat el fitxer, i `202 Accepted` quan s'executa l'extracció.

**id** `string` *required*

ID del document (UUID). Fes-lo servir amb [Obtén els resultats del document](https://docs.anivahealth.com/ca/api/documents/get-document-results.md) i
[Descarrega el document](https://docs.anivahealth.com/ca/api/documents/download-document.md).

**status** `string` *required*

`processing` mentre Aniva extreu els valors, o `stored` quan el fitxer només s'ha desat.

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

El perfil al qual pertany el document.

**document\_date** `string`

La data de la mostra que has enviat, o la que Aniva ha llegit d'un fitxer desat. Pot ser `null`.

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

L'URL d'[Obtén els resultats del document](https://docs.anivahealth.com/ca/api/documents/get-document-results.md) d'aquest document.

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

Nom del fitxer per mostrar, el mateix que envia [Descarrega el document](https://docs.anivahealth.com/ca/api/documents/download-document.md).

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

El nom del fitxer que has pujat.

**origin** `string` *required*

Sempre `partner_upload`.

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

Tipus de contingut del fitxer, p. ex., `application/pdf`.

**etag** `string`

Versió del contingut del fitxer. Pot ser `null`.

**size\_bytes** `integer`

Mida del fitxer en bytes. Pot ser `null`.

**lab\_code** `string`

Sempre `null` per a un document pujat.

## Respostes d'error

| Estat | Descripció |
| - | - |
| `400` | Un camp del formulari no és vàlid o el cos no és `multipart/form-data`. |
| `403` | A la teva clau d'API li falta un àmbit, el perfil és fora del teu context d'accés o has enviat `extract_results: true` sense `documents_extract_results`. |
| `404` | No s'ha trobat el perfil. |
| `409` | `duplicate_document`: el mateix fitxer ja és en aquest perfil. `document_id` l'identifica, o és `null` quan no el pots llegir. També s'envia en cas de conflicte d'`Idempotency-Key`. |
| `413` | `file_too_large`: el fitxer supera els 4 MB. |
| `415` | `unsupported_media_type`: el fitxer no és PDF, DOC, DOCX, PNG ni JPEG. El nom del fitxer ha d'acabar en `.pdf`, `.doc`, `.docx`, `.png`, `.jpg` o `.jpeg`. |
| `500` | Error intern del servidor. `extraction_not_started`: el fitxer s'ha desat com a `document_id`, però no s'ha pogut iniciar l'extracció. Contacta amb 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.