v1

latestOpenAPI 3.0.02026-07-264636241.7 MB

Cessão

Realiza cessão de direitos de uma reserva

🔒 Autenticação necessária

Esta API utiliza autenticação via e-mail e token nos headers da requisição. Consulte o tutorial completo antes de fazer sua primeira chamada: Como autenticar nas APIs do CV CRM (v1 — E-mail e Token)

Cessão é o processo de troca do cliente associado a unidade, como uma transferência de imóvel. Esta API fará requisições ao sistema legado para que lhe seja fornecido os dados da proposta que se deseja executar cessão no Construtor de Vendas, logo após irá verificar se os dados inseridos nos campos reserva, documento_novo_titular e documento_novo_associado existem ou não no Construtor de Vendas, somente se todos esses campos existirem será executada a troca do cliente.

Obs: Para que essas informações sejam inseridas no Construtor de Vendas, a reserva deve estar em situação com flag 'vendida'. Todos os documentos devem ser válidos.

post/v1/comercial/reservas/cessao

Headers

emailstring required

Example:email@email.com

tokenstring required

Example:79d965e5027b7423423f2471824e799949c75f9ce

Request body

reservastring string required

Identificador da reserva no Construtor de Vendas.

documento_novo_titularstring string required

Documento do novo titular da reserva.

documento_novo_associadostring string

Documento do associado ao novo titular.

motivostring string required

Motivo da transferência da unidade.

Example request

{
  "reserva": "1577",
  "documento_novo_titular": "89685705909",
  "documento_novo_associado": "59933096010",
  "motivo": "Doação"
}

Response

Cessão realizada com sucesso.

codigostring

mensagemstring

Example response

{
  "codigo": "200",
  "mensagem": "Operação realizada com sucesso."
}