Pular para o conteúdo
Nota Ligeira Central de ajuda

Emissão em lote

Emitir várias notas de uma vez por planilha CSV (uma nota por linha, de um ou vários clientes), validando antes de emitir.

Para: Escritório, Integrador (API) · Atualizado em 23/10/2026

Para que serve

Para emitir muitas notas sem preencher uma a uma. Você envia uma planilha CSV com uma nota por linha, de um ou vários clientes. Cada linha usa os cadastros: o cliente emitente, o tomador da agenda desse cliente e o serviço do catálogo dele. O motor de tributação calcula os impostos de cada linha, como na emissão "tomador + serviço + valor".

Primeiro o sistema valida tudo sem emitir nada; depois você confirma a emissão. Até 500 linhas por arquivo.

Passo a passo

  1. Clique no botão Emitir e escolha Em lote (ou abra Rotinas → Emissão em lote).
  2. Clique em ↓ Baixar modelo CSV para ter a planilha com as colunas certas.
  3. Preencha uma linha por nota e salve como CSV (separado por ponto e vírgula ou vírgula).
  4. Em Arquivo, escolha o CSV. A tela mostra o nome do arquivo e quantas linhas leu.
  5. Clique em Validar lote. Nada é emitido nesta etapa.
  6. Confira a tabela Validação: cada linha mostra cliente, tomador, serviço, competência, valor e a Situação ("ok" ou o erro).
  7. Se houver linhas com erro, corrija o arquivo, escolha-o de novo e clique em Validar de novo. As linhas com erro são ignoradas na emissão.
  8. Clique em Emitir N nota(s) — R$ total. Só as linhas válidas são emitidas.
  9. Na tabela Resultado da emissão, cada linha válida aparece como "enfileirada". Clique em Acompanhar na lista de NFS-e para ver as notas conforme forem autorizadas.

Se algum cliente do lote é do Lucro Presumido ou Lucro Real em município que não usa o emissor Nacional e ainda não foi confirmado, ao clicar em emitir aparece a janela Este município pode recusar a nota. Nada é emitido até você confirmar com Confirmo, emitir assim mesmo; a confirmação vale para o cliente nas próximas notas. A validação não pede essa confirmação. Veja NFS-e: quem pode emitir pelo sistema.

Clicar de novo em emitir, ou reenviar o mesmo arquivo validado, não duplica notas.

O lote respeita a franquia do plano: com o excedente desligado e a franquia do mês já atingida, nenhuma linha é emitida e cada uma mostra a mensagem "Franquia do plano ... atingida". Teste grátis encerrado também bloqueia. A validação não confere o plano, só a emissão. Veja Plano e uso.

Campos

Colunas da planilha

ColunaO que significa
cliente_cpf_cnpjCNPJ ou CPF do cliente emitente. Sem esta coluna (ou vazia), a linha usa o cliente que aparece em Emitindo por
tomador_cpf_cnpjCPF/CNPJ do tomador; ele precisa estar na agenda daquele cliente
servicoServiço do catálogo do cliente: o código nacional (código de tributação nacional, ex.: 01.07.01) ou a descrição exata
valorValor da nota (ex.: 1500,00). Vazio usa o valor padrão do serviço
descricaoTexto da nota (opcional). Aceita {competencia}, {mes} e {ano}
competenciaCompetência em AAAA-MM-DD, AAAA-MM ou MM/AAAA. Só mês e ano usa o último dia do mês (no mês corrente, a data de hoje, porque a competência não pode ser futura); vazia usa a data de hoje. Mês ou data futura recusa a linha
informacoes_complementaresTexto livre extra (opcional)

A planilha não tem coluna de desconto incondicionado nem de materiais do INSS: as linhas saem sem esses valores. Para usá-los, emita pela tela Emitir NFS-e.

Arquivo JSON (integrações)

A tela também aceita um arquivo JSON com DPS completas, para quem já gera a DPS em outro sistema. Nesse caso todas as notas são do cliente que aparece em Emitindo por, até 100 por arquivo, e o botão é Enviar N DPS para…. Para emitir a partir dos cadastros, prefira o CSV. O formato do JSON está na documentação da API.

Erros comuns e como resolver

  • "Colunas obrigatórias ausentes: tomador, servico": o cabeçalho não tem essas colunas. Baixe o modelo e copie o cabeçalho.
  • "Máximo de 500 linhas por lote": divida o arquivo.
  • "cliente … não encontrado (ou sem acesso)": o CPF/CNPJ do cliente está errado ou você não tem acesso a esse cliente.
  • "informe o CPF/CNPJ do cliente": a linha está sem cliente e não há cliente em Emitindo por.
  • "cliente inativo": o cliente está inativo no cadastro.
  • "tomador … não está na agenda do cliente — cadastre-o em Tomadores": cadastre o tomador para aquele cliente. Veja Tomadores.
  • "serviço … não encontrado no catálogo do cliente": confira o código nacional ou a descrição exata, e se o serviço está ativo. Veja Serviços.
  • "competência inválida": use AAAA-MM-DD, AAAA-MM ou MM/AAAA.
  • "competência futura": a competência não pode ser posterior à data de emissão (a SEFIN recusaria, E0015). Use o mês atual ou um mês passado.
  • "valor inválido": use números como 1500,00 ou 1.500,00, maior que zero.
  • "tributação pendente: …": o motor não conseguiu calcular a linha (pendência de tributação), por exemplo serviço sem alíquota de ISS. Corrija o cadastro indicado e valide de novo.
  • "Franquia do plano ... atingida" ou "O período de teste terminou" em todas as linhas: veja o aviso sobre a franquia acima e o erro.
  • A linha foi "enfileirada" mas a nota não aparece: "enfileirada" quer dizer que a DPS foi aceita para envio; a autorização (ou a rejeição) pela Sefin vem depois. A nota aparece em Notas → Emitidas quando é autorizada. Rejeições entram no contador Rejeitadas do Dashboard. Antes de emitir a mesma nota de novo, confira na lista se ela não foi autorizada, para não duplicar.

Veja também

Termos usados

NFS-e
Nota Fiscal de Serviço eletrônica: o documento fiscal que comprova a prestação de um serviço.
DPS
Declaração de Prestação de Serviço: os dados da nota que o sistema assina e envia para virar NFS-e.
Emissor Nacional
Sistema público do governo para emitir NFS-e no padrão nacional, que o sistema usa por meio da Sefin Nacional.
Tomador
Quem contrata e recebe o serviço — a pessoa ou empresa para quem a nota é emitida.
Cliente (do escritório)
Empresa ou profissional que emite notas pelo sistema — o prestador do serviço.
Competência
Mês (ou data) a que o serviço se refere, para fins de imposto.
Motor de tributação
Parte do sistema que calcula ISS, retenções e IBS/CBS de cada nota a partir dos cadastros.
Pendência de tributação
Dado que falta para o motor calcular a nota; enquanto existir, o botão de emitir fica bloqueado.
Código de tributação nacional
Código de 6 dígitos do serviço na NFS-e Nacional, derivado do subitem da LC 116.
CPF
Cadastro de Pessoas Físicas: identifica pessoas.
CNPJ
Cadastro Nacional da Pessoa Jurídica: identifica empresas.

Mais em Notas fiscais

  • Emitir NFS-eComo emitir uma nota escolhendo tomador, serviço e valor (o motor calcula os impostos) ou preenchendo a DPS completa no modo avançado.
  • Emitir NF-e e NFC-e e acompanharComo montar a nota de mercadoria (destinatário, produtos, frete e pagamento), validar sem emitir, emitir, acompanhar o resultado da SEFAZ e consultar as notas emitidas.
  • Cancelar, corrigir (CC-e) e inutilizar NF-e e NFC-ePrazos e passo a passo do cancelamento (24 horas na NF-e, 30 minutos na NFC-e), da carta de correção (só NF-e) e da inutilização de números pulados.
  • NFC-e e QR CodeO que muda na NFC-e (modelo 65), o CSC e as versões 2 e 3 do QR Code, o consumidor sem identificação e o DANFE de 80 mm.
  • Contingência da NF-e e NFC-eO que fazer quando a SEFAZ para — SVC, EPEC e NFC-e off-line — quando o sistema entra e sai sozinho, os prazos de transmissão e o cancelamento por substituição.
  • NF-e: venda para outros estados, ST, DIFAL e tributos aproximadosComo o sistema calcula a alíquota interestadual, o ICMS-ST com MVA ajustada, o DIFAL, o PIS/COFINS sem o ICMS e os tributos aproximados, e o que o cliente ou o contador precisa cadastrar.
  • Notas emitidas (NFS-e)Consultar, filtrar e exportar as NFS-e emitidas pelos clientes do escritório.
  • Detalhe da notaVer os dados de uma NFS-e, baixar XML e DANFSe, enviar por e-mail, duplicar, cancelar, substituir e acompanhar os eventos.
  • Emissão automáticaCriar regras que emitem NFS-e sozinhas (mensal, semanal ou uma única vez), executar na hora e acompanhar o histórico.
  • InutilizaçõesRegistrar uma faixa de números de DPS que não será usada, com motivo, para explicar buracos na numeração.
  • Pedidos de notaAtender os pedidos de nota feitos pelos clientes no portal — assumir, emitir ou recusar com motivo.