---
title: "Alterar pagamento da comissão"
method: PUT
path: "/v1/financeiro/comissoes/parcelas"
tags: ["Pagamentos da comissão"]
---

# Alterar pagamento da comissão

`PUT /v1/financeiro/comissoes/parcelas`

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

Atualizar pagamentos de comissão. Permite alterar a situação do pagamento e/ou associar dados de boleto.

O endpoint aceita dois grupos de dados independentes:

- **Situação do pagamento** (`idsituacao_cv` ou `situacao`): obrigatório informar um dos dois.
- **Dados do boleto** (`idpagamento_int` + `boleto_url` ou `boleto_base64`): opcional. Quando enviado, deve vir completo (o `idpagamento_int` é obrigatório junto com `boleto_url` ou `boleto_base64`). Caso contrário o sistema retorna erro 400.

Se a requisição enviar apenas a situação, somente ela será alterada e os dados de boleto existentes permanecem intocados.

Quando enviados vários `idpagamentos` junto com dados de boleto, um único registro de boleto é criado e vinculado a todos eles. Nesse caso, todos os pagamentos devem pertencer à mesma comissão.

Autenticação: Requer email e token nos Headers da requisição.

## Headers

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

## Request body

- AlterarPagamentoComissao — Dados para alterar o pagamento da comissão. - É obrigatório informar `idpagamento` **ou** `idpagamentos`. - É obrigatório informar `idsituacao_cv` **ou** `situacao`. - Os campos de boleto são opcionais, mas quando enviados devem vir em conjunto: `idpagamento_int` junto com `boleto_url` ou `boleto_base64`. Enviar parcialmente resulta em erro 400.
  - `idpagamento` integer — Identificador único de um pagamento da comissão. Use este campo OU `idpagamentos`.
  - `idpagamentos` integer[] — Lista de identificadores de pagamentos da comissão. Quando enviados com dados de boleto, todos devem pertencer à mesma comissão.
  - `situacao` string — Nome da situação do pagamento no workflow. Use este campo OU `idsituacao_cv`.
  - `idsituacao_cv` integer — ID da situação do pagamento. Use este campo OU `situacao`.
  - `idpagamento_int` string — Protocolo do(s) boleto(s) no sistema parceiro. Obrigatório quando `boleto_url` ou `boleto_base64` é enviado.
  - `boleto_url` string — Link de acesso ao boleto. Use este campo OU `boleto_base64` ao enviar dados de boleto.
  - `boleto_base64` string — Arquivo do boleto em Base64. Use este campo OU `boleto_url` ao enviar dados de boleto.

## Response `200`

Operação realizada com sucesso no put de pagamento de comissão.

- AlterarPagamento — Resposta da operação de alteração de pagamento.
  - `sucesso` boolean — campo informando o status da operação

## 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/versions/42bf5add8bf3/schema)