Documentos Destinados
Módulo: Fiscal Caminho na aplicação: Menu > Fiscal > Documentos Destinados Última atualização: 20/04/2026
Para que serve
Exibe os documentos fiscais eletrônicos destinados ao CNPJ do tenant que foram consultados na SEFAZ (DFe — Distribuição de Documentos Fiscais Eletrônicos). Inclui NF-e (modelo 55) e CT-e (modelo 57). Permite pesquisar, filtrar, forçar uma nova consulta na SEFAZ, importar um documento por chave de acesso e navegar para o Detalhe do Documento (onde é possível manifestar e baixar o XML). A partir desta tela também é possível iniciar a NF-e de Entrada com base em um documento destinado.
Quem pode usar
Usuários com acesso ao módulo Fiscal.
Como usar (passo a passo)
Visualizar documentos recebidos
- Acesse Menu > Fiscal > Documentos Destinados.
- A listagem exibe os documentos já sincronizados com a SEFAZ.
- Use os filtros para refinar a busca (chave, CNPJ, razão, modelo, situação, filial, período de emissão).
- Clique no ícone Editar (lápis) na coluna de ações da linha para abrir o Detalhe do Documento Destinado.
Forçar consulta na SEFAZ agora
- Clique em Forçar consulta agora.
- O sistema executa o job de polling que consulta novos documentos na SEFAZ para todas as filiais do tenant.
- Uma mensagem informa quantos documentos foram processados e quantos erros ocorreram.
- A lista é recarregada automaticamente.
Importar documento por chave de acesso
- Clique em Importar por chave.
- Selecione a Filial destinatária.
- Informe a Chave de acesso (44 dígitos).
- Clique em Consultar.
- Se o documento existir na SEFAZ e pertencer à filial, ele é importado e aparece na lista.
Campos da tela
Filtros
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Buscar | Não | Chave de acesso, CNPJ ou razão social | — |
| Modelo | Não | NF-e (55) / CT-e (57) | — |
| Situação | Não | Autorizada / Cancelada / Denegada | — |
| Filial | Não | Selecione a filial destinatária | — |
| Período de emissão | Não | Intervalo de datas DD/MM/AAAA | — |
Colunas da tabela
| Coluna | Descrição |
|---|---|
| Modelo | NF-e, CT-e ou outros; tag colorida |
| Emissão | Data de emissão do documento |
| Emitente | Razão social e CNPJ do emitente |
| Chave | Últimos 12 dígitos da chave de acesso |
| Valor | Valor total do documento em R$ |
| Situação | autorizada / cancelada / denegada |
| Manifestação | Apenas NF-e: ciência / confirmada / desconhecida / não realizada / sem |
| Detalhe | NF-e: natureza da operação; CT-e: modal e tipo do tomador |
Modal "Importar por chave"
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Filial | Sim | Selecione a filial | — |
| Chave de acesso | Sim | 44 dígitos | Ex.: 35260400000000000000000000000000000000000000 |
Validações e regras
- A busca e os filtros são aplicados automaticamente ao alterar qualquer campo; não é necessário pressionar Enter.
- A chave de acesso para importação avulsa deve ter exatamente 44 dígitos.
- O scroll infinito carrega 50 registros por vez.
- Manifestação está disponível apenas para NF-e autorizadas; CT-e não possui fluxo de manifestação nesta versão.
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Erro ao carregar documentos destinados" | Falha na requisição à API | Verifique a conectividade e recarregue |
Polling: X ok / Y erros | Resultado do job de consulta na SEFAZ | Verifique os erros no log do emissor se Y > 0 |
| "Consulta executada — documento (se existir) foi importado" | — | Confirmação de importação avulsa |
| "Chave deve ter 44 digitos" | Chave com tamanho incorreto | Corrija a chave |
| "Selecione" | Filial não selecionada no modal | Selecione a filial |
| ⚠️ CONFIRMAR demais mensagens retornadas pela API no modal de importação | Documento não encontrado ou CNPJ não corresponde à filial | Verifique se a chave está correta e se a filial é a destinatária da nota |
Integrações e dependências
- Consulta a SEFAZ via serviço interno
emissor-nfe(ACBrLib) usando o certificado A1 de cada filial. - O polling automático é agendado pelo backend; este botão o força manualmente.
- Um documento destinado NF-e pode ser transformado em NF-e de Entrada — acesse o detalhe e use a opção de importação.
- Depende de
documentosDestinadosServiceefiliaisService.
Dúvidas frequentes
Por que não aparecem NF-e recentes do meu fornecedor? O sistema consulta a SEFAZ periodicamente. Use o botão Forçar consulta agora para atualizar imediatamente. Se ainda não aparecer, verifique se o certificado da filial está ativo.
Preciso manifestar ciência antes de baixar o XML? Sim, para NF-e (modelo 55). A manifestação de "Ciência da Operação" libera o XML completo na SEFAZ. Sem ela, só o resumo está disponível. Acesse o Detalhe do Documento para manifestar.
O que é uma NF-e denegada? A SEFAZ pode denegar uma NF-e emitida para o seu CNPJ por irregularidade fiscal do emitente. Documentos denegados aparecem na lista para ciência, mas não devem ser efetivados como entrada de mercadoria.
Histórico de alterações
| Data | Alteração |
|---|---|
| 20/04/2026 | Documento inicial criado. |