{
"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'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 事实解析 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。
(年度计费可节省 2 个月 🎉)
“上传文档”端点返回有关上传文档的元数据,包括作业 ID 和状态“解析文档”端点返回从文档中提取的结构化 JSON 数据,例如供应商详细信息和总计“获取上传状态”端点提供上传的状态和元数据,而“服务状态”端点提供系统健康信息,包括作业统计
关键字段包括“job_id”(唯一标识符) “status”(处理状态) “document_type”(文档类型) “result”(解析数据)和“content_hash”(文档内容的哈希)对于服务状态,“total_jobs”和“done_jobs”等字段提供了对系统性能的洞察
返回的数据采用JSON格式结构。每个响应包含组织成嵌套对象的键值对,例如“result”用于解析的数据,“data”用于服务统计。这种结构便于访问特定信息,比如供应商详细信息或工作状态
“上传文档”端点提供上传元数据 “解析文档”端点提取详细的发票数据,包括供应商信息和财务总额 “获取上传状态”端点提供处理状态 “服务状态”端点提供系统健康和工作统计的概述
响应数据根据终端点组织为不同的部分。例如,“解析文档”响应包括“job_id”、“status”和一个包含解析后的发票详细信息的“result”对象。这种组织方式帮助用户快速找到相关信息
数据来源于意大利FatturaPA XML和PDF发票,确保符合意大利行政框架。该API采用隐私优先的零保留架构,意味着不存储数据,从而增强了数据安全性和隐私性
典型的用例包括自动化发票处理 提取财务数据用于会计 以及将发票信息集成到业务系统中 用户可以利用结构化的JSON输出进行报告和分析
用户可以解析结构化的JSON以提取特定字段,例如供应商名称或总金额,以便进一步处理。这些数据可以集成到财务系统中或用于合规报告,从而提高运营效率