Na chamada dessa API será retornada um objeto contendo uma lista de notas que foram encontradas de acordo com o filtro aplicado, vale ressaltar que essa lista é paginada, portanto no máximo 200 registros serão exibidos por vez.
Descrição breve dos campos:
- hasMoreResults: Indica se existem mais páginas de resultados da pesquisa.
- retrievedRecordsCount: Indica a quantidade de registros existentes na página atual
- continuationToken: Caso o atributo hasMoreResults esteja como true, neste campo terá o token que deverá ser incluído na requisição para se obter a próxima página de resultados da pesquisa.
- records: Lista de notas fiscais que foram encontradas na pesquisa.
A consulta é processada de forma totalmente síncrona e o resultado é retornado em poucos segundos, na maioria das vezes em menos de 3 segundos, inclusive para filtros com período maior que 1 ano.
No JSON de retorno da consulta serão retornados dois tipos de registro de nota fiscal.
- Resumo-NF-e: É a nota fiscal com informações resumidas, ao consultar as notas tomadas a sefaz disponibiliza apenas as informações básicas da nota fiscal para que o Tomador (Destinatário) possa fazer uma análise prévia da nota fiscal, caso o tomador precise baixar a nota fiscal por completo, ele deverá realizar a manifestação da NF-e indicando a Confirmação da Operação ou Ciência da Operação, para então ter acesso a nota completa.
IMPORTANTE
Após um período determinado, todas as NF-es com manifestação de Ciência da Operação deverão obrigatoriamente ter a manifestação final do tomador (destinatário) declarando Confirmação da Operação, Desconhecimento ou Operação não Realizada.
Caso a manifestação final não seja concluída no prazo estipulado pela Sefaz, o tomador (destinatário) poderá sofrer penalidades.
As penalidades variam de acordo com a legislação estadual, sendo que para alguns a multa é por documento e para outros estados é sobre o valor da operação.
- NF-e: É a nota fiscal completa, contendo inclusive a DANFE (em formato PDF) e XML.
DICA
Caso você precise baixar a nota fiscal sem se preocupar com a manifestação de destinatário e suas implicações, basta usar a nossa API de consulta sem manifestação.
Essa API te dará acesso a nota completa, sem a realização de nenhuma manifestação de destinatário.
JSON de retorno da consulta, contendo duas notas fiscais, uma resumida e outra completa.
A resumida ainda não teve nenhuma operação que liberasse o acesso completa a ela, nesse caso se faz necessário a execução de uma das seguintes operações para ter acesso completo a essa nota.
- Consulta sem Manifestação: Consulta da Nota Fiscal completa pela nossa API de Consulta de Nota Tomada sem manifestação de destinatário.
- Manifestação de Destinatário: "Ciência da Operação" ou "Confirmação da Operação".
Já a nota completa, podemos perceber pelo atributo "historicoManifestacao" que ela está disponível por completo porque houve evento de manifestação, dando "Ciência da Operação" e posteriormente "Confirmação da Operação".
{
"hasMoreResults": false,
"retrievedRecordsCount": 2,
"continuationToken": null,
"records": [
{
"id": "32922254400896700550128652340003330000011211",
"tipo": "Resumo-NF-e",
"status": "Autorizada",
"motivoStatus": null,
"ambienteEmissao": "Producao",
"dataCriacao": "2020-01-19T19:25:16Z",
"dataUltimaAlteracao": "2020-01-19T19:26:01Z",
"dataEmissao": "2020-01-19T19:25:58Z",
"chaveAcesso": "32922254400896700550128652340003330000011211",
"dataAutorizacao": "2020-01-19T19:26:00Z",
"protocolo": {
"numero": "320330600942081",
"digestValue": "NsyJTvet7jjNNs/igCVhu8wg42L="
},
"valorTotal": 37.16
},
{
"id": "32200544554167000128652340000009220000011216",
"tipo": "NF-e",
"status": "Autorizada",
"motivoStatus": null,
"ambienteEmissao": "Producao",
"dataCriacao": "2020-01-19T19:25:16Z",
"dataUltimaAlteracao": "2020-01-19T19:26:01Z",
"numero": 1,
"serie": "1",
"dataEmissao": "2020-01-19T19:25:58Z",
"chaveAcesso": "32200544554167000128652340000009220000011216",
"transporte": {
"frete": {
"modalidade": "SemFrete",
"valor": 0.0
}
},
"dataAutorizacao": "2020-01-19T19:26:00Z",
"linkDanfe": "http://{linkDanfe}",
"linkDownloadXml": "http://{linkXml}",
"protocolo": {
"numero": "320300946200360",
"digestValue": "ChyJTvet7jjNNsNs/iVguwG846L="
},
"itens": [
{
"cfop": "5656",
"codigo": "000002",
"descricao": "Produto 01",
"ncm": "00070000",
"cest": null,
"extipi": null,
"codigoBeneficioFiscal": null,
"quantidade": 1,
"quantidadeTributavel": 1,
"sku": null,
"unidadeMedida": "UN",
"unidadeMedidaTributavel": null,
"valorUnitario": 37.16,
"valorTotal": 37.16,
"descontos": 0.0,
"impostos": {
"icms": {
"origem": 0,
"situacaoTributaria": "60",
"modalidadeBaseCalculo": 0,
"baseCalculo": 37.16
},
"pis": {
"situacaoTributaria": "05"
},
"cofins": {
"situacaoTributaria": "05"
}
}
}
],
"valorTotal": 37.16,
"informacoesAdicionais": null,
"pedido": {
"presencaConsumidor": "OperacaoPresencial",
"pagamento": {
"tipo": "PagamentoAVista",
"formas": [
{
"tipo": "Dinheiro",
"valor": 37.16
}
]
}
},
"historicoManifestacao": [
{
"tipo": "CienciaDaOperacao",
"justificativa": null,
"status": "Autorizada",
"motivoStatus": null,
"dataAutorizacao": "2020-01-28T19:26:00Z",
"protocolo": "320300946200360"
},
{
"tipo": "ConfirmacaoDaOperacao",
"justificativa": null,
"status": "Autorizada",
"motivoStatus": null,
"dataAutorizacao": "2020-02-10T16:01:02Z",
"protocolo": "326204009306030"
},
]
}
]
}