---
title: "Cadastra empreendimento."
method: POST
path: "/v1/cadastros/empreendimentos"
tags: ["Empreendimento"]
---

# Cadastra empreendimento.

`POST /v1/cadastros/empreendimentos`

> 🔒 **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)

Empreendimento é um conjunto de unidades (imóveis) para venda ou aluguel. Esta integração coleta informações de requisições realizadas por sistemas legados e verifica se o dado inserido no campo 'nome' existe ou não no Construtor de Vendas. Se já existir um empreendimento cadastrado com o mesmo nome, essa API irá atualizar os dados solicitados na requisição, se não irá cadastrá-los.

**Obs: Somente será aceito um cadastro por nome. O campo estado deve ter a sigla em letras MAIÚSCULAS (Exemplo: São Paulo = SP).**

## Headers

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

## Request body

- CadastrarEmpreendimento — Dados no formato JSON do empreendimento a ser cadastrado.
  - `idempreendimento_int` string, required — Código interno do empreendimento.
  - `nome` string, required — Nome do empreendimento.
  - `disponivel` string — Informa a disponibilidade do empreendimento (Ativou ou Finalizado).
  - `matricula` string, required — Matrícula do empreendimento.
  - `referencia_externa` string — Referência de externa.
  - `regiao` string — Região do empreendimento.
  - `cidade` string, required — Cidade do empreendimento.
  - `estado` string, required — Estado do empreendimento.
  - `bairro` string — Bairro do empreendimento.
  - `endereco_emp` string — Endereço do empreendimento.
  - `numero` string — Número do empreendimento.
  - `logradouro` string — Logradouro do empreendimento. (id ou nome)
  - `cep` string — CEP do empreendimento.
  - `endereco` string — Endereço completo do empreendimento.
  - `data_entrega` string — Data de entrega do empreendimento. (AAAA/MM/DD)
  - `periodo_venda_inicio` string — Início do das Vendas do empreendimento.
  - `area_construida` string — Área construída do Empreendimento.
  - `area_privativa` string — Área privativa do Empreendimento.
  - `idempresa_int` string, required — Código interno da empresa.
  - `nome_empresa` string, required — Nome da empresa.
  - `razao_social_empresa` string, required — Razão Social da empresa.
  - `cnpj_empresa` string, required — CNPJ da empresa.
  - `endereco_empresa` string — Endereço da empresa.
  - `ativo_painel` string, required — Disponibilidade de relacionamento do Empreendimento com as funcionalidades do sistema.
  - `sigla` string, required — Sigla do empreendimento.
  - `campos_adicionais` object
    - `adc_valor_adicional` string — Valor do campo adicional adc_valor_adicional (Nome referência) em empreendimento.

## Response `200`

Empreendimento cadastrado com sucesso.

- CadastrarEmpreendimentoSucesso — Retorna mensagem de empreendimento cadastrado com sucesso.
  - `codigo` integer
  - `mensagem` string

## Other responses

- `400` — Requisição de cadastro de empreendimento incorreta!
- `404` — Nenhum dado encontrado!

---

[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/versions/42bf5add8bf3/schema)