---
title: "Atualiza uma assinatura"
method: PUT
path: "/api/Assinatura"
tags: ["Assinatura"]
---

# Atualiza uma assinatura

`PUT /api/Assinatura`

Esta API permite que seja atualizado os dados na assinatura, por ID.

### Requisão 
| **Campo** | **Tipo** | **Descrição** | **Obrigatório** | 
|--|--|--|--|  
| Id | GUID  | Identificador único da assinatura | Sim | 
| ClienteId | GUID | Identificador único do cliente| Não | 
| ClienteNome | Texto | Nome do cliente relacionado a assinatura, somente para retornar dados | Não | 
| Descricao | Texto | Breve descrição sobre a cobrança | Não | 
| Valor | Numérico | Valor da cobrança | Sim | 
| Periodicidade | Texto | Período o qual a cobrança será enviada ao cliente | Sim |
| DiasGeracaoCobranca | Numérico | Dias para gerar a cobrança de assinatura | Não | 
| IniciandoEm | Data | Data de início da assinatura. Não pode ser alterada se já existirem cobranças geradas | Sim |
| FinalizandoEm | Data | Data de fim da assinatura | Não |
| FormasPagamento | Texto | Forma de pagamento da cobrança| Não | 
| ProdutoId | GUID | Identificador único do produto caso houver | Não (1) |
| Multa | Numérico | Valor da multa caso haja algum tipo de atraso | Não | 
| JurosMes | Numérico | Porcentagem de juros ao mes após o vencimento | Não | 
| DescontoAteVencimento | Numérico  | Desconto até a última data do vencimento da assinatura| Não | 
| SplitValores | Array | Array especificando o “split” financeiro dos valores arrecadados pelo pagamento para diversas contas do meuK8, a partir do código de cliente e do valor respectivo | Não | 
| ClientePagamentosId | GUID | Id do cliente de pagamento | Não |
| Valor | Numérico | Valor da assinatura | Não | 

(1) - Quando o campo ProdutoId está preenchido a Multa, DescontoAteVencimento e Juros devem estar vazios!

## Headers

- `Aeskey` string, required

## Request body

- BknBankCobrancasAPIModelsAssinatura — Modelo de Assinaturas
  - `Id` string — Id da assinatura
  - `ClienteId` string, uuid — Id do cliente relacionado a assinatura
  - `ClienteNome` string — Nome do cliente relacionado a assinatura, somente para retornar dados
  - `Descricao` string, required — Descrição da assinatura
  - `Valor` number, double — Valor da assinatura
  - `Periodicidade` 'Todos' | 'Mensal' | 'Semanal' | 'Quinzenal' | 'Bimestral' | 'Trimestral' | 'Semestral' | 'Anual' — Periodicidade da assinatura
  - `DiasGeracaoCobranca` integer — Dias para gerar a cobrança de assinatura
  - `IniciandoEm` string, date-time — Data de início da assinatura
  - `FinalizandoEm` string, date-time — Data de fim da assinatura
  - `FormasPagamento` 'Nenhum' | 'Boleto' | 'Cartao' | 'Pix' | 'Manual' | 'Protesto' | 'SaldoWebConta' — Formas de pagamento da assinatura
  - `ProdutoId` string, uuid — Id do produto da assinatura
  - `Multa` number, double — Multa percentual da assinatura
  - `JurosMes` number, double — Juros percentual ao mês da assinatura
  - `DescontoAteVencimento` number, double — Desconto percentual para pagamento até o vencimento da assinatura
  - `SplitValores` BknBankCobrancasAPIModelsSplitAssinaturaRequest[] — Definicao de split para a assinatura
    - `ClientePagamentosId` string, uuid — Id da produto associado ao split
    - `Valor` number, double — Valor nominal de credito para o participante
  - `AutoEmiteFormaPagamento` boolean

## Response `200`

OK

- object

## Other responses

- `204` — Assinatura atualizada
- `400` — Dados inválidos da assinatura
- `401` — Não há permissão para acessar esta assinatura
- `404` — Não existe a assinatura por Id
- `500` — Id inválido da assinatura ou erro atualizando assinatura

---

[API](https://skmtc.net/meuk8/apis/k8-fintech.md) · [All operations](https://skmtc.net/meuk8/apis/k8-fintech/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/meuk8/k8-fintech/revisions/14db4977f490/schema)