Quando a receita informa que uma nota fiscal foi emitida contra a empresa, recebemos apenas um resumo do xml da nota fiscal com os dados mais importantes. Caso a nota seja manifestada, recebemos um xml com todos os dados da nota. Da mesma forma, a receita poderá notificar quando a nota recebe uma carta de correção ou quando ela é cancelada.
Por isso as notas fiscais recebidas possuem um campo chamado "versao" que é único entre todos os documentos do mesmo CNPJ e que é atualizado a cada alteração nesta nota fiscal. Isto facilita a busca apenas dos documentos que seu sistema ainda não conhece, sendo necessário que você armazene apenas um número por CNPJ.
Exemplo: Se você recebe uma nota fiscal, com versao = 60, e ela posteriormente receber uma carta de correção ou for cancelada, sua versão será atualizada para algum número maior que 60.
Este endpoint retorna as 100 primeiras notas encontradas. Para recuperar as demais notas você deverá fazer uma nova requisição alterando o parâmetro versao.
Para auxiliar o processo de consultar a API irá devolver os seguintes cabeçalhos HTTP:
- X-Total-Count: O número total de registros (incluindo aqueles que não foram devolvidos pelo limite de 100 registros)
- X-Max-Version: Valor máximo da versão dos documentos devolvidos. Utilize este cabeçalho para utilizar na próxima busca de versão, caso seja necessário.
Como retorno você receberá os campos descritos nos exemplos abaixo, de acordo com o status da nota.