A API Factum Parse se especializa na extração de dados de documentos administrativos e financeiros italianos, incluindo formatos XML e PDF de FatturaPA. Ela garante completa privacidade dos dados com sua política de Retenção Zero de Dados Estrita (ZDR), utilizando RAM volátil e mantendo total conformidade com as regulamentações do 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'
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Factum Parse API basta incluir seu token Bearer no cabeçalho Authorization.
| Cabeçalho | Descrição |
|---|---|
Authorization
|
Obrigatório
Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.
|
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.
(Economize 2 meses com cobrança anual 🎉)
A API Factum Parse é especializada na extração de dados de documentos administrativos e financeiros italianos, incluindo formatos XML e PDF FatturaPA. Garante a completa privacidade dos dados com sua política de Reter Dados Zero Estrita (ZDR), utilizando RAM volátil e mantendo total conformidade com as regulamentações do GDPR
O endpoint "Carregar Documento" retorna metadados sobre o documento carregado, incluindo ID do trabalho e status O endpoint "Analisar Documento" retorna dados JSON estruturados extraídos do documento, como detalhes do fornecedor e totais O endpoint "Obter Status do Carregamento" fornece o status e metadados do carregamento, enquanto o endpoint "Status do Serviço" oferece informações sobre a saúde do sistema, incluindo estatísticas do trabalho
Os campos principais incluem "job_id" (identificador único) "status" (estado de processamento) "document_type" (tipo de documento) "result" (dados analisados) e "content_hash" (hash do conteúdo do documento) Para o status do serviço campos como "total_jobs" e "done_jobs" fornecem insights sobre o desempenho do sistema
Os dados retornados estão estruturados no formato JSON Cada resposta contém pares de chave-valor organizados em objetos aninhados como "resultado" para dados analisados e "dados" para estatísticas de serviço Essa estrutura permite o acesso fácil a informações específicas como detalhes do fornecedor ou status do trabalho
O endpoint "Carregar Documento" fornece metadados de upload O endpoint "Analisar Documento" extrai dados detalhados de fatura incluindo informações do fornecedor e totais financeiros O endpoint "Obter Status de Upload" oferece status de processamento enquanto o endpoint "Status do Serviço" fornece uma visão geral da saúde do sistema e estatísticas de trabalho
Os dados de resposta são organizados em seções distintas com base no ponto de extremidade Por exemplo a resposta "Parse Document" inclui "job_id" "status" e um objeto "result" contendo detalhes da fatura analisada Essa organização ajuda os usuários a localizar rapidamente informações relevantes
Os dados são obtidos de faturas XML e PDF do FatturaPA italiano, garantindo conformidade com as estruturas administrativas italianas A API emprega uma arquitetura de Zero-Retention com foco na Privacidade, o que significa que nenhum dado é armazenado, aumentando a segurança e a privacidade dos dados
Casos de uso típicos incluem automação do processamento de faturas extração de dados financeiros para contabilidade e integração das informações de faturas em sistemas empresariais Os usuários podem aproveitar a saída JSON estruturada para relatórios e análises
Os usuários podem analisar o JSON estruturado para extrair campos específicos, como nomes de fornecedores ou valores totais, para processamento adicional. Esses dados podem ser integrados a sistemas financeiros ou utilizados para relatórios de conformidade, aumentando a eficiência operacional