# Busca despesas por filtro

Retorna uma lista de lançamentos financeiros baseado nos filtros

Endpoint: GET /v1/financeiro/eventos-financeiros/contas-a-pagar/buscar
Version: v1
Security: BearerAuth

## Query parameters:

  - `pagina` (integer, required)
    Número da página
    Example: 1

  - `tamanho_pagina` (integer, required)
    Número de itens por página
    Example: 10

  - `campo_ordenado_ascendente` (string)
    Se este campo for utilizado, o parâmetro campo_ordenado_descendente será desconsiderado. É possível ordenar por id do centro de custo (ID), pelo código (CODIGO), pelo nome (NOME) e por ativo (ATIVO).
    Enum: "ID", "CODIGO", "NOME", "ATIVO"

  - `campo_ordenado_descendente` (string)
    Se este campo for utilizado, o campo campo_ordenado_ascendente não deverá ser informado. É possível ordenar por id do centro de custo (ID), pelo código (CODIGO), pelo nome (NOME) e por ativo (ATIVO).
    Enum: "ID", "CODIGO", "NOME", "ATIVO"

  - `descricao` (string)
    Descrição da conta
    Example: "Conta Corrente"

  - `data_vencimento_de` (string, required)
    Date de vencimento de (ISO date format)
    Example: "2027-08-15"

  - `data_vencimento_ate` (string, required)
    Data de vencimento até (ISO date format)
    Example: "2027-08-20"

  - `data_competencia_de` (string)
    Data de competência de (ISO date format)
    Example: "2025-08-15"

  - `data_competencia_ate` (string)
    Data de competência até (ISO date format)
    Example: "2025-08-20"

  - `data_pagamento_de` (string)
    Data de pagamento de (ISO date format)
    Example: "2025-08-15"

  - `data_pagamento_ate` (string)
    Data de pagamento até (ISO date format)
    Example: "2025-08-20"

  - `valor_de` (string)
    Valor de
    Example: "110.10"

  - `valor_ate` (string)
    Valor até
    Example: "110.10"

  - `status` (array)
    Lista de status da conta
    Enum: "PERDIDO", "RECEBIDO", "EM_ABERTO", "RENEGOCIADO", "RECEBIDO_PARCIAL", "ATRASADO"

  - `ids_contas_financeiras` (array)
    Lista de IDs de contas financeiras
    Example: "35473eec-4e74-11ee-b500-9f61de8a8b8b"

  - `ids_categorias` (array)
    Lista de IDs de categorias
    Example: "35473eec-4e74-11ee-b500-9f61de8a8b8b"

  - `ids_centros_de_custo` (array)
    Lista de IDs de centros de custo
    Example: "35473eec-4e74-11ee-b500-9f61de8a8b8b"

## Response 200 fields (application/json):

  - `itens_totais` (integer)
    Example: 6

  - `itens` (array)

  - `itens.id` (string)
    Example: "c6a28b6e-efe4-11ee-8ef8-8b86c5251537"

  - `itens.descricao` (string)
    Example: "Descrição..."

  - `itens.data_vencimento` (string)
    Example: "2027-08-15"

  - `itens.status` (string)
    Example: "OVERDUE"

  - `itens.total` (number)
    Example: 781201.79

  - `itens.nao_pago` (number)
    Example: 213023.79

  - `itens.pago` (number)

  - `itens.data_criacao` (string)
    Example: "2027-08-15T14:30:00Z"

  - `itens.data_alteracao` (string)
    Example: "2027-08-15T14:30:00Z"

  - `itens.fornecedor` (object)

  - `itens.fornecedor.nome` (string)
    Example: "Maria da Silva"

  - `totais` (object)

  - `totais.ativo` (integer)
    Example: 6

  - `totais.inativo` (integer)

  - `totais.todos` (integer)
    Example: 6