Central de Ajuda
  • Tutorial

Como configurar a emissão de NFS-e pelo Ambiente Nacional

SP
Samuel Peñaloza Suporte Técnico
Atualizado em 25 set 2026 5 min de leitura 35 visualizações

Visão geral

Vamos configurar a Retaguarda para emitir a NFS-e (Nota Fiscal de Serviço eletrônica) pelo Ambiente Nacional. O Ambiente Nacional é o sistema da NFS-e de padrão nacional, mantido pelo governo federal em conjunto com os municípios: em vez de cada prefeitura ter um sistema e um leiaute próprios, a nota segue um modelo único para todo o país. A empresa envia uma DPS (Declaração de Prestação de Serviço), e o Ambiente Nacional valida e gera a NFS-e.

Na Retaguarda, a emissão pelo Ambiente Nacional é ativada no mesmo Cadastro NFS-e usado para as prefeituras, com a opção Ambiente Nacional marcada. Os serviços também precisam estar com o código de tributação nacional preenchido.

Pré-requisitos

Aviso

A emissão pelo Ambiente Nacional só funciona para empresas de municípios que aderiram ao padrão nacional. Antes de configurar, confirme a adesão do seu município no Portal Nacional da NFS-e ou diretamente com a prefeitura. Se o município ainda usa sistema próprio, siga o artigo como configurar a empresa para emitir NFS-e.

Conferindo o certificado digital

No padrão nacional, a comunicação com o Ambiente Nacional é autenticada pelo certificado digital da empresa.

  1. No menu principal, acesse Configurações e clique em Empresa.
  2. Na aba Emitente, confira se o Certificado Digital está enviado e dentro da validade.

Se o certificado ainda não foi enviado, siga o passo a passo do artigo como configurar a empresa para emitir NF-e, na parte do certificado digital. O mesmo certificado serve para a NF-e e para a NFS-e.

Ativando o Ambiente Nacional no Cadastro NFS-e

  1. Ainda em Configurações › Empresa, clique na aba Documento Fiscal.
  2. Role até a seção NFS-e e clique em Cadastrar NFS-e.
  3. Marque a opção Ambiente Nacional.
  4. Informe a Série da NFS-e e confira o Núm. Últ. NFS-e, o número da última NFS-e emitida. Para ajustar esse número, clique no ícone de lápis ao lado, altere o valor e clique no ícone de disquete.
  5. Informe o Usuário NFS-e e a Senha NFS-e, que são o usuário e a senha de acesso da empresa ao Ambiente Nacional da NFS-e. Clique no ícone de olho para conferir a senha digitada.
  6. Informe o CNPJ Prefeitura, campo exigido pela tela para salvar a configuração.
  7. Marque Utiliza RPS/DPS e informe a Série RPS/DPS e o Número RPS/DPS. No Ambiente Nacional, esses três campos são obrigatórios: a nota nasce de uma DPS, e eles definem a série e a numeração das DPS enviadas.
  8. Informe o Cód. Mun. Prestação, que é o código da atividade de serviço da empresa, conforme a orientação da contabilidade.
  9. Selecione o Indicador Operação, conforme a orientação da contabilidade.
  10. Informe o CNAE (Classificação Nacional de Atividades Econômicas) da atividade de serviço e o Regime Especial Trib., se a empresa tiver um. O ícone de informação ao lado do regime mostra a lista de códigos disponíveis.
  11. Marque as retenções que se aplicam (COFINS ret., INSS ret., IR ret., CSLL ret. e PIS ret.) e preencha Base IRRF e % IRRF, se houver retenção de IRRF (Imposto de Renda Retido na Fonte).
  12. Informe a Nat. Oper. Padrão, que vem preenchida em toda nota de serviço nova.
  13. Clique em Salvar.

Nota

A tela Cadastro NFS-e só salva a configuração com Série, Usuário NFS-e, Senha NFS-e e CNPJ Prefeitura preenchidos. Os demais campos, como Frase Secreta, Número Lote e Código Cancelamento, não são exigidos pela tela para salvar.

Preenchendo o código nacional nos serviços

O padrão nacional identifica cada serviço pelo código de tributação nacional e pela NBS. Na Retaguarda, esses códigos ficam no cadastro de cada serviço e são levados automaticamente para a nota quando o serviço é lançado.

  1. Acesse Cadastros › Serviços e abra o serviço.
  2. Na seção Extra, no fim da tela, informe o Código SN (código de serviço nacional) e o Código NBS.
  3. Confira a Tributação Municipal e a Tributação Federal do serviço.
  4. Clique em Salvar.
  5. Repita para cada serviço que a empresa emite em nota.

Dica

No cadastro de serviços, o Código SN e o Código NBS não são obrigatórios para salvar. No Ambiente Nacional, porém, a nota depende desses códigos. Revise todos os serviços usados em nota antes da primeira emissão, com a lista de códigos definida pela contabilidade.

Emitindo a primeira nota

  1. Acesse Saídas › Nota de Serviço e lance uma nota com um serviço já ajustado.
  2. Salve e confirme a pergunta de transmissão.
  3. Na listagem, confira se a nota ficou com a situação Transmitida e se o Nº Prefeitura e o Protocolo foram preenchidos.

Se a nota continuar Pendente, leia a mensagem de erro exibida na transmissão, corrija o dado indicado e transmita de novo. O passo a passo completo está no artigo como emitir uma nota de serviço.

Erros comuns

Mensagem exibida Causa Correção
"Verifique o campo Série NFS-e!" A Série ficou vazia no Cadastro NFS-e Informe a série da NFS-e
"Verifique o campo Usuário NFS-e!" ou "Verifique o campo Senha NFS-e!" O usuário ou a senha do Ambiente Nacional ficou vazio no Cadastro NFS-e Informe o usuário e a senha de acesso ao Ambiente Nacional
"Verifique o campo CNPJ Prefeitura!" O CNPJ da prefeitura ficou vazio Informe o CNPJ da prefeitura do município
Mensagem de erro retornada pelo Ambiente Nacional na transmissão Dado da empresa, do tomador, do serviço ou da tributação recusado pela validação do padrão nacional Leia a mensagem, corrija o cadastro indicado (por exemplo, o Código SN ou a NBS do serviço) e transmita a nota de novo
"Não foi possível transmitir a NFS-e!" Falha de comunicação ou certificado digital vencido Confira a conexão com a internet e a validade do certificado digital

Se o erro persistir, entre em contato pelos canais oficiais de atendimento da Torge.

Fechamento

Pronto!

A Retaguarda está configurada para emitir NFS-e pelo Ambiente Nacional, e os serviços estão com o código de tributação nacional preenchido.