Manual do Emissor NFS-e
Guia completo: da configuração inicial até a emissão da nota fiscal de serviço eletrônica pelo Sistema Nacional NFS-e.
O que é o Emissor NFS-e
Um programa de computador que lê uma planilha com os dados dos seus serviços prestados e emite, uma a uma, as Notas Fiscais de Serviço eletrônicas (NFS-e) direto no Sistema Nacional NFS-e (Sefin Nacional) — o mesmo padrão usado pelo Portal Nacional da Receita Federal.
Ele existe pra evitar digitar nota por nota no site do governo: você organiza os dados numa planilha (Excel ou CSV), configura uma vez o mapeamento entre as colunas da planilha e os campos da nota, e depois disso é só selecionar a planilha e clicar em Emitir. O programa assina cada nota com o certificado digital do prestador, envia pra Sefin Nacional e guarda o retorno (XML oficial + PDF do DANFSe) na sua pasta de saída.
Completo tem uma seção extra chamada “Avançado” (retenção de tributos federais, tomador no exterior, grupo IBS/CBS da Reforma Tributária). Simplificado não mostra essa seção — é a mesma ferramenta, só com menos campos na tela, pensada pra quem emite notas simples e nunca precisa desses recursos.
Antes de começar
Três coisas precisam estar prontas antes de abrir o programa pela primeira vez.
.pfx ou .p12, ou já instalado no Windows.É ele que assina digitalmente cada nota — sem certificado válido, nenhuma nota sai.A planilha
Cada linha da planilha vira uma nota. Não existe um “modelo obrigatório” de colunas — o Configurador deixa você apontar qual coluna sua tem cada informação.
Os únicos campos que toda nota precisa ter (por coluna ou como valor fixo, ver seção 4.2) são:
| Campo | Exemplo | Observação |
|---|---|---|
| CPF/CNPJ do tomador | 38533753837 | Quem recebeu o serviço |
| Nome do tomador | Empresa XYZ LTDA | — |
| Data de emissão | 06/01/2026 | Ou deixe em “Fixo” pra usar sempre a data de hoje |
| Valor do serviço | 145,80 | — |
| Código de tributação (cTribNac) | 080201 | 6 dígitos, conforme LC 116/2003 |
| Descrição do serviço | Consultoria contábil | — |
Uma planilha de exemplo (exemplo_planilha_nfse_v3.xlsx) acompanha a instalação — use como ponto de partida se tiver dúvida sobre o formato.
Configurar o cliente (só na primeira vez)
Esse passo cria um arquivo de configuração (.yaml) que guarda o mapeamento da planilha e os dados fixos do prestador. Depois de criado, você reutiliza esse mesmo arquivo em toda emissão futura — não precisa refazer isso toda vez.
4.1Abrir o Configurador
- Abra o Emissor NFS-e e clique em Selecionar… ao lado de “Planilha” pra escolher a planilha que você preparou.
- Clique em Configurar planilha… (canto inferior esquerdo da tela). Isso abre a janela do Configurador, já lendo as colunas da sua planilha.
4.2Mapear os campos
Pra cada campo da nota, escolha Coluna (usa o valor daquela linha da planilha) ou Fixo (mesmo valor em toda nota emitida nessa leva).
Se um campo é opcional e você não vai usar, deixe em Fixo com o valor em branco — o Configurador aceita sem erro. Campos obrigatórios (CPF/CNPJ, data, valor, cTribNac, descrição) sempre precisam de uma Coluna ou um valor Fixo preenchido.
4.3Campos avançados completo
Escondidos atrás da caixa Mostrar campos avançados — só marque se precisar de algum destes:
A Sefin Nacional rejeita a nota se os campos de Retenção Federal vierem preenchidos e o prestador for pessoa física (CPF). Se o prestador é autônomo, deixe essa seção em branco.
4.4Dados fixos do prestador (Defaults)
4.5Perfil tributário
Escolha o Regime tributário do prestador: Simples Nacional, MEI, Autônomo/Não Optante, Lucro Presumido ou Lucro Real. Pra Simples Nacional/MEI, mantenha marcada a opção Aplicar regra do Simples Nacional — é um campo exigido pelo padrão nacional, e o valor 0.00 serve pra quase todos os casos.
4.6Salvar
Clique em Salvar config… e escolha onde guardar o arquivo .yaml. Guarde esse arquivo num lugar fixo — ele é o que você vai selecionar em “Config do cliente” toda vez que for emitir (seção 5). Se precisar reconfigurar depois, abra o Configurador de novo e use Importar config… pra carregar o que já existe, em vez de recomeçar do zero.
Emitir as notas
Depois de configurado uma vez, esse é o fluxo do dia a dia — a tela principal do programa.
.yaml salvo na seção 4.6 — normalmente sempre o mesmo.
O botão Cancelar interrompe a emissão em andamento assim que a nota atual terminar — notas já emitidas continuam válidas, só as restantes da planilha ficam pendentes pra uma próxima leva.
O que você recebe
Pra cada nota emitida com sucesso, dois arquivos vão pra pasta de saída:
| Arquivo | O que é |
|---|---|
NFSE-{'{'}id{'}'}.xml | O XML oficial da NFS-e, devolvido pela Sefin Nacional — o documento fiscal em si. |
DANFSE-{'{'}id{'}'}.pdf | A representação visual da nota (Documento Auxiliar da NFS-e), pronta pra enviar ao cliente ou imprimir. |
Notas com falha não geram esses arquivos — o motivo do erro fica registrado na caixa de Logs (e, se você fechar o programa, no resumo final da execução).
Erros comuns
| Mensagem / sintoma | Causa provável | O que fazer |
|---|---|---|
Erro E0116 | Falta a Inscrição Municipal do prestador (comum com autônomo/CPF). | Preencha “Inscrição Municipal (IM)” nos Defaults do Configurador. |
Erro E0675 | Campos de Retenção Federal preenchidos com prestador pessoa física. | Deixe a seção “Retenção Federal” em branco pra prestador autônomo. |
| “Selecione o arquivo PFX” / senha inválida | Certificado ou senha não informados, ou senha errada. | Confira o arquivo .pfx e a senha; se estiver vencido, é preciso um certificado novo. |
| “Planilha não possui as colunas mapeadas” | O Configurador foi feito com uma planilha de layout diferente da que você está usando agora. | Abra “Configurar planilha…” de novo com a planilha atual, ou ajuste os nomes das colunas. |
| Aviso: endereço do tomador não encontrado | Consulta automática por CEP ou CNPJ não achou o endereço (rede instável, CNPJ inexistente). | Não impede a emissão — a nota sai sem esse dado. Preencha manualmente se for obrigatório pro seu caso. |
| “Nova versão disponível” no log | Existe uma versão mais nova do Emissor NFS-e. | Aviso informativo — a emissão continua normalmente. Atualize quando for conveniente. |
Perguntas frequentes
Preciso de internet?
Sim, o tempo todo durante a emissão — cada nota é enviada em tempo real pra Sefin Nacional.
Funciona pra prestador autônomo (CPF)?
Sim. Use CPF em vez de CNPJ nos Defaults, escolha o regime “Autônomo / Não Optante” no Perfil Tributário, e preencha a Inscrição Municipal se seu município exigir (ver seção 7).
Posso emitir várias notas de uma vez?
Sim — cada linha da planilha vira uma nota; uma planilha com 50 linhas emite 50 notas em sequência, numa única execução.
Ambiente de Teste emite nota de verdade?
Não. É homologação — serve pra validar se o processo está funcionando, sem gerar uma nota fiscal oficialmente válida. Só está disponível em alguns municípios.
O que muda entre a versão Completo e a Simplificado?
Nenhuma diferença na forma de emitir — a Simplificado só não mostra a seção “Avançado” do Configurador (retenção federal, tomador estrangeiro, endereço do tomador, IBS/CBS). Se seu dia a dia é só nota simples, não faz falta.