# Consultas de documentos fiscais recebidos (DF-e)

> Cria o menu Consultas DF-e, onde o Odoo reúne os documentos fiscais emitidos contra o CNPJ da empresa e disponíveis. Módulo l10n_br_fiscal_dfe no Odoo 18.

Fonte: https://docs.kmee.com.br/odoo/18.0/modulos/localizacao-brasileira/l10n-br-fiscal-dfe/

- Módulo `l10n_br_fiscal_dfe`
- Origem: OCA
- Localização brasileira
- Licença AGPL-3
- Odoo 18.0

Cria o menu Consultas DF-e, onde o Odoo reúne os documentos fiscais emitidos contra o CNPJ da empresa e disponíveis na distribuição da SEFAZ. Oferece painel de acompanhamento, consulta específica por chave de acesso, vínculo automático com o fornecedor e notificações na caixa de entrada.

## Quando usar

- Acompanhar quais notas de fornecedores foram emitidas contra a empresa, sem pedir o arquivo a cada um.
- Buscar uma nota específica pela chave de acesso.
- Receber aviso no Odoo quando surgem novos documentos de terceiros.
- Consultar o registro das conversas com a SEFAZ para entender uma consulta que falhou.

## Como configurar

1. Abra Fiscal -> Parceiros -> Empresa, entre na empresa e, na aba Fiscal, abra a aba DF-e. O botão Logs de DF-e mostra o histórico de consultas da empresa.
2. Habilite a busca de NF-e na aba NF-e DF-e da empresa.
3. Em Preferências do usuário, marque Notificação DF-e para receber os avisos na caixa de entrada.
4. Abra Fiscal -> Consultas DF-e -> Documentos de Terceiros para ver todos os documentos recebidos; use Busca específica para localizar uma nota pela chave de acesso.

## Cuidados

- O menu Consultas DF-e aparece para os grupos Usuário Fiscal e Gerente Fiscal.
- A consulta automática à SEFAZ usa uma fila própria de tarefas, com uma consulta por vez, para evitar o bloqueio temporário do CNPJ por consumo indevido.
- A SEFAZ define o intervalo entre as consultas; o Odoo agenda a próxima conforme a resposta recebida.
- Os menus Registros DF-e e Logs de Distribuição aparecem no modo técnico, para análise de uma consulta.

## Veja na prática

Cenários do manual que usam este módulo, do começo ao fim, com exemplo calculado, passo a passo e vídeo curto com legendas.

- [Dar ciência da operação](https://docs.kmee.com.br/odoo/18.0/localizacoes/brasil/df-e/ciencia-da-operacao/) Vídeo de 2 min
- [Confirmar a operação](https://docs.kmee.com.br/odoo/18.0/localizacoes/brasil/df-e/confirmacao-da-operacao/) Vídeo de 1 min
- [Ligar a nota de combustível ao veículo e ver o custo da van](https://docs.kmee.com.br/odoo/18.0/localizacoes/brasil/financeiro/ligar-a-nota-de-combustivel-ao-veiculo-da-van/) Vídeo de 3 min
- [Lançar a nota da oficina na van e ver o serviço no histórico do veículo](https://docs.kmee.com.br/odoo/18.0/localizacoes/brasil/financeiro/lancar-a-nota-da-oficina-e-ver-o-servico-na-van/) Vídeo de 2 min
- [Dividir o gasto de uma nota de combustível entre duas vans](https://docs.kmee.com.br/odoo/18.0/localizacoes/brasil/financeiro/dividir-a-nota-de-combustivel-entre-duas-vans/) Vídeo de 3 min

## Módulos relacionados

- [Motor fiscal brasileiro](https://docs.kmee.com.br/odoo/18.0/modulos/localizacao-brasileira/l10n-br-fiscal/)
- [Monitor de NF-e recebidas](https://docs.kmee.com.br/odoo/18.0/modulos/localizacao-brasileira/l10n-br-nfe-dfe/)
- [Emissão de NF-e e NFC-e](https://docs.kmee.com.br/odoo/18.0/modulos/localizacao-brasileira/l10n-br-nfe/)

## Código e fontes

- Código-fonte: [OCA/l10n-brazil](https://github.com/OCA/l10n-brazil)
- [Documentação do módulo na OCA (18.0)](https://github.com/OCA/l10n-brazil/tree/18.0/l10n_br_fiscal_dfe)
