---
title: "Realiza cessão de direitos de uma reserva"
method: POST
path: "/v1/comercial/reservas/cessao"
tags: ["Cessão"]
---

# Realiza cessão de direitos de uma reserva

`POST /v1/comercial/reservas/cessao`

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

Cessão é o processo de troca do cliente associado a unidade, como uma transferência de imóvel. Esta API fará requisições ao sistema legado para que lhe seja fornecido os dados da proposta que se deseja executar cessão no Construtor de Vendas, logo após irá verificar se os dados inseridos nos campos reserva, documento_novo_titular e documento_novo_associado existem ou não no Construtor de Vendas, somente se todos esses campos existirem será executada a troca do cliente.

**Obs: Para que essas informações sejam inseridas no Construtor de Vendas, a reserva deve estar em situação com flag 'vendida'. Todos os documentos devem ser válidos.**

## Headers

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

## Request body

- Cessao — Requisição para realizar cessão de direitos.
  - `reserva` string, string, required — Identificador da reserva no Construtor de Vendas.
  - `documento_novo_titular` string, string, required — Documento do novo titular da reserva.
  - `documento_novo_associado` string, string — Documento do associado ao novo titular.
  - `motivo` string, string, required — Motivo da transferência da unidade.

## Response `200`

Cessão realizada com sucesso.

- ResponseSucesso — Retorno do schema quando a operação é realizada com sucesso. Dados inseridos com sucesso.
  - `codigo` string
  - `mensagem` string

## Other responses

- `400` — Erro ao executar a cessão
- `401` — E-mail e/ou token incorreto(s) na requisição de cadastro da cessão.
- `403` — Sem permissão no perfil de acesso ou módulo inativo para cadastrar cessão.
- `404` — URL não encontrada na requisição de cadastro da cessão.
- `422` — Erro inesperado na requisição de cadastro da cessão, por favor entre em contato com o suporte técnico.

---

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