Atualizar despesa

POST /update_expense

Resumo

Rota para atualizar despesas com tratamento de arquivo principal.

Descrição

Permite atualização parcial ou completa dos dados de uma despesa.

---

Requisição

Headers

• Content-Type: multipart/form-data

Body da Requisição

O JSON deve ser enviado dentro do campo metadata.

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	-
id_token_expense	string	Token da despesa.	aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee	-
due_date	string	Data de vencimento em YYYY-MM-DD.	2025-03-20	-
date	string	Alias de due_date.	2025-03-20	-
pay_day	string	Data de pagamento em YYYY-MM-DD.	2025-03-15	-
competence_date	string	Data de competência em YYYY-MM-DD.	2025-03-01	due_date ou date ao alterar datas
competence	string	Alias de competence_date.	2025-03-01	-
category_id_token	string	Categoria de despesa.	aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee	-
prev_value	number	Valor base.	30.5	-
description	string	Descrição.	Descrição da despesa	-
barcode	string	Código de barras.	00000000000000000000000000000000000000000000	-
access_key	string	Chave de acesso.	00000000000000000000000000000000000000000000	-
id_token_action	number	Status da despesa.	1	-
id_token_bank_account	string	Conta bancária.	aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee	-
id_token_project	string	Projeto.	aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee	-
id_token_contact	string	Contato.	aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee	-
id_token_unit	string	Unidade.	aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee	-
id_token_bank_account_out	string	Conta bancária de saída.	aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee	-
discounts	number	Descontos.	10	-
interest	number	Juros.	4	-
installment	string	Parcela.	002/010	-
data_bank	string	Dados bancários complementares.	Banco XPTO	-

Anexos

• file: arquivo principal, apenas 1 PDF ou imagem

---

Exemplo de requisição

curl -s -X POST 'https://portal.fipli.pro/api/v1/update_expense' \
  -F 'metadata={
    "access_token":"<access_token>",
    "unit_token":"<unit_token>",
    "id_token_expense":"<id_token_expense>",
    "date":"<date>",
    "pay_day":"<pay_day>",
    "competence":"<competence>",
    "category_id_token":"<category_id_token>"
  };type=application/json' \
  -F 'file=@./documento.pdf'

Respostas

200 Sucesso

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

Observações

• date pode ser usado no lugar de due_date
• competence pode ser usado no lugar de competence_date
• Se competence_date não for informado ao atualizar datas, a API usa due_date ou date