--- title: "Como emitir DC-e em lote por planilha" description: "Como importar uma planilha de Declaração de Conteúdo Eletrônica (DC-e) no painel da NFE.io, conferir os erros antes de enviar e acompanhar o desfecho linha a linha." source_url: https://nfe.io/docs/documentacao/nossa-plataforma/declaracao-de-conteudo/emitir-dce-em-lote/ product: documentacao last_updated: 2026-10-23 tags: ["how-to", "dce", "emissao", "planilha", "lote"] integration: ["painel", "planilha"] --- # Como emitir DC-e em lote por planilha Para emitir muitos documentos de uma vez, o painel importa uma planilha `.xlsx`, valida tudo **antes de enviar** e depois acompanha o desfecho de cada linha. > 📚 O formato do arquivo — as colunas, a obrigatoriedade e os limites — está em > [template de planilha para emissão de DC-e](/docs/documentacao/declaracao-de-conteudo-eletronica/template-de-planilha-para-emissao-de-dce). > Esta página é sobre a **tela**; aquela é sobre o **arquivo**. ## Ao final deste tutorial, você será capaz de: * Importar uma planilha de DC-e no painel * Corrigir os erros apontados antes de qualquer documento ser enviado * Acompanhar o envio linha a linha e exportar o resultado ## Requisitos 1. [Ter certificado digital ativo](/docs/documentacao/nossa-plataforma/upload-do-certificado-digital) 2. Ter a DC-e habilitada na assinatura 3. A planilha preenchida a partir do modelo baixado no próprio painel ## 1\. Abrir a importação 1.1 No menu lateral, clique em **Empresas**, escolha a empresa e, no grupo de emissão, clique em **DC-e**. 1.2 Clique em **Importar em lote**. A tela **Emissão de DC-e em lote** abre em três passos. :::tip Atalho pela empresa Na página da empresa, o botão de **Ações** (⋮) traz **Enviar DC-e em lote**, que leva ao mesmo lugar. ::: ## 2\. Passo 1 — baixe e preencha o modelo Clique em **Baixar o modelo**. A planilha tem duas abas de dados: * **DCe** — uma linha por documento * **Itens** — uma linha por item A coluna **`ID_DCe`** liga as duas, e é a única parte do formato que não se descobre olhando o arquivo. Três regras valem sempre: 1. Todo item precisa de um `ID_DCe` que exista na aba **DCe** 2. Todo documento precisa de **pelo menos um item** 3. Colunas com **asterisco** no cabeçalho são obrigatórias sempre :::warning Apague as linhas de exemplo O modelo vem com as linhas `EXEMPLO-1` e `EXEMPLO-2` preenchidas. Se elas ficarem, o painel avisa — mas o aviso não impede o envio. Apague antes de importar. ::: ## 3\. Passo 2 — envie e confira 3.1 Arraste a planilha para a área de upload ou clique para escolher. Só `.xlsx`, com as abas **DCe** e **Itens**. :::info Nenhum documento é enviado neste passo A conferência é local, no navegador. Nada vai para a SEFAZ antes de você clicar em enviar no passo 3. ::: 3.2 O painel mostra o que a planilha contém — quantos documentos, quantos itens, quantos estão **prontos** e quantos estão **com erro** — e uma tabela com uma linha por documento. Clique em **Ver os itens** para abrir os itens de um documento, e use os filtros **Todos**, **Prontos** e **Com erro**. 3.3 Cada erro aponta **aba, linha e coluna** com o nome da coluna da planilha — `Destinatario_CNPJ`, não o nome do campo da API. Corrija na planilha e importe de novo. ### Os problemas mais comuns | Aviso | O que houve | |---|---| | *"A planilha precisa de duas abas"* | O arquivo tem só uma aba. Arquivos CSV não têm abas | | *"Falta a aba…"* | Uma das duas abas não existe ou foi renomeada | | *"As abas foram identificadas pela posição"* | Os nomes não batem. Renomeie para **DCe** e **Itens** | | *"A coluna … foi lida como número"* | A coluna pode ter perdido zeros à esquerda. Formate-a como **texto** na planilha | | *"Linha sem ID_DCe"* | O identificador é obrigatório nas duas abas | | *"O ID_DCe se repete com os mesmos dados"* | Só um aviso: as linhas repetidas viram um documento só | | *"O ID_DCe se repete com dados diferentes"* | Não dá para saber qual documento vale. Corrija o identificador | | *"Este item aponta um ID_DCe que não existe"* | O item está órfão | | *"Este documento não tem nenhum item"* | Todo documento precisa de pelo menos um item | | *"Não foi possível abrir esta planilha"* | O arquivo não é `.xlsx` ou está protegido por senha | :::warning Confira os valores na prévia A prévia mostra **quantidade × valor unitário = total** por item e o **valor total** de cada documento. É onde um separador decimal errado aparece — `5.500` lido como `5,5` é um erro de mil vezes num documento fiscal. ::: ### O limite de documentos por planilha Uma planilha aceita até **50 documentos**. Com a funcionalidade de **envio em lote** na assinatura, o limite passa para **1.000**. Se a planilha ultrapassar o seu limite, o painel diz qual é e pede para dividir o arquivo. O arquivo também tem limite de tamanho, porque é lido no navegador: até **10.000 linhas** na aba **Itens** e até **60.000 textos distintos**. Passando disso, o painel pede para dividir o arquivo. ## 4\. Passo 3 — envie os documentos 4.1 Selecione as linhas que vão ser enviadas. **Selecionar todas as prontas** marca de uma vez tudo que passou na validação; linhas com erro não podem ser selecionadas. 4.2 Clique em **Enviar** e acompanhe. Cada documento sai numa requisição própria, com chave de idempotência: o **Tentar de novo** desta tela reenvia com a mesma chave e não duplica. 4.3 A tabela mostra a situação de cada linha: | Situação | O que significa | |---|---| | **Pendente de envio** | Selecionada, ainda não enviada | | **Enviando** / **Aguardando desfecho** | Em andamento | | **Autorizada** | A SEFAZ autorizou | | **Rejeitada pela SEFAZ** | Recusada pela SEFAZ. O motivo aparece nos detalhes da linha | | **Recusada antes do envio** | A plataforma não transmitiu. Nenhum documento foi emitido | | **Ainda processando** | A SEFAZ não respondeu dentro do tempo de acompanhamento | | **Falha no envio** | A requisição não teve resposta. **Tentar de novo** é seguro: a mesma chave evita duplicar | 4.4 Ao fim, clique em **Baixar resultado** para exportar a planilha com o desfecho de cada linha, ou em **Ver este lote na lista** para abrir a lista de DC-e já filtrada por este lote. :::danger Importar de novo emite de novo A proteção contra duplicidade vale só dentro desta tela. **Cada importação é um envio novo**: subir outra vez a mesma planilha — ou a planilha de resultado — emite de novo todas as linhas que estiverem nela, inclusive as já autorizadas. Para reenviar só as que falharam, **apague do arquivo as linhas autorizadas** (e os itens delas) antes de importar. ::: :::warning Fechar a aba interrompe o envio O que já foi enviado **continua sendo processado e não é desfeito** — só as linhas restantes deixam de sair. Se você sair no meio, o painel avisa quantos documentos já foram enviados. ::: ## Onde os documentos aparecem depois Todos entram na [lista de DC-e da empresa](./consultar-dce-e-baixar-dace-e-xml.md), com a marca **Em lote** e o identificador do lote. É por lá que você baixa a DACE e o XML de cada um.