La API Factum Parse se especializa en la extracción de datos de documentos administrativos y financieros italianos, incluidos los formatos XML y PDF de FatturaPA. Garantiza la privacidad completa de los datos con su política de Estricto Cero Retención de Datos (ZDR), utilizando RAM volátil y manteniendo el pleno cumplimiento de las regulaciones del GDPR
{
"job_id": "3f2b5e6a-0000-4000-8000-000000000004",
"doc_type": "fattura_pa_xml",
"content_hash": "a1b2c3d4e5f67890",
"size_bytes": 2841,
"mime_type": "text/xml",
"deduplicated": false,
"status": "done"
}
curl --location --request POST 'https://zylalabs.com/api/13523/factum+parse+api/30046/upload+document' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{}'
{
"job_id": "3f2b5e6a-0000-4000-8000-000000000004",
"status": "done",
"document_type": "fattura",
"provider_used": "fast-path-xml",
"prompt_version": "fattura-v1",
"confidence": 1,
"cost_usd": 0,
"tokens": 0,
"fallbacks": [],
"content_hash": "a1b2c3d4e5f67890",
"result": {
"supplier": {
"name": "Company SRL",
"vat_id": "IT01234567890"
},
"totals": {
"net_amount": 100,
"vat_amount": 22,
"total_amount": 122
}
}
}
curl --location --request POST 'https://zylalabs.com/api/13523/factum+parse+api/30047/parse+document' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"job_id": "3f2b5e6a-0000-4000-8000-000000000004",
"doc_type": "auto"
}'
{
"job_id": "3f2b5e6a-0000-4000-8000-000000000004",
"doc_type": "fattura_pa_xml",
"content_hash": "a1b2c3d4e5f67890",
"size_bytes": 2841,
"mime_type": "text/xml",
"deduplicated": false,
"status": "done"
}
curl --location --request GET 'https://zylalabs.com/api/13523/factum+parse+api/30048/get+upload+status' --header 'Authorization: Bearer YOUR_API_KEY'
{
"status": "ok",
"service": "factum-parse",
"version": "0.1.0",
"environment": "dev",
"uptime_seconds": 0,
"data": {
"total_jobs": 30,
"done_jobs": 18,
"failed_jobs": 3,
"pending_jobs": 9,
"last_parse_at": "2026-08-13T10:27:42.876838+00:00",
"cost_per_doc_usd": 0.00021
}
}
curl --location --request GET 'https://zylalabs.com/api/13523/factum+parse+api/30049/service+status' --header 'Authorization: Bearer YOUR_API_KEY'
Después de registrarte, a cada desarrollador se le asigna una clave de acceso a la API personal, una combinación única de letras y dígitos proporcionada para acceder a nuestro endpoint de la API. Para autenticarte con el Factum Parse API simplemente incluye tu token de portador en el encabezado de Autorización.
| Encabezado | Descripción |
|---|---|
Autorización
|
Requerido
Debería ser Bearer access_key. Consulta "Tu Clave de Acceso a la API" arriba cuando estés suscrito.
|
Sin compromiso a largo plazo. Mejora, reduce o cancela en cualquier momento. La Prueba Gratuita incluye hasta 50 solicitudes.
(Ahorra 2 meses pagando anualmente 🎉)
Factum Parse API se especializa en la extracción de datos de documentos administrativos y financieros italianos, incluidos los formatos XML y PDF de FatturaPA. Asegura la completa privacidad de los datos con su política de Estricto Cero Retención de Datos (ZDR), utilizando RAM volátil y manteniendo el pleno cumplimiento de las regulaciones del GDPR.
El endpoint "Subir Documento" devuelve metadatos sobre el documento subido, incluyendo el ID del trabajo y su estado. El endpoint "Analizar Documento" devuelve datos JSON estructurados extraídos del documento, como detalles del proveedor y totales. El endpoint "Obtener Estado de Subida" proporciona el estado y metadatos de la subida, mientras que el endpoint "Estado del Servicio" ofrece información sobre la salud del sistema, incluyendo estadísticas del trabajo
Los campos clave incluyen "job_id" (identificador único) "status" (estado de procesamiento) "document_type" (tipo de documento) "result" (datos analizados) y "content_hash" (hash del contenido del documento) Para el estado del servicio campos como "total_jobs" y "done_jobs" proporcionan información sobre el rendimiento del sistema
Los datos devueltos están estructurados en formato JSON Cada respuesta contiene pares de clave-valor organizados en objetos anidados como "resultado" para datos analizados y "datos" para estadísticas del servicio Esta estructura permite un acceso fácil a información específica como detalles del proveedor o estado del trabajo
El punto final "Cargar Documento" proporciona metadatos de carga El punto final "Analizar Documento" extrae datos detallados de la factura incluyendo información del proveedor y totales financieros El punto final "Obtener Estado de Carga" ofrece estado de procesamiento mientras que el punto final "Estado del Servicio" brinda una visión general de la salud del sistema y estadísticas de trabajo
Los datos de respuesta se organizan en secciones distintas según el punto final Por ejemplo la respuesta de "Analizar Documento" incluye "job_id" "estado" y un objeto "resultado" que contiene los detalles de la factura analizada Esta organización ayuda a los usuarios a localizar rápidamente la información relevante
Los datos provienen de facturas en XML y PDF de FatturaPA italianas, asegurando el cumplimiento de los marcos administrativos italianos. La API utiliza una arquitectura de Privacidad Primero Cero Retención, lo que significa que no se almacena ningún dato, lo que mejora la seguridad y privacidad de los datos
Los casos de uso típicos incluyen la automatización del procesamiento de facturas la extracción de datos financieros para la contabilidad y la integración de la información de las facturas en los sistemas empresariales Los usuarios pueden aprovechar la salida JSON estructurada para informes y análisis
Los usuarios pueden analizar el JSON estructurado para extraer campos específicos como nombres de proveedores o montos totales para un procesamiento adicional. Estos datos se pueden integrar en sistemas financieros o utilizarse para informes de cumplimiento mejorando la eficiencia operativa