Com o PlugNotas, é possível consultar e importar de forma simplificada as notas que foram emitidas contra o CNPJ da empresa, contando com alguns processos automatizados. O objetivo dessa documentação é oferecer uma visão clara de como funciona o fluxo de consulta das notas destinadas.  

Fluxo de Consulta de Destinadas

Seguindo o fluxo descrito, por parte da Software House é necessário cadastrar a empresa no PlugNotas e ativar a consulta automática das destinadas. Essas duas operações podem ser executadas por meio da interface web ou via API, utilizando a rota /empresa para o cadastro e, na mesma rota, incluir a propriedade nfe.config.dfe.ativo como TRUE para ativar a consulta de destinadas. Se a empresa já estiver cadastrada, basta ativar essa propriedade por meio da rota empresa/cnpj. 

A comunicação com a SEFAZ para consulta das notas destinadas, a manifestação com a “Ciência da Operação” e o download do XML são automatizados pelo PlugNotas e ocorrem a cada intervalo de 1 hora e 20 minutos. 

Para obter as notas destinadas completas, que foram retornadas pela SEFAZ, é possível configurar um webhook ou utilizar a rota de consulta específica para esse fluxo. Além disso, é necessário verificar no retorno se a nota foi manifestada para obter o XML completo. Caso a manifestação não tenha ocorrido, será retornado o motivo da rejeição, sendo necessário solicitar a manifestação  por meio da rota /nfe/{idNota}/manifestacao. 

Tipos de consulta:

• Somente com cpfCnpj, retorna todos os registros.
• cpfCnpj + manifestada = true, retorna todas as notas já manifestadas conclusivamente.
• cpfCnpj + manifestada = false, retorna todas as notas ainda não manifestadas conclusivamente.
• cpfCnpj + dataInicial + dataFinal, retorna todos os registros do período solicitado.
• cpfCnpj + status, retorna todos as notas com o status informado.
• cpfCnpj + status,status..., retorna todas as notas com os status informado.

Rota

GET

Produção

Sandbox

Headers

body - query Parameters;

Retorno

Exemplo de retorno:

Para ver um exemplo de retorno da consulta, acesso nossa documentação completa da rota Consultar Notas Destinadas

Exemplo de retorno com erro:

{
  "error": {
    "message": "O token informado é inválido. Para o ambiente de produção, Acesse https://app2.plugnotas.com.br/, e gere o seu TOKEN de acesso"
 }
}