Índice minLevel 2 exclude CONTEÚDO style none
Este evento tem como finalidade consultar documentos fiscais eletrônicos (NF-e) emitidos contra o CNPJ do estabelecimento.
...
É possível enviar a consulta de NF-e emitidas contra o CNPJ do estabelecimento via API no formato Json.
...
Método:
...
POST
...
Descrição:
...
Utilize este recurso para consultar documentos fiscais emitidos contra o CNPJ do destinatário.
...
Modelo JSON (Envio e Retorno):
...
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:
- Consulta com NSU:
Bloco de código | ||
---|---|---|
| ||
{
"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",
"nsuRequest":
{
"ultimoNsu":"Último 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."
}
}
|
- Retorno:
- Consulta com a Chave de Acesso:
Bloco de código | ||
---|---|---|
| ||
{
"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."
}
}
|
- Retorno:
...
Para realizar a consulta completa manualmente é necessário ter permissão. As permissões são configuradas no Perfil (Processos Fiscais>missão: "NFE-e Consulta Completa". > Perfis de segurança), para habilitar a consulta completa é necessário que o usuário tenha a per
...
Na aba DF-e preencha o campo Tipo de Busca e clique na opção NF-e Consulta Completa para realizar a 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 manualmente:
é realizado automaticamente a cada 60 minutos e caso tem documentos disponíveis consulta é realizada a cada 5 minutos.
Quando a consulta automática e Ao clicar em consulta completa é realizado a manifestação: Ciência da Operação e 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 () e na sequencia clicar no botão NF-e Consulta Completa). O botão "Salvar MD-e" salva apenas o que esta no campo ÚçtÚlt. NSU consultado. O botão "Salvar Alterações" salva todas as alterações do estabelecimento. |
...
É 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:
Método: | POST |
Descrição: | Utilize este recurso para consultar documentos fiscais emitidos contra o CNPJ do estabelecimento, sendo o destinatário por NSU. |
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", { |
...
" } } | |
Modelo JSON (Retorno): | { "retornoSefaz": { "loteDistDFeInt": { "docZip": [{ } "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", { } |
Modelo JSON (Retorno): | { "retornoSefaz": { "tpAmb": "Ambiente que consulta foi realizada 1-Produção/ 2-Homologação", "loteDistDFeInt": {"docZip": [ { }, } |
...
Card documentos | ||||
---|---|---|---|---|
|
...