9. Consulta Gastos

Endpoint

POST https://cashtrack.com.br/api/cliente/show/gastos?page=1

Headers

Accept: application/json
Content-Type: application/json
Authorization: Bearer {{SEU_TOKEN}}

Corpo da Requisição (Request Body)

json

{
  "id": "",
  "data_inicial": "",
  "data_final": "",
  "empresa": "",
  "fornecedor": "",
  "valor": "",
  "situacao": "",
  "forma_pagamento": "",
  "banco":""
}

• id (opcional): ID do gasto.

• data_inicial e data_final: filtros para a data de lançamento da despesa (formato dd/mm/aaaa) valor da coluna "datalançamento" da tabela "gastos".

• empresa: filtro pelo apelido da empresa (modo like) ou filtro pelo ID da empresa quando o campo conter apenas números.

• fornecedor: filtro pelo apelido do fornecedor (modo like) ou filtro pelo ID do fornecedor quando o campo conter apenas números.

• valor: filtra por valor (na base 100) filtro da coluna "valor" da tabela "gastos".

• situacao: Indica a situação do gasto podendo ser filtrado pelo ID (1,2,3 ou 4) ou pelas situações, sendo elas:

  • pago

  • recebido

  • a_receber

  • a_pagar

• forma_pagamento: Indica a forma de pagamento podendo ser filtrado pelo ID (1,2,3,4,5,6 ou 7) ou pelas formas de pagamento, sendo elas:

  • pix

  • boleto

  • cartao

  • dinheiro

  • transferencia

  • cheque

  • debito_automatico

banco : filtro pelo ID do banco quando o campo conter apenas números ou filtro em modo like pelo nome/apelido do banco, caso apelido seja null o filtro será aplicado pelo nome do banco.

Exemplo de Resposta

json

{
  "current_page": 1,
  "data": [

     {
            "id": 85934,
            "empresa_id": 949,
            "data_lancamento": "23/01/2025",
            "situacao": 1,
            "valor": "138.22",
            "forma_pagamento": 2,
            "fornecedor_id": 6463,
            "related_id": null,
            "categoria_id": 84222,
            "banco_id": 1488,
            "parcelamento": 3,
            "numero_parcelas": null,
            "detalhes": null,
            "centro_id": 98,
            "numero_parcelas_recorrencia": 2,
            "tipo_gasto": 1
        },

    // ...demais registros
  ],
  "first_page_url": "https://cashtrack.com.br/api/cliente/show/gastos?page=1",
  "from": 1,
  "last_page": 1,
  "last_page_url": "https://cashtrack.com.br/api/cliente/show/gastos?page=1",
  "links": [...],
  "next_page_url": null,
  "path": "https://cashtrack.com.br/api/cliente/show/gastos",
  "per_page": 25,
  "prev_page_url": null,
  "to": 15,
  "total": 15
}