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
• lawsuits_id REQUER customers_id junto — sem ele retorna erro 422
• date_payment não pode ser futura (deve ser hoje ou passada)
• amount deve ser maior que zero — amount: 0 causa erro 500 na API
• 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

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."
}

{
  "message": "The given data was invalid.",
  "errors": {
    "entry_type": [
      "Select the transaction type: credit or debit"
    ],
    "users_id": [
      "The responsible user is required"
    ],
    "date_due": [
      "The date due field is required"
    ],
    "categories_id": [
      "The category field is required"
    ],
    "amount": [
      "The amount field is required"
    ],
    "debit_account": [
      "The bank account field is required"
    ],
    "cost_centers_id": [
      "The cost center field is required"
    ]
  }
}

{
  "message": "Too Many Requests"
}