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:

• Reemitir as notas do mês anterior copiando o 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. 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 exportado terá uma linha por nota. O cabeçalho inclui colunas como InscricaoMunicipalPrestador, Status, DataEmissao, RazaoSocial, CpfCnpj, InscricaoMunicipal, Cep, entre outras.

Regras obrigatórias ao editar:

1. Não remova a primeira linha (cabeçalho).
2. Não use fórmulas nas células — elas não são interpretadas.
3. Mantenha o mesmo formato de data, valor e demais campos do arquivo original.
4. As colunas NumeroNfse e Status são ignoradas no envio; pode deixá-las ou excluí-las.

Mantenha no arquivo apenas as notas que deseja emitir. Revise campos como Discriminação, Valor e Endereço antes de salvar.

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. Na tela Emitir NFS-e em massa, 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 emissão, defina a data desejada. O padrão é emitir todas as notas com a data de hoje.
4. Marque a confirmação: Entendo que após o envio, não há como cancelar os pedidos de emissão.
5. Clique em Emitir NFS-e em massa.

4. Acompanhe e corrija falhas

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

• Notas com erro — notas rejeitadas antes do envio à prefeitura (ex.: dados inválidos no arquivo).
• 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 falhas:

• Notas na seção "Notas com erro" devem ser corrigidas no arquivo Excel e reenviadas em um novo envio.
• Notas falhadas também podem ser editadas diretamente pelo painel e reenviadas individualmente para emissão.