Atualização da Despesa

Edite os dados de uma despesa enquanto ela ainda estiver no status created. Após a submissão ou após a criação com documentos (status pending_adm_approval), a despesa não pode mais ser alterada.

informação

Somente despesas com status created podem ser atualizadas.

Request

ENDPOINT

/expense_submission/fund_class/{fund_class_key}/contract/{contract_key}/expense/{expense_key}

MÉTODO

PUT

Path params

Parâmetro	Tipo	Descrição
fund_class_key	string	Chave única do fundo (UUID)
contract_key	string	Chave única do contrato
expense_key	string	Chave única da despesa (UUID)

Request Body

{
    "payment_method": "transfer",
    "start_deferral_date": "2026-06-02",
    "end_deferral_date": "2026-06-30",
    "description": "Honorários de auditoria - 1º semestre 2026 (corrigido)",
    "payment_value": 16000.00,
    "payment_date": "2026-07-01",
    "payment": {
        "target": {
            "name": "AUDITORES EXEMPLO S.A.",
            "document_number": "12.345.678/0001-90"
        },
        "target_account": {
            "account_number": "123456",
            "account_branch": "0001",
            "account_digit": "0",
            "financial_institution_code": "341"
        },
        "transfer_type": "wire_transfer",
        "source_account": {
            "account_key": "5e621ba2-b4ac-4ddd-9893-82d220e1577e"
        }
    }
}

Atributos do body

Campo	Tipo	Obrigatoriedade	Descrição
payment_method	string	opcional	Método de pagamento: transfer, automatic_debit ou bank_slip.
start_deferral_date	string	opcional	Data início da competência no formato YYYY-MM-DD. Deve ser dia útil.
end_deferral_date	string	opcional	Data fim da competência no formato YYYY-MM-DD. Deve ser dia útil.
description	string	opcional	Nova descrição da despesa. Máximo de 200 caracteres.
payment_value	number	opcional	Novo valor da despesa. Mínimo: 0.
payment_date	string	opcional	Nova data de pagamento no formato YYYY-MM-DD. Deve ser dia útil.
payment	object	opcional	Novos dados do pagamento. Mesma estrutura da criação da despesa.

Response

STATUS

200

A resposta segue a mesma estrutura da criação da despesa, com os campos atualizados.

Possíveis erros

STATUS

404

Despesa não encontrada

O conjunto fund_class_key + contract_key + expense_key não corresponde a nenhuma despesa cadastrada.

{
  "title": "Expense Not Found",
  "description": "Expense with key {expense_key} was not found.",
  "translation": "A despesa com chave {expense_key} não foi encontrada.",
  "code": "ESB000016"
}

STATUS

400

Despesa não pode ser editada neste status

A despesa não está no status created e não pode ser editada.

{
  "title": "Cannot Update Expense In This Status",
  "description": "Expense {expense_key} cannot be updated with status {current_status}.",
  "translation": "A despesa {expense_key} não pode ser atualizada com o status {current_status}.",
  "code": "ESB000023"
}

Próximos passos

1. Submeter a despesa — encaminhe para análise quando estiver pronto.
2. Cancelar a despesa — cancele caso não seja mais necessária.