Atualize uma transação financeira existente
Atualiza campos de uma transação financeira (receita ou despesa) existente no sistema.
Campos alteráveis (7 confirmados):
entry_type- Tipo da transação (income/expense)categories_id- Categoria financeiraamount- Valor da transaçãodate_due- Data de vencimentodate_payment- Data de pagamento (marcar como paga/em aberto)description- Descriçãocompetence- Competência (MM/YYYY)
Validações importantes:
- Para alterar
categories_id, é OBRIGATÓRIO enviarentry_typejunto (validação de tipo ativa) - Validação de tipo continua:
entry_type="income"aceita APENAS categoriastype="CRÉDITO" - Validação de tipo continua:
entry_type="expense"aceita APENAS categoriastype="DÉBITO" - Pode alterar múltiplos campos simultaneamente
- Para marcar como paga: envie
"date_payment": "2026-02-10" - Para marcar como em aberto: envie
"date_payment": null
Resposta:
- Sempre retorna
{"success":true,"lawsuits_id":"ID"}(nãotransactions_id)
Rate Limit: 500 requisições por dia
Authorization
BearerAuth In: header
Path Parameters
ID da transação a ser atualizada
Request Body
application/json
[Optional] Tipo da transação: income (receita) ou expense (despesa). ⚠️ OBRIGATÓRIO ao alterar categories_id (validação de tipo)
"income" | "expense"[Optional] ID da categoria financeira. ⚠️ Deve enviar entry_type junto (validação de tipo). Obtido via GET /api/v1/settings → financial.categories[]
[Optional] Valor da transação em reais (ex: 500.00 ou "1.234,90"). Aceita number ou string
[Optional] Data de vencimento no formato YYYY-MM-DD
date[Optional] Data de pagamento no formato YYYY-MM-DD. Use null para marcar como em aberto, ou uma data para marcar como paga
[Optional] Descrição da transação. Será convertida automaticamente para MAIÚSCULAS
[Optional] Competência no formato MM/YYYY (ex: 05/2026)
^(0[1-9]|1[0-2])/\d{4}$Response Body
application/json
application/json
application/json
application/json
curl -X PUT "https://app.advbox.com.br/api/v1/transactions" \ -H "Content-Type: application/json" \ -d '{ "amount": 2500 }'{
"success": true,
"lawsuits_id": "98765432"
}{
"error": "Unauthenticated."
}{
"error": "Transaction not found."
}{
"message": "The given data was invalid.",
"errors": {
"entry_type": [
"Select the transaction type: credit or debit"
]
}
}