API fiscal para ERP: cálculo tributário em tempo real
Como uma API fiscal conecta o cálculo de impostos 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.
Os critérios técnicos estão detalhados em como avaliar uma API de cálculo fiscal.
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.
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. Calcula, não recolhe.
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.