API ADVBOX
Transactions

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 financeira
  • amount - Valor da transação
  • date_due - Data de vencimento
  • date_payment - Data de pagamento (marcar como paga/em aberto)
  • description - Descrição
  • competence - Competência (MM/YYYY)

Validações importantes:

  • Para alterar categories_id, é OBRIGATÓRIO enviar entry_type junto (validação de tipo ativa)
  • Validação de tipo continua: entry_type="income" aceita APENAS categorias type="CRÉDITO"
  • Validação de tipo continua: entry_type="expense" aceita APENAS categorias type="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ão transactions_id)

Rate Limit: 500 requisições por dia

PUT
/transactions

Authorization

BearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

id*integer

ID da transação a ser atualizada

Request Body

application/json

entry_type?string

[Optional] Tipo da transação: income (receita) ou expense (despesa). ⚠️ OBRIGATÓRIO ao alterar categories_id (validação de tipo)

Value in"income" | "expense"
categories_id?integer

[Optional] ID da categoria financeira. ⚠️ Deve enviar entry_type junto (validação de tipo). Obtido via GET /api/v1/settingsfinancial.categories[]

amount?|

[Optional] Valor da transação em reais (ex: 500.00 ou "1.234,90"). Aceita number ou string

date_due?string

[Optional] Data de vencimento no formato YYYY-MM-DD

Formatdate
date_payment?|

[Optional] Data de pagamento no formato YYYY-MM-DD. Use null para marcar como em aberto, ou uma data para marcar como paga

description?string

[Optional] Descrição da transação. Será convertida automaticamente para MAIÚSCULAS

competence?string

[Optional] Competência no formato MM/YYYY (ex: 05/2026)

Match^(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"
    ]
  }
}