Como funciona a emissão em massa de NFS-e
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.
