Como consultar uma DC-e e baixar a DACE e o XML
A lista de DC-e da empresa reúne tudo que foi emitido, não importa por onde: painel, API ou planilha. É por ela que você acompanha o que está em processamento e baixa os arquivos do que já foi autorizado.
📚 Para consultar por código, veja como consultar uma declaração de conteúdo pela API e DACE e XML.
Ao final deste tutorial, você será capaz de:
- Encontrar uma DC-e pela lista da empresa
- Entender o status e a etapa de processamento
- Baixar a DACE completa, a DACE resumida e o XML autorizado
1. Abrir a lista
No menu lateral, clique em Empresas, escolha a empresa e, no grupo de emissão, clique em DC-e. A tela Declarações de conteúdo abre com o cartão DC-e emitidas.
A lista não separa origem. Documentos enviados em lote trazem a marca Em lote e o identificador do lote.
Se a empresa ainda não emitiu nada, a tela mostra "Nenhuma DC-e encontrada".
2. As colunas da lista
| Coluna | O que traz |
|---|---|
| Série / Número | A identificação do documento na SEFAZ |
| Chave de acesso | A chave de 44 dígitos do documento autorizado |
| Status | O desfecho — ver a tabela do passo 3 |
| Criada em | Quando o documento entrou na plataforma |
| Destinatário | Nome de quem recebe |
| Valor total | A soma dos itens |
| Protocolo | O protocolo de autorização da SEFAZ |
| Lote | O identificador do lote, quando a emissão veio de planilha |
3. Filtrar para achar um documento
A busca aceita status, período de criação, chave de acesso, número, série, nome do destinatário e identificador do lote.
Os status possíveis:
| Status | O que significa |
|---|---|
| Criada | O documento existe na plataforma e ainda não foi transmitido |
| Processando | Em andamento |
| Autorizada | A SEFAZ autorizou. É o único status de onde sai DACE e XML |
| Cancelada | O cancelamento foi homologado pela SEFAZ |
| Rejeitada | A SEFAZ recusou. O motivo aparece no detalhe |
| Recusada antes do envio | A plataforma não transmitiu. Nenhum documento foi emitido na SEFAZ |
| Status não reconhecido | O painel recebeu um status que ainda não sabe exibir. Abra o detalhe e confira a linha do tempo |
O filtro de status também oferece Não iniciada, Denegada e Falha. A DC-e não chega a esses status: filtrar por eles não traz documento.
O ambiente da DC-e é configurado por empresa. Uma empresa que já emitiu em homologação e em produção não vê os dois misturados: a lista mostra os documentos do ambiente em que a empresa está agora, e o detalhe traz o campo Ambiente. O ambiente é trocado no cartão Declaração de Conteúdo (DC-e) da edição da empresa — e a troca vale também para as próximas emissões.
4. Ver o detalhe do documento
Clique na linha para abrir a Declaração de conteúdo. O detalhe traz:
- Identificação — série e número, status, etapa, criada em, protocolo, chave de acesso e ambiente
- Emitente e Destinatário, com nome e CNPJ/CPF
- Itens do documento — número, descrição, NCM, quantidade, valor unitário e valor total
- Linha do tempo dos eventos do documento
- Lote, quando a emissão veio de planilha
Status é o desfecho (Autorizada, Rejeitada…). Etapa é onde o processamento está agora — Enviando à SEFAZ, Consultando a autorização, Gerando a DACE, Concluída. Um documento em Processando tem etapa que muda; um documento Autorizada tem etapa Concluída.
5. Baixar a DACE e o XML
No detalhe do documento, três botões:
| Botão | O que baixa |
|---|---|
| DACE completa | O documento auxiliar em versão completa |
| DACE resumida | O documento auxiliar em versão resumida |
| XML | O XML autorizado pela SEFAZ |
Se a DC-e ainda estiver em processamento, ou tiver sido rejeitada ou recusada, a tela informa que "este documento ainda não tem arquivos gerados". Não há DACE nem XML de documento que a SEFAZ não autorizou.
Os mesmos três botões aparecem na tela de emissão logo depois de uma DC-e ser autorizada — não é preciso voltar à lista para baixar.
Próximo passo
Para desfazer um documento autorizado, veja como cancelar uma DC-e — e note que a janela é curta.