💡 Mapa do Cluster Reforma Tributária (Sem Sobreposição): Para a resolução geral do Anexo VIII e eliminação do Erro E363/E637, consulte nosso guia pilar API NFS-e e a Reforma Tributária: Como Implementar IBS/CBS (Anexo VIII) e o co-pilar de payload Como Emitir IBS e CBS na NFS-e Nacional: Schema DPS v1.01. Já o roteamento híbrido entre prefeituras e SNNFSE está documentado em Resolução CGSN 189 e 191/2026 e Código 990101. Neste artigo, dissecamos exclusivamente as entregas das releases
v0.56.160av0.56.164(w0.33.154/@notaas/mcp v0.2.8): o novo cronograma do Ato Conjunto RFB/CGIBS nº 7/2026, a guarda de competência retroativa (dCompet < 2026-11-01) na CGSN 191 e o motor público da Calculadora Oficial de IBS/CBS (/api/v1/rtc/calcular) com paridade integral ao repositórioReceitaFederal/calculadora-rtc-regime-regular.
Na última sexta-feira (13/11/2026), a Receita Federal e o Comitê Gestor do IBS publicaram o Ato Conjunto RFB/CGIBS nº 7/2026 (alterando o Ato Conjunto nº 4/2026), ao mesmo tempo em que o repositório oficial da calculadora da Reforma Tributária (ReceitaFederal/calculadora-rtc-regime-regular) recebeu uma bateria de migrações SQL (V0042 até V0059) e o manual de Perguntas Frequentes da NFS-e v1.3 trouxe novas travas sobre competência retroativa e omissão do grupo <gIBSCBS> em operações isentas ou imunes.
Para quem mantém um ERP, um SaaS B2B, uma plataforma imobiliária ou um escritório de contabilidade digital, o impacto imediato foi uma enxurrada de dúvidas contraditórias:
- "Afinal, empresas de SaaS (
01.03,01.05,01.09) e locadoras de imóveis (99.03) precisam destacar IBS/CBS agora em dezembro de 2026, em janeiro de 2027 ou só em março de 2027?" - "Por que meu cliente do Simples Nacional está tomando rejeição no SNNFSE ao emitir uma nota com data de competência (
dCompet) de outubro de 2026?" - "Por que a Sefin Nacional devolve erro
E0961/E0860quando informamosCST 400(Isenção) ouCST 410(Imunidade/Não incidência)?" - "Como simular exatamente a mesma memória de cálculo (
baseRGebaseSN) do motor Java da Receita Federal sem subir um container pesado na minha infraestrutura?"
Em vez de deixar cada software house codificar dezenas de if/else de datas e tabelas SQLite por conta própria, nós empacotamos toda essa inteligência diretamente no núcleo da Notaas (releases v0.56.160 e v0.56.164), liberamos um endpoint REST público gratuito (POST /api/v1/rtc/calcular) e adicionamos a 50ª tool (notaas_calculate_ibs_cbs_nfse) no nosso MCP Server Fiscal (@notaas/mcp v0.2.8).
A seguir, abro os detalhes técnicos do que mudou na norma, como o nosso motor decide isso em tempo de execução e como você pode consultar a calculadora oficial via API hoje mesmo.
O novo cronograma do Ato Conjunto RFB/CGIBS nº 7/2026: os 3 cortes oficiais (resolveRtcSchedule)
Um dos maiores erros que vejo em grupos de desenvolvedores é tratar a obrigatoriedade do destaque de IBS/CBS na NFS-e como uma data única para todo o Brasil. Com o Ato Conjunto RFB/CGIBS nº 7/2026, o legislador escalonou o início da obrigatoriedade combinando duas variáveis: o Regime Tributário do Prestador (normalizedRegime) e o Subitem da LC 116/2003 ou Grupo 99 (resolvedItemPrefix4).
Na Notaas, implementamos o módulo determinístico resolveRtcSchedule() (src/lib/nfse/rtc/rtc-schedule.ts), acoplado diretamente aos nossos gates de emissão (isRtcEnabled() nos workers nacionais e municipais e shouldUseSpV2() na Paulistana v2.0).
Veja na tabela abaixo a matriz exata que já está rodando em produção para todos os clientes da API:
Categoria no Motor Notaas (RtcScheduleCategory) |
Regime Tributário | Códigos de Serviço (cTribNac / LC 116) |
Início Oficial (mandatoryFromIso) |
Base Legal (Ato Conjunto RFB/CGIBS nº 7/2026) |
|---|---|---|---|---|
REGIME_NORMAL_GERAL_2026_10_01 |
Lucro Real / Lucro Presumido (regime = 1) |
Serviços gerais da LC 116/2003 (exceto 01.03, 01.05, 01.09, 16.01 e Grupo 99) |
2026-10-01 |
Art. 1º, II |
GRUPO_99_IMOVEIS_LOCACAO_CONDOMINIO_2027_01_01 |
Regime Normal ou Simples Nacional | 99.02 (Bens imateriais), 99.03 (Locação/cessão/arrendamento de imóveis), 99.04 (Locação de móveis), 99.05 (Condomínios edilícios) |
2027-01-01 |
Art. 1º, III, alíneas "d" a "h" |
SIMPLES_NACIONAL_GERAL_2027_01_01 |
Simples Nacional ME/EPP (regime = 3) |
Serviços gerais da LC 116/2003 (exceto 01.03, 01.05, 01.09 e 16.01) |
2027-01-01 |
Art. 1º, III, alínea "i" e § 1º, I |
TECH_SAAS_TRANSPORTE_2027_03_01 |
Regime Normal e Simples Nacional | 01.03 (Hospedagem/Cloud/Processamento), 01.05 (Licenciamento/SaaS), 01.09 (Streaming) e 16.01 (Transporte coletivo municipal) |
2027-03-01 |
Art. 1º, IV, alíneas "b" e "c", e § 1º, II |
MEI_DISPENSADO |
Microempreendedor Individual (regime = 2) |
Todos os códigos de serviço | null (Dispensado) |
Art. 2º, § 2º da LC 214/2025 |
O que isso significa na prática para ERPs de SaaS (01.05) e Sistemas Imobiliários (99.03)?
Se o seu sistema emite notas fiscais de licenciamento de software ou SaaS (cTribNac = 010501 ou 01.05) ou hospedagem/processamento de dados (010301), o destaque obrigatório do bloco <IBSCBS> foi oficialmente postergado para 01/03/2027, tanto para empresas do Lucro Presumido/Real quanto para optantes do Simples Nacional (mesma data de entrada em vigor da NF-e ABI — Modelo 77 para alienação de bens imóveis).
Já para administradoras de bens, imobiliárias e locadoras que utilizam os novos fatos geradores do Grupo 99 (99.03 — locação, cessão onerosa, arrendamento e servidão de bens imóveis; 99.04 — locação de bens móveis; 99.05 — cotas condominiais), o marco obrigatório passa a ser 01/01/2027.
⚡ Como o Gate
resolveRtcSchedule()protege sua integração na Notaas:
- 1. Sem
if/elsede calendário no seu ERP: Quando você enviaPOST /api/v1/emitir, a Notaas avalia a data de competência (dCompet) da nota contra a matriz acima (isMandatoryOnReferenceDate).- 2. Emissão Voluntária Antecipada vs. Omissão Segura: Se a nota de um SaaS (
010501) ou de uma empresa do Simples Nacional ainda não atingiu a data obrigatória e você não enviou overrides explícitos de IBS/CBS, o motor mantém o XML enxuto sem disparar erros de validação desnecessários. Se a data obrigatória já chegou (ou se você parametrizou os defaults no projeto para antecipar a transição), o motor resolve a tríade do Anexo VIII e injeta o grupo<IBSCBS>automaticamente.
Guarda de competência retroativa na Resolução CGSN nº 191/2026 (dCompet < 2026-11-01)
Enquanto o Ato Conjunto nº 7/2026 organizou o calendário futuro de 2027, um problema urgente explodiu no fechamento contábil de novembro de 2026: a emissão de notas retroativas de outubro (dCompet anterior a 01/11/2026) por empresas do Simples Nacional.
Como explicamos no nosso estudo sobre o roteamento híbrido das Resoluções CGSN 189 e 191/2026, a partir de novembro de 2026, empresas do Simples Nacional (regime_tributario = '3') passaram a ser roteadas para o Ambiente Nacional (SNNFSE ou el_nacional) em centenas de municípios que ainda mantêm emissor próprio para o Regime Normal.
Contudo, conforme diretriz técnica do CGNFS-e de 29/10/2026 e o Item 20.1 do Perguntas Frequentes da NFS-e v1.3 da Receita Federal, a Sefin Nacional rejeita Declarações de Prestação de Serviços (DPS) do Simples Nacional cuja data de competência (dCompet) seja anterior à vigência da obrigatoriedade em 01/11/2026 quando o município possuía sistema próprio naquela competência.
Para eliminar essa dor nos fechamentos retroativos de contabilidades e BPOs fiscais, adicionamos na release v0.56.160 a guarda minDCompetIso: '2026-11-01' diretamente no NfseSystemRouter.resolveWithTrace (src/lib/nfse/nfse-routing.ts):
⚡ Fluxo da Guarda Retroativa CGSN 191 (
isRetroactivePreCgsn191Competencia):
- 1. Inspeção de
dCompetantes do Enfileiramento: Tanto no endpoint unitário (POST /api/v1/emitir) quanto no lote (POST /api/v1/emitir/batch) e no serviço de reprocessamento (InvoiceRequeueService), o roteador extrai a data civil de competência da operação.- 2. Preservação Automática do Motor Municipal (
dCompet < '2026-11-01'): Se o emitente for optante pelo Simples Nacional em um município híbrido (cujo motor base éabrasf,betha,conam,el,tbw, etc.) e a competência informada for de outubro/2026 ou anterior (dCompet < '2026-11-01'), as políticasEL_NACIONAL_SIMPLES_CGSN_191eSIMPLES_NACIONAL_CGSN_191_ADN_EMISSORcedem lugar ao emissor municipal original.- 3. Competência Atual (
dCompet >= '2026-11-01'): Para qualquer nota com competência de novembro de 2026 em diante, o roteamento segue automaticamente para o SNNFSE / Padrão Nacional, sem que o contador ou o ERP precise trocar chaves ou configurações de projeto entre uma nota e outra.
Paridade 100% com o repositório ReceitaFederal/calculadora-rtc-regime-regular (Migrações B0001..V0059)
Para que uma API fiscal calcule e valide IBS e CBS com precisão cirúrgica, não basta ler o PDF da Lei Complementar nº 214/2025. Quem dita as regras reais de aceitação na Sefin Nacional é o banco de dados embutido na Calculadora Oficial de RTC da Receita Federal (ReceitaFederal/calculadora-rtc-regime-regular).
Na release v0.56.164 (w0.33.154), realizamos uma auditoria linha a linha contra todas as migrações Flyway do repositório oficial da Receita Federal (de B0001 até V0059), atingindo paridade absoluta de 1.515 / 1.515 tuplas ativas (0 divergências) no nosso catálogo rtc-tabela.json.
Dentre as atualizações críticas trazidas pelas migrações V0042 a V0058 da Receita Federal, destacam-se 13 novas tuplas que resolvem lacunas históricas de diversos setores de serviços:
Código Serviço (cTribNac / Item) |
NBS Oficial | cIndOp |
cClassTrib |
Redução de Alíquota (IBS/CBS) | Impacto Prático na Emissão |
|---|---|---|---|---|---|
990101 |
125032000 |
100301 |
000001 |
0% (Integral) | Zera o conjunto semCClassTrib no Anexo VIII (100% dos códigos mapeados). |
990302 a 990305 |
110022000 |
020201 |
200027 |
70% de redução | Locação, cessão onerosa, arrendamento e servidão de bens imóveis no Grupo 99. |
2901 e 3801 |
Catálogo RFB | Catálogo RFB | 200052 |
30% de redução | Biblioteconomia (29.01) e Museologia (38.01) como profissões intelectuais regulamentadas. |
0713 e 1709 |
Catálogo RFB | Catálogo RFB | 200038 |
60% de redução | Dedetização/controle ambiental (07.13) e Perícias/exames técnicos (17.09). |
0716 |
Catálogo RFB | Catálogo RFB | 200037 |
60% de redução | Florestamento, reflorestamento, semeadura e adubação (07.16). |
1211 |
Catálogo RFB | 030101 / 030102 |
200042 |
60% de redução | Competições esportivas ou de destreza física/intelectual (12.11). |
3901 |
Catálogo RFB | 050102 |
000001 |
0% (Integral) | Serviços de ourivesaria e lapidação (39.01). |
Além das tuplas de correlação, sincronizamos no rtc-calculator.ts toda a tabela PERCENTUAL_REDUCAO do banco oficial da Receita (CATALOGED_CCLASSTRIB_REDUCTIONS), cobrindo:
- Redução de 30% (
200052,200056,011005): Profissões intelectuais regulamentadas por conselho (engenharia, arquitetura, contabilidade, advocacia, biologia, etc.) e planos de saúde animal. - Redução de 40% (
200048,200051): Hotelaria, parques de diversão e agências de turismo. - Redução de 50% (
200046): Operações com bens imóveis (administração, intermediação, construção civil). - Redução de 60% (
200028a200045,011001..011003,515001): Educação (200028), Saúde humana (200029), Planos de saúde (011001), Produções artísticas/culturais, desporto, agro e segurança da informação/cibersegurança. - Redução de 70% (
200027) e 80% (200026): Locação, cessão e arrendamento de bens imóveis (70%) e projetos de reabilitação urbana em zonas históricas (80%). - Redução Assimétrica do PROUNI (
200025): Caso único na legislação onde a redução é de 100% na CBS (pRedCBS: 100) e 60% no IBS (pRedIBS: 60). - Alíquota Zero (
200001a200021,200054): Redução de 100% em ambos os tributos.
Duas armadilhas silenciosas resolvidas: CST 400/410 (E0961/E0860) e a Base Unificada (baseRG vs baseSN)
Quando analisamos o código-fonte Java do motor da Receita Federal (BaseCalculoUnificadaNfseService.java) e o Perguntas Frequentes v1.3 (pág. 166), encontramos duas regras críticas onde 90% das implementações caseiras falham.
1. Omissão obrigatória de <gIBSCBS> quando CST é 400, 410 ou 820 (ind_gIBSCBS = 0)
Na Nota Técnica 009 e nas tabelas de validação da Sefin Nacional, cada CST possui um indicador booleano chamado ind_gIBSCBS.
Quando a operação é de Isenção (CST 400 — ex: cClassTrib 400001), Imunidade / Não incidência (CST 410 — ex: 410001 a 410999), Suspensão (CST 550) ou Sem alíquota na operação (CST 800, 811, 820), o grupo de detalhamento de valores/alíquotas <gIBSCBS> não deve ser instanciado (ou as alíquotas efetivas são semTributacao: true), informando-se apenas <CST> e <cClassTrib>. Enviar alíquotas de teste (0,9% e 0,1%) dentro de um CST 400 ou 410 dispara imediatamente as rejeições E0961 e E0860 na Sefin Nacional.
2. A memória de cálculo oficial de vBC e o bloco baseCalculoUnificadaRfb
Como o valor da base de cálculo (vBC) do IBS e da CBS é calculado na NFS-e?
Segundo a fórmula oficial da Receita Federal implementada em calculateRtcSimulation():
- Em 2026 (
anoRegra = '2026'— Alíquotas de teste0,9% CBS+0,1% IBS"por fora"):- Abate-se do valor do serviço: o desconto incondicionado, o reembolso/repasse tributado na origem (
gReeRepRes), o valor do ISSQN incidente na operação (uma única vez, independentemente de o ISS ser retido na fonte ou pago pelo próprio prestador!) e o PIS/COFINS próprio da operação. - Os valores calculados de IBS e CBS em 2026 têm caráter meramente informativo e não somam no
vTotNF(somaNoTotalDaNota = false).
- Abate-se do valor do serviço: o desconto incondicionado, o reembolso/repasse tributado na origem (
- A partir de 2027 (
anoRegra = '2027'— Extinção do PIS/COFINS):- O PIS e a COFINS deixam de existir (não há dedução de PIS/COFINS próprio) e o valor de IBS/CBS passa a somar no total da nota (
somaNoTotalDaNota = true, comparando o efeito "por fora" vs. "por dentro").
- O PIS e a COFINS deixam de existir (não há dedução de PIS/COFINS próprio) e o valor de IBS/CBS passa a somar no total da nota (
- A exceção do Subitem
99.03(Locação de Imóveis) no Simples Nacional (EXXX-LOC-SN):- Espelhando exatamente a classe
BaseCalculoUnificadaNfseService.javada Receita Federal, a nossa calculadora retorna o objetobaseCalculoUnificadaRfbcontendobaseRG(Base do Regime Geral de IBS/CBS) ebaseSN(Base do Simples Nacional). - Se o código de serviço pertencer ao grupo
99.03(Locação/cessão de bens imóveis), onde constitucionalmente não incide ISSQN, qualquervalorIssoualiquotaIssenviado por engano não deduz abaseRG, e o motor emite o alerta oficialEXXX-LOC-SNcaso o contribuinte seja do Simples Nacional. - Se o emitente for MEI (
regimeTributario = '2'), o blocobaseCalculoUnificadaRfbretornabaseRG: null,baseSN: nulle o código oficial da RFBE1302("A calculadora de base de cálculo unificada da NFS-e não se aplica ao MEI").
- Espelhando exatamente a classe
Como usar o novo endpoint público POST /api/v1/rtc/calcular (Sem API Key)
Para ajudar desenvolvedores, arquitetos de ERP e contadores a validarem qualquer cenário da Reforma Tributária sem precisar baixar o projeto Java da Receita Federal, liberamos o endpoint público GET e POST https://platform.notaas.com.br/api/v1/rtc/calcular (protegido por rate-limit de 30 requisições/minuto por IP).
Em uma única chamada JSON, você recebe:
obrigatoriedade: O diagnóstico completo do Ato Conjunto RFB/CGIBS nº 7/2026 (category,mandatoryFromIso,isMandatoryOnReferenceDateelegalBasis);classificacaoTributaria: A resolução da tríade oficial do Anexo VIII (nbs,cIndOp,cst,cClassTrib,cLocalidadeIncid,indDest) ou a lista de combinações candidatas quando o item exigir escolha do contribuinte;apuracaoNaCompetenciaInformadaeprojecaoComparativaAnual: A memória de cálculo centavo a centavo devBC,pCBSEfetiva,pIBSEfetiva,vCBS,vIBSevTotNFcomparando 2026 vs. 2027;baseCalculoUnificadaRfb: Os camposbaseRG,baseSNeavisosRfbidênticos ao motor Java da RFB;xmlPreview: Os blocos XML<IBSCBS>prontos para colar ou validar, gerados simultaneamente nos layoutsnt004ent009.
Exemplo prático em cURL: Simulando Licenciamento de SaaS (010501) ou Locação de Imóvel (990302)
curl -s -X POST "https://platform.notaas.com.br/api/v1/rtc/calcular" \
-H "Content-Type: application/json" \
-d '{
"codigoServico": "010501",
"regimeTributario": "1",
"dataCompetencia": "2026-11-17",
"valorServico": 10000.00,
"aliquotaIss": 2.0,
"vPis": 65.00,
"vCofins": 300.00,
"municipioPrestador": "3550308",
"municipioTomador": "4106902"
}'
Veja um trecho real da resposta JSON retornada pelo motor da Notaas:
{
"obrigatoriedade": {
"normalizedRegime": "REGIME_NORMAL",
"resolvedItemPrefix4": "0105",
"resolvedCTribNac6": "010501",
"category": "TECH_SAAS_TRANSPORTE_2027_03_01",
"mandatoryFromIso": "2027-03-01",
"isMandatoryOnReferenceDate": false,
"legalBasis": "Ato Conjunto RFB/CGIBS nº 7/2026, Art. 1º, IV, \"b\" e \"c\", e § 1º, II",
"summary": "Subitem 01.05 (Tecnologia/SaaS/Cloud/Streaming/Transporte Coletivo): destaque de IBS/CBS obrigatório a partir de 01/03/2027 (tanto para Regime Normal quanto para Simples Nacional)."
},
"statusClassificacao": "RESOLVIDA",
"classificacaoTributaria": {
"tuplaResolvida": {
"nbs": "115022000",
"cIndOp": "100301",
"cst": "000",
"cClassTrib": "000001",
"cLocalidadeIncid": "4106902",
"indDest": "0"
}
},
"projecaoComparativaAnual": {
"cenario2026": {
"anoRegra": "2026",
"valorServico": 10000,
"deducaoIssqn": 200,
"deducaoPisCofinsProprio": 365,
"vBC": 9435,
"vLiq": 10000,
"tributosCalculados": {
"pCBSEfetiva": 0.9,
"pIBSEfetiva": 0.1,
"vCBS": 84.92,
"vIBS": 9.44,
"vIBSCBSTotal": 94.36,
"somaNoTotalDaNota": false,
"vTotNF": 10000
}
},
"cenario2027": {
"anoRegra": "2027",
"valorServico": 10000,
"deducaoIssqn": 200,
"deducaoPisCofinsProprio": 0,
"vBC": 9800,
"vLiq": 10000,
"tributosCalculados": {
"pCBSEfetiva": 0.9,
"pIBSEfetiva": 0.1,
"vCBS": 88.2,
"vIBS": 9.8,
"vIBSCBSTotal": 98,
"somaNoTotalDaNota": true,
"vTotNF": 10098
}
}
},
"baseCalculoUnificadaRfb": {
"baseRG": 9435,
"baseSN": null,
"isLocacaoImoveis9903": false
}
}
50ª Tool no @notaas/mcp v0.2.8: calculando IBS/CBS direto no Cursor, Claude Code e Windsurf
Se você utiliza assistentes de IA no fluxo de desenvolvimento — conceito que detalhamos no nosso guia de Vibe Coding Fiscal com Cursor, Lovable e Next.js e no lançamento do @notaas/mcp Server — não precisa nem abrir o terminal para montar o cURL.
Na versão @notaas/mcp v0.2.8, adicionamos a tool pública notaas_calculate_ibs_cbs_nfse (que funciona sem necessidade de API Key). Basta configurar o servidor MCP na sua IDE:
{
"mcpServers": {
"notaas": {
"command": "npx",
"args": ["-y", "@notaas/mcp@latest"]
}
}
}
E pedir diretamente em linguagem natural no chat do Cursor ou do Claude Code:
"Use a tool
notaas_calculate_ibs_cbs_nfsepara simular uma nota de R$ 15.000,00 no código 990302 (locação de imóvel comercial) no Simples Nacional em São Paulo e me mostre quando passa a ser obrigatório pelo Ato Conjunto nº 7/2026 e qual a redução de alíquota do cClassTrib 200027."
O agente de IA consulta nosso motor determinístico em tempo real e já devolve o código TypeScript/JSON validado para o seu backend, além do XML compatível com o DANFSe v2.0 local da NT-008 (que você também pode testar visualmente no playground gratuito danfse.notaas.com.br).
Conclusão: pare de manter tabelas da Reforma Tributária na mão
A Reforma Tributária sobre o Consumo até 2027 será uma maratona de Atos Conjuntos, Notas Técnicas quinzenais (como a virada da NT-009 em 01/12/2026 e o pacote SEFAZ de 14/12/2026) e migrações silenciosas do banco de dados da Receita Federal.
Quando você integra seu SaaS, ERP ou escritório contábil à API da Notaas (ou gerencia dezenas de clientes via Org API Multi-CNPJ):
- O cronograma do Ato Conjunto RFB/CGIBS nº 7/2026 é aplicado automaticamente por código de serviço e regime tributário;
- Suas notas retroativas do Simples Nacional (
dCompet < 01/11/2026) são protegidas contra rejeição no SNNFSE; - Todas as 1.515 tuplas do Anexo VIII e reduções de alíquota da Receita Federal ficam sincronizadas sem que você precise fazer deploy no seu sistema;
- E você começa com 20 notas fiscais gratuitas por mês em produção real (1 CNPJ) + até 5 projetos simultâneos grátis em homologação via Org API, sem cartão de crédito e sem mensalidade fixa.
👉 Crie sua conta gratuita na Notaas e emita com proteção automática da Reforma Tributária ou consulte a especificação completa do endpoint em docs.notaas.com.br.

