{
"job_id": "",
"status": "done",
"document_type": "fattura",
"confidence": 1,
"content_hash": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
"result": {
"schema_version": "2.0",
"document_type": "invoice",
"meta": {
"cost_eur": 0,
"confidence": 1,
"provider": "fast-path",
"prompt_version": "fast-path-v1"
},
"payload": {
"kind": "invoice",
"dati_trasmissione": {
"id": "example"
},
"cedente_prestatore": {
"nome": "Example SRL",
"partita_iva": "IT01234567890"
},
"cessionario_committente": {
"nome": "Cliente SpA"
},
"corpi": [
{
"numero": "INV-001",
"data": "2026-08-15",
"importo": 122
}
]
}
},
"error": null
}
curl --location --request POST 'https://zylalabs.com/api/13523/factum+parse+api/30047/parse+document' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{}'
{
"status": "ok"
}
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以提取特定字段,例如供应商名称或总金额,以便进一步处理。这些数据可以集成到财务系统中或用于合规报告,从而提高运营效率