8.6. Atualizar Taxa de um Cedente

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, que aceita tanto a carteira inteira quanto uma lista de CNPJs.

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
	`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.

Request Body

{
  "taxa": 1.7500
}

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.

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.