> ## Documentation Index
> Fetch the complete documentation index at: https://docs.matil.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Entries

> Cada resultado procesado se almacena como una entry — consúltala, revísala y corrígela.

Cada vez que Matil procesa un documento, el resultado se almacena como una **entry**. Una entry contiene los datos extraídos, errores de validación, metadata de procesamiento y un ID único.

Las entries son tu registro de lo que se ha extraído. Puedes consultarlas después, revisar los resultados y enviar correcciones.

## Qué contiene una entry?

Cuando procesas un documento de forma síncrona, la respuesta es:

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "entry_id": "01934b1a-89ab-7def-0123-456789abcdef",
  "resource_type": "structure",
  "resource_id": "01934b1a-1234-7abc-0000-111122223333",
  "resource_version_number": 1,
  "data": {
    "numero_factura": "FAC-2024-001",
    "fecha": "2024-01-15",
    "total": 1250.00
  },
  "errors": null,
  "status": "completed",
  "time_ms": 2340,
  "price": 0.05
}
```

| Campo                     | Descripción                                                        |
| ------------------------- | ------------------------------------------------------------------ |
| `entry_id`                | ID único de este resultado.                                        |
| `resource_type`           | Siempre `"structure"`.                                             |
| `resource_id`             | La estructura utilizada para la extracción.                        |
| `resource_version_number` | La versión de la estructura aplicada.                              |
| `data`                    | Los datos extraídos como JSON estructurado.                        |
| `errors`                  | Errores de validación, si los hay. `null` cuando todo es correcto. |
| `status`                  | `completed`, `completed_with_errors` o `failed`.                   |
| `time_ms`                 | Tiempo de procesamiento en milisegundos.                           |
| `price`                   | Coste de esta petición.                                            |

## Consultar entries

Consulta una entry específica por su ID:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl "https://api.matil.ai/v3/entries/{entry_id}" \
  -H "x-api-key: tu-api-key"
```

## Correcciones

Si los datos extraídos no son del todo correctos, puedes enviar una corrección:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -X POST "https://api.matil.ai/v3/entries/{entry_id}/correction" \
  -H "x-api-key: tu-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "data": {
      "numero_factura": "FAC-2024-001",
      "total": 1350.00
    }
  }'
```

La respuesta confirma cuantos patches se aplicaron:

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "entry_id": "01934b1a-89ab-7def-0123-456789abcdef",
  "patches_applied": 1
}
```

## Siguientes pasos

<CardGroup cols={2}>
  <Card title="Structures" href="/es/guides/structures">
    Define que datos se extraen en las entries.
  </Card>

  <Card title="Manejo de errores" href="/es/api-reference/error-handling">
    Gestiona errores de procesamiento y casos limite.
  </Card>
</CardGroup>