Crie uma nova transação financeira

Cria uma transação financeira (receita ou despesa) no sistema.

Campos obrigatórios:

users_id - ID do usuário responsável (obtenha em GET /api/v1/settings → users[])
entry_type - Tipo da transação: income (receita) ou expense (despesa)
debit_account - ID da conta bancária (obtenha em GET /api/v1/settings → financial.banks[])
categories_id - ID da categoria financeira (obtenha em GET /api/v1/settings → financial.categories[])
cost_centers_id - ID do centro de custo (obtenha em GET /api/v1/settings → financial.cost_centers[])
amount - Valor da transação em reais
date_due - Data de vencimento (YYYY-MM-DD)

Validações importantes:

entry_type DEVE corresponder ao tipo da categoria:
- entry_type="income" aceita APENAS categorias com type="CRÉDITO"
- entry_type="expense" aceita APENAS categorias com type="DÉBITO"
Todos os IDs são validados se pertencem ao escritório autenticado
date_payment não pode ser futura (deve ser hoje ou passada)
Execute GET /api/v1/settings primeiro para obter os IDs válidos

Transformações automáticas:

Campo description é convertido para MAIÚSCULAS
IDs são resolvidos para nomes no GET (users_id→responsible, categories_id→category)

Rate Limit: 500 requisições por dia

Authorization

BearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

users_id*integer

[Required] ID do usuário responsável. Obtido via GET /api/v1/settings → users[]

entry_type*string

[Required] Tipo da transação: income (receita) ou expense (despesa). ⚠️ Deve corresponder ao tipo da categoria: income requer categorias tipo CRÉDITO, expense requer categorias tipo DÉBITO.

Value in"income" | "expense"

debit_account*integer

[Required] ID da conta de débito. Obtido via GET /api/v1/settings → financial.banks[]

categories_id*integer

[Required] ID da categoria. ⚠️ O tipo da categoria (CRÉDITO/DÉBITO) DEVE corresponder ao entry_type. Obtido via GET /api/v1/settings → financial.categories[]

cost_centers_id*integer

[Required] ID do centro de custo. Obtido via GET /api/v1/settings → financial.cost_centers[]

amount*|

[Required] Valor da transação em reais (ex: 1234.90 ou "1.234,90"). Aceita number ou string nos formatos brasileiro (vírgula) ou internacional (ponto)

date_due*string

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

Formatdate

customers_id?integer

[Optional] ID do cliente. Quando fornecido, popula os campos name e identification no GET

lawsuits_id?integer

[Optional] ID do processo. Popula o campo lawsuit_id no GET

sectors_id?integer

[Optional] ID do setor

description?string

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

date_payment?string

[Optional] Data de pagamento no formato YYYY-MM-DD. ⚠️ Não pode ser futura (deve ser hoje ou passada)

Formatdate

competence?string

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

Match^(0[1-9]|1[0-2])/\d{4}$

Response Body

`application/json`

curl -X POST "https://app.advbox.com.br/api/v1/transactions" \  -H "Content-Type: application/json" \  -d '{    "users_id": 12345,    "entry_type": "income",    "debit_account": 1001,    "categories_id": 100,    "cost_centers_id": 500,    "amount": 1500,    "date_due": "2026-03-15"  }'

{
  "success": true,
  "transactions_id": 12948208
}

{
  "error": "Unauthenticated."
}

{
  "errors": {
    "entry_type": [
      "validation.required"
    ]
  }
}

Crie uma nova transação financeira

Authorization

Request Body

Response Body

200application/json

401application/json

422application/json

Campo entry_type obrigatório não fornecido

Categoria incompatível com entry_type

Data de pagamento não pode ser futura

Campos obrigatórios faltando

`application/json`

`application/json`

`application/json`