🔒

Autenticação necessária

Esta API utiliza Bearer Token no header Authorization.
Consulte o tutorial completo antes de fazer sua primeira chamada:
Como autenticar nas APIs do CV CRM (v3+ — Bearer Token)

Associa um responsável ao lead para o tipo informado. Na troca, o responsável anterior é registrado como perda,
com motivo atribuído automaticamente pelo backend (não é um campo do body).

Cada lead tem no máximo um responsável ativo por tipo simultaneamente
(gestor, corretor, imobiliaria); não há múltiplos responsáveis concorrentes do
mesmo tipo. Associar um novo responsável para um tipo que já tem um responsável ativo
substitui o anterior (troca), preservando o histórico da alteração.

Corretor sempre associa (e desassocia) junto com a imobiliária dele

Um corretor pertence a exatamente uma imobiliária (vínculo fixo do cadastro do
corretor). Ao associar tipoAtendente=corretor, a API busca automaticamente a
imobiliária do corretor e a associa também ao lead — não é necessário (nem possível)
informar idImobiliaria no body. Se o corretor não tiver imobiliária cadastrada, a
associação falha com 422 (corretor_sem_imobiliaria).

Simetricamente, ao desassociar tipoAtendente=imobiliaria, o corretor
associado ao lead (se houver) também é removido junto — ele não faz mais sentido
sem a imobiliária responsável.

Regras específicas do painel Imobiliária

• Nunca pode alterar tipoAtendente=gestor — nem associar (POST) nem
  remover (DELETE), independente de ter ou não corretores associados. Só pode
  atuar sobre corretor/imobiliaria.
• Um corretor só pode ser associado (POST tipoAtendente=corretor) se pertencer à
  própria imobiliária do usuário logado (corretores.idimobiliaria igual à
  imobiliária do usuário) — associar um corretor de outra imobiliária retorna 403
  (corretor_de_outra_imobiliaria).

Usuário Imobiliária com corretores associados

Quando o usuário autenticado possui corretores associados ativos ao seu cadastro
(usuarios_imobiliarias_corretores.ativo = 'S'), as regras de escrita são ainda
mais restritas:

• Não é permitido associar nenhum responsável (POST sempre retorna 403).
• Só é permitido remover corretor ou imobiliaria.
• Remover corretor ou imobiliaria sempre remove os dois juntos.

Um usuário Imobiliária sem corretores associados não tem essas restrições
adicionais: visualiza e altera normalmente todos os leads da própria imobiliária
(respeitando sempre a regra de gestor acima).