NFS-e

Resolução CGSN 189 e 191/2026 (Erros EL137 / E0039 no Simples e MEI) e Locação de Bens Móveis (Código 990101 / NT-009)

Entenda como a Resolução CGSN 189 e 191/2026 dividiu prefeituras entre o SNNFSE e provedores municipais (erros EL137 e E0039), como funciona o auto-healing na API Notaas e a emissão de Locação de Bens Móveis (cTribNac 990101 / NT-009).

Fábio Magalhães CostaAtualizado em 06/11/2026
Roteamento declarativo por regime tributário e auto-healing da Notaas: decidindo em tempo real entre SNNFSE e webservices municipais sob as Resoluções CGSN 189/191

Roteamento declarativo por regime tributário e auto-healing da Notaas: decidindo em tempo real entre SNNFSE e webservices municipais sob as Resoluções CGSN 189/191

💡 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 EL137 e E0039) e do código 990101 (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:

  1. MEI (crt = 4 ou opSimpNac = 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.
  2. Simples Nacional ME/EPP (crt = 1 ou opSimpNac = 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.
  3. Regime Normal — Lucro Presumido e Lucro Real (crt = 3 ou opSimpNac = 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 municipal cTribMun), obrigando que essas empresas continuem transmitindo via webservice municipal nativo. Em outras (como Cuiabá/MT 5103403, que migramos 100% na release v0.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 municipal tbw, el ou conam).
  • 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ódigos EL137/E999 na 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 para snnfse ou el_nacional), preserva um snapshot auditável da transição e dispara uma notificação transparente explicando a mudança oficial da prefeitura. (Em homologação tp_amb = 2, um guardrail da v0.56.104 impede 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 a v0.56.90 e omitindo <pAliq> no Simples para evitar os erros E0617/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 com E0039 ("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 (ou 99.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.

Notaas — Infraestrutura Fiscal Multi-Tenant para SaaS, ERPs e BPOs

Escale a emissão de NFS-e, NF-e, NFC-e, CT-e e MDF-e para dezenas de CNPJs

Integre a API de Nota Fiscal da Notaas no seu software: provisione clientes via Org API Multi-CNPJ, isole certificados A1 em nuvem, receba webhooks assinados com HMAC e gere DANFSe v2.0 local. Sandbox ilimitado e planos sob medida para operações em escala.

Artigos Relacionados em NFS-e

Guias Pilares de Integração Fiscal