Lote por planilha

Como emitir NFS-e em lote por planilha (CSV ou Excel)

Emitir NFS-e em lote é enviar uma planilha com uma linha por nota (CPF ou CNPJ do tomador, nome, valor e data) e deixar o emissor gerar todas de uma vez. No WAY NF, o lote aceita até 200 notas em CSV ou Excel, confere cada linha antes de emitir e não emite nada enquanto houver erro. Para quem cobra os mesmos clientes todo mês, a emissão recorrente costuma ser mais simples que a planilha.

Atualizado em 30 de outubro de 2026

Quando o lote vale a pena

A NFS-e Nacional é sempre gerada nota a nota: para cada nota, o emissor monta uma DPS (Declaração de Prestação de Serviço), assina com o certificado digital da empresa e envia à Sefin Nacional, que valida e devolve a nota. "Lote" é o jeito de você preparar todas essas notas de uma vez, numa planilha, em vez de digitar uma por uma. O emissor faz os envios em sequência.

O lote compensa quando:

  • você emite muitas notas no mesmo dia (fechamento do mês, mensalidades, repasses, comissões);
  • os dados já estão numa planilha ou podem ser exportados de outro sistema (financeiro, ERP, sistema de matrículas, banco);
  • os valores mudam de um mês para o outro, o que impede usar sempre o mesmo valor fixo;
  • várias pessoas preparam os dados, e uma só confere e emite.

Se o seu caso é o contrário (os mesmos clientes, com o mesmo valor, todo mês), o lote vira trabalho repetido: alguém precisa montar a mesma planilha todo mês. Para isso existe a emissão recorrente, explicada mais abaixo.

As colunas da planilha

A planilha tem uma linha de cabeçalho e uma linha por nota. No WAY NF, o modelo pronto fica em Emitir em lote → Baixar modelo (arquivo modelo-lote-way-nf.csv, que abre no Excel). Estas são as colunas:

ColunaObrigatória?O que vai nela
cpf_cnpjSimCPF (11 dígitos) ou CNPJ (14 dígitos) do tomador, com ou sem pontos e traços
nomeSimNome ou razão social do tomador, até 150 caracteres
valorSimValor do serviço em reais: 150,00 ou 1.200,50 (também aceita 150.00 e R$ 150,00)
competenciaNãoData de competência: dd/mm/aaaa ou aaaa-mm-dd. Vazia, vale a data de hoje
descricaoNãoTexto do serviço na nota, até 2.000 caracteres. Vazia, vale a descrição padrão do perfil
emailNãoE-mail do tomador, que vai na nota
referenciaNãoSeu código para aquela cobrança (letras, números e . _ : -, até 128). Não pode repetir
perfilNãoNome do perfil de emissão (ex.: PJ com retenção), se a empresa tiver mais de um; vazio, vale o padrão. A coluna também pode se chamar tipo

O cabeçalho pode vir com ou sem acento, em maiúsculas ou minúsculas, e o sistema entende alguns nomes alternativos: "CPF", "CNPJ" ou "documento" para o CPF/CNPJ; "tomador", "cliente" ou "razão social" para o nome; "total" para o valor; "data" para a competência; "serviço" para a descrição; "código" ou "id" para a referência. Colunas que o sistema não reconhece são ignoradas, então a planilha pode ter colunas suas de controle.

Prestador, código de serviço, alíquota do ISS, retenções e códigos do IBS/CBS não vão na planilha: vêm do perfil de emissão da empresa (ou do perfil indicado na coluna perfil). Assim, quem monta a planilha não precisa saber nada de tributação.

Exemplo de planilha

Uma planilha de fechamento de mês com quatro notas, duas para pessoas físicas e duas para empresas (dados fictícios):

cpf_cnpjnomevalorcompetenciadescricaoemailreferencia
123.456.789-09Maria da Silva150,0030/10/2026Mensalidade de outubromaria@exemplo.commens-2026-10-0001
529.982.247-25João Pereira150,0030/10/2026Mensalidade de outubromens-2026-10-0002
11.222.333/0001-81Empresa Exemplo Ltda1.200,5030/10/2026Consultoria de outubro, contrato 12/2026financeiro@exemplo.comcons-2026-10-0001
11.444.777/0001-61Comércio Modelo Ltda980,0030/10/2026cons-2026-10-0002

Na última linha, a descrição ficou vazia: a nota sai com a descrição padrão cadastrada no perfil da empresa. Em CSV, as mesmas linhas ficam separadas por ponto e vírgula, que é o formato do modelo e o que o Excel em português abre corretamente:

cpf_cnpj;nome;valor;competencia;descricao;email;referencia
123.456.789-09;Maria da Silva;150,00;30/10/2026;Mensalidade de outubro;maria@exemplo.com;mens-2026-10-0001
529.982.247-25;João Pereira;150,00;30/10/2026;Mensalidade de outubro;;mens-2026-10-0002
11.222.333/0001-81;Empresa Exemplo Ltda;1.200,50;30/10/2026;Consultoria de outubro, contrato 12/2026;financeiro@exemplo.com;cons-2026-10-0001
11.444.777/0001-61;Comércio Modelo Ltda;980,00;30/10/2026;;;cons-2026-10-0002

Cuidados ao montar a planilha

Quase todo erro de lote vem de quatro pontos: documento, valor, data e duplicidade. Vale conferir cada um antes de enviar.

  • CPF e CNPJ válidos. O sistema confere a quantidade de dígitos e o dígito verificador. CPF digitado com um número trocado é a recusa mais comum. Pontos, traços e barras podem ficar ou sair.
  • Zero à esquerda. O Excel costuma apagar o zero do começo de um CPF como 012.345.678-90 quando a coluna está como número. O WAY NF recupera o zero quando a coluna vem como número, mas o mais seguro é formatar a coluna como texto.
  • Valor com vírgula. Use o formato brasileiro (150,00 ou 1.200,50), com no máximo duas casas depois da vírgula. Um valor como 1,200 (três casas) é recusado, e texto como "cento e cinquenta" também. O valor tem que ser maior que zero.
  • Datas. Use dd/mm/aaaa (30/10/2026). Se a célula do Excel for do tipo data, o sistema converte sozinho. Competência vazia vira a data de hoje, o que pode não ser o que você quer num fechamento feito no dia 2 do mês seguinte.
  • Uma linha por nota. Não junte duas cobranças na mesma linha nem deixe linhas de total ou subtotal no fim da planilha. Linhas totalmente vazias são ignoradas.
  • Arquivo certo. O lote aceita .xlsx e .csv. O .xls antigo não é aceito: salve como .xlsx ou CSV. No .xlsx, vale a primeira aba.
No WAY NF, enviar de novo a mesma planilha, sem mudar nada, não gera nota repetida: o sistema reconhece o lote e reaproveita o que já foi emitido. O risco está na planilha que mudou um pouco (alguém corrigiu um nome, apagou uma linha, juntou duas turmas): para o sistema, é um lote novo. A coluna referencia é a proteção para esse caso. Preencha com o código da cobrança no seu controle (por exemplo, mens-2026-10-0001): uma linha com referência já usada volta com erro em vez de gerar nota repetida, em qualquer planilha.

Passo a passo no WAY NF

  1. No painel, abra Emitir em lote e clique em Baixar modelo.
  2. Preencha uma linha por nota. Obrigatórias: cpf_cnpj, nome e valor.
  3. Envie o arquivo (.xlsx ou .csv). Nesta etapa nada é emitido: o sistema só confere.
  4. Veja a tabela de conferência: cada linha aparece como "Pronta" ou com o erro escrito ao lado, junto com a quantidade de linhas e a soma dos valores.
  5. Se houver erro, corrija a planilha e envie de novo. Enquanto houver uma linha com problema, o botão de emitir não aparece.
  6. Com tudo certo, clique em Emitir N notas. As notas recebem números em sequência, na ordem da planilha.
  7. Acompanhe o resultado de cada linha (Emitida, Na fila, Emitindo, Confirmando, Recusada) e depois em Notas emitidas, onde ficam o PDF e o XML de cada nota.

Comece pelo ambiente de teste. Toda conta do WAY NF nasce na homologação da Sefin, onde as notas não têm valor fiscal: é o lugar certo para descobrir que um CPF está errado ou que a descrição ficou estranha, antes de emitir 150 notas de verdade.

O que acontece quando uma linha dá erro

Existem dois momentos em que uma linha pode falhar, e cada um tem um efeito diferente:

MomentoExemploO que acontece
Conferência, antes de emitirCPF com dígito errado, valor vazio, data em formato estranho, referência com espaçoNenhuma nota do lote é emitida. A tabela mostra o erro de cada linha; você corrige e envia de novo
Emissão, na SefinA Sefin recusa a nota por uma regra dela (cadastro, código, município)Só aquela linha fica "Recusada", com o motivo. As outras seguem normalmente
Sefin sem resposta claraDemora ou queda na comunicaçãoA linha fica "Confirmando". O WAY NF consulta a Sefin antes de qualquer nova tentativa, para não emitir duas vezes

Uma nota recusada pela Sefin abre preenchida no painel para você corrigir e enviar de novo, sem refazer o lote inteiro. Se a mesma planilha for enviada de novo (por exemplo, depois de a internet cair no meio), as notas que já foram registradas não se repetem.

Um caso específico da reforma tributária: quando o IBS/CBS do seu serviço exige o endereço do tomador ou do imóvel na nota, a linha sem endereço volta com esse aviso. Hoje a planilha não tem colunas de endereço; essas notas saem pela emissão avulsa ou pela API. O guia IBS/CBS na NFS-e explica quais serviços pedem endereço.

Limite de 200 por lote e as notas do plano

No WAY NF, cada lote tem até 200 notas. Com mais que isso, divida em duas ou mais planilhas (por exemplo, uma por turma, por filial ou por faixa de clientes) e use a coluna referencia para não repetir ninguém entre elas.

O lote conta para a franquia do plano como qualquer outra nota. Nota além da franquia não trava a emissão: entra como nota extra na cobrança do mês seguinte, pelo valor do plano. O lote está nos planos a partir do Essencial; veja planos.

Alternativa: clientes fixos e emissão automática

Se as mesmas pessoas ou empresas recebem nota todo mês, montar planilha vira retrabalho. No WAY NF, cadastre essas pessoas uma vez em Clientes fixos (CPF/CNPJ, nome, valor e descrição; a descrição aceita {mes}, que vira o mês da nota). Todo mês, Emitir as do mês mostra a lista já marcada com quem ainda não recebeu nota no mês, deixa ajustar o valor só daquele mês e emite tudo com um clique. Repetir não duplica: sai uma nota por cliente por mês.

A partir do plano Essencial, a emissão automática faz isso sozinha: cada cliente fixo tem um dia (de 1 a 28) e a nota sai às 6h desse dia. Ela para sozinha se o certificado vencer ou se a produção for desligada, e pula quem já tem nota no mês.

SituaçãoMelhor caminho
Clientes e valores mudam todo mêsLote por planilha
Mesmos clientes, mesmo valor todo mêsClientes fixos com emissão automática
Mesmos clientes, valor que às vezes mudaClientes fixos com Emitir as do mês, ajustando o valor
Notas geradas pelo seu sistema a cada pagamentoAPI; veja o guia API de NFS-e Nacional

Perguntas frequentes

Quantas notas posso emitir num lote?

No WAY NF, até 200 notas por lote. Para mais, divida em várias planilhas e use a coluna referencia para não repetir nenhuma cobrança entre elas.

A planilha pode ser em Excel?

Pode, em .xlsx (vale a primeira aba) ou em CSV separado por ponto e vírgula ou vírgula. O formato .xls antigo não é aceito: salve como .xlsx ou CSV.

Se uma linha estiver errada, as outras são emitidas?

Na conferência, não: enquanto houver uma linha com erro de dado (CPF, valor, data), nenhuma nota do lote sai, e a tabela mostra o que corrigir. Depois de emitido, se a Sefin recusar uma nota, só aquela fica recusada e as outras seguem.

Como evito emitir a mesma nota duas vezes?

Preencha a coluna referencia com o código de cada cobrança. Uma referência já usada não gera outra nota, mesmo numa planilha editada. Reenviar a mesma planilha, sem mudanças, também não duplica.

Preciso colocar código de serviço e alíquota na planilha?

Não. Código de serviço, ISS, retenções e IBS/CBS vêm do perfil de emissão da empresa, configurado com o contador. Se a empresa tem mais de um serviço, a coluna tipo escolhe qual usar.

O que acontece com a data de competência vazia?

Vale a data de hoje. Em fechamento feito no início do mês seguinte, preencha a competência de propósito, para a nota não cair no mês errado.

Posso testar o lote sem emitir nota de verdade?

Pode. Enquanto a produção não é ativada, as notas saem na homologação da Sefin, sem valor fiscal. É o melhor jeito de testar a planilha antes do primeiro fechamento real.

Fontes

Este guia explica o uso da NFS-e Nacional; não substitui a orientação da sua contabilidade sobre regime, código de serviço e alíquotas.

Emita a NFS-e Nacional sem portal

Nota avulsa em três campos, lote por planilha ou API, com o IBS/CBS já no perfil. Teste na homologação da Sefin antes de emitir de verdade.