Como Emitir NFS-e no Ambiente Nacional: Guia Completo via API REST e Dashboard NFER

Este guia técnico e operacional detalha tudo o que você precisa saber para realizar a emissão de Nota Fiscal de Serviço Eletrônica (NFS-e) no Ambiente Nacional. O conteúdo foi estruturado tanto para desenvolvedores e integradores que desejam automatizar o fluxo via API REST, quanto para empresários e contadores que emitem diretamente pelo Dashboard do NFER sem precisar programar.

Aqui você entenderá as regras de obrigatoriedade, como consultar municípios conveniados, particularidades da DPS (Declaração de Prestação de Serviços), códigos NBS e como evitar rejeições fiscais comuns.

O Que É o Ambiente Nacional da NFS-e?

O Ambiente Nacional da NFS-e é uma iniciativa do Governo Federal (coordenada pela Receita Federal do Brasil e pelo Comitê Gestor da NFS-e - CGNFS-e) criada para unificar e padronizar a emissão de notas fiscais de serviço em um único layout e fluxo operacional em todo o país, substituindo progressivamente os mais de 5.500 sistemas municipais isolados.

Os municípios que aderem formalmente ao convênio passam a receber e processar as notas fiscais através do Ambiente de Dados Nacional (ADN) e do SEFIN Nacional, mantendo apenas suas parametrizações de alíquotas e regras locais.

Quem Deve Emitir NFS-e no Ambiente Nacional?

Devem emitir NFS-e no Ambiente Nacional as empresas e prestadores de serviços estabelecidos em municípios que aderiram ao Emissor Nacional da NFS-e, além das categorias que possuem obrigatoriedade federal independente da cidade:

1. MEI (Microempreendedor Individual)

Para todos os MEIs prestadores de serviço do Brasil, a emissão via Ambiente Nacional é obrigatória em 100% dos municípios desde setembro de 2023 (Resolução CGSN nº 169/2022). Nenhum MEI pode mais emitir notas de serviço em portais de prefeituras locais.

2. Empresas do Simples Nacional (ME e EPP)

Para as demais empresas optantes pelo Simples Nacional, a transição para a obrigatoriedade nacional de emissão no padrão unificado possui previsão de vigência a partir de novembro de 2026 (Comitê Gestor do Simples Nacional Prorroga a Obrigatoriedade de Emissão de Notas Fiscais de Serviço pelo Emissor Nacional da NFS-e).

3. Municípios Aderentes (Empresas em Geral)

Para empresas de Lucro Presumido ou Lucro Real, a emissão no Ambiente Nacional passa a valer a partir do momento em que a prefeitura do município onde a empresa está sediada publica o decreto de adesão e conclui a migração de dados.

A lista oficial de cidades conveniadas pode ser consultada no painel público do governo:

• Dashboard Oficial Power BI — Monitoramento de Adesão dos Municípios à NFS-e: Filtre pela opção "Adesão ao Emissor Nacional da NFS-e".
• Painel de Monitoramento de Adesões e Planilhas Oficiais: Tabela completa disponibilizada pela Receita Federal com a coluna AderenteEmissorNacional.

Duas Formas de Emitir no NFER: Dashboard Web ou API REST

Diferente de sistemas legados que exigem integrações complexas por código ou ferramentas burocráticas, o NFER oferece duas maneiras extremamente práticas para emitir suas notas fiscais de serviço no padrão nacional:

Forma 1: Emissão Direta pelo Dashboard NFER (Sem Programar)

Se você ou sua equipe operacional precisa emitir notas de serviço de forma manual e rápida:

1. Acesse o painel do NFER em dashboard.nfer.me/dashboard/nfe/create-nfse.
2. Selecione a empresa prestadora (o NFER já identifica automaticamente se a emissão é no Ambiente Nacional ou municipal).
3. Preencha os dados do Tomador (CPF/CNPJ, Razão Social, E-mail) e o valor do serviço prestado.
4. Informe o Código de Tributação Nacional da LC 116 e a descrição dos serviços.
5. Clique em Emitir NFS-e: o NFER assina na nuvem e entrega o link do PDF do DANFSe e o XML autorizado em menos de 2 segundos.

Forma 2: Emissão Automatizada via API REST NFER (Para Desenvolvedores)

Para integrar seu SaaS, ERP, gateway de pagamento ou e-commerce, basta realizar uma única requisição HTTP POST em JSON para a API NFER:

Exemplo de JSON para Envio de DPS no Ambiente Nacional

Veja a estrutura de um payload completo para emissão de uma DPS (Declaração de Prestação de Serviço) no Ambiente Nacional:

E a chamada correspondente em cURL para envio imediato:

Inscrição Municipal (IM): Atenção Especial para Evitar Rejeições

Um dos campos que mais geram dúvidas e chamados de suporte técnico em todo o país é a Inscrição Municipal do Prestador (inscricao_municipal_prestador).

Particularidades Cruciais do Ambiente Nacional da NFS-e

Ao operar com a NFS-e Nacional, desenvolvedores e contadores devem se atentar às seguintes diretrizes técnicas:

• Certificado Digital A1 Específico: O certificado digital A1 deve pertencer exatamente ao CNPJ da empresa emissora (não é permitido emitir com a raiz do certificado da matriz para filiais sem cadastro prévio de procuração eletrônica).
• Cancelamento Nacional Padronizado: 100% dos municípios aderentes ao padrão nacional aceitam cancelamento oficial de NFS-e diretamente via API ou painel web.
• Substituição de NFS-e: O modelo nacional aceita emissão de NFS-e de substituição (vinculando a nota substituta à nota cancelada).
• Emissão sem Tomador Identificado: O schema nacional permite emitir NFS-e sem identificação do tomador em operações que se enquadrem nas regras municipais de dispensa.
• Campos Opcionais que Podem Tornar-se Obrigatórios: Cada município aderente pode definir parametrizações próprias. Por exemplo, o campo codigo_tributacao_municipal_iss é opcional no schema nacional geral, mas certas cidades o tornam obrigatório em suas configurações.

Códigos de Serviço, NBS e a Tabela de Correlação da Reforma Tributária

Para o preenchimento correto da DPS no padrão nacional e conformidade com a Reforma Tributária (IBS/CBS), utilize os anexos oficiais disponibilizados pela Receita Federal:

• Lista de Códigos de Serviço com Desdobramento Nacional (NBS): Tabela oficial que correlaciona cada item da Lei Complementar 116/2003 aos códigos NBS (Nomenclatura Brasileira de Serviços).
• Tabela de Correlação: Indicador de Operação, NBS e Classificação Tributária IBS/CBS: Mapeamento essencial para a transição tributária do IVA Dual.
• Biblioteca Oficial de Documentação Técnica da NFS-e Nacional: Schemas XSD, Manuais de Integração e Notas Técnicas vigentes.

Conclusão: Emita NFS-e Nacional com o NFER sem Burocracia

A transição para o Ambiente Nacional da NFS-e traz modernidade e padronização, mas exige atenção a regras cadastrais, certificados e códigos de NBS. Com o NFER, sua empresa conta com um motor fiscal moderno que resolve toda essa complexidade de forma automática.