Pular para o conteúdo
Integrações

A análise fiscal do TributoX, onde a operação acontece.

O seu ERP, sistema contábil ou plataforma financeira envia a operação e recebe de volta uma análise estruturada, com a regra, a versão e a norma citada. Quem usa o seu sistema vê o resultado sem sair dele.

Plataforma, API e Google Drive.

Três formas de levar o TributoX para o seu trabalho. Cada uma tem a sua condição de acesso.

  • Plataforma TributoXConsulta, carteira, documentos, oportunidades e relatórios na interface web, para escritórios e empresas. Carteira por planilha e XML de NF-e (um a um ou em .zip) são enviados na ficha de cada cliente.
  • API fiscalEndpoints versionados em /api/fiscal/v1, JSON de entrada e saída e OpenAPI pública. A auditoria de uma operação responde na mesma chamada; a sugestão fiscal devolve um job_id e o resultado é consultado até concluir.Liberado por contrato.
  • Google DriveConecte o Drive para ler documentos na conversa e salvar relatórios na sua pasta, sem baixar e reenviar arquivos.

Como um ERP envia uma operação e recebe a análise.

O caminho de uma chamada real, do pedido no ERP à decisão do fiscal. Os campos e respostas estão na documentação.

curl https://api.tributox.studiolabsai.com/api/fiscal/v1/auditar \
  -H "Authorization: Bearer $TRIBUTOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"entrada": "Venda de produção própria, NCM 84713012, de SP para BA em 2026-03-10, origem 0, para contribuinte do ICMS, emitente no Simples Nacional."}'

# 200: regras_icms.aliquota_interestadual = { "status": "determinado", "valor": "7.00", ... }
#      regras_icms.difal = { "status": "inconclusivo", "faltando": ["finalidade_aquisicao"] }

Exemplo com dados fictícios

  • O ERP envia a operaçãoPedido, nota a emitir ou nota recebida, com NCM, origem, destino, regime e destinatário, em POST /api/fiscal/v1/auditar, como texto da operação ou XML da NF-e.
  • O TributoX processaAlíquota interestadual, CFOP e DIFAL saem de regras versionadas, com a fonte e a versão. A IA só extrai os campos; não decide valor.
  • O resultado volta estruturadoCada campo volta como determinado, inconclusivo ou revisão necessária, com os fundamentos e a lista do que falta. Para dúvida interpretativa, POST /api/fiscal/v1/sugerir traz regras, exceções, base legal e grau de confiança.
  • O ERP mostra no fluxoAlerta antes de emitir, sugestão de correção ou fila de revisão para o fiscal, conforme a regra do seu produto.
Guia completo de integração na documentação

Quem autoriza o acesso, e o que cada sistema ganha.

A API é liberada por contrato. Cada parceiro recebe uma credencial exclusiva, com escopos, empresas autorizadas e limites definidos no contrato; quando o contrato lista empresas, o CNPJ vai no header X-TributoX-CNPJ.

  • ERPsConferência fiscal da operação antes da emissão, com a decisão por campo e a norma.
  • Sistemas contábeisAnálise fundamentada para o contador dentro da rotina de escrituração.
  • Plataformas financeirasLeitura tributária de operações e documentos dos clientes da plataforma, com a evidência junto do resultado.
  • Software houses e sistemas própriosInteligência fiscal como recurso do seu produto ou da operação interna, sem manter a regra internamente.

Compatível não é homologado.

Qualquer sistema que faça uma chamada HTTPS com JSON consegue usar a API. Isso é compatibilidade. Integração homologada, certificação ou parceria comercial com uma marca específica só aparece aqui quando estiver firmada e funcionando.

Isolamento por chave, banco de dados em São Paulo, trilha de cada chamada e a mesma política de LGPD da plataforma.