Reservas

Aprovar reserva (com comparação de tabela)

Aprova a condição de pagamento da reserva, validando os limites de alçada do usuário (juros, VPL, prosoluto, ato e percentuais pré/pós-obra). Em caso de violação de regra, retorna falha com o código de mensagem correspondente em message (somente gestor).

Quando a reserva não possui tabela de preço, o fluxo padrão retorna 400 com message: erro_tabela_nao_existe ("A tabela escolhida não existe."). Para aprovar mesmo assim, envie aprovarSemComparar: true: nesse caso a comparação com a tabela é ignorada e a reserva é aprovada sem comparar (equivalente ao fluxo legado aprovarReservaSemComparar), preservando apenas os gates de permissão de aprovação.

post/v4/comercial/reservas/{idReserva}/aprovacao

Request

  • Base URL
    https://integracao.cvcrm.com.br/api
  • URL
    https://integracao.cvcrm.com.br/api/v4/comercial/reservas/{idReserva}/aprovacao
  • Auth
    HTTP bearer

Path parameters

idReservainteger required

Request body

jurosnumber float

Quando omitido, usa o valor de juros_cadastro da reserva.

jurosAposEntreganumber float

Quando omitido ou 0, usa juros_apos_entrega_cadastro da reserva (ou o próprio juros resolvido).

idTabelainteger

Quando omitido, usa o idtabela da reserva.

idTabelaMinimainteger

Quando omitido, busca idtabelaMinima da TabelaDePreco resolvida.

comentariostring nullable
comentarioExibirImobiliariaboolean
comentarioExibirCorretorboolean
aprovarSemCompararboolean

Quando true, aprova a reserva sem comparar com a tabela de preço, ignorando o erro erro_tabela_nao_existe. Mantém os gates de permissão de aprovação e pula as validações de alçada/comparação de tabela.

Example request

{
  "juros": 0.5,
  "jurosAposEntrega": 0.7,
  "idTabela": 123,
  "idTabelaMinima": 456
}

Response

Reserva aprovada

statusstring
codeinteger

Example response

{
  "status": "sucesso",
  "code": 200,
  "data": {
    "idReserva": 100
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.