Motor de cálculo de impostos para ERP: API em tempo real
Como um motor de cálculo de impostos, conectado por API fiscal, leva o imposto já decidido ao ERP, ao e-commerce e ao integrador, antes da emissão da nota.
API fiscal de cálculo ou de emissão de nota: qual a diferença?
São duas camadas que trabalham em sequência. A API de cálculo decide o imposto de cada pedido antes do faturamento, considerando o regime do comprador, a NCM e o par de UFs. A API de emissão transforma o pedido em NF-e, NFC-e ou NFS-e e transmite à SEFAZ ou à prefeitura. A Mastery atua na primeira: calcula e entrega os valores ao ERP, que segue emitindo pela solução que já usa.
| API de cálculo | API de emissão | |
|---|---|---|
| Quando atua | Antes do faturamento, no pedido | Depois do pedido fechado |
| O que recebe | Comprador, produto, NCM, UFs e valores | Pedido com os tributos já definidos |
| O que devolve | Tributos desagregados e base legal | XML autorizado, protocolo e DANFE |
| Quem decide o imposto | A API de cálculo | Ninguém: ela transmite o que recebeu |
| Exemplo | Motor Fiscal B2B | Agentic Tax, da Mastery | O emissor do seu ERP ou um emissor por API |
Quando o imposto chega errado ao emissor, a nota sai errada ou é rejeitada. Por isso o cálculo vem antes e a emissão confia nele.
Como a API fiscal funciona dentro do ERP
- O ERP ou o e-commerce envia o pedido para a API.
- O Aprova CNPJ, a frente de aprovação da Mastery, confere o comprador em diversas bases: CNPJ, inscrição estadual e regime.
- O Motor Fiscal B2B aplica a NCM do catálogo, mantido enquadrado item a item conforme a legislação muda, e calcula os tributos para aquele par de UFs.
- A resposta volta ao ERP com os tributos desagregados, pronta para o pedido e para a nota.
O que entra: CNPJ do comprador, produtos com NCM e valores, UF de origem e de destino.
O que sai: ICMS, ICMS-ST, DIFAL, FCP e IPI desagregados, a projeção de IBS e CBS da Reforma, a base legal de cada tributo e a situação do comprador.
As regras ficam do lado do motor, não dentro do ERP. Quando um estado muda alíquota ou benefício, a atualização acontece no motor e o ERP recebe o valor novo na próxima chamada. A Mastery calcula; não emite a nota e não recolhe o tributo.
Veja o Motor Fiscal B2B funcionandoDemonstração em tela do produto, no YouTubeUma API aberta para ERP, e-commerce e integradores
A API da Mastery é aberta, no mesmo modelo das grandes plataformas de comércio, como a Shopify: o seu sistema chama a API e recebe a resposta, sem trocar de ERP e sem depender de um conector exclusivo. A conexão segue três caminhos: direto no ERP, pela plataforma de e-commerce ou pelo integrador que já atende a sua empresa. Em todos eles, a Mastery funciona como camada complementar: o ERP continua dono do pedido, do cadastro e da nota.
- ERPs: SAP, Oracle, TOTVS e Sankhya.
- Plataformas de e-commerce: VTEX, Zydon, GoDeep e Shopify.
- Integradores: a mesma API atende o parceiro que já cuida da integração dos seus sistemas.
Para plataformas com integração prévia, como a VTEX, o setup leva 10 dias úteis. A VTEX usa a Mastery na loja de demonstração da plataforma.
Segurança: a API roda no Google Cloud
Toda a infraestrutura da Mastery roda no Google Cloud, a mesma base de segurança, escala e confiabilidade usada por grandes operações no mundo inteiro. Os dados trafegam e ficam armazenados com criptografia, com controle de acesso, redundância geográfica e monitoramento contínuo.
A infraestrutura do Google Cloud é certificada nas normas ISO/IEC 27001, 27017 e 27018 e auditada nos relatórios SOC 1, SOC 2 e SOC 3. Quem conecta o ERP à Mastery opera sobre essa base. Como a Mastery opera sobre ela está na página de governança.
O que a TI deve avaliar numa API fiscal para ERP
- Cobertura: quais tributos e quantas UFs a API calcula.
- Comprador no cálculo: se o regime e a inscrição estadual entram na conta, ou só o produto.
- Momento: se o cálculo acontece antes do faturamento ou só confere a nota depois.
- Atualização de regras: quem mantém a legislação em dia, o fornecedor ou a sua equipe.
- Reforma Tributária: se a resposta já traz IBS e CBS ao lado do ICMS.
- Conexão: se a API conversa com o ERP, o e-commerce e o integrador, ou só com um deles.
- Segurança: onde a API roda e quais certificações a infraestrutura tem.
- Modelo: se a API complementa o ERP ou exige trocar o motor fiscal dele.
Antes de contratar, vale uma prova de conceito curta e com escopo fechado:
- Escopo limitado: uma plataforma, cerca de dez produtos representativos, três UFs de destino e dois regimes de comprador.
- Critérios definidos antes do teste: tributos cobertos, situação do comprador no cálculo, comportamento quando uma fonte de dado oscila e clareza da memória de cálculo.
- Integração em ambiente de teste, conduzida pela TI junto com o fornecedor.
- Conferência fiscal: o time fiscal compara cada resultado com o que espera e marca as divergências.
- Relatório: o resultado de cada critério e a recomendação final.
Quando a integração fiscal quebra, e o que a API faz antes da nota
| Erro | Causa comum | O que a API faz antes da nota |
|---|---|---|
| Alíquota ou ST errada | NCM desatualizada no cadastro | Aplica a NCM do catálogo enquadrado e monitorado |
| DIFAL ou ST indevidos | Comprador sem inscrição estadual ativa ou com regime errado | Confere o comprador em diversas bases antes do cálculo |
| Benefício aplicado fora de hora | Regra estadual mudou e o ERP não acompanhou | Mantém a regra atualizada do lado do motor |
| Valores divergentes na transição | ICMS, IBS e CBS convivendo até 2033 | Devolve o cálculo atual com a projeção de IBS e CBS |
| Nota rejeitada | Tributo divergente descoberto só na emissão | Entrega o valor calculado antes do faturamento |
Um caso real de integração
Um exemplo real de integração da Mastery, com o depoimento do gerente de TI do cliente, está no caso Midea.
Parametrização tributária no ERP ou motor de cálculo externo?
Parametrização tributária é o cadastro das regras fiscais dentro do ERP: para cada combinação de produto, operação, UF de origem, UF de destino e perfil do comprador, alguém define CFOP, CST, alíquota, base de cálculo e exceções. Funciona enquanto as combinações são poucas e a legislação muda devagar.
No e-commerce B2B as combinações se multiplicam. O mesmo item vai para revenda, uso e consumo ou industrialização, em 27 unidades da federação, com ST, DIFAL e benefícios estaduais. Cada mudança de regra vira uma nova linha para manter, e o erro só aparece na nota. Na transição da Reforma, IBS e CBS entram nas mesmas tabelas até 2033.
Com um motor de cálculo de impostos externo, o ERP continua dono do cadastro e da nota, e a decisão tributária chega pela API, com a regra atualizada pelo fornecedor. A parametrização no ERP fica com o que é da empresa: cadastro de produto, regime e regras comerciais próprias. A Mastery calcula; a emissão da nota e o recolhimento continuam com o ERP e com a empresa.
Onde o ERP continua sendo o lugar certo
Um motor de cálculo ao lado do ERP não toma o lugar dele. Há rotinas em que o ERP segue sendo a ferramenta certa, e separar esses papéis evita retrabalho na integração.
Fechamento contábil e fiscal do mês
Apuração dos tributos, SPED Fiscal, SPED Contribuições, ECF e ECD são funções do ERP ou da ferramenta contábil. O motor entrega o cálculo certo de cada pedido; a apuração consolidada continua no ERP.
Compras e contas a pagar
Cotação, ordem de compra, recebimento e contas a pagar seguem inteiros no ERP. O motor de cálculo não entra nessa cadeia.
Conciliação e caixa
Conciliação bancária, fluxo de caixa e tesouraria ficam no ERP ou em ferramentas próprias. O motor calcula o tributo do pedido e não substitui o controle de caixa.
Perguntas frequentes
O que é uma API fiscal para ERP?
É a interface que conecta o cálculo de impostos ao ERP: o ERP envia o pedido e recebe os tributos desagregados antes da nota.
A API fiscal da Mastery emite nota fiscal?
Não. Ela calcula e entrega os valores ao ERP. A emissão segue no emissor que o ERP já usa.
Preciso trocar de ERP?
Não. A API funciona como camada complementar; o ERP continua dono do pedido e da nota.
Como a Mastery se conecta ao meu ERP, e-commerce ou integrador?
Pela API, por três caminhos: direto no ERP (SAP, Oracle, TOTVS e Sankhya), pela plataforma de e-commerce (VTEX, Zydon, GoDeep e Shopify) ou pelo integrador que já atende a sua empresa.
A API já calcula IBS e CBS?
Sim. A resposta traz o cálculo atual e a projeção de IBS e CBS da Reforma.
A API também valida o comprador?
Sim. O Aprova CNPJ confere CNPJ, inscrição estadual e regime em diversas bases, no mesmo fluxo.
Quanto tempo leva a integração?
Para plataformas com integração prévia, como a VTEX, o setup leva 10 dias úteis. Nos demais casos, o prazo é definido na conversa inicial, conforme o ERP e o integrador.
A API é segura?
Sim. Toda a infraestrutura roda no Google Cloud, com criptografia, controle de acesso e monitoramento contínuo, sobre uma base certificada em ISO/IEC 27001 e auditada em SOC 2.
Conecte o fiscal ao seu ERP
A Mastery é a plataforma fiscal B2B: um motor fiscal Agentic Tax que analisa e decide o imposto de cada pedido em tempo real, integrado ao seu ERP ou e-commerce, e um hub de aprovação e enriquecimento de dados fiscais para vendas a CNPJ.
Conectar meu ERP, e-commerce ou integrador →Pronto para automatizar sua operação fiscal?
Entre em contato e fale com um dos sócios. Retornaremos em até 24h úteis.