Histórico da Página
CONTEÚDO
Índice minLevel 2 exclude CONTEÚDO style none
01. VISÃO GERAL
Este evento tem como finalidade consultar documentos fiscais eletrônicos (NF-e) emitidos contra o CNPJ do estabelecimento.
02. CONSULTA VIA TELA
Para realizar a consulta completa manualmente é necessário ter permissão. As permissões são configuradas no Perfil (Processos Fiscais>
> Perfis de segurança), para habilitar a consulta completa é necessário que o usuário tenha a permissão: "NFE-e Consulta Completa".
| Dica |
|---|
Lembrando que após a configuração é necessário realizar o login novamente. |
Rotina: Processos Fiscais> Cadastro> Estabelecimento> Filtrar o Estabelecimento que deseja realizar a consulta completa manualmente do MD-e e editar:
Na aba DF-e preencha o campo Tipo de Busca e selecione a opção "sim" para consulta automática e ciência automática e consulta dos documentos emitidos contra o CNPJ do estabelecimento é realizado automaticamente a cada 60 minutos e caso tem documentos disponíveis consulta é realizada a cada 5 minutos.
Quando a consulta automática e manifestação: Ciência da Operação são realizados, também é atualizado o campo do último numero do NSU consultado no MD-e.
| Aviso |
|---|
Caso for necessário realizar uma consulta com número de NSU diferente (Ex.: 0 - zero) basta digitar o número do NSU desejado, salvar essa alteração ( |
Após ser realizado a consulta, será listado a(s) nota(s) recebida contra o CNPJ do estabelecimento (Consulta NF-e (Nota Fiscal Eletrônica)) e o campo tipo de manifestação deve apresentar de acordo com a cor do evento:
- Cinza: Quando o documento não tem nenhuma manifestação;
- Azul: Quando o documento tem o evento ciência da operação;
- Verde: Quando o documento tem o evento confirmação da operação;
- Laranja: Quando o documento tem o evento de operação não realizada;
- Vermelho: Quando o documento tem o evento de desconhecimento da operação.
03. CONSULTA VIA API
É possível enviar a consulta de NF-e emitidas contra o CNPJ do estabelecimento via API no formato Json.
A consulta pode ser realizada de duas formas: com o NSU (Número Sequencial Único) ou com a chave de acesso da NFe:
- Consulta com NSU:
Método: | POST |
Descrição: | Utilize este recurso para consultar documentos fiscais emitidos contra o CNPJ do estabelecimento, sendo o destinatário por NSU. |
Modelo JSON (Envio e Retorno)Endpoint: | https://plataformafiscal.totvs.com.br/api/v1/dfe/consultar/nfe |
A consulta pode ser realizada de duas formas: com o NSU (Número Sequencial Único) ou com a chave de acesso da NFe.
Segue exemplo de Json:
...
| language | java |
|---|
...
| Modelo JSON (Envio): | { |
"ambiente":"Identificação |
...
do |
...
Ambiente: |
...
1=Produção |
...
/ 2=Homologação", |
...
|
...
da |
...
UF |
...
do |
...
Autor", |
...
|
...
do |
...
interessado |
...
no |
...
DF-e", |
...
|
...
{ |
...
|
...
NSU |
...
recebido |
...
pelo |
...
ator. Caso |
...
seja |
...
informado |
...
com |
...
zero, |
...
ou |
...
com |
...
um |
...
NSU |
...
muito |
...
antigo, |
...
a |
...
consulta |
...
retornará |
...
unicamente |
...
as |
...
informações |
...
resumidas |
...
e |
...
documentos |
...
fiscais |
...
eletrônicos |
...
que |
...
tenham |
...
sido |
...
recepcionados |
...
pelo |
...
Ambiente |
...
Nacional |
...
nos |
...
últimos |
...
3 |
...
meses." |
...
} |
...
} |
...
| Modelo JSON (Retorno): | { "retornoSefaz": { |
...
tpAmb": " |
...
Ambiente que consulta foi realizada 1-Produção/ 2 |
...
-Homologação", |
...
dhResp": " |
...
Data/Hora do retorno", "loteDistDFeInt": { "docZip": [{ |
...
schema": |
...
"procEventoNFe_v1.00.xsd" } " |
...
versao": " |
...
1.01", } } |
...
2. Consulta por Chave de Acesso:
Método: | POST |
| Descrição: | Utilize este recurso para consultar documentos fiscais emitidos contra o CNPJ do estabelecimento, sendo o destinatário por Chave de Acesso |
| Endpoint: | https://plataformafiscal.totvs.com.br/api/v1/dfe/consultar/nfe |
| Modelo JSON (Envio): | { |
...
"ambiente":"Identificação do Ambiente: 1=Produção /2=Homologação", |
...
"codigoUf":"Código da UF do Autor", |
...
"cnpj":"CNPJ do interessado no DF-e", |
...
"chaveNFeRequest":
|
...
{ |
...
"chaveNFe":"Chave de acesso específica." |
...
} } |
...
| Modelo JSON (Retorno): | { "retornoSefaz": { "tpAmb": "Ambiente que consulta foi realizada 1-Produção/ 2-Homologação", "loteDistDFeInt": {"docZip": [ { }, } |
...
Para realizar a consulta completa manualmente é necessário ter permissão. As permissões são configuradas no Perfil (Processos Fiscais>> Perfis de segurança), para habilitar a consulta completa é necessário que o usuário tenha a permissão: "NFE-e Consulta Completa".
| Dica |
|---|
Lembrando que após a configuração é necessário realizar o login novamente. |
Rotina: Processos Fiscais> Cadastro> Estabelecimento> Filtrar o Estabelecimento que deseja realizar a consulta completa manualmente do MD-e e editar:
Na aba DF-e clicar na opção NF-e Consulta Completa para realizar a consulta dos documentos emitidos contra o CNPJ do estabelecimento manualmente:
Ao clicar em consulta completa é realizado a manifestação: Ciência da Operação e também atualizado o numero do NSU no MD-e.
| Aviso |
|---|
Caso for necessário realizar uma consulta com número de NSU diferente (Ex.: 0 - zero) basta digitar o número do NSU desejado, salvar essa alteração (botão de Salvar MD-e) e na sequencia clicar no botão NF-e Consulta Completa. A diferença entre os botões: "" |
Após ser realizado a consulta, será listado a(s) nota(s) recebida contra o CNPJ do estabelecimento (Consulta NF-e (Nota Fiscal Eletrônica)) e o campo tipo de manifestação deve apresentar de acordo com a cor do evento:
- Cinza: Quando o documento não tem nenhuma manifestação;
- Azul: Quando o documento tem o evento ciência da operação;
- Verde: Quando o documento tem o evento confirmação da operação;
- Laranja: Quando o documento tem o evento de operação não realizada;
- Vermelho: Quando o documento tem o evento de desconhecimento da operação.
...
| Card documentos | ||||
|---|---|---|---|---|
|
04. ASSUNTOS RELACIONADOS
- Manifestação de Destinatário Eletrônica (MD-e) - Cadastro
- Manifestar Nota Fiscal Eletrônica
- Importar Certificado Digital
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas