Referências das Apis

Cadastrar unidade no empreendimento

post
https://{dominiodocliente}.cvcrm.com.br/api/v3/cadastros/empreendimentos//unidades
🔒

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)

Cadastra uma unidade e dispara os mesmos efeitos do cadastro pelo painel: histórico do
empreendimento, histórico da unidade, recálculo da situação, webhooks e evento de automação.

Regras aplicadas:

  • idbloco precisa ser de um bloco ativo do empreendimento da rota
  • idtipologia, idposicao, idtipo, idenquadramentoRenda e idempresaterceirizacao,
    quando informados, precisam existir e estar ativos — caso contrário a resposta é 404
  • nome não pode se repetir dentro do mesmo bloco
  • coluna aceita no máximo 60
  • datas são enviadas no formato YYYY-MM-DD
  • areaTotal é sempre calculada (privativa + garagem + comum + outra privativa) e
    ignora o que for enviado no corpo
  • financeiroAtivo só é aceito de quem tem a permissão de perfil
    empreendimentos|desativar_financeiro_por_unidade — sem ela a resposta é 403
  • o usuário responsável é o dono do token, não um campo do corpo

O cadastro e seus efeitos (histórico, situação, webhook, evento) rodam em uma única
transação: falha em qualquer etapa desfaz o INSERT.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required

ID do empreendimento

Body Params

Corpo do POST: os mesmos campos do PATCH, com quatro obrigatórios e mais
bloqueadoIntegracao, que só faz sentido no cadastro.

integer
required

Bloco ativo do empreendimento informado na rota

string
required
length ≤ 100

Único dentro do bloco. A coluna aceita 100 caracteres e a API também; o formulário do
gestor limita a digitação a 45, então nome acima disso só nasce pela API ou por
importação e o painel o exibe sem permitir reeditar o excedente.

float
required
boolean
required
string
length ≤ 45
integer
string
length ≤ 36
string
length ≤ 20
string
length ≤ 9
integer
string
integer
0 to 60
integer
integer
integer
string
length ≤ 12
string
length ≤ 12
string
length ≤ 25
integer
string
length ≤ 100
integer
≥ 0
integer
≥ 0
integer
≥ 0
integer
≥ 0
string
length ≤ 100
string
length ≤ 100
float
float
float
float
float
float
string
float
float
float
string
integer
integer
string
length ≤ 12
string
length ≤ 12
date
date
date
date
date
boolean
Defaults to false
float
string
length ≤ 255
float
string
length ≤ 255
float
float
float
float
integer
string
length ≤ 15
boolean
Defaults to false
boolean
float
boolean
Defaults to true

Exige a permissão de perfil empreendimentos|desativar_financeiro_por_unidade — a
mesma que o formulário do gestor usa para mostrar o campo. Enviar o campo sem ela
devolve 403; omiti-lo não exige permissão nenhuma.

float
float
string

Imagem da unidade em base64 puro (sem o prefixo data:image/...;base64,).
Extensões aceitas: jpg, jpeg, gif, png, bmp. A imagem é redimensionada no upload e
os metadados gravados aparecem no campo imagem da consulta.
Base64 recusado (extensão ou tamanho) devolve 400.

boolean
Defaults to false
Responses

Updated about 3 hours ago

Did this page help you?
Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 3 hours ago

Did this page help you?