---
title: "Cadastra etapa."
method: POST
path: "/v1/cadastros/empreendimentos/etapas"
tags: ["Etapa"]
---

# Cadastra etapa.

`POST /v1/cadastros/empreendimentos/etapas`

## Request

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

Etapa é um conjunto de blocos pertencentes a um empreendimento. Quando essa interface for consumida uma nova etapa será criada dentro de um empreendimento no Construtor de Vendas, ela irá verificar se o dado inserido no campo idetapa_int existe ou não no Construtor de Vendas, se já existir uma etapa cadastrada com o mesmo idetapa_int, essa API irá atualizar os dados solicitados na requisição, se não irá cadastrá-los.

**Obs: Para que a etapa seja inserida no Contrutor de Vendas, o identificador do empreendimento deve existir no sistema. Somente será aceito um cadastro por nome**

## Headers

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

## Request body

- CadastroEtapa: JSON para cadastro de empreendimento.
  - `idetapa_int` string, required: Identificador da etapa no sistema legado (Código interno).
  - `idempreendimento_int` string, required: Identificador do empreendimento da etapa no sistema legado (código interno).
  - `nome` string, required: Nome da etapa.
  - `disponivel` string, required: Disponibilidade da etapa (Ativo ou Finalizado).
  - `data_cad` string, required: Data de cadastro da etapa.
  - `remover` string: Identificador (código interno - etapa_int) da etapa que deseja remover.

## Response `200`

Mensagem de sucesso ao cadastrar etapa.

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

## Other responses

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

---

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