Saltar al contenido principal

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.

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
}
CampoDescripción
entry_idID único de este resultado.
resource_typeSiempre "structure".
resource_idLa estructura utilizada para la extracción.
resource_version_numberLa versión de la estructura aplicada.
dataLos datos extraídos como JSON estructurado.
errorsErrores de validación, si los hay. null cuando todo es correcto.
statuscompleted, completed_with_errors o failed.
time_msTiempo de procesamiento en milisegundos.
priceCoste 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
}

​
Siguientes pasos

Structures

Define que datos se extraen en las entries.

Manejo de errores

Gestiona errores de procesamiento y casos limite.