Principal Emissão em massa Como funciona a emissão em massa de NFS-e

Como funciona a emissão em massa de NFS-e

Última atualização em Aug 07, 2026

A emissão em massa permite enviar um arquivo Excel (.xlsx ou .xls) com várias notas de uma vez. Dois casos de uso comuns:

  • Emitir as notas do mês (inclusive com data de competência retroativa) a partir do arquivo exportado.
  • Gerar o arquivo programaticamente e enviá-lo ao sistema.

1. Obtenha um arquivo modelo

A forma mais prática é exportar notas já emitidas — a planilha exportada é o próprio modelo, já com as colunas no formato certo e uma aba Documentação explicando campo a campo. Se ainda não há nenhuma nota emitida, emita uma manualmente pelo painel antes de continuar.

  1. Na listagem de notas, clique no botão Exportar notas (ícone ao lado de Emitir NFS-e).
  2. No modal que abre, selecione o período desejado.
  3. Em Selecione o formato desejado, marque Exportar Excel.
  4. Opcionalmente, marque apenas Emitidas em "Selecione as notas desejadas" para filtrar só as notas com sucesso.
  5. Clique em Exportar notas.

2. Edite o arquivo no Excel

O arquivo tem uma linha por nota. As cores do cabeçalho indicam o que preencher:

  • Verde — coluna obrigatória.
  • Amarelo — coluna opcional.
  • Cinza — coluna somente de exportação (Número NFS-e, Chave de Acesso, Status). É ignorada na importação; pode deixar como estiver.

Regras ao editar:

  1. Não remova a primeira linha (cabeçalho) e não use fórmulas nas células — elas não são interpretadas.
  2. Data da nota: preencha a coluna "Serviço - Data de Competência" (dd/mm/aaaa). Pode ser retroativa — a competência sai com a data informada; a data/hora de emissão do documento é sempre a do momento do envio, por regra do padrão nacional.
  3. Mantenha no arquivo apenas as notas que deseja emitir e revise Descrição, Valores e Endereço antes de salvar.

Empresas que ainda emitem no padrão antigo (ABRASF) usam outro modelo de planilha — envie as notas delas em um arquivo separado, com a empresa selecionada no painel.

3. Envie o arquivo

  1. Na listagem de notas, clique no botão Emitir NFS-e em massa (ícone ao lado de Emitir NFS-e).
  2. Clique em Escolher arquivos e selecione o(s) arquivo(s) Excel. Limites: apenas .xlsx ou .xls, no máximo 20 arquivos por vez, total de até 20 MB.
  3. Em Data de competência, escolha:
    • Emitir cada nota com a data da coluna "Serviço - Data de Competência" — usa a data preenchida na planilha (é a opção certa para notas retroativas);
    • Emitir todas com a data de hoje — ignora a coluna do arquivo e emite tudo com a data do dia.
  4. Marque a confirmação: Entendo que após o envio, não há como cancelar os pedidos de emissão. Para notas com data anterior a 30 dias há uma confirmação extra — o cancelamento delas só é possível por processo administrativo junto à prefeitura.
  5. Clique em Emitir NFS-e em massa.

Dica: na primeira vez, envie uma planilha com 1 ou 2 notas e confira o resultado antes de subir o lote inteiro.

4. Acompanhe e corrija falhas

Após o envio, a tela Detalhes do envio exibe três painéis:

  • Notas com erro — notas rejeitadas na validação do arquivo, com o arquivo e a linha de cada problema (ex.: dados inválidos).
  • Notas pendentes e falhadas — notas enviadas mas que retornaram falha da prefeitura; o badge Falha aparece na coluna Situação de cada linha.
  • Notas emitidas — notas processadas com sucesso.

Para corrigir:

  • Notas em "Notas com erro" devem ser corrigidas no arquivo Excel e reenviadas em um novo envio.
  • Notas falhadas podem ser editadas diretamente pelo painel e reemitidas individualmente — os dados enviados ficam preservados, inclusive a data de competência.

Em caso de dúvida, fale com a gente pelo chat — a equipe Nota RP acompanha as emissões e pode verificar o motivo de qualquer rejeição.