Agora existe um endpoint de API dedicado para trocar o titular de uma reserva, reaproveitando exatamente as mesmas regras de negócio já validadas na tela do sistema.

https://{dominiodocliente}.cvcrm.com.br/api/v3/comercial/reservas/{idReserva}/titularidade

Agora é possível:

• Alterar o titular de uma reserva diretamente via API;
• Integrar essa ação a ERPs, portais do cliente e apps parceiros sem simular a interface.

Por que isso é importante?

Até então, a troca de titularidade só era possível pela tela, e integrações externas não tinham como executá-la de forma automatizada. A nova API elimina essa limitação, mantendo total consistência com o comportamento da interface.

Como funciona?

A troca só é permitida para uma pessoa que já seja associada da própria reserva. A operação respeita as permissões existentes, as regras de bloqueio de pessoa e a configuração de visibilidade por situação da reserva. Todo o processo é atômico: ou tudo é concluído, ou nada é alterado.

ATENÇÃO

O idassociado informado deve ser um associado ativo da própria reserva, obtido previamente em
GET /v3/comercial/reservas/{idReserva}/associados. A API não aceita promover uma pessoa nova ou
externa à reserva — apenas associados já existentes.

A troca é cruzada: o titular atual passa a ocupar a posição de associado que era do associado promovido,
preservando o vínculo de cônjuge quando existente.

A operação é bloqueada se a pessoa do novo titular estiver com bloqueio de reserva ativo e não houver
exceção para o corretor da reserva.

Pré-requisitos

• Possuir permissão de alteração de titularidade;
• O novo titular deve já ser um associado ativo da reserva.