---
title: "Bloqueia ou disponibiliza unidade."
method: POST
path: "/v1/cadastros/empreendimentos/unidades/bloquear"
tags: ["bloquear_unidade"]
---

# Bloqueia ou disponibiliza unidade.

`POST /v1/cadastros/empreendimentos/unidades/bloquear`

> 🔒 **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 irá mudar a situação da unidade, seja para bloqueada temporariamente ou para disponivel.

**Obs: Para que essas informações sejam inseridas no CV, os identificadores da etapa, bloco e empreendimento precisam existir no sistema quando forem utilizados para localizar a unidade.**

## Headers

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

## Request body

- BloquearUnidade — Esquema de requisição para bloqueio ou disponibilização de unidade.
  - `idunidade_int` string, required — Obrigatório quando idunidade não for informado. Código interno da unidade.
  - `idunidade` string — Obrigatório quando idunidade_int não for informado. ID da unidade no CV.
  - `idempreendimento_int` string — Opcional. Código interno do empreendimento. Usado em conjunto com idetapa_int e idbloco_int para localizar a unidade.
  - `idbloco_int` string — Opcional. Código interno do bloco. Usado para localizar a unidade quando idunidade não for informado.
  - `idetapa_int` string — Opcional. Código interno da etapa. Usado para localizar a unidade quando idunidade não for informado.
  - `idbloco` string — Opcional. ID do bloco no CV. Usado para localizar a unidade quando idunidade não for informado.
  - `idetapa` string — Opcional. ID da etapa no CV. Usado para localizar a unidade quando idunidade não for informado.
  - `situacao` 'Bloqueada' | 'Disponivel', required — Obrigatório. Situação desejada da unidade.
  - `motivo_bloqueio` string, required — Motivo do bloqueio. Obrigatório quando situacao for Bloqueada.
  - `descricao_motivo_bloqueio` string, required — Opcional. Descrição complementar do motivo do bloqueio.
  - `documento_bloqueio` string, required — Obrigatório quando data_desbloqueio for informada. Documento relacionado ao bloqueio temporário.
  - `data_desbloqueio` string, required — Data em que a unidade ficará disponível automaticamente.
  - `hora_desbloqueio` string, required — Opcional. Hora em que a unidade ficará disponível automaticamente.

## Response `200`

Mensagem de sucesso ao bloquear ou disponibilizar unidade.

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

## Other responses

- `400` — Requisição de bloqueio de unidade incorreta!
- `422` — Erro ao tentar bloquear/disponibilizar 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)