---
title: "Cadastra unidade."
method: POST
path: "/v1/cadastros/empreendimentos/unidades"
tags: ["Unidade"]
---

# Cadastra unidade.

`POST /v1/cadastros/empreendimentos/unidades`

## Request

- Base URL: `https://integracao.cvcrm.com.br/api`
- URL: `https://integracao.cvcrm.com.br/api/v1/cadastros/empreendimentos/unidades`
- Auth: none declared. Required headers: `email`, `token`

> 🔒 **Autenticação necessária**
>
> Esta API utiliza autenticação via **e-mail e token** nos headers da requisição.
> Consulte o tutorial completo antes de fazer sua primeira chamada:
> [Como autenticar nas APIs do CV CRM (v1 — E-mail e Token)](https://desenvolvedor.cvcrm.com.br/docs/como-autenticar-apis-cvcrm-email-token)

Unidade é um imóvel do empreendimento. Quando essa interface for consumida uma nova unidade será cadastrada no Construtor de Vendas. A interface irá verificar se o dado inserido no campo idbloco_int existe ou não no CV, se já existir um bloco cadastrado com o mesmo idbloco_int essa API irá atualizar os dados solicitados na requisição, se não irá cadastrá-los.

**Obs: Para que essas informações sejam inseridas no CV, os identificadores da etapa e do empreendimento devem existir no sistema.**

## Headers

- `email` string, required
- `token` string, required

## Request body

- CadastroUnidade: JSON para cadastro de unidade.
  - `idunidade_int` string, required: Identificador da unidade no sistema legado (código interno).
  - `idbloco_int` string, required: Identificador do bloco da unidade no sistema legado (código interno).
  - `idetapa_int` string, required: Identificador da etapa da unidade no sistema legado (código interno).
  - `idempreendimento_int` string, required: Identificador do empreendimento da unidade no sistema legado (código interno).
  - `idtipologia_int` string: Identificador da tipologia no sistema legado (código interno).
  - `idtipo_int` string: Identificador da tipo no sistema legado (código interno).
  - `matricula` string: Matrícula de Unidade.
  - `cib` string: Cadastro Imobiliário Brasileiro (CIB) da unidade. Formato AAAAAAA-D (7 caracteres alfanuméricos, hífen e 1 dígito verificador).
  - `nome` string, required: Nome da unidade.
  - `descricao` string: Descrição da unidade.
  - `complemento` string: Complemento da unidade.
  - `vagas_garagem` string: Número de vagas da garagem.
  - `situacao` string, required: Situação da unidade (Disponivel ou Bloqueada).
  - `remover` string: Identificador da unidade que deseja remover.
  - `andar` string: Andar da unidade.
  - `coluna` integer: Coluna da unidade.
  - `valor` number: Valor da unidade.
  - `valor_avaliacao` number: Valor de avaliação da unidade.
  - `qtde_quartos` integer: Quantidade de quartos da unidade.
  - `qtde_banheiros` integer: Quantidade de banheiros da unidade.
  - `qtde_suites` integer: Quantidade de suítes da unidade.
  - `qtde_espacos_complementares` integer: Quantidade de espaços complementares da unidade.
  - `qtde_vagas_garagem` integer: Quantidade de vagas de garagem da unidade.
  - `jardim` string: Jardim da unidade.
  - `dimensoes` string: Dimensões da unidade.
  - `latitude` string: latitude da unidade.
  - `longitude` string: latitude da unidade.
  - `tipologia` string: tipologia da unidade. (Pode informar o id ou nome de uma tipologia existente)
  - `posicao` string: Posição da unidade. (Pode informar o id ou nome de uma posição existente)
  - `ref_ordenacao` string: Referência de ordenação da unidade.
  - `fase` integer: Fase da unidade.
  - `fator_apropriacao` number: Fator de apropriação da unidade.
  - `mapa_lote` string, binary: Enviar imagem do mapa do lote (multipart/form-data ou passar uma imagem em base64)
  - `fracao_ideal` string: Fração ideal da unidade.
  - `area_privativa` string, required: Área privativa da unidade em m².
  - `area_garagem` string: Área de garagem da unidade em m².
  - `area_comum` string: Área comum da unidade em m².
  - `area_outra_privativa` string: Outras áreas privativas em m².
  - `area_total` string: Área total da unidade em m² (deve ser equivalente à soma das áreas privativa, garagem, comum e outras áreas privativas).
  - `area_privativa_total` string: Área privativa total da unidade em m².
  - `area_terreno` string: Área de terreno da unidade em m².
  - `motivo_bloqueio` string: Motivo de bloqueio da unidade (caso seja bloqueada).
  - `nome_tipo` string: Tipo da unidade.
  - `data_entrega` string: Data de entrega da unidade (dd/mm/aaaa)
  - `data_entrega_chaves` string: Data de entrega das chaves da unidade (dd/mm/aaaa)
  - `agendar_a_partir` string: Data de agendamentos das vistorias da unidade (dd/mm/aaaa)
  - `liberar_a_partir` string: Data de liberação da unidade (dd/mm/aaaa)
  - `campos_adicionais` object
    - `adc_valor_adicional` string: Valor do campo adicional adc_valor_adicional (Nome referência) em unidade.

## Response `200`

Mensagem de sucesso ao cadastrar unidade.

- CadastroSucesso
  - `id` integer: Id criado
  - `sucesso` boolean

## Other responses

- `400`: Requisição de cadastro de unidade incorreta!
- `422`: Erro ao tentar cadastrar unidade.

---

[API](https://skmtc.dev/cvcrm/apis/clientes.md) - [All operations](https://skmtc.dev/cvcrm/apis/clientes/llms.txt) - [OpenAPI document](https://skmtc.dev/cvcrm/apis/clientes/revisions/42bf5add8bf3?raw)