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 petición de procesamiento en Matil incluye uno o más documentos. Un documento es la entrada que quieres procesar — una factura, un contrato, un DNI o cualquier otro archivo. Matil acepta documentos en varios formatos, para que puedas integrar independientemente de como almacenes o recibas tus archivos.

​
Tipos de archivo soportados

Matil puede procesar una amplia variedad de formatos:
CategoriaFormatos
PDF.pdf
Imagenes.jpg, .jpeg, .png, .gif, .webp, .tiff, .bmp
Hojas de cálculo.xlsx, .xls, .ods, .csv
Texto.txt, .html, .xml, .json
El tamano maximo de archivo es 50 MB.

​
Formatos de entrada

​
URL

Apunta a un documento alojado online. Matil lo descarga y lo procesa automaticamente. Esta es la forma más comun de enviar documentos. 
{
  "type": "url",
  "url": "https://ejemplo.com/factura.pdf"
}

​
Base64

Envía archivos binarios directamente en el cuerpo de la petición. Útil cuando tienes archivos en memoria. 
{
  "type": "base64",
  "content": "JVBERi0xLjQK...",
  "mime_type": "application/pdf"
}
Asi se codifica un archivo en Python: 
import base64

with open("documento.pdf", "rb") as f:
    encoded = base64.b64encode(f.read()).decode("utf-8")

document = {
    "type": "base64",
    "content": encoded,
    "mime_type": "application/pdf"
}

​
Texto plano

Envía contenido de texto directamente. Útil cuando ya tienes el texto extraído. 
{
  "type": "text",
  "text": "FACTURA\n\nNumero de factura: FAC-2024-001\nFecha: 15 de enero de 2024\nTotal: 150.00 EUR"
}

​
Multiples documentos

Puedes enviar varios documentos en una sola petición. Matil los procesa juntos como una unidad — util para documentos multipagina que llegan como archivos separados. 
{
  "documents": [
    {"type": "url", "url": "https://ejemplo.com/pagina1.pdf"},
    {"type": "url", "url": "https://ejemplo.com/pagina2.pdf"}
  ]
}

​
Anadir metadata

Puedes adjuntar metadata personalizada a cualquier petición. Esta metadata se almacena con el resultado y se devuelve en las respuestas y webhooks — util para correlacionar resultados con tu sistema. 
{
  "documents": [
    {"type": "url", "url": "https://ejemplo.com/factura.pdf"}
  ],
  "metadata": {
    "pedido_id": "PED-12345",
    "origen": "bandeja-email",
    "cliente_id": "cli_abc"
  }
}
Usa metadata para vincular los resultados de Matil con registros de tu propia base de datos. Esto facilita la correspondencia entre entradas procesadas y su origen.

​
Siguientes pasos

Modos de procesamiento

Procesa muchos documentos eficientemente con el modo batch.

Structures

Aprende como extraer datos estructurados de tus documentos.