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

# Atualiza uma reserva no Construtor de Vendas

`PUT /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 atualizar 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

- AlterarReserva — Requisição para alterar reserva
  - `idreserva_int` string, string, required — Identificador interno da reserva no sistema externo
  - `idreserva_cv` integer, required — Identificador da reserva no Construtor de Vendas.
  - `idpessoa_cv` integer — Identificador do cliente no Construtor de Vendas
  - `idpessoa_int` string, string — Identificador interno do cliente no sistema externo
  - `idcorretor_cv` integer — Identificador do corretor no Construtor de Vendas
  - `idcorretor_int` string, string — Identificador interno do corretor no sistema externo.
  - `associados` object[] — Associados
    - `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
    - `idconjuge_cv` integer — Identificador da pessoa no Construtor de Vendas
    - `idconjuge_int` string, string — Identificador interno da pessoa no sistema externo
    - `participacao_contrato` string, string — Participação no contrato
    - `percentual_participacao` number, float — Participação no contrato (%)
  - `regras_comissao` object[] — Regras de comissão
    - `tipo_comissao` 'C' | 'P' | 'E', string — Tipo da regra: <ul><li>C - Comissão</li> <li>P - Prêmio</li> <li>E - Premiação Extra</li></ul>
    - `tipo_valor` 'V' | 'P' | 'VSC' | 'PRT', string — Tipo de valor: <ul><li>V - Valor</li> <li>P - Prêmio</li> <li>VSC - Valor da série de comissão</li> <li>PRT - Premiação Regra Tabela de Preço</li></ul>
    - `comissao_pagamento_tipo` 'VGV' | 'VP', string — Pagamento de comissão por: <ul><li>VGV - Valor do Contrato</li> <li>VP - Valor Presente</li></ul>
    - `comissao_juros` 'S' | 'N', string — Calcular com juros: <ul><li>S - Sim</li> <li>N - Não</li></ul>
    - `para` 'IR' | 'IC' | 'CO' | 'CR' | 'CC' | 'CP' | 'UA' | 'UI', string — Para quem vai ser a regra: <ul><li>IR - Imobiliária (Reserva)</li> <li>IC - Imobiliária</li> <li>CO - Imobiliária (Coordenação)</li> <li>CR - Corretor (Reserva)</li> <li>CC - Corretor</li> <li>CP - Coordenador do Produto</li> <li>UA - Usuário Administrativo</li> <li>UI - Usuário Imobiliária</li></ul>
    - `quem` integer — Identificador do pessoa que vai receber.
    - `para_pagamento` 'DU' | 'DF', string — Para pagamento: <ul><li>DU - Dados do Usuário</li> <li>DF - Dados do Faturamento</li></ul>
    - `ordem` integer — Ordem.
    - `valor_comissao` number, float — Valor / Porcentagem.
    - `enviar_pagadoria` 'S' | 'N', string — Enviar para Pagadoria: <ul><li>S - Sim</li> <li>N - Não</li></ul>
    - `forma_pagamento` string, string — Sigla da Forma de Pagamento.
    - `proporcao` number, float — Proporção Pagamento: (%).
    - `pago_pela_condicao_reserva` 'S' | 'N', string — Comissão paga pela condição da reserva: <ul><li>S - Sim</li> <li>N - Não</li></ul>
    - `contrato` 'S' | 'N', string — Retirar do Subtotal: <ul><li>S - Sim</li> <li>N - Não</li></ul>
    - `idindexador_sienge_comissao` integer — Identificador do Indexador.
    - `descricao` string, string — Descrição.
  - `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.
  - `campos_adicionais` object[]
    - `idcampo_adicional` integer — Identificador do campo adicional no Construtor de Vendas.
    - `valor` string, string — Valor do campo adicional.

## Response `200`

Rerserva retornada 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 reserva!
- `401` — E-mail e/ou token incorreto(s) na requisição de alteração da reserva.
- `403` — Sem permissão no perfil de acesso ou módulo inativo para alterar reserva.
- `404` — URL não encontrada na requisição de alteração da reserva.
- `422` — Ocorreu um erro inesperado na requisição de alteração da, 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)