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

# Atualiza uma assinatura

`PUT /api/Assinatura`

## Request

- Base URL: `https://pagamentos.meuk8.com.br/CobrancasAPI`
- URL: `https://pagamentos.meuk8.com.br/CobrancasAPI/api/Assinatura`
- Auth: OAuth 2
  - Password
  - Token URL: `/CobrancasAPI/token` scopes: `BknBankCobrancasAPI`

Esta API permite que sejam atualizados os dados de uma assinatura, por ID.

### Requisição 
| **Campo** | **Tipo** | **Descrição** | **Obrigatório** | 
|--|--|--|--|  
| Id | GUID  | Identificador único da assinatura | Sim | 
| ClienteId | GUID | Identificador único do cliente que será cobrado | Sim | 
| ClienteNome | Texto | Nome do cliente que será cobrado | Não | 
| Descricao | Texto | Breve descrição sobre a assinatura | Sim | 
| Valor | Numérico | Valor da assinatura | Sim | 
| Periodicidade | Texto | Período no qual a cobrança da assinatura será enviada ao cliente - Todos, Mensal, Semanal, Quinzenal, Bimestral, Trimestral, Semestral, Anual | 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 término da assinatura | Não |
| FormasPagamento | Texto | Forma de pagamento da cobrança| Não | 
| ProdutoId | GUID | Identificador único do produto caso haja | Não (1) |
| Multa | Numérico  | Multa da assinatura, para pagamento após vencimento | Não |
| MultaCorrecao | Texto | Tipo da correção aplicada sobre a multa - "Percentual", "Valor", "Isento" | Não |
| JurosMes | Numérico | Juros ao mês da assinatura, para pagamento após vencimento | Não |
| JurosCorrecao | Texto | Tipo da correção aplicada sobre os juros - "Percentual", "Valor", "Isento" | Não |
| DescontoAteVencimento | Numérico  | Desconto para pagamento até o vencimento da assinatura | Não |
| DescontoCorrecao | Texto | Tipo da correção aplicada sobre o desconto - "Percentual", "Valor", "Isento" | Não |
| **SplitValores** | **Array de Objeto** | **Array especificando o “split” financeiro dos valores arrecadados pelo pagamento para diversas contas MeuK8, a partir do código de cliente e do valor respectivo** | **Não** |  
| ClientePagamentosId | GUID | Identificador único do cliente relacionado ao split | Não |
| Valor | Numérico | Valor de crédito para o participante do split | 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
  - `Criacao` string, date-time: Data de criaçã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 término 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: Valor
  - `MultaCorrecao` 'Percentual' | 'Valor' | 'Diario' | 'Isento': Tipo da multa a ser aplicada
  - `JurosMes` number, double: Valor
  - `JurosCorrecao` 'Percentual' | 'Valor' | 'Diario' | 'Isento': Tipo do juros a ser aplicado
  - `DescontoAteVencimento` number, double: Valor
  - `DescontoCorrecao` 'Percentual' | 'Valor' | 'Diario' | 'Isento': Tipo do desconto a ser aplicado
  - `SplitValores` BknBankCobrancasAPIModelsSplitAssinaturaRequest[]: 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
    - `ClientePagamentosId` string, uuid: Id do cliente associado ao split
    - `Valor` number, double: Valor de crédito para o participante do split
  - `AutoEmiteFormaPagamento` boolean
  - `DadosPagamento` BknBankCobrancasAPIModelsDadosPagamentoAgregado: Modelo de Dados Agregados de Pagamento
    - `Id` string: Id da cobrança mais recentemente paga (null se nenhuma paga)
    - `Situacao` 'pendente' | 'pago' | 'atrasado': Situação geral do pagamento
    - `DataPagamento` string, date-time: Data do pagamento mais recente
    - `FormaPagamento` 'Nenhum' | 'Boleto' | 'Cartao' | 'Pix' | 'Manual' | 'Protesto' | 'SaldoWebConta': Forma de pagamento mais recente
    - `DadosPagamento` string: Dados do pagamento mais recente
    - `NumeroCobrancas` integer: Número de cobranças vinculadas
    - `ValorPago` number, double: Valor total pago (soma de todas cobranças pagas)
    - `ValorPrincipal` number, double: Valor principal total pago
    - `ValorMultaJuros` number, double: Valor total de multas/juros
    - `NumeroPagamento` string: Número do pagamento mais recente
    - `ValorTaxas` number, double: Valor total de taxas
    - `ValorLiquido` number, double: Valor líquido total
    - `DataDisponibilizacao` string, date-time: Data de disponibilização mais recente
    - `ReembolsadoAoCliente` boolean: Indicação se algum pagamento foi reembolsado
    - `Antecipado` boolean: Indicativo se algum pagamento foi antecipado
    - `TransacaoId` string, uuid: Id da Transação mais recente
    - `CobrancaId` string, uuid: Id da Cobrança mais recente paga
    - `NumeroCobrancasPagas` integer: Número de cobranças pagas
    - `NumeroCobrancasPendentes` integer: Número de cobranças pendentes
    - `NumeroCobrancasCanceladas` integer: Número de cobranças canceladas
    - `NumeroCobrancasInadimplentes` integer: Número de cobranças inadimplentes

## Response `204`

Assinatura atualizada

- SystemVoid

## Other responses

- `400`: Dados inválidos da assinatura
- `401`: Não há permissão para acessar esta assinatura
- `404`: Assinatura não encontrada
- `422`: Erro de validação
- `500`: Id inválido da assinatura ou erro atualizando assinatura

---

[API](https://skmtc.dev/meuk8/apis/k8-fintech-cobran-as.md) - [All operations](https://skmtc.dev/meuk8/apis/k8-fintech-cobran-as/llms.txt) - [OpenAPI document](https://skmtc.dev/meuk8/apis/k8-fintech-cobran-as/revisions/4b96dba8717a?raw)