Atualizar receita

POST /update_income

Resumo

Rota para atualizar receitas no sistema.

Descrição

Esta rota é responsável por atualizar registros de receitas existentes no sistema. Ela permite a modificação parcial ou completa dos dados de uma receita, incluindo valores, datas, categorias e informações relacionadas.

---

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 do usuário (obrigatório)	aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee	-
unit_token	string	Token de identificação da unidade (obrigatório)	aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee	-
id_income	string	ID da receita (obrigatório)	aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee	-
category_id	string	ID da categoria de despesa (obrigatório)	aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee	-
prev_value	number	Valor base da receita (obrigatório)	30.5	-
due_date	string	Data de vencimento (AAAA-MM-DD) (obrigatório)	2025-03-20	-
description	string	Descrição da receita (Máximo 255 caracteres) (opcional)	Descrição da receita	-
pay_day	string	Data de pagamento (AAAA-MM-DD) (opcional)	2025-03-15	-
id_action	number	ID do tipo de ação, pode ser achado aqui: Status (Entre 1 e 8) (opcional)	1	1
id_bank_account	string	ID da conta bancária (opcional)	aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee	-
id_bank_account_out	string	ID da conta bancária de saída (opcional)	aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee	-
discounts	number	Valor de descontos (opcional)	10	-
interest	number	Valor de juros (opcional)	4	-
data_bank	string	Dados bancários (opcional)	3	-

---

Respostas

Abaixo estão algumas respostas que podem ser retornadas dependendo dos parâmetros:

200 Sucesso

{
  "success": true,
  "message": "Income updated successfuly",
  "data": null
}

400 Requisição Inválida

{
  "success": false,
  "message": "Missing parameters",
  "data": null
}

403 Acesso Negado

{
  "success": false,
  "message": "Invalid data",
  "data": null
}

500 Erro no Servidor

{
  "success": false,
  "error": "Internal server error",
  "data": null
}

Exemplo de Requisição

curl -s -X POST 'https://portal.fipli.pro/api/v1/update_income' \
    -d '{
            "access_token": "<access_token>",
            "unit_token": "<unit_token>",
            "id_income": "<id_income>",
            "description": "<description>",
            "due_date": "<due_date>",
            "pay_day": "<pay_day>",
            "category_id": "<category_id>",
            "id_action": <id_action>,
            "id_bank_account": "<id_bank_account>",
            "id_bank_account_out": "<id_bank_account_out>",
            "id_contact": "<id_contact>",
            "id_project": "<id_project>",
            "prev_value": <prev_value>,
            "discounts": <discounts>,
            "interest": <interest>,
            "data_bank": "<data_bank>"
        }' \
    -H 'Content-Type: application/json' \
    | jq

Observações Importantes

• Validação de intervalo máximo de 1 ano para datas

• Apenas categorias de receitas podem ser atreladas a receita