Validador de Lançamentos

Este endpoint utiliza IA para validar a lógica de um lançamento contábil descrito em texto. Ele analisa a descrição e sugere as contas de débito e crédito apropriadas, ajudando a prevenir erros.

---

Validar um Lançamento

Envia a descrição de um lançamento para ser validada pela IA.

POST/api/journal-entry-validator

Corpo da Requisição

{
  "journalEntryDescription": "Pagamento de salários do mês de julho."
}

Atributo	Tipo	Descrição
journalEntryDescription	string	Obrigatório. A descrição do lançamento que o usuário pretende fazer.

Resposta

200 OK com o resultado da validação, incluindo as contas sugeridas.

{
  "validationResult": {
    "isValid": true,
    "suggestedDebitAccount": "Despesas com Salários",
    "suggestedCreditAccount": "Salários a Pagar",
    "explanation": "Para registrar o pagamento de salários, você deve debitar a conta de despesa correspondente e creditar uma conta de passivo (Salários a Pagar) ou diretamente o Caixa/Banco se o pagamento for imediato."
  }
}

Códigos de Status HTTP

• 200 OK: Lançamento validado e sugestões retornadas 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 validar o lançamento.