🔒

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)

Alteração parcial: campo ausente no corpo permanece como está. Dispara os mesmos efeitos da
alteração pelo painel — uma linha de histórico por campo alterado, recálculo da situação,
carimbo nas tabelas de preço do empreendimento, webhooks e evento de automação.

Regras aplicadas:

• a unidade precisa pertencer ao empreendimento da rota
• idbloco novo precisa ser de um bloco ativo do mesmo empreendimento
• idtipologia, idposicao, idtipo, idenquadramentoRenda e idempresaterceirizacao,
  quando informados, precisam existir e estar ativos — caso contrário a resposta é 404
• nome não pode colidir com outra unidade do bloco
• coluna aceita no máximo 60
• datas são enviadas no formato YYYY-MM-DD
• areaTotal é sempre recalculada e ignora o que for enviado
• unidade com bloqueio de integração só é alterada por quem tem a permissão
  empreendimentos|118, ou mantendo bloqueadosInternos ligado
• financeiroAtivo só é aceito de quem tem a permissão de perfil
  empreendimentos|desativar_financeiro_por_unidade — sem ela a resposta é 403
• adimplenciaPremiada alterada repropaga as séries da reserva viva da unidade

Pontos de comportamento que valem conhecer:

• campo não se limpa pelo PATCH: null e "" são normalizados para null e o update
  ignora nulos. Para zerar um número, envie 0; para esvaziar um texto, não há caminho
  pela API — é o mesmo comportamento do formulário do gestor.
• reenviar os mesmos valores devolve 200 sem efeitos: sem linha alterada no banco
  não há histórico, webhook nem evento. A resposta é sucesso porque o estado pedido é o
  estado final; só não houve o que registrar.
• a alteração e seus efeitos rodam em uma única transação: falha em qualquer etapa desfaz
  o update.