Entries

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:

{
  "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:

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:

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:

{
  "entry_id": "01934b1a-89ab-7def-0123-456789abcdef",
  "patches_applied": 1
}

Primeros pasos

Conceptos

Qué contiene una entry?

Consultar entries

Correcciones

Siguientes pasos

Structures

Manejo de errores

​Qué contiene una entry?

​Consultar entries

​Correcciones

​Siguientes pasos

Structures

Manejo de errores

Qué contiene una entry?

Consultar entries

Correcciones

Siguientes pasos