NFS-e e a Reforma Tributária — os três cenários de emissão

A NFS-e nunca teve um padrão nacional obrigatório: cada município define seu próprio layout, campos e ambiente de emissão. Com a Reforma Tributária, parte dos municípios aderiu ao Ambiente Nacional da NFS-e (SEFIN), parte adotou apenas o formato nacional mantendo o emissor próprio, e parte manteve o formato próprio com pequenos ajustes. Isso produz três cenários de integração — e identificar o cenário certo é a primeira decisão de qualquer emissão de NFS-e sob a reforma.

📘
Por que isso importa
O cenário define dois ajustes que precisam ser coerentes entre si: qual endpoint você chama (/v2/nfse ou /v2/nfsen) e quais flags a empresa tem habilitadas no cadastro. Endpoint e flags desalinhados são a causa mais comum de rejeição na NFS-e sob a reforma.

Como identificar o cenário

O município do prestador determina o cenário — não é uma escolha do cliente. Consulte a lista de municípios integrados para saber qual padrão a prefeitura adotou. A única regra que ignora o município:

📘
MEI é sempre Cenário C
Empresas MEI são obrigadas a emitir no Ambiente Nacional da NFS-e (Cenário C), independente do município.

📘
Simples Nacional no Cenário C
Empresas Simples Nacional serão obrigadas a emitir no Ambiente Nacional da NFS-e (Cenário C), independente do município, a partir de 01/11/2026.

Cenário A — Próprio

Formato próprio + ambiente de emissão próprio.

O município usa layout e ambiente próprios e apenas adicionou os novos campos da Reforma ao seu padrão existente. Muitos ajustaram a implementação interna para sincronizar os dados com o ambiente nacional depois.

Endpoint: /v2/nfse
Campos: os do padrão do município (a Focus faz a curadoria para manter nomes consistentes entre municípios diferentes).
Cadastro da empresa: mantém a NFS-e municipal habilitada.
Onde ver os campos alterados: nos posts de municípios integrados, atualizados conforme cada município é reimplementado.

Cenário B — Formato Nacional

Formato nacional + ambiente de emissão próprio.

O município adotou o layout e os campos da NFS-e Nacional, mas opera em um ambiente de emissão próprio — distinto do ambiente oficial nacional. É o cenário que mais confunde, porque usa o formato nacional sem usar o ambiente nacional.

Endpoint: /v2/nfsen
Campos: os do layout nacional (DPS).
Cadastro da empresa (Painel da API → Documentos Fiscais):
- Não habilitar "Ambiente da NFSe Nacional"
- Manter habilitada apenas "NFSe"
Cadastro via API de Empresas:

habilita_nfse: true
habilita_nfsen_producao: false

Cenário C — Ambiente Nacional

Formato nacional + ambiente de emissão oficial nacional.

O município migrou integralmente para a NFS-e Nacional: usa o formato nacional e emite pelo ambiente oficial da SEFIN. É também o cenário obrigatório para MEI.

Endpoint: /v2/nfsen
Campos: os do layout nacional (DPS).
Cadastro da empresa (Painel da API → Documentos Fiscais):
- Habilitar "Ambiente da NFSe Nacional"
- Desabilitar "NFSe"
Cadastro via API de Empresas:

habilita_nfse: false
habilita_nfsen_producao: true

Tabela comparativa

	A — Próprio	B — Formato Nacional	C — Ambiente Nacional
Formato (layout/campos)	próprio do município	nacional (DPS)	nacional (DPS)
Ambiente de emissão	próprio	próprio	oficial nacional (SEFIN)
Endpoint	`/v2/nfse`	`/v2/nfsen`	`/v2/nfsen`
`habilita_nfse`	`true`	`true`	`false`
`habilita_nfsen_producao`	`false`	`false`	`true`
"Ambiente da NFSe Nacional" no Painel	desabilitado	desabilitado	habilitado
MEI	—	—	obrigatório
Simples Nacional	—	—	01/11/2026

📘
Regra do cadastro (fonte da verdade da API)
habilita_nfse (NFS-e municipal) e habilita_nfsen_producao (NFS-e Nacional em produção) não podem estar habilitados ao mesmo tempo em produção. É um ou outro. Para testar o ambiente nacional sem afetar produção, existe a flag separada habilita_nfsen_homologacao.

O detalhe que inverte o cenário

A diferença entre o Cenário B e o Cenário C não está no endpoint — ambos usam /v2/nfsen. Está no cadastro da empresa:

Habilitou "Ambiente da NFSe Nacional" / habilita_nfsen_producao: true → emite pelo ambiente oficial nacional (Cenário C).
Deixou essa opção desabilitada e manteve só "NFSe" → emite pelo ambiente próprio do município usando o formato nacional (Cenário B).

Trocar essas flags por engano faz a nota sair para o ambiente errado — autorizada em um ambiente, rejeitada no outro.

Flexibilidade: com ou sem reforma

Alguns municípios passaram a oferecer duas versões da integração: uma com os campos da Reforma e outra sem. Nesses casos o cliente escolhe qual usar simplesmente informando ou não os campos da reforma no envio. Exemplos: São Paulo e Osasco.

Fonte: Guia da Reforma Tributária da Focus NFe (seção NFS-e, três cenários e orientações de cadastro) e documentação da API de Empresas (/reference/atualizar_empresa, flags habilita_nfse / habilita_nfsen_producao / habilita_nfsen_homologacao e a regra de exclusividade em produção).