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. 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
- Ter certificado digital ativo
- Ter a DC-e habilitada na assinatura
- 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.
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:
- Todo item precisa de um
ID_DCeque exista na aba DCe - Todo documento precisa de pelo menos um item
- Colunas com asterisco no cabeçalho são obrigatórias sempre
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.
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 |
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.
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.
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, com a marca Em lote e o identificador do lote. É por lá que você baixa a DACE e o XML de cada um.