---
title: "Cadastra bloco."
method: POST
path: "/v1/cadastros/empreendimentos/blocos"
tags: ["Bloco"]
---

# Cadastra bloco.

`POST /v1/cadastros/empreendimentos/blocos`

## Request

- Base URL: `https://integracao.cvcrm.com.br/api`
- URL: `https://integracao.cvcrm.com.br/api/v1/cadastros/empreendimentos/blocos`
- 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)

Bloco é um conjunto de unidades de um empreendimento. Quando essa interface for consumida um novo bloco será cadastrado no CV, logo após irá verificar se o dado inserido no campo idbloco_int existe ou não no CVs, 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

- CadastroBloco: JSON para cadastro de bloco.
  - `idbloco_int` string, required: Identificador do bloco no sistema legado (código interno).
  - `idetapa_int` string, required: Identificador da etapa do bloco no sistema legado (código interno).
  - `idempreendimento_int` string, required: Identificador do empreendimento do bloco no sistema legado (código interno).
  - `nome` string, required: Nome do bloco.
  - `ativo_painel` string: Informa se está ativo no painel. (Ativo|Inativo)
  - `data_cad` string, required: Data de cadastro do bloco.
  - `remover` string: Identificador do bloco que deseja remover. Informar o código interno do bloco nesse campo.

## Response `200`

Mensagem de sucesso ao cadastrar bloco.

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

## Other responses

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

---

[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)