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

# Cadastra etapa.

`POST /v1/cadastros/empreendimentos/etapas`

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