Retornar as notas fiscais por filtro

Request

Permite consultar todas as notas fiscais de produto (NFe) já emitidas no ERP, com suporte a filtros como data, número da nota, id da venda.. Este endpoint retorna somente NFe com status EMITIDA e CORRIGIDA COM SUCESSO (outros status em construção). Essa funcionalidade facilita o monitoramento fiscal, exportação para relatórios ou integração com contabilidade.

Security

BearerAuth

Query

data_inicialstringrequired

Data inicial no formato YYYY-MM-DD

data_finalstringrequired

Data final no formato YYYY-MM-DD

paginainteger

Página

Default:1

tamanho_paginainteger

Tamanho da página

Default:10

Enum:102050100

documento_tomadorstring

Documento do tomador

Example:documento_tomador=12345678900

numero_notastring

Número da nota fiscal

Example:numero_nota=1234

id_vendastring

ID da venda

Example:id_venda=550e8400-e29b-41d4-a716-446655440000

curl -i -X GET \
  'https://api-v2.contaazul.com/v1/notas-fiscais?data_inicial=string&data_final=string&pagina=1&tamanho_pagina=10&documento_tomador=12345678900&numero_nota=1234&id_venda=550e8400-e29b-41d4-a716-446655440000' \
  -H 'Authorization: YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/json

itensArray of objects(NotaFiscal)

Lista de notas fiscais

paginacaoobject(Pagina_o)

Paginação

Response

{
  "itens": [
    { … }
  ],
  "paginacao": {
    "pagina_atual": 1,
    "tamanho_pagina": 10,
    "total_itens": 50,
    "total_paginas": 5
  }
}