💡 Guia Pilar de Referência: Para a visão geral da arquitetura do Padrão Nacional (DPS, ADN e cobertura completa de cidades), consulte nosso guia pilar API NFS-e Nacional 2026: Guia de Integração em 4.782 Cidades. Neste artigo específico, aprofundamos o tratamento das Resoluções CGSN 189 e 191/2026 (erros
EL137eE0039) e do código990101(Locação de Bens Móveis na NT-009).
Nos últimos trinta dias, se você lidera a engenharia de um ERP, SaaS vertical ou plataforma de contabilidade que emite notas de serviço em dezenas de cidades brasileiras, provavelmente viveu um pesadelo silencioso: na sexta-feira, um cliente de Americana/SP, Caxias do Sul/RS, Cuiabá/MT ou de municípios atendidos pelos provedores E&L, TBW e Infisc emitia normalmente no webservice da prefeitura; na segunda-feira às 08h00, todas as notas daquele CNPJ passaram a voltar bloqueadas com mensagens dizendo que o contribuinte estava "obrigado ao Emissor Nacional (ADN/SNNFSE) conforme Resolução CGSN nº 189/191".
Para piorar, quando a sua equipe corria para apontar todas as empresas daquela cidade para a API da NFS-e Nacional (SNNFSE), outro cliente da mesma cidade — mas enquadrado no Lucro Presumido ou Lucro Real (Regime Normal) — parava de funcionar com o erro inverso (E0039 ou convênio municipal restrito), porque a prefeitura só havia migrado MEI e Simples Nacional para a Receita Federal, mantendo o Regime Normal no servidor próprio.
Eu acompanhei cada uma dessas viradas de chave de dentro dos nossos logs de produção entre as releases v0.56.82 e v0.56.118 da Notaas. Ao invés de tratar cada prefeitura com if/else manuais no código, nós redesenhamos nosso motor de decisão para operar com Roteamento Híbrido Declarativo por Regime Tributário + Auto-Healing In-Flight, além de habilitar na mesma janela o aguardado Grupo 99 da NT-009 (cTribNac = 990101 — Locação de Bens Móveis com destaque de IBS/CBS) no Padrão Nacional.
A seguir, vou abrir como essa tempestade regulatória funciona na prática e como uma Software House usando a Org API da Notaas atravessa essas migrações municipais sem tocar em uma única linha de código no ERP.
O efeito dominó das Resoluções CGSN nº 189 e 191/2026: por que uma mesma cidade agora tem dois motores fiscais
Até pouco tempo atrás, a regra de roteamento em qualquer software emissor de NFS-e era binária: você consultava o código IBGE de 7 dígitos da prefeitura e mapeava aquela cidade para um único conector (por exemplo, 3550308 ➔ Paulistana; 4106902 ➔ SNNFSE Curitiba; 3170206 ➔ Uberlândia).
Com o escalonamento das Resoluções CGSN nº 189 e nº 191 em conjunto com o cronograma da Reforma Tributária (LC 214/2025), centenas de municípios brasileiros entraram no que chamamos na engenharia da Notaas de Estado de Aderência Híbrida (snnfse_aderente parcial).
Funciona assim nos bastidores das secretarias de fazenda municipais:
- MEI (
crt = 4ouopSimpNac = 2): Já possui obrigatoriedade soberana nacional no SNNFSE (Ambiente de Dados Nacional) em todos os 5.571 municípios, independentemente de a prefeitura ter aderido ou não ao convênio completo. - Simples Nacional ME/EPP (
crt = 1ouopSimpNac = 3): Por força das Resoluções CGSN 189/191, diversos provedores municipais (como TBW, E&L Administração Pública, CONAM/Americana-SP e Infisc/Caxias do Sul-RS) bloquearam a recepção de RPS via SOAP municipal para optantes do Simples, devolvendo erros específicos (EL137,E999, ou rejeição textual citando a Resolução CGSN 191) e exigindo que a DPS seja transmitida diretamente à Sefin Nacional. - Regime Normal — Lucro Presumido e Lucro Real (
crt = 3ouopSimpNac = 1): Em várias dessas mesmas cidades híbridas, a prefeitura ainda não habilitou o recebimento de empresas do Regime Normal no ADN (ou exige configurações específicas de desdobro municipalcTribMun), obrigando que essas empresas continuem transmitindo via webservice municipal nativo. Em outras (como Cuiabá/MT5103403, que migramos 100% na releasev0.56.111), a prefeitura virou todos os regimes de uma vez para o SNNFSE.
Veja na tabela abaixo os quatro cenários reais que um ERP Multi-CNPJ encontra hoje ao emitir NFS-e no Brasil:
| Cenário Municipal em 2026 | MEI (opSimpNac = 2) |
Simples Nacional ME/EPP (opSimpNac = 3) |
Lucro Presumido / Real (opSimpNac = 1) |
Exemplos Reais em Produção |
|---|---|---|---|---|
| 1. Adesão Total ao Padrão Nacional | SNNFSE (ADN) |
SNNFSE (ADN) |
SNNFSE (ADN) |
Curitiba/PR, Belo Horizonte/MG, Porto Alegre/RS, Rio de Janeiro/RJ, Cuiabá/MT (v0.56.111), Caxias do Sul/RS (v0.56.105) |
| 2. Município Híbrido CGSN 189/191 | SNNFSE (ADN) |
SNNFSE (ADN) (bloqueado no municipal) |
Motor Municipal (ou SNNFSE c/ regra híbrida) | Americana/SP (v0.56.99), municípios TBW (v0.56.108) e E&L (v0.56.118) em transição |
| 3. Município Próprio c/ MEI Soberano | SNNFSE (ADN) |
Motor Municipal (SOAP/REST) | Motor Municipal (SOAP/REST) | São Paulo/SP (Paulistana), Fortaleza/CE (GINFES v0.56.103), Paranaguá/PR (Elotech v0.56.109) |
| 4. Virada Súbita Sem Aviso Prévio | SNNFSE (ADN) |
Prefeitura bloqueia SOAP na madrugada (EL137 / CGSN 191) |
Prefeitura migra para el_nacional ou snnfse |
Dezenas de prefeituras do ES, BA, MG, SP e PR toda segunda-feira |
Se o seu ERP controla isso na mão, cada virada do Cenário 4 gera chamados urgentes no suporte, notas travadas no faturamento do cliente e deploys de emergência.
Como funciona o Auto-Healing Multi-Engine da Notaas (v0.56.96 a v0.56.118)
Quando percebemos que as prefeituras estavam ativando os bloqueios da Resolução CGSN 189/191 e da migração el_nacional sem publicar cronograma técnico prévio, tomamos uma decisão de arquitetura na release v0.56.96 (evoluída até a v0.56.118): a própria fila de processamento da Notaas deve diagnosticar a mudança regulatória da prefeitura, corrigir a rota do projeto e autorizar a nota na mesma transação (in-flight).
⚡ Fluxo de Auto-Healing In-Flight na Fila de Emissão da Notaas:
- 1. Disparo Único pelo ERP (
POST /api/v1/emitir): O SaaS envia o payload JSON padrão da nota. O worker seleciona a rota ativa do projeto (ex.: motor municipaltbw,elouconam).- 2. Detecção Inteligente de Rejeição de Transição (
Cgsn191RejectionDetector): Se o webservice municipal devolver rejeição indicando migração para o Emissor Nacional (ex.: menção àResolução CGSN 189,CGSN 191,ADN, ou códigosEL137/E999na E&L), o detector intercepta o erro antes de marcar a nota como falha.- 3. Guardrail e Reconfiguração Persistente (Apenas em Produção
tp_amb = 1): O worker atualiza automaticamente a rota do projeto no banco de dados (migrando parasnnfseouel_nacional), preserva um snapshot auditável da transição e dispara uma notificação transparente explicando a mudança oficial da prefeitura. (Em homologaçãotp_amb = 2, um guardrail dav0.56.104impede que testes alterem a rota de produção).- 4. Reemissão Instantânea na Nova Engine: Sem que o seu ERP precise fazer uma segunda requisição HTTP, o próprio worker reconstrói o XML no padrão da nova engine (ex.: DPS assinada para o SNNFSE, aplicando o corte correto da tag
<IM>conforme av0.56.90e omitindo<pAliq>no Simples para evitar os errosE0617/E0635), autoriza a nota e gera o DANFSe v2.0 local.- 5. Rollback Seguro em Caso de Exceção (
E0039): Se uma prefeitura rejeitar no ADN comE0039("Município não conveniado para o regime do emitente"), o motor desfaz o override de forma determinística e mantém a consistência cadastral.
Para quem gerencia 10, 50 ou 500 clientes PJ nos nossos Planos Dev (R$ 99/mês para até 3 CNPJs) ou SaaS Pro (R$ 249/mês com CNPJs ilimitados), essa camada de auto-healing significa zero chamados de suporte na virada de mês.
Locação de Bens Móveis no Padrão Nacional (cTribNac = 990101 — Grupo 99 da NT-009)
A segunda grande transformação comercial que entregamos na release v0.56.82 resolve uma dor histórica de locadoras de equipamentos, máquinas para construção civil, veículos, geradores, equipamentos médicos e TI: a emissão de documento fiscal para Locação de Bens Móveis.
Historicamente, como a locação pura de bens móveis (sem fornecimento de mão de obra/operador) não sofre incidência de ISSQN por força da Súmula Vinculante nº 31 do STF e do veto ao item 3.01 da LC 116/2003, a maioria das prefeituras brasileiras proibia a emissão de NFS-e para locação — obrigando as empresas a emitirem ”faturas/recibos de locação” em PDF sem validade de documento fiscal eletrônico.
Com a Reforma Tributária (LC 214/2025), as operações de locação, cessão onerosa e arrendamento de bens móveis passaram a ser fato gerador do IBS (Imposto sobre Bens e Serviços) e da CBS (Contribuição sobre Bens e Serviços). Para viabilizar essa emissão dentro do Sistema Nacional da NFS-e, a Nota Técnica SEFIN/ADN nº 009 (NT-009) criou oficialmente o Grupo 99 na tabela nacional de serviços:
- Código de Tributação Nacional (
cTribNac):990101(ou99.01.01) - Descrição Oficial NT-009: Locação de bens móveis.
- Natureza no SNNFSE: Operação sem incidência de ISSQN municipal, porém com preenchimento e validação do bloco
<IBSCBS>na Declaração de Prestação de Serviços (DPS).
Exemplo Prático: Emitindo uma Nota de Locação de Bens Móveis (990101) via API JSON
Na Notaas, você não precisa montar o XML complexo da NT-009 nem lidar com a diferença entre um item da LC 116 e o Grupo 99. Basta enviar codigo: "990101" (ou "99.01.01") no endpoint POST /api/v1/emitir. Nosso dps-builder detecta automaticamente que se trata do Grupo 99 da NT-009, configura a não incidência de ISS e injeta a correlação exata do Anexo VIII para IBS e CBS:
{
"tipo": "nfse",
"ambiente": "producao",
"externalId": "LOCACAO-GERADOR-2026-1104",
"prestador": {
"cnpj": "12345678000199"
},
"tomador": {
"cpfCnpj": "45678912000188",
"razaoSocial": "Construtora Horizonte Engenharia S.A.",
"email": "suprimentos@construtorahorizonte.com.br",
"endereco": {
"logradouro": "Avenida Carlos Gomes",
"numero": "1200",
"bairro": "Auxiliadora",
"codigoMunicipio": "4314902",
"uf": "RS",
"cep": "90480001"
}
},
"servico": {
"codigo": "990101",
"codigoNbs": "111032000",
"descricao": "Locação mensal de 2 (dois) grupos geradores silenciados de 150 kVA sem operador — Contrato #842/2026.",
"valor": 14800.00,
"issRetido": false
},
"ibscbs": {
"nbs": "111032000",
"indicadorOperacao": "100301",
"cst": "000",
"classificacaoTributaria": "000001"
}
}
Assim que a Sefin Nacional autoriza a DPS de locação e gera a chave de acesso de 50 dígitos, a Notaas renderiza instantaneamente o PDF do DANFSe v2.0 em servidor próprio — eliminando de vez o problema de instabilidade e tela em branco do visualizador do ADN e os erros de falha de conexão ao gerar chave na API do integrador nacional.
Como consultar o status real de cada prefeitura via API (GET /api/projects)
Na release v0.56.107, também enriquecemos o retorno dos endpoints de listagem e detalhes de projetos (/api/projects e /api/v1/org/projects) para que o painel do seu ERP saiba exatamente se o CNPJ do seu cliente está operando no motor nacional ou no motor municipal naquele município híbrido.
A propriedade booleana snnfse_aderente retornada pela API agora reflete a resolução efetiva por projeto (cruzando as flags do município com o regime tributário opSimpNac / crt daquele CNPJ específico e eventuais overrides de auto-healing), permitindo que a interface do seu sistema exiba com 100% de precisão quais campos são obrigatórios para aquele cliente.
Escale seu ERP Multi-CNPJ sem sofrer com mudanças de prefeituras
Manter um time de engenharia apagando incêndios toda vez que uma prefeitura publica um decreto de adesão à Resolução CGSN 189/191 ou altera regras de série no SNNFSE custa muito mais caro do que delegar a infraestrutura fiscal para uma plataforma especializada.
Na Notaas, você começa de graça e cresce com previsibilidade total:
- Plano Free (R$ 0/mês): 20 notas fiscais gratuitas por mês em produção real (1 CNPJ) + até 5 CNPJs simultâneos grátis em homologação via Org API, sem pedir cartão de crédito.
- Plano Dev (R$ 99/mês): Até 3 CNPJs em produção com Org API inclusa e 500 notas/mês.
- Plano SaaS Pro (R$ 249/mês): CNPJs ilimitados em produção via Org API e 2.500 notas/mês compartilhadas — perfeito para Software Houses, ERPs e escritórios de contabilidade digital.
👉 Crie sua conta gratuita na Notaas em 1 minuto ou explore todos os recursos na Documentação Oficial da API.

