# Retornar as despesas por filtro

Permite consultar as parcelas de despesas (contas a pagar) conforme filtros como data de vencimento, data competência, data de alteração, valor, status, conta financeira, etc. Essa consulta possibilita monitorar as obrigações financeiras pendentes ou pagas, favorecendo a gestão e o planejamento.

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

## Security:

  - `BearerAuth` (unknown)
    http bearer JWT

## Query parameters:

  - `pagina` (integer, required)
    Página

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

  - `campo_ordenado_ascendente` (string)
    Campo para ordenação ascendente. Se informado ele desconsidera o valor do campo_ordenado_descendente. É possível ordenar por id do centro de custo (id),  pelo código (CODIGO), pelo nome (NOME) e por ativo (ATIVO)

  - `campo_ordenado_descendente` (string)
    Campo para ordenação descendente. 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) ou por ativo (ATIVO)

  - `descricao` (string)
    Descrição da conta

  - `data_vencimento_de` (string, required)
    Date de vencimento de (ISO date format)

  - `data_vencimento_ate` (string, required)
    Data de vencimento até (ISO date format)

  - `data_competencia_de` (string)
    Data de competência de (ISO date format)

  - `data_competencia_ate` (string)
    Data de competência até (ISO date format)

  - `data_pagamento_de` (string)
    Data de pagamento de (ISO date format)

  - `data_pagamento_ate` (string)
    Data de pagamento até (ISO date format)

  - `data_alteracao_de` (string)
    Data de alteração de (ISO 8601, São Paulo/GMT-3)

  - `data_alteracao_ate` (string)
    Data de alteração até (ISO 8601, São Paulo/GMT-3)

  - `valor_de` (string)
    Valor de

  - `valor_ate` (string)
    Valor até

  - `status` (array)
    Lista de status da conta

  - `ids_contas_financeiras` (array)
    Lista de IDs de contas financeiras

  - `ids_categorias` (array)
    Lista de IDs de categorias

  - `ids_centros_de_custo` (array)
    Lista de IDs de centros de custo

## Response 200:

  - `200` (unknown)
    OK

## 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: Aluguel do escritório

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

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

  - `itens.status_traduzido` (string)
    Enum: "PERDIDO", "RECEBIDO", "EM_ABERTO", "RENEGOCIADO", "RECEBIDO_PARCIAL", "ATRASADO"

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

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

  - `itens.pago` (number)
    Example: 0

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

  - `itens.data_alteracao` (string)
    Data de alteração da conta a pagar (ISO 8601, São Paulo/GMT-3)
    Example: 2027-08-15T14:30:00Z

  - `itens.data_competencia` (string)
    Data de competência da parcela (campo data_competencia)
    Example: 2018-03-16

  - `itens.categorias` (array)
    Lista de categorias associadas à parcela (id e nome)

  - `itens.categorias.id` (string)
    Identificador único da categoria
    Example: b134ec6b-30f8-4edc-9a8f-4787fd3381ac

  - `itens.categorias.nome` (string)
    Nome da categoria
    Example: Adiantamento Salarial

  - `itens.centros_custo` (array)
    Lista de centros de custo associados à parcela (id e nome)

  - `itens.centros_custo.id` (string)
    Identificador único do centro de custo
    Example: 428389c6-4e74-11ee-a3eb-9b5f0f22a7c1

  - `itens.centros_custo.nome` (string)
    Nome do centro de custo
    Example: Centro de custo de Teste

  - `itens.fornecedor` (object)

  - `itens.fornecedor.id` (string)
    Example: 35473eec-4e74-11ee-b500-9f61de8a8b8b

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

  - `totais` (object)

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

  - `totais.inativo` (integer)
    Example: 0

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

## Response 400:

  - `400` (unknown)
    Bad Request

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 429:

  - `429` (unknown)
    Too Many Requests

## Response 500:

  - `500` (unknown)
    Internal Server Error