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:
| Categoria | Formatos |
|---|
| PDF | .pdf |
| Imagenes | .jpg, .jpeg, .png, .gif, .webp, .tiff, .bmp |
| Hojas de cálculo | .xlsx, .xls, .ods, .csv |
| Texto | .txt, .html, .xml, .json |
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"
}
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"}
]
}
{
"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.
