Saltar al contenido principal
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.