Criar Transação

Cria uma nova transação financeira. Suporta dois modos no mesmo endpoint: estruturado (padrão) e IA (ai: true + text). Áudio e imagem continuam em rotas multipart dedicadas (/voice, /image).

Modo estruturado

Envie todos os campos. O saldo da carteira é atualizado automaticamente.

{
  "type": "expense",
  "amount": 89.90,
  "description": "Conta de luz",
  "date": "2026-02-15",
  "categoryId": "uuid-da-categoria",
  "walletId": "uuid-da-carteira"
}

curl --request POST \
  --url https://api.usematias.com/v1/financial-records \
  --header 'accept: application/json' \
  --header 'x-api-key: SUA_API_KEY' \
  --header 'content-type: application/json' \
  --data '{ "type": "expense", "amount": 89.90, "description": "Conta de luz", "date": "2026-02-15", "categoryId": "uuid-da-categoria", "walletId": "uuid-da-carteira"}'

Modo IA

Envie ai: true com text em linguagem natural. A IA infere type, amount, description, date, categoria e detecta recorrência. Se omitido, a carteira padrão é usada. Campos estruturados passados em conjunto sobrescrevem a saída da IA. Consome cota mensal de parsing por IA do plano.

{
  "ai": true,
  "text": "Gastei 150 reais no mercado ontem"
}

curl --request POST \
  --url https://api.usematias.com/v1/financial-records \
  --header 'accept: application/json' \
  --header 'x-api-key: SUA_API_KEY' \
  --header 'content-type: application/json' \
  --data '{ "ai": true, "text": "Gastei 150 reais no mercado ontem"}'

Erros possíveis

• 400 Dados inválidos ou IA não conseguiu interpretar o texto.
• 403 Limite mensal de transações atingido, ou parsing por IA indisponível no plano, ou cota mensal de IA esgotada.
• 404 Categoria ou carteira não encontrada (modo estruturado).