🔒

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)

API responsável pelos interesses de um lead: empreendimentos, unidades, produtos e
motivo de escolha do empreendimento.

Changelog vs v1: a definição de interesses hoje é feita dentro do endpoint
"God Endpoint" POST /api/v1/comercial/leads (que resolve cadastro, interesses e
diversos outros side-effects numa única chamada). A v4 isola a leitura e a
atualização de interesses num sub-recurso dedicado do lead
(/leads/{idLead}/interesses), com validação explícita de que empreendimentos e
unidades estão ativos e visíveis para o painel do usuário autenticado.

Adiciona empreendimento(s), unidade(s) e/ou produto(s) de interesse ao lead, e
opcionalmente atualiza o motivo de escolha. Sempre aditivo: nunca remove
interesses já associados — para substituir o conjunto, use PATCH. Todos os
campos são opcionais, mas ao menos um precisa ser enviado.

• idEmpreendimento: associa apenas os empreendimentos ativos e visíveis ao
  painel autenticado; os demais são reportados em naoAssociados.
• idUnidade: associa apenas unidades ativas e visíveis ao painel (unidade,
  bloco e etapa precisam estar todos ativos/visíveis); o empreendimento da
  unidade também é associado automaticamente como interesse.
• idProduto/produto: duas formas independentes de referenciar produtos —
  envie apenas a que fizer sentido para o seu caso (não é necessário enviar
  as duas). idProduto aceita IDs de produtos já existentes e ativos;
  produto aceita nomes e cria o produto automaticamente quando o nome
  ainda não existe. Se as duas forem enviadas na mesma requisição, devem se
  referir a produtos diferentes — cada uma é resolvida de forma
  independente. Produtos vinculados a empreendimentos também associam
  esses empreendimentos automaticamente.
• idMotivoEscolha: precisa existir e estar ativo, senão é reportado em
  naoAssociados sem bloquear os demais campos do mesmo request.

Se nenhum item do payload puder ser associado/atualizado, a resposta é 422.
Se ao menos um item for processado com sucesso, a resposta é 201 e os itens
rejeitados aparecem em data.naoAssociados (chave presente apenas quando há
rejeição parcial).