Erros - Patrimonion

Formato de Erro

Todos os erros seguem o mesmo formato JSON:

{
  "error": "Descrição legível do problema."
}

Sem envelope, sem array, sem campo code separado — só error com a mensagem. Isso mantém o tratamento simples no frontend.

Status Codes

Status	Significado	Quando ocorre
`200`	OK	Leitura ou atualização bem-sucedida
`201`	Created	Recurso criado com sucesso
`400`	Bad Request	Campos obrigatórios faltando ou valor inválido
`401`	Unauthorized	Token ausente ou expirado
`403`	Forbidden	Token válido, mas o recurso pertence a outro usuário
`404`	Not Found	Recurso não existe no banco
`409`	Conflict	Violação de unicidade (ex: CPF duplicado, contrato ativo)
`500`	Internal Error	Erro inesperado no servidor — verifique os logs

Exemplos Reais

{
  "error": "contratoId, descricao, valor, dataVencimento e tipo são obrigatórios."
}

{
  "error": "Tipo inválido. Use: ALUGUEL, CAUCAO, REPARO"
}

{
  "error": "Acesso negado a este contrato."
}

{
  "error": "Contrato não encontrado."
}

{
  "error": "Já existe um locatário cadastrado com esse CPF."
}

{
  "error": "Não é possível excluir um locatário com contrato ativo."
}

Tratamento no Frontend

const res = await fetch("https://api.patrimonion.com.br/financeiro", {
  method: "POST",
  credentials: "include", // envia o cookie imob_session automaticamente
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify(payload),
});

if (!res.ok) {
  const { error } = await res.json();
  // error é sempre uma string legível
  toast.error(error);
  return;
}

const data = await res.json();