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.
Exemplo de resposta da API.
Use `/answers` quando um ERP fiscal, agente ou sistema próprio precisa receber uma síntese curta já acompanhada de evidências oficiais verificáveis.
Payload
POST /answers
{
"question": "Como funciona a apuração assistida da CBS?",
"domain": "reforma_tributaria",
"mode": "fast",
"audience": "erp",
"answer_style": "executive",
"require_citations": true,
"max_citations": 3,
"purpose": "avaliar impacto em ERP fiscal"
}
Resposta
200 OK
{
"answer_id": "ans_01HZ...",
"mode": "fast",
"answer": "A apuração assistida da CBS deve ser tratada como fluxo sujeito a acompanhamento oficial. Para ERPs fiscais, a implementação exige monitorar atos, manuais e orientações da Plataforma RTC antes de transformar a resposta em requisito fechado.",
"confidence": "medium",
"citations": [
{
"citation_id": "cit_01HZ...",
"title": "Manual da Plataforma da Reforma Tributária do Consumo",
"source": "Receita Federal",
"official_url": "https://www.gov.br/receitafederal/...",
"source_date": "2026-05-21",
"locator": {
"type": "section",
"value": "Apuração assistida"
},
"excerpt": "Trecho oficial usado para sustentar a resposta...",
"excerpt_is_literal": true
}
],
"limitations": [
{
"code": "implementation_requires_review",
"message": "A implementação operacional pode depender de atos e manuais posteriores."
}
],
"usage": {
"citations_returned": 1,
"request_id": "req_01HZ..."
}
}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?
O consumo deve seguir a mesma lógica de plano e governança da conta, para evitar uso imprevisível entre API, MCP, Claude, ChatGPT, agentes e sistemas próprios.
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.