# Retornar as notas fiscais por filtro

Endpoint: GET /v1/notas-fiscais
Version: v1
Security: BearerAuth

## Query parameters:

  - `data_inicial` (string, required)
    Data inicial no formato YYYY-MM-DD

  - `data_final` (string, required)
    Data final no formato YYYY-MM-DD

  - `pagina` (integer)
    Página

  - `tamanho_pagina` (integer)
    Tamanho da página

  - `documento_tomador` (string)
    Documento do tomador

  - `numero_nota` (string)
    Número da nota fiscal

  - `id_venda` (string)
    ID da venda

## Response 200 fields (application/json):

  - `itens` (array)
    Lista de notas fiscais

  - `itens.chave_acesso` (string)
    Chave de acesso da nota fiscal
    Example: "42250323643586000108550010000001151606401726"

  - `itens.data_emissao` (string)
    Data de emissão da nota fiscal
    Example: "2025-01-15T10:30:00Z"

  - `itens.nome_destinatario` (string)
    Nome do destinatário
    Example: "EMPRESA EXEMPLO LTDA"

  - `itens.numero_nota` (integer)
    Número da nota fiscal
    Example: 123456

  - `itens.status` (string)
    Status da nota fiscal
    Enum: "EMITIDA", "CORRIGIDA_SUCESSO"

  - `paginacao` (object)
    Paginação

  - `paginacao.pagina_atual` (integer)
    Página atual
    Example: 1

  - `paginacao.tamanho_pagina` (integer)
    Tamanho da página
    Example: 10

  - `paginacao.total_itens` (integer)
    Total de itens
    Example: 50

  - `paginacao.total_paginas` (integer)
    Total de páginas
    Example: 5

## Response 400 fields (application/json):

  - `error` (string)
    Mensagem de erro
    Example: "Mensagem de erro detalhada"

## Response 404 fields (application/json):

  - `error` (string)
    Mensagem de erro
    Example: "Mensagem de erro detalhada"

## Response 500 fields (application/json):

  - `error` (string)
    Mensagem de erro
    Example: "Mensagem de erro detalhada"