Resolvedor de Exercícios

Este endpoint utiliza IA para interpretar e propor uma solução para exercícios de contabilidade. Ele analisa o texto do problema e sugere os lançamentos contábeis necessários em formato de partidas dobradas.

---

Resolver um Exercício

Envia o texto de um exercício contábil para ser resolvido.

POST/api/exercise-solver

Corpo da Requisição

{
  "exercise": "A empresa XYZ comprou R$ 5.000,00 em mercadorias para revenda, pagando 50% à vista via transferência bancária e o restante a prazo."
}

Atributo	Tipo	Descrição
exercise	string	Obrigatório. O texto completo do exercício a ser resolvido.

Resposta

200 OK com a solução proposta pela IA. A solução inclui uma explicação e uma estrutura de lançamentos que pode ser usada para confirmação.

{
  "solution": {
    "explanation": "Para registrar esta transação, precisamos reconhecer o aumento no estoque, a saída de dinheiro do banco e a criação de uma obrigação com o fornecedor.",
    "proposedEntries": [
      {
        "date": "2025-07-24", // A data atual é usada como padrão
        "description": "Compra de mercadorias para revenda",
        "debits": [
          { "account": "Estoque de Mercadorias", "value": 5000.00 }
        ],
        "credits": [
          { "account": "Bancos Conta Movimento", "value": 2500.00 },
          { "account": "Fornecedores", "value": 2500.00 }
        ]
      }
    ]
  }
}

Códigos de Status HTTP

• 200 OK: Exercício resolvido e solução proposta com sucesso.
• 400 Bad Request: Dados da requisição inválidos.
• 401 Unauthorized: Autenticação necessária ou credenciais inválidas.
• 500 Internal Server Error: Erro interno do servidor ao resolver o exercício.