---
title: "Painel de lotes: enviar e acompanhar lotes ao lado da lista"
description: "Como ativar o novo envio em lote do app da NFE.io, enviar planilhas de NFS-e e NF-e ou chaves de consulta de NF-e num painel ao lado da lista e acompanhar cada nota sem sair da tela."
source_url: https://nfe.io/docs/documentacao/nossa-plataforma/painel-de-lotes/
product: documentacao
last_updated: 2026-10-27
tags: ["how-to", "nfse", "nfe", "emissao", "consulta", "lote"]
integration: ["painel", "planilha"]
---

# Painel de lotes

O painel de lotes é o novo jeito de enviar e acompanhar lotes no app da NFE.io. Em vez de abrir uma
tela separada, você envia a planilha num painel à direita da lista de notas e vê as notas aparecerem
na lista enquanto o lote é processado.

O painel vale para:

* emissão de NFS-e em lote;
* emissão de NF-e em lote;
* consulta de NF-e em lote, por chave de acesso.

:::info Ativação opcional
O painel de lotes é opcional e pode ser desligado a qualquer momento. Enquanto ele não for ativado,
o envio em lote continua funcionando como antes. A liberação acontece em etapas, então alguns
produtos podem chegar à sua conta em datas diferentes.
:::

## Ao final deste guia, você será capaz de:

* Ativar e desativar o painel de lotes
* Enviar um lote de NFS-e, NF-e ou de consulta de NF-e pelo painel
* Acompanhar o lote, ver o motivo de cada erro e baixar os arquivos e o relatório

## Requisitos

1. [Criar uma conta](/docs/documentacao/nossa-plataforma/criar-conta)
2. [Criar uma empresa](/docs/documentacao/nossa-plataforma/criar-empresa)
3. Para emitir, [ter o certificado digital da empresa no app](/docs/documentacao/nossa-plataforma/upload-do-certificado-digital)
4. Ter na assinatura o produto do lote que você vai enviar (NFS-e, NF-e ou consulta de NF-e)

## 1. Ativar o painel de lotes

Você pode ativar o painel de dois jeitos:

* **Pela tela Novidades**, no menu lateral do app: no item do painel de lotes, clique em
  **Ativar o novo envio**.
* **Pelo aviso nas telas de envio em lote atuais**: no aviso **Novo envio em lote disponível**,
  clique em **Ativar o novo envio**. **Saiba mais** abre a explicação em Novidades, e **Agora não**
  esconde o aviso.

Depois de ativado, o app confirma com a mensagem **Novo envio em lote ativado.** A ativação vale
para a assinatura inteira: todos os usuários da conta passam a ver o painel.

### Voltar ao envio anterior

Para voltar ao modelo anterior, clique em **Voltar ao envio anterior** no topo do painel de lotes ou
no item do painel em Novidades. As telas de envio em lote anteriores voltam a aparecer na hora, e
você pode ativar o painel de novo quando quiser.

## 2. Enviar um lote

2.1 Abra a lista do produto: as notas de serviço ou as notas de produto da empresa, ou a lista de
consultas de NF-e em lote.

2.2 Clique em **Lotes** no cabeçalho da lista. O painel abre à direita com os lotes recentes da
empresa, do mais novo para o mais antigo. Na consulta de NF-e, a própria lista já é a de lotes:
clique em **Novo lote** no cabeçalho, e o painel abre direto no envio.

2.3 Clique em **Novo lote**. Se ainda não tiver o arquivo, baixe o modelo em **Modelos**. **Como
preencher** abre a explicação de cada coluna.

2.4 Envie o arquivo: arraste para a área de envio ou clique nela para escolher.

2.5 Conforme o produto, o painel pede mais um passo antes do envio:

| Produto | O que o painel pede |
|---|---|
| NFS-e | Nada a mais. Antes de liberar o envio, o app confere se a empresa tem inscrição municipal cadastrada. |
| NF-e | **Inscrição estadual da emissão**: escolha a inscrição que vai emitir o lote. O ambiente (produção ou homologação) é o dessa inscrição. Confira e marque **Confirmo a emissão das notas desta planilha**. |
| Consulta de NF-e | Você pode enviar as chaves em planilha, em arquivo de texto ou colando na tela, uma por linha. Depois escolha a fonte da consulta, os arquivos que quer receber e o ambiente. |

:::warning Emissão em produção
No ambiente de produção, cada nota emitida é um documento fiscal real. Confira o ambiente
mostrado no painel antes de confirmar.
:::

2.6 Clique em **Enviar lote**.

O lote é processado nos servidores da NFE.io. Depois do envio, você pode fechar a página e
acompanhar o andamento quando voltar.

## 3. Acompanhar o lote

Enquanto o lote é processado:

* **A lista se atualiza sozinha.** Na primeira página da lista, sem filtros, as notas novas entram
  destacadas, sem você perder o lugar. Com filtro, ordenação ou outra página aberta, a lista avisa
  quantas notas novas chegaram e oferece um atalho para ver as mais recentes.
* **O botão Lotes mostra quantos lotes estão em andamento** na empresa.

No detalhe do lote, o painel mostra:

* **O resumo**: quantas notas foram emitidas do total, quantas tiveram erro e, nas emissões, o valor
  total das notas emitidas.
* **Uma linha por nota da planilha**, com busca e filtro por situação: **Todas**, **Processando**,
  **Emitidas**, **Com erro** e **Descartadas**.
* **O motivo de cada erro**: na linha com erro, abra o motivo para ver o que precisa ser corrigido.
* **A nota emitida**: nas emissões, clique na linha para abrir o detalhe da nota, com o painel
  aberto no lote.

### Situação do lote

| Situação | O que significa |
|---|---|
| **Na fila** | O lote foi recebido e aguarda o início do processamento. |
| **Processando** | A planilha está sendo lida ou as notas estão sendo emitidas ou consultadas. |
| **Concluído** | Todas as notas do lote foram processadas sem erro. |
| **Concluído com erros** | O lote terminou, mas parte das notas teve erro. Veja o motivo de cada uma no filtro **Com erro**. |
| **Falhou** | O lote não foi processado, por exemplo porque a planilha foi recusada inteira. O painel mostra o motivo. |

### Consulta de NF-e: reprocessar as chaves com erro

No detalhe de um lote de consulta, você pode criar um novo lote só com as chaves que falharam ou
copiar essas chaves de uma vez.

## 4. Baixar os arquivos e o relatório

Quando o lote termina:

* **Baixar XML** e **Baixar PDF** baixam os arquivos das notas do lote compactados.
* **Baixar relatório (CSV)** baixa uma linha por nota da planilha, com a situação e o motivo de cada
  erro. O arquivo abre direto no Excel.

Os arquivos aparecem no botão de download assim que ficam prontos.

## 5. Enviar a mesma planilha de novo

Se você enviar de novo uma planilha de emissão que já foi enviada, as notas que já foram emitidas
não são emitidas outra vez: só as notas recusadas voltam a ser enviadas. Assim, corrigir as linhas
com erro e reenviar a mesma planilha não duplica as notas que deram certo.

Algumas regras para não ser pego de surpresa:

* **Duas notas idênticas na mesma planilha viram uma só.** Para emitir as duas, use códigos
  diferentes em cada linha.
* **NFS-e sem data:** uma linha sem data de emissão e sem data de competência só é reconhecida como
  repetida se for reenviada no mesmo dia.

## 6. Limites

| Produto | Limite por lote |
|---|---|
| NFS-e | Até 1.000 notas por planilha, dentro do limite de emissão em lote do seu plano |
| NF-e | Até 10.000 notas por planilha |
| Consulta de NF-e | Até 3.000 chaves de acesso por lote |

Uma planilha acima do limite é recusada inteira, antes de qualquer nota ser emitida. O painel mostra
**A planilha passou do limite de notas por lote** e, em **Ver detalhes**, o total da planilha e o
limite. Divida a planilha em arquivos menores e envie cada um.

## Dúvidas frequentes

**Preciso mudar alguma coisa na minha integração pela API?**
Não. O painel de lotes muda só a tela do app. A emissão pela API continua igual.

**Ativei o painel e quero voltar. Perco as notas que emiti?**
Não. As notas emitidas pelo painel continuam na lista do produto.

**O formato das planilhas mudou?**
Não. O painel usa os mesmos modelos de planilha de antes, disponíveis em **Modelos**:

* [Emitir NFS-e em lote](/docs/documentacao/nossa-plataforma/nota-fiscal-servico/emitir-em-lote)
* [Emitir NF-e em lote](/docs/documentacao/nossa-plataforma/nota-fiscal-produto/emitir-em-lote)

Ficou com alguma dúvida? Fale com o nosso time de suporte pelo chat do app ou por
[suporte@nfe.io](mailto:suporte@nfe.io).
