# Retornar as categorias por filtro

Endpoint: GET /v1/financeiro/categorias
Version: v1
Security: BearerAuth

## Security:

  - `BearerAuth` (unknown)
    apiKey in header Authorization

## Query parameters:

  - `pagina` (integer)
    Número da página

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

  - `campo_ordenado_ascendente` (string)
    Ordenação ascendente (case-insensitive)

  - `campo_ordenado_descendente` (string)
    Ordenação descendente (case-insensitive)

  - `apenas_filhos` (boolean)
    Filtrar apenas categorias filhas

  - `permite_apenas_filhos` (boolean)
    Permite apenas categorias filhas

  - `tipo` (string)
    Tipo da categoria financeira

  - `nome` (string)
    Nome da categoria financeira

  - `busca` (string)
    Busca textual pela categoria

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `itens` (array)
    Itens de categorias financeiras

  - `itens.categoria_pai` (string)
    ID da categoria pai (null quando é categoria raiz)
    Example: 123e4567-e89b-12d3-a456-426614174001

  - `itens.considera_custo_dre` (boolean)
    Indica se a categoria deve ser considerada no custo do DRE
    Example: true

  - `itens.entrada_dre` (string)
    Entrada no DRE (null quando ausente ou não mapeada)
    Enum: "RECEITA_BRUTA_VENDAS", "RECEITAS_OPERACIONAIS", "RECEITA_VENDA_PRODUTOS_SERVICOS", "RECEITA_FRETES_ENTREGAS", "RECEITA_LIQUIDA_VENDAS", "DEDUCOES_RECEITA_BRUTA", "IMPOSTOS_SOBRE_VENDAS", "COMISSOES_SOBRE_VENDAS", "DESCONTOS_INCONDICIONAIS", "DEVOLUCOES_DE_VENDAS", "LUCRO_BRUTO", "CUSTOS_OPERACIONAIS", "CUSTO_PRODUTOS_VENDIDOS", "CUSTO_VENDAS_PRODUTOS", "CUSTO_SERVICOS_PRESTADOS", "LUCRO_PREJUIZO_OPERACIONAL", "DESPESAS_OPERACIONAIS_NIVEL_1", "DESPESAS_COMERCIAIS", "DESPESAS_ADMINISTRATIVAS", "DESPESAS_OPERACIONAIS_NIVEL_2", "LUCRO_PREJUIZO_LIQUIDO", "RECEITAS_DESPESAS_FINANCEIRAS", "RECEITAS_RENDIMENTOS_FINANCEIROS", "DESPESSAS_FINANCEIRAS", "OUTRAS_RECEITAS_DESPESAS_NAO_OPERACIONAIS", "OUTRAS_RECEITAS_NAO_OPERACIONAIS", "OUTRAS_DESPESAS_NAO_OPERACIONAIS", "LUCRO_PREJUIZO_FINAL", "DESPESAS_INVESTIMENTOS_EMPRESTIMOS", "INVESTIMENTOS_IMOBILIZADO", "EMPRESTIMOS_DIVIDAS"

  - `itens.id` (string)
    ID da categoria financeira
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `itens.nome` (string)
    Nome da categoria financeira
    Example: Água e Saneamento

  - `itens.tipo` (string)
    Tipo da categoria financeira (null quando não mapeado)
    Enum: "RECEITA", "DESPESA"

  - `itens.versao` (integer)
    Versão da categoria financeira
    Example: 1

  - `itens_totais` (integer)
    Total de itens encontrados
    Example: 100

## Response 400:

  - `400` (unknown)
    Bad Request

## Response 400 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