# Retornar as notas fiscais por filtro

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.

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

## Security:

  - `BearerAuth` (unknown)
    apiKey in header Authorization

## 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:

  - `200` (unknown)
    OK

## 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:

  - `400` (unknown)
    Bad Request

## Response 400 fields (application/json):

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

## Response 404:

  - `404` (unknown)
    Not Found

## Response 404 fields (application/json):

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

## Response 500:

  - `500` (unknown)
    Internal Server Error

## Response 500 fields (application/json):

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