Motor de Cálculo de Tributos - Conceitos

O Motor de Cálculo Tributário (Taxes) é uma ferramenta automatizada desenvolvida para simplificar e garantir a conformidade na gestão de tributos da sua empresa. A legislação brasileira exige extrema precisão no cálculo de impostos como ICMS, PIS, COFINS, IPI e DIFAL na emissão da Nota Fiscal Eletrônica (NF-e). Nosso motor realiza todo esse processamento para você.

Cálculo de impostos é cobrado à parte

O Motor de Cálculo de Tributos é um serviço cobrado separadamente da emissão da nota fiscal. Não há etapa de ativação: o consumo é registrado sempre que você:

• emite uma NF-e ou NFC-e com o grupo taxDetermination preenchido em pelo menos um item;
• chama diretamente a API de Cálculo de Impostos ou o método calculate dos SDKs;
• cadastra ou atualiza produtos com regras tributárias no Cadastro de Produto.

Para emitir sem o motor, informe os impostos no grupo tax e não envie taxDetermination.

O valor e a forma de cobrança são definidos no seu plano comercial. Confirme com o time comercial antes de usar o motor em produção.

1. O que é e como funciona?

O cálculo de impostos no Brasil varia de acordo com inúmeros fatores, tais como a localização do remetente e do destinatário, o regime tributário de ambos, a classificação fiscal (NCM/CEST) do produto e o tipo da operação (venda, revenda, devolução, etc.).

O Motor de Cálculo Tributário da NFE.io analisa todos esses cenários em tempo real. Você informa os dados básicos da operação comercial e da mercadoria, e o nosso motor processa as regras fiscais vigentes e retorna os valores, alíquotas, códigos (como CFOP, CST/CSOSN) e bases de cálculo prontos para a emissão da NF-e.

2. Modelos de Utilização

Nosso motor adapta-se à complexidade do seu negócio através de dois cenários principais de uso:

2.1. Regras Padrão (Standard)

Neste modelo, o sistema utiliza a inteligência tributária nativa em tempo real.

• Como funciona: Você envia os parâmetros da operação (emitente, destinatário, produto e valores) no momento de solicitar o cálculo.
• Vantagem: Não é necessário cadastrar os produtos previamente. O motor se encarrega de aplicar a regra geral com máxima precisão.

2.2. Regras Customizadas (Cadastro de Produtos)

Ideal para empresas que possuem particularidades fiscais, benefícios específicos (como redução de base de cálculo, isenções) ou regimes especiais que divergem da tributação padrão.

• Como funciona: Você realiza o cadastro dos seus produtos em nossa plataforma configurando os cenários tributários customizados (customTax).
• Vantagem: Quando o cálculo for acionado para um produto cadastrado e as condições da operação baterem com a sua regra, o motor prioriza a sua customização, substituindo o cálculo padrão.

3. Os Pilares do Cálculo Tributário

Para garantir que o cálculo seja correto e aplicável à operação, o motor baseia-se em quatro pilares de dados:

1. Emitente: O seu estado (UF), perfil fiscal (ex: varejista, indústria, atacadista) e regime tributário (Lucro Real, Presumido, Simples Nacional). O regime dita regras cruciais, determinando se será usado CST (2 dígitos) ou CSOSN (3 dígitos) no ICMS.
2. Destinatário: A UF de destino, regime e, principalmente, o perfil (consumidor final, contribuinte de ICMS, etc.). Isso afeta diretamente a formação da partilha do DIFAL, por exemplo.
3. Produto: Informações detalhadas do item que está sendo negociado, destacando-se a NCM (classificação fiscal), CEST (para casos de substituição tributária) e a Origem (nacional, importada, etc.).
4. Operação: Qual a natureza do movimento? (ex: Venda de produto próprio, transferência entre filiais, entrada por devolução). A inteligência do motor mapeia internamente os códigos de operação.

4. O Que o Motor Retorna?

O retorno do motor consiste em todo o pacote de informações exigido pelo layout da NF-e em relação à tributação:

• CFOP: O Código Fiscal de Operações e Prestações correto para a operação faturada.
• ICMS: Modalidade de determinação da base de cálculo, CST/CSOSN, valor da base, alíquota aplicável e valor do imposto.
• ICMS ST: Cálculos completos para Substituição Tributária (incluindo ICMS ST retido).
• DIFAL: Diferencial de Alíquota e partilha entre os estados remetente e destinatário (aplicável a consumidor final em operações interestaduais).
• FCP: Valores referentes ao Fundo de Combate à Pobreza.
• PIS, COFINS, IPI e II: Respectivos cálculos de base, alíquota e valores finais para impostos federais.

5. Visão Geral do Fluxo

O Motor de Cálculo de Tributos pode ser acionado diretamente via API antes da emissão da nota fiscal, para simulações e validações do carrinho de compras (checkout), ou atuar automaticamente no momento da emissão da nota fiscal, sempre que a nota for enviada com o grupo taxDetermination, gerando o documento já com todos os tributos devidamente preenchidos. Nos dois casos, o uso do motor é cobrado à parte da emissão.

Dica para Desenvolvedores: Para visualizar exemplos técnicos e payloads completos do motor de cálculo, acesse nossa collection no Postman: https://api.postman.com/collections/13456751-85dce505-ec19-4086-b2ed-fd6adfa49b41?access_key=PMAT-01JKE6X6T47G7JGRYDNV5XRD1S