---
title: "Cadastrar nova comissão"
method: POST
path: "/v1/financeiro/comissoes"
tags: ["Comissão"]
---

# Cadastrar nova comissão

`POST /v1/financeiro/comissoes`

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

Endpoint destinado ao cadastro de uma comissão no sistema CVCRM.

A comissão representa um valor percentual ou fixo pago a um profissional (corretor e/ou equipe de vendas) com base no valor do contrato ou em outra base definida pela incorporadora, conforme as regras configuradas no sistema.

Para o cadastro, é necessário informar:

Código da reserva à qual a comissão será vinculada;

Empreendimento, bloco e unidade;

Código da comissão no sistema parceiro (quando aplicável);

Valor da comissão;

Dados do beneficiário, como documento ou identificador;

Classificação da comissão (comissão, prêmio ou extra).

Caso a comissão seja parcelada, os dados das parcelas devem ser informados, incluindo as datas de vencimento correspondentes.

Se já existir uma comissão ativa vinculada à reserva, o endpoint retornará erro de validação.

## Headers

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

## Request body

- Comissao — schema de resposta das comissões do get de comissão
  - `idreserva_cv` integer, required — Identificador da reserva no Construtor de Vendas.
  - `idreserva_int` string — Identificador da reserva no sistema legado.
  - `idempreendimento_int` string, required — Identificador do empreendimento no sistema legado.
  - `idbloco_int` string, required — Identificador do bloco no sistema legado.
  - `idunidade_int` string, required — Identificador da unidade no sistema legado.
  - `situacao` integer — Identificador da situação ou nome da situação no workflow de comissões.
  - `comissoes` object[]
    - `idcomissao_int` string, required — Código interno do pagamento da comissão na reserva.
    - `comissao_valor` number, required — Valor do pagamento da comissão na reserva.
    - `comissao_para` string, required — Para do pagamento (corretor, usuário administrativo, coordenador do produto, usuário imobiliária, imobiliária).
    - `comissao_quem` integer, required — Identificador do quem (obrigatório documento ou quem ou docfaturamento).
    - `comissao_documento` string — Documento do quem (obrigatório documento ou quem ou docfaturamento).
    - `comissao_docfaturamento` string — Documento faturamento do quem (obrigatório documento ou quem ou docfaturamento).
    - `comissao_tipo` string, required — Tipo da comissão. C - Comissão, P - prêmio, E - prêmio extra
    - `comissao_cancelamento` string
    - `idparcela_int` string — Código interno do pagamento
    - `parcela_valor` number, required — Valor do pagamento
    - `parcela_data` string, required — Data de pagamento
    - `parcela_datamediacao` string, required — Data da medição do pagamento
    - `parcela_cancelamento` string, required — Informa pagamento cancelado
    - `parcela_observacoes` string — Observação do pagamento
    - `parcela_notafiscal` string, required — Nota fiscal do pagamento
    - `situacao` integer — Identificador da situação ou nome da situação no workflow de pagamentos de comissão.

## Response `200`

Operaçã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

- `204` — Requisição Incorreta! Nenhum dado foi encontrado.
- `400` — Erro de solicitação, revise os parâmetros!
- `401` — E-mail e/ou token incorreto(s).
- `403` — Sem permissão no perfil de acesso ou módulo inativo.
- `404` — URL não encontrada.
- `422` — Erro inesperado, 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/revisions/42bf5add8bf3/schema)