Por que é preciso uma API dedicada ao cálculo de impostos
O sistema tributário do Brasil é avaliado por instituições financeiras internacionais (FMI / OCDE) como um dos mais complexos do mundo. Só a circulação de mercadorias envolve:
- ICMS · imposto estadual sobre a circulação de mercadorias, legislado de forma independente por 27 estados, com alíquotas usuais de 7-25%
- ICMS-ST · substituição tributária, em que o fabricante ou distribuidor retém antecipadamente o imposto devido pela cadeia seguinte
- DIFAL · diferencial de alíquota estadual em operações interestaduais, que pode exigir recolhimento complementar ou restituição
- IPI · imposto federal sobre produtos industrializados, com alíquota definida por código NCM da mercadoria (mais de 10.000 tipos)
- PIS / COFINS · contribuições sociais federais (gradualmente substituídas pela CBS a partir de 2026)
- ISS · imposto sobre serviços (municipal, gradualmente substituído pelo IBS a partir de 2026)
- CBS / IBS de 2026 · novos tributos da reforma, com coexistência dos antigos e novos durante a transição
Para um ERP, implementar esses cálculos por conta própria é praticamente inviável: só o ICMS exige manter uma base de alíquotas multidimensional de 27 estados × categoria de mercadoria × tipo de cliente, e as alíquotas podem mudar todo mês. A taxa de erro do cálculo manual ultrapassa 30%, e o cálculo incorreto leva a notas recusadas, restituições complicadas e alto risco de conformidade.
Principais recursos da API de cálculo de impostos da TF Fiscal
1. Suporte a todos os tributos
Em uma única chamada, retorna o detalhamento de todos os tributos devidos. Sem necessidade de várias consultas.
2. Integração com o código NCM da mercadoria
Informe o código NCM da mercadoria (a classificação de mercadorias do Brasil, compatível com o código HS aduaneiro), e o sistema aplica automaticamente as alíquotas correspondentes de IPI e PIS / COFINS. Não conhece o código NCM? O recurso de correspondência aproximada de NCM pelo nome da mercadoria da TF Fiscal ajuda nessa tarefa.
3. Determinação automática do DIFAL interestadual
Quando o estado de origem ≠ o estado de destino, o sistema determina automaticamente se o DIFAL deve ser incluído e calcula o valor a recolher / a restituir conforme a diferença de alíquota com o estado de destino.
4. Base nacional de regras de ICMS-ST
Quais mercadorias exigem ICMS-ST? Qual a proporção da retenção antecipada? O que é a margem de valor agregado (MVA)? — tudo embutido na base de regras e aplicado automaticamente.
5. Identificação do tipo de cliente
A mesma mercadoria vendida a um "revendedor" vs. a um "consumidor final" vs. a uma "pequena empresa do Simples Nacional" segue cálculos de alíquota diferentes. A API permite informar o tipo de cliente para ajustar isso automaticamente.
6. Cálculo em duplo regime CBS / IBS
Durante a transição da reforma tributária, os tributos antigos e novos coexistem. A API retorna ao mesmo tempo o "imposto antigo" e o "imposto novo", para que você escolha a forma de declaração ou faça a conciliação.
Exemplo da API
POST /v1/tax/calculate
{
"ncm": "8517.12.31",
"valor": 1000.00,
"uf_origem": "SP",
"uf_destino": "RJ",
"tipo_cliente": "PJ_consumidor_final",
"regime_emit": "Lucro_Real"
}
Response:
{
"icms": { "aliquota": 0.18, "valor": 180.00 },
"icms_st": null,
"difal": { "aliquota": 0.02, "valor": 20.00 },
"ipi": { "aliquota": 0.15, "valor": 150.00 },
"pis": { "aliquota": 0.0165, "valor": 16.50 },
"cofins": { "aliquota": 0.076, "valor": 76.00 },
"cbs_simulacao_2026": { "valor": 87.00 },
"valor_total_com_impostos": 1442.50
}
Cenários típicos de uso
- Orçamento no ERP: cálculo de impostos em tempo real ao precificar a mercadoria, evitando divergências no valor da nota mais tarde
- Precificação de e-commerce: exibir preços com impostos diferentes conforme o estado de destino
- Conciliação financeira: comparar com o imposto efetivamente calculado em NF-e já emitidas, identificando anomalias
- Conciliação transfronteiriça: apuração das diferenças de impostos no acerto entre a entidade estrangeira e a entidade brasileira
Preços
- Cobrança por chamada: R$ 0,10 / chamada
- Solução corporativa personalizada: para clientes com grande volume de chamadas, cálculo em lote entre regiões e requisitos de SLA dedicado, oferecemos uma personalização individual: precificação anual / por pacote de linha de negócio, com gerente de conta dedicado, pool de recursos dedicado e suporte técnico prioritário. Fale com o time comercial para receber uma proposta →
Perguntas frequentes
P: E se eu não souber o código NCM?
Informe o nome da mercadoria, e o sistema faz a correspondência aproximada com os candidatos a NCM mais prováveis. Recomendamos que a definição final seja confirmada por você ou pela equipe fiscal da sua empresa.
P: Com que frequência a base de alíquotas é atualizada?
Fazemos uma varredura mensal dos atos de alíquotas dos 27 estados; em caso de reforma tributária de urgência, a sincronização ocorre em até 48 horas.
P: Posso usar para planejamento tributário?
É possível fazer simulações comparativas básicas, mas, para o planejamento em si, recomendamos consultar um profissional de tributação. Esta API faz apenas o cálculo de conformidade e não oferece recomendações de elisão.
Soluções relacionadas