Listar despesas e receitas

POST /transactions

Compatibilidade: a rota raiz POST / continua funcionando com o mesmo comportamento.

Resumo

Esta rota retorna despesas e receitas com base nos parâmetros fornecidos pelo usuário.

Descrição

Utilize esta rota para obter uma lista de dados financeiros filtrados conforme os parâmetros passados na requisição.

---

Requisição

Headers

• Content-Type: application/json

Body da Requisição

Parâmetro	Tipo	Descrição	Exemplo	Padrão
access_token	string	Token de acesso da API.	aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee	-
unit_token	string	Token da unidade.	aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee	-
from_date	string	Data inicial do filtro no formato YYYY-MM-DD.	2024-07-01	Primeiro dia do mês atual
to_date	string	Data final do filtro no formato YYYY-MM-DD.	2024-10-01	Hoje
type	string	Filtro de tipo de transação: in para receitas ou out para despesas.	out	Retorna ambos
user_token	string	Filtra as movimentações inseridas por um coletor específico.	aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee	Retorna todas da unidade

Observação: o intervalo máximo permitido entre from_date e to_date é de 1 ano.

---

Requisição de exemplo

curl -s 'https://portal.fipli.pro/api/v1/transactions' \
  -d '{"access_token":"<access_token>","unit_token":"<unit_token>","from_date":"2024-07-01","to_date":"2024-10-01","type":"out"}' \
  -H 'Content-Type: application/json'

{
  "access_token": "<access_token>",
  "unit_token": "<unit_token>",
  "from_date": "2024-07-01",
  "to_date": "2024-10-01",
  "type": "out"
}

Respostas

200 OK

{
  "success": true,
  "data": [
    {
      "id": "<id>",
      "id_user": "<id_user>",
      "access_key": "<access_key>",
      "user_name": "<user_name>",
      "company_name": "<company_name>",
      "entity_name": "<entity_name>",
      "created_date": "<created_date>",
      "description": "<description>",
      "barcode": "<barcode>",
      "due_date": "<due_date>",
      "pay_day": "<pay_day>",
      "competence_date": "<competence_date>",
      "value": "<value>",
      "type": "<type>",
      "category": "<category>",
      "note": "<note>",
      "active": "<active>",
      "data_bank": "<data_bank>",
      "private": "<private>",
      "id_token_unit": "<id_token_unit>",
      "action_status": "<action_status>",
      "status": "<status>",
      "nick_name_bank": "<nick_name_bank>",
      "wallet": "<wallet>",
      "active_remittances": "<active_remittances>",
      "id_ofx": "<id_ofx>",
      "conciliation_date": "<conciliation_date>",
      "contact_name": "<contact_name>",
      "key_method_credor": "<key_method_credor>"
    }
  ]
}

4xx e 5xx

{
  "success": false,
  "error": "Missing parameters"
}