Se a equipe de tecnologia da sua empresa ainda está esperando um endpoint da Receita Federal para calcular IBS e CBS a cada pedido, o cronograma já passou por cima dessa expectativa. A obrigatoriedade de destacar os novos tributos na NF-e e na NFC-e começou em 3 de agosto de 2026. A NFS-e de serviços em geral entrou em 1º de outubro. As demais famílias de documentos, incluindo Simples Nacional, ficam entre dezembro de 2026 e janeiro de 2027.

O ponto que trava muitos projetos não é a data, é a arquitetura. A Receita Federal não vai oferecer uma API de nuvem para calcular impostos. A Calculadora de Tributos é um motor de código aberto com conteúdo normativo embarcado, distribuído para execução local. Quem não entendeu isso ainda está dimensionando o problema errado.

Por que não existe uma API pública da Calculadora de Tributos

A Receita Federal declarou, no FAQ oficial do piloto da Calculadora, que não está prevista a disponibilização de APIs públicas para cálculo online. A justificativa é operacional: manter um serviço de cálculo contínuo em produção exigiria infraestrutura dedicada e sustentação permanente, o que tornaria a iniciativa economicamente inviável.

O que existe é o oposto de um serviço centralizado. A integração com ERPs e sistemas emissores acontece por meio do consumo local do módulo offline, que expõe uma API REST dentro do ambiente do contribuinte. Há um simulador web para consultas pontuais, mas ele tem finalidade demonstrativa e não se conecta a sistemas externos. Confundir os dois é o erro que faz empresas contratarem prazo de integração sem ter integração nenhuma.

A consequência prática é direta: a responsabilidade de operar o cálculo migra para dentro da sua infraestrutura. Você passa a ser o dono da disponibilidade, da versão e da atualização desse motor.

O que o motor offline realmente faz

A Calculadora é um motor de cálculo com conteúdo. Ela não apenas soma alíquotas: decide o tratamento tributário de cada operação a partir da combinação entre CST e cClassTrib, cruzando NCM ou NBS, local e data do fato gerador. Devolve valor, memória de cálculo e a referência legal aplicada.

O conteúdo normativo vem embarcado, ancorado na Lei Complementar nº 214/2025 e na tabela CST × cClassTrib. Quando a legislação muda, a atualização chega por uma nova versão do componente, não por parametrização manual item a item. Isso reduz o risco de a sua equipe "interpretar" a regra por conta própria e produzir nota inconsistente.

O componente pode rodar de três formas: imagem Docker, JAR com Java 21 ou via WSL no Windows. Os serviços locais ficam expostos em http://localhost:8080/api para o regime geral e em http://localhost:8081/api para o split payment simplificado, com interface web em http://localhost. A documentação é entregue em Swagger.

Entre os recursos estão os assistentes Gerador e Validador de XML, memória de cálculo, compartilhamento de simulações e dados abertos como alíquotas, NCM, NBS e a matriz completa de classificações tributárias.

O cronograma que define a urgência

O Ato Conjunto RFB/CGIBS nº 4, de 30 de julho de 2026, escalonou a obrigatoriedade por tipo de documento. A tabela abaixo resume os marcos que ainda pressionam os times técnicos.

Documento Início da obrigatoriedade Observação para o ERP
NF-e e NFC-e (regime regular) 03/08/2026 Já em vigor; campos IBS/CBS obrigatórios
NFS-e de serviços em geral 01/10/2026 Flexibilidade de recepção no ADN, sem rejeição automática
NFCom, DeRE (eventos de tabela), DIR 01/10/2026 Comunicação, cadastros e importação de remessa
NFGas, NFAg, NF-e ABI, plataformas digitais, locações, condomínios, NFS-e específicas 01/12/2026 Maior bloco de viradas simultâneas
Simples Nacional e Duimp 01/01/2027 Última janela antes do regime pleno

Cronograma urgente

Durante 2026, a apuração de IBS e CBS é informativa e sem efeitos tributários, desde que as obrigações acessórias sejam cumpridas. Isso não tira a urgência: é na fase de teste que a esteira de integração precisa estar estável. A alíquota de teste é de 1% no total, sendo 0,1% de IBS e 0,9% de CBS.

Onde encaixar o cálculo no fluxo do pedido

O cálculo não pode virar uma etapa que o usuário aciona no meio do faturamento. Ele precisa ser determinístico e invisível para quem opera. A matriz abaixo ajuda a decidir onde a chamada entra.

Ponto de integração Quando faz sentido Risco principal
Na gravação do item do pedido Regras comerciais claras e catálogo maduro Reprocessar pedidos antigos com regra nova
No fechamento da nota Operação já consolidada, com dados fiscais completos Latência no pico de emissão
Em serviço intermediário (sidecar/microsserviço) Sistema legado com núcleo difícil de alterar Duplicação de fonte de verdade se mal isolado
Só na validação antes do envio Baixo volume e tolerância a ajuste manual Retrabalho quando o cálculo reprova

A escolha depende de quanto o seu sistema já conhece sobre a operação no momento da chamada. Um ERP que grava cClassTrib no cadastro do produto precisa de menos esforço do que um emissor que só descobre o enquadramento no fim do processo.

Impacto na infraestrutura e no banco de dados

Rodar o motor localmente não é pesado, mas exige planejamento. O contêiner precisa de portas reservadas, memória dedicada e uma política de atualização de versão que não coincida com a janela de fechamento fiscal. Emissões em lote no fim do mês são o pior momento para reiniciar serviço.

Coloque o motor atrás de um health check e trate indisponibilidade como evento de negócio, não como erro genérico. Se a calculadora cair, o faturamento precisa saber exatamente o que fazer: reter a nota, enfileirar ou bloquear a emissão.

No banco, o trabalho maior é de modelagem. Os campos novos têm formato e origem definidos:

  • CST do IBS/CBS — 3 dígitos, tabela própria;
  • cClassTrib — 6 dígitos, cada código vinculado a um dispositivo da LC 214/2025;
  • NCM ou NBS — conforme o tipo de bem ou serviço;
  • Alíquotas — pIBSUF, pCBS e, quando aplicável, o Imposto Seletivo;
  • Base de cálculo — vBC, com o grupo de informações por item.

A pergunta que define o esforço é simples: sua base trata classificação tributária como atributo de produto ou como dado de transação? Se hoje ela não existe em lugar nenhum, o trabalho é de cadastro e curadoria, não de código. Esse costuma ser o gargalo real dos projetos, e é onde uma modernização gradual do sistema legado rende mais do que uma reescrita completa.

Validação antes do envio evita rejeição de lote

O assistente Validador de XML existe para ser usado antes da SEFAZ, não depois. Ele verifica a aderência do documento às regras de conformidade, o que corta uma classe inteira de rejeições que só aparecem quando o lote já voltou com erro.

A estratégia que funciona na prática é em três camadas:

  1. Validação de schema no próprio emissor, barata e instantânea;
  2. Validação de regras com o assistente oficial, incluindo estrutura CST × cClassTrib;
  3. Reenvio controlado com log da memória de cálculo, para auditoria e disputa futura.

A memória de cálculo é o ativo mais subestimado aqui. Ela documenta por que cada valor foi aplicado, com base legal. Guardar esse histórico por documento transforma uma discussão com a fiscalização em consulta, não em arqueologia.

Sidecar ou mexer no núcleo do legado

Aqui vale a transparência que separa uma decisão boa de uma decisão cara. Se o seu ERP já tem camada de serviços bem definida, integrar a calculadora no fluxo existente é o caminho mais direto. Se o núcleo é monolítico, com regras fiscais espalhadas e difícil de testar, insistir em alterá-lo pode paralisar o faturamento na pior hora.

Nesses casos, um serviço isolado que recebe os dados do item, consulta o motor offline e devolve o grupo tributário pronto é a alternativa mais segura. O núcleo legado continua funcionando e só passa a consumir um contrato novo. É a mesma lógica de isolamento que sustenta uma integração de loja virtual com ERP sem duplicar pedidos: a regra crítica vive em um lugar só, com fronteira clara.

O padrão se repete em outras viradas regulatórias. Preparar o sistema para a integração do Pix Automático exigiu o mesmo tipo de raciocínio: fluxo de autorização, webhook e tratamento de falha desenhados antes da obrigatoriedade, não durante.

Checklist técnico de prontidão

  • O motor offline está publicado com health check e política de atualização de versão definida?
  • As portas 8080, 8081, 9091 e 9092 estão reservadas e monitoradas no ambiente de produção?
  • CST, cClassTrib, NCM/NBS e alíquotas têm lugar definido no modelo de dados?
  • Existe rotina de curadoria para manter as classificações tributárias corretas por produto ou serviço?
  • O assistente Validador de XML está na esteira de testes automatizados?
  • A memória de cálculo é persistida e recuperável por documento?
  • A indisponibilidade do motor tem plano B descrito, sem surpresa para o time de faturamento?
  • A versão do motor usada em homologação é a mesma de produção?

Uma equipe que responde "não sei" a três desses itens ainda não está pronta para a próxima virada, mesmo que a emissão atual esteja passando.

ERPs refatorados

A decisão de arquitetura diante da reforma tributária não é contratar mais um sistema, é decidir onde o cálculo passa a viver. O motor é oficial, é aberto e é seu para operar. Quem trata isso como dependência externa vai descobrir na virada de dezembro que não havia fornecedor do outro lado.

O caminho pragmático é preparar o ambiente local, isolar a regra tributária em um ponto único e automatizar a validação antes do envio. A Site Sob Medida apoia empresas que precisam integrar regras tributárias a ERPs legados sem travar a operação, decidindo junto com o time técnico onde a camada de cálculo entra e o que fica intacto. Se o seu emissor ainda não tem esse mapa, vale um diagnóstico de arquitetura antes que o calendário decida por você.