---
title: 8.6. Atualizar Taxa de um Cedente
url: https://docs.vehub.com.br/API/Cadastro%20de%20Cedente/8.%20Antecipa%C3%A7%C3%A3o%20autom%C3%A1tica%20de%20cart%C3%A3o/8.6.%20Atualizar%20Taxa%20de%20um%20Cedente/
---
Atualiza a taxa de deságio de **um** cedente em uma operação.

É a alteração pontual, síncrona, para quando a taxa foi negociada individualmente. Para mudar a taxa de muitos cedentes de uma vez, use [8.5. Atualizar Taxa por Operação](8.5.%20Atualizar%20Taxa%20por%20Opera%C3%A7%C3%A3o.md), que aceita tanto a carteira inteira quanto uma lista de CNPJs.

!!! info "A taxa vive no vínculo"
    Esta chamada grava em `operacao_cedente` — o mesmo lugar lido pelo ciclo automático e pela criação de contratos. O valor gravado aqui é o que vale a partir do próximo ciclo.

---

## Atualizar Taxa de um Cedente

| Método                                              | URL                                                                                    |
| --------------------------------------------------- | -------------------------------------------------------------------------------------- |
| ![PATCH](https://img.shields.io/badge/PATCH-yellow) | `https://BASE_URL/public/api/v1/cedentes/{idEmpresa}/operacoes/{idOperacao}/taxa`       |

### Path Params

| Campo        | Tipo   | Descrição                         |
| ------------ | ------ | --------------------------------- |
| `idEmpresa`  | Número | Identificador da empresa cedente. |
| `idOperacao` | Número | Identificador da operação.        |

### Request Body

| Campo  | Tipo    | Obrigatório | Descrição                                |
| ------ | ------- | ----------- | ---------------------------------------- |
| `taxa` | Decimal | Sim         | Nova taxa, com até 8 casas decimais.     |

```json title="Request Body"
{
  "taxa": 1.7500
}
```

```json title="Response Body — 200 OK"
{
  "idEmpresa": 4821,
  "idOperacao": 1,
  "taxaAnterior": 1.9900,
  "taxaNova": 1.7500
}
```

### Detalhamento da resposta

| Campo          | Tipo    | Descrição                                                                 |
| -------------- | ------- | ------------------------------------------------------------------------- |
| `idEmpresa`    | Número  | Identificador da empresa cedente.                                         |
| `idOperacao`   | Número  | Operação afetada.                                                         |
| `taxaAnterior` | Decimal | Taxa que estava gravada antes da chamada. `null` se o vínculo não tinha taxa. |
| `taxaNova`     | Decimal | Taxa gravada.                                                             |

!!! tip "Efeito no ciclo automático"
    A taxa nova vale a partir do **próximo ciclo**. Contratos já gerados não são reprecificados — o deságio de um contrato é definido no momento em que ele é criado.

### Erros

| Status | Quando acontece                                                   |
| ------ | ----------------------------------------------------------------- |
| `400`  | `taxa` ausente, negativa ou fora da precisão suportada.           |
| `401`  | Token ausente, expirado ou sem permissão de acesso à API pública. |
| `403`  | Grupo econômico não habilitado para antecipação automática.       |
| `404`  | Cedente ou operação não encontrados, ou sem vínculo vivo entre eles. |
| `422`  | Operação calcula deságio por Fonte Externa.                       |