---
title: "Cadastra uma reserva no Construtor de Vendas"
method: POST
path: "/v1/comercial/reservas"
tags: ["Reserva"]
---

# Cadastra uma reserva no Construtor de Vendas

`POST /v1/comercial/reservas`

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

Esta API deve ser utilizada para cadastrar uma reserva no Construtor de Vendas. É necessário informar ao menos um dos campos de identificador ou identificador interno para cada campo que possue essa opção.

## Headers

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

## Request body

- CadastrarReserva — Requisição para cadastrar reserva
  - `idpessoa_cv` integer, required — Identificador do cliente no Construtor de Vendas.
  - `idpessoa_int` string, string, required — Identificador interno do cliente no sistema externo.
  - `idempreendimento_cv` integer, required — Identificador do empreendimento no Construtor de Vendas.
  - `idempreendimento_int` string, string, required — Identificador interno do empreendimento no sistema externo.
  - `idunidade_cv` integer, required — Identificador da unidade no Construtor de Vendas.
  - `idunidade_int` string, string, required — Identificador interno da unidade no sistema externo.
  - `idcorretor_cv` integer, required — Identificador do corretor no Construtor de Vendas.
  - `idcorretor_int` string, string, required — Identificador interno do corretor no sistema externo.
  - `idreserva_int` string, string — Identificador interno da reserva no sistema externo.
  - `idtipovenda` integer — Identificador do tipo de venda.
  - `condicoes` object[], required
    - `idserie_cv` integer — Identificador da série no Construtor de Vendas.
    - `idserie_int` string, string — Identificador interno da série no sistema externo.
    - `quantidade_parcelas` integer — Quantidade de parcelas.
    - `valor_parcela` number, float — Valor da parcela.
    - `primeiro_vencimento` string, string — Data do primeiro vencimento em formato DD/MM/YYYY.
    - `idindexador` integer — Identificador do indexador.
    - `idportador` integer — Identificador do portador.
    - `retirar_comissao` 'S' | 'N', string — Retirar comissão dessa série <ul><li>S - Sim</li> <li>N - Não</li></ul>
  - `associado` object
    - `idpessoa_cv` integer — Identificador da pessoa no Construtor de Vendas.
    - `idpessoa_int` string, string — Identificador interno da pessoa no sistema externo.
    - `idtipo_associacao` integer — Identificador do tipo de associação.
    - `participacao_contrato` string, string — Participação no contrato.
    - `percentual_participacao` number, float — Participação no contrato (%).
  - `espacos_complementares` object[]
    - `idespaco_cv` integer — Identificador do espaço complentar no Construtor de Vendas
    - `idespaco_int` string, string — Identificador interno do espaço complentar no sistema externo
    - `valor` number, float — Valor do espaço complementar

## Response `200`

Cadastro de reserva realizado com sucesso.

- RetornoReservaAlteracao — Retorno ao alterar reserva
  - `codigo` integer — Código da resposta da alteração de reserva
  - `mensagem` string, string — Mensagem informativa do alteração

## Other responses

- `400` — Erro de integração na requisição de cadastro da reserva!
- `401` — E-mail e/ou token incorreto(s) na requisição de cadastro da reserva.
- `403` — Sem permissão no perfil de acesso ou módulo inativo para cadastrar reserva.
- `404` — URL não encontrada na requisição de cadastro da reserva.
- `422` — Ocorreu um erro inesperado na requisição de cadastro da reserva, por favor tente mais tarde.

---

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