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

# Subir documento

> Subir un informe de laboratorio o cualquier otro documento a un perfil y, opcionalmente, extraer sus valores de laboratorio

Sube un archivo a un perfil. Envíalo como `multipart/form-data`. Sin `extract_results`, Aniva solo
almacena el archivo. Con `extract_results: true`, Aniva también extrae los valores de laboratorio del archivo.

No tienes que indicar qué tipo de informe es el archivo. Aniva lo decide. Un archivo sin resultados de laboratorio, como
una carta del médico, termina como `stored` y no supone un error.

Consulta los valores con [Obtener resultados del documento](https://docs.anivahealth.com/es/api/documents/get-document-results.md). No necesitas hacer
polling: suscríbete a los [webhooks](https://docs.anivahealth.com/es/concepts/webhooks.md) `document.results.*`.

Requiere el permiso `documents_upload` en un grupo de perfiles del perfil. `extract_results: true`
también requiere el permiso `documents_extract_results` en el mismo grupo. Pide a Aniva que los añada. El
documento pertenece a ese grupo: las claves con `results_view` en él pueden leer el documento y sus resultados.

Envía una cabecera opcional `Idempotency-Key` para que sea seguro reintentar la subida. Consulta
[Idempotencia](https://docs.anivahealth.com/es/concepts/idempotency.md).

## Qué hace la extracción

Con `extract_results: true`:

1. Aniva envía el archivo a sus subprocesadores de OCR e IA para leer los valores.
2. Los valores aparecen en la app de Aniva del miembro, como cualquier otro resultado.
3. Cada valor lleva `origin: partner_upload` y el mismo `status` que cualquier otro resultado. Un valor
   del que duda la comprobación automática de Aniva tiene el estado `likely_wrong`.

Sin ella, el archivo no se envía a ningún servicio externo si también envías `document_date`.

> [accordion] Precisión y protección de datos
>
> * La lectura automática puede leer mal un valor, una unidad o una fecha. El archivo original sigue siendo la fuente de
>   verdad. Comprueba el valor con él antes de usarlo para una decisión médica. Los valores extraídos no
>   son un diagnóstico.
> * Los subprocesadores son Mistral AI (OCR, UE) y Google Cloud Vertex AI, a través de
>   Vercel AI Gateway (extracción, puede procesar fuera de la UE). Solo procesan el archivo para
>   leerlo.
> * Necesitas una base legal para subir los datos de salud de un miembro, normalmente su consentimiento
>   explícito. Eres responsable de ello.

## Solicitud

### Campos del formulario

**file** `file` *required*

El archivo. PDF, DOC, DOCX, PNG o JPEG, como máximo 4 MB.

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

UUID del perfil al que pertenece el documento.

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

`true` para leer los valores de laboratorio del archivo. Envía `true` o `false`.

**document\_date** `string`

La fecha de la muestra en formato `YYYY-MM-DD`, si la conoces. Sin ella, Aniva lee la fecha del
archivo.

## Respuesta

La API devuelve `201 Created` cuando solo ha almacenado el archivo y `202 Accepted` cuando se ejecuta la extracción.

**id** `string` *required*

ID del documento (UUID). Úsalo con [Obtener resultados del documento](https://docs.anivahealth.com/es/api/documents/get-document-results.md) y
[Descargar documento](https://docs.anivahealth.com/es/api/documents/download-document.md).

**status** `string` *required*

`processing` mientras Aniva extrae los valores, o `stored` cuando el archivo solo se almacena.

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

El perfil al que pertenece el documento.

**document\_date** `string`

La fecha de la muestra que enviaste o la que Aniva leyó de un archivo almacenado. Puede ser `null`.

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

La URL de [Obtener resultados del documento](https://docs.anivahealth.com/es/api/documents/get-document-results.md) de este documento.

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

Nombre del archivo para mostrar, el mismo que envía [Descargar documento](https://docs.anivahealth.com/es/api/documents/download-document.md).

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

El nombre del archivo que subiste.

**origin** `string` *required*

Siempre `partner_upload`.

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

Tipo de medio del archivo, p. ej., `application/pdf`.

**etag** `string`

Versión del contenido del archivo. Puede ser `null`.

**size\_bytes** `integer`

Tamaño del archivo en bytes. Puede ser `null`.

**lab\_code** `string`

Siempre `null` para un documento subido.

## Respuestas de error

| Estado | Descripción |
| - | - |
| `400` | Un campo del formulario no es válido o el cuerpo no es `multipart/form-data`. |
| `403` | A tu clave API le falta un scope, el perfil está fuera de tu contexto de acceso o enviaste `extract_results: true` sin `documents_extract_results`. |
| `404` | Perfil no encontrado. |
| `409` | `duplicate_document`: el mismo archivo ya está en este perfil. `document_id` lo indica, o es `null` cuando no puedes leerlo. También se envía por un conflicto de `Idempotency-Key`. |
| `413` | `file_too_large`: el archivo supera los 4 MB. |
| `415` | `unsupported_media_type`: el archivo no es PDF, DOC, DOCX, PNG ni JPEG. El nombre del archivo debe terminar en `.pdf`, `.doc`, `.docx`, `.png`, `.jpg` o `.jpeg`. |
| `500` | Error interno del servidor. `extraction_not_started`: el archivo se ha almacenado como `document_id`, pero no se pudo iniciar la extracción. Contacta con 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.