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

# Cadastra unidade.

`POST /v1/cadastros/empreendimentos/unidades`

> 🔒 **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.net/cvcrm/apis/clientes.md) · [All operations](https://skmtc.net/cvcrm/apis/clientes/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cvcrm/clientes/revisions/42bf5add8bf3/schema)