API Docs
API da Reforma Tributária para ERPs fiscais, agentes e sistemas próprios.
Conecte produtos fiscais, ERPs, suporte e agentes próprios à API de fontes oficiais tributárias da FonteIA. A API da Reforma Tributária entrega evidências estruturadas ou respostas citáveis com fonte oficial, URL, data, trecho e limitação.
O problema não é usar IA. É usar IA sem fonte verificável.
Modelos de IA são excelentes para organizar linguagem, resumir cenários e acelerar análise. Mas, quando trabalham sem uma base confiável, atualizada e organizada, eles podem preencher lacunas com respostas plausíveis, porém falsas.
Normas, manuais, comunicados e páginas oficiais ficam em portais diferentes, com formatos e datas distintas.
Sem URL, data e trecho usado, a equipe não consegue revisar rapidamente se a orientação tem fundamento oficial.
Uma resposta fiscal convincente, mas incorreta, pode virar atendimento, requisito de produto ou decisão interna.
API Docs
O que a API da Reforma Tributária resolve.
A API não é uma exportação de documentos. Ela entrega evidências oficiais para a IA do cliente ou respostas prontas quando o produto precisa de síntese citável.
Buscar evidências
Use `/evidence/search` quando sua IA, agente ou sistema precisa receber documentos, trechos e fontes antes da síntese.
Responder com fundamento
Use `/answers` quando o sistema precisa devolver uma resposta em linguagem natural, acompanhada de citações oficiais.
Gerar briefings
Use `/impact/brief` para apoiar análises de impacto operacional em áreas fiscais, contábeis e de produto.
Monitorar mudanças
Use `/changes/recent` e `/timeline` para acompanhar atualizações oficiais e construir rotinas de revisão.
Contrato técnico com foco em rastreabilidade.
Cada integração deve preservar a diferença entre texto oficial, síntese FonteIA e limitação da resposta.
As chamadas usam `Authorization: Bearer` e ficam associadas ao cliente, plano, ambiente e escopos permitidos.
Limites protegem a base contra extração em massa e ajudam a prever consumo por produto, agente ou equipe.
A resposta pode carregar fonte, URL, data, trecho, metadados e indicação de suficiência da evidência.
Comece por busca e respostas. Evolua para briefings, monitoramento e consultas por documento conforme o fluxo amadurece.
Endpoints principais.
A referência pública deve ser usada para planejar a integração antes de gerar tokens e limites de produção.
/evidence/search
Busca evidências e documentos candidatos sem forçar uma síntese final.
/answers
Retorna uma resposta fundamentada sobre Reforma Tributária com fontes oficiais.
/impact/brief
Gera briefing de impacto operacional a partir de uma pergunta ou cenário.
/changes/recent
Lista mudanças oficiais recentes disponíveis para o cliente autenticado.
/timeline
Monta linha do tempo regulatória sobre tema, norma ou documento.
/documents/lookup
Localiza documento, artigo, seção ou trecho oficial de forma controlada.
Exemplos compatíveis com o contrato V2.
Os valores abaixo são ilustrativos, mas os campos, tipos e estados seguem o OpenAPI publicado. Use `/answers` para receber síntese citável e `/evidence/search` quando seu sistema controla a síntese.
Resposta fundamentada para um ERP
O estado `partial` preserva uma resposta útil sem esconder que parte da pergunta ainda exige revisão.
Payload
POST /v1/answers
{
"question": "Como funciona a apuração assistida da CBS?",
"domain": "reforma_tributaria",
"mode": "fast",
"max_citations": 3,
"profile": "interactive_fast",
"purpose": "avaliar impacto em ERP fiscal"
}
Resposta
200 · partial
{
"contract_version": "v2.0",
"request_id": "req_01K5...",
"status": "partial",
"confidence": "medium",
"confidence_reason": "Há fonte oficial para o conceito, mas a operação depende de atos complementares.",
"latency_ms": 842,
"answer": "A apuração assistida deve ser acompanhada pelos atos e manuais oficiais antes de virar requisito fechado no ERP.",
"citations": [
{
"marker": 1,
"evidence_id": "ev_01K5...",
"url": "https://www.gov.br/receitafederal/...",
"date": "2026-05-21",
"locator": "Seção Apuração assistida",
"excerpt": "Trecho oficial retornado pela consulta."
}
],
"coverage_matrix": {
"conceito": "supported",
"procedimento_operacional": "partial"
},
"limitations": ["A implementação pode depender de atos e manuais posteriores."]
}Evidências para síntese no seu sistema
O endpoint de evidências devolve trechos e metadados para o backend aplicar sua própria regra, interface ou revisão.
Payload
POST /v1/evidence/search
{
"query": "documentos fiscais com IBS e CBS",
"domain": "reforma_tributaria",
"source_groups": ["receita_federal"],
"limit": 3,
"profile": "sources_only",
"purpose": "preparar requisito de ERP"
}
Resposta
200 · completed
{
"contract_version": "v2.0",
"request_id": "req_01K6...",
"status": "completed",
"latency_ms": 391,
"query": "documentos fiscais com IBS e CBS",
"items": [
{
"marker": 1,
"evidence_id": "ev_01K6...",
"source_group": "receita_federal",
"source_name": "Portal da Receita Federal",
"source_org": "Receita Federal",
"title": "Documento técnico oficial",
"url": "https://www.gov.br/receitafederal/...",
"date": "2026-06-02",
"locator": "Seção Documentos fiscais",
"excerpt": "Trecho oficial retornado pela busca.",
"score": 0.92,
"quality_score": 0.96,
"selection_reason": "Fonte oficial diretamente relacionada à consulta.",
"limitations": []
}
],
"total_returned": 1,
"summary": "Uma evidência oficial foi localizada."
}Quando a base não sustenta uma resposta
O estado `no_evidence` evita que ausência de fonte seja transformada em uma conclusão plausível.
Payload
POST /v1/answers
{
"question": "Qual regra definitiva ainda não publicada se aplica ao meu caso?",
"domain": "reforma_tributaria",
"mode": "fast",
"profile": "sources_only",
"purpose": "validar requisito antes da implementação"
}
Resposta
200 · no_evidence
{
"contract_version": "v2.0",
"request_id": "req_01K7...",
"status": "no_evidence",
"confidence": "none",
"confidence_reason": "Nenhuma evidência oficial suficiente foi localizada.",
"latency_ms": 278,
"answer": "A base consultada não sustenta uma resposta para esta pergunta.",
"citations": [],
"coverage_matrix": {},
"limitations": ["Revise a pergunta ou aguarde publicação oficial aplicável."]
}Dúvidas comuns.
A API serve apenas para busca simples?
Não. A API foi desenhada para alimentar fluxos profissionais: busca de evidências, respostas fundamentadas, briefings de impacto, consulta por documento, linha do tempo e monitoramento de mudanças oficiais.
Consigo gerar análises profundas em sistemas próprios?
Sim. Use `/answers` ou combine `/evidence/search`, `/documents/lookup`, `/timeline` e `/impact/brief` para montar análises com fonte, URL, data, trecho, contexto e limitações explícitas antes da revisão final.
Quando devo usar evidências em vez de resposta pronta?
Use `/evidence/search` quando seu agente, ERP ou backend precisa controlar a síntese, aplicar regra própria, registrar logs ou mostrar os trechos oficiais diretamente na interface. Use `/answers` quando precisa de uma resposta já fundamentada.
A API pode apoiar produto, suporte e governança?
Sim. Ela pode levar evidência oficial para backlog fiscal, suporte ao usuário, agentes internos, painéis de revisão, documentação técnica e rotinas de acompanhamento da Reforma Tributária.
Os limites são separados do MCP e do ChatGPT?
Não. A cota é compartilhada entre site, API, MCP, Claude, ChatGPT, agentes e sistemas próprios. Uma pergunta conta uma vez, mesmo quando exige várias chamadas técnicas. O volume pode ser ajustado em Planos & Uso.
Precisa integrar um produto próprio?
Comece pela API de fontes oficiais tributárias quando sua equipe precisa levar fonte oficial, evidência e resposta citável para um sistema fora da interface da FonteIA.