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"
                },
            ]
        }
    ]
}