---
title: "Atualiza o carnê"
method: PUT
path: "/api/CobrancaCarne/AtualizaCarne"
tags: ["CobrancaCarne"]
---

# Atualiza o carnê

`PUT /api/CobrancaCarne/AtualizaCarne`

Esta API permite atualizar um carnê.

### Requisição
| **Campo** | **Tipo** | **Descrição** | **Obrigatório** |
|--|--|--|--| 
| CarneId | GUID | ID do carnê já cadastrado | Sim |
| Descricao| Texto | Descrição do carnê | Não |
| Valor | Numérico | Valor individual de cada parcela do carnê | Não |
| QuantidadeParcelas | Numérico | Quantidade de parcelas do carnê (mínimo de duas parcelas) | Não |
| Vencimento | Data | Data de vencimento do carnê | Não |
| NaoReceberDepoisDe | Data | Data limite para pagamento após o vencimento da cobrança | Não |
| Multa | Numérico | Valor da multa que será aplicado em todas as cobrança/parcela, em aberto | Não | 
| MultaCorrecao | Texto | Tipo da multa a ser aplicada| Não | 
| JurosMes | Numérico | Juros mensais que será aplicado em todas as cobranças/parcelas, em aberto   | Não | 
| JurosCorrecao | Texto |  Tipo do juros a ser aplicado  | Não | 
| DescontoAteVencimento | Numérico | Desconto aplicado até a data do vencimento que será aplicado em todas as cobrança/parcela, em aberto| Não | 
| DescontoCorrecao | Texto | Tipo do desconto a ser aplicado | Não | 

### Resposta 
| **Campo** | **Tipo** | **Descrição** |
|--|--|--| 
| CarneId | GUID | Identificador único do carnê gerado|
| Estado | Texto | Estado que o carnê se encontra |
| ImgBase64 | Texto | Base64 do PDF completo do carnê |
| **Parcelas** | **CarneParcelas** | **Lista com o detalhamento de cada parcela** |
| CobrancaId | GUID | Identificador único da cobrança gerada |
| Estado | Texto | Estado da cobrança |
| Valor | Numérico | Valor da parcela |
| Vencimento | Data | Data de vencimento da parcela |
| NossoNumero | Texto | Nosso Número do boleto gerado |
| LinhaDigitavel | Texto | Linha digitável do boleto gerado |
| CodigoBarras | Texto | Código de Barras do boleto gerado |
| QRCodeTexto | Texto | Copia e cola do PIX (se for gerado como boleto híbrido) |
| QRCodeImagem | Texto | Imagem do QRCode do PIX (se for gerado como boleto híbrido) |

## Headers

- `Aeskey` string, required

## Request body

- BknBankCobrancasBusinessAtualizarCarneBusinessModel
  - `CarneId` string, uuid
  - `Descricao` string
  - `Valor` number, double
  - `QuantidadeParcelas` integer
  - `Vencimento` string, date-time
  - `NaoReceberDepoisDe` string, date-time
  - `Multa` number, double
  - `MultaCorrecao` 'Percentual' | 'Valor' | 'Diario' | 'Isento'
  - `JurosMes` number, double
  - `JurosCorrecao` 'Percentual' | 'Valor' | 'Diario' | 'Isento'
  - `DescontoAteVencimento` number, double
  - `DescontoCorrecao` 'Percentual' | 'Valor' | 'Diario' | 'Isento'
  - `Instrucao1` string
  - `Instrucao2` string
  - `Instrucao3` string
  - `Instrucao4` string

## Response `200`

Cobrança do tipo carnê atualizada com sucesso.

- BknBankCobrancasAPIModelsCobrancaCarneResponse
  - `CarneId` string, uuid
  - `Estado` 'Todos' | 'EmDia' | 'Finalizada' | 'Cancelada' | 'GerandoCarne'
  - `ImgBase64` string
  - `Parcelas` BknBankCobrancasAPIModelsParcela[]
    - `CobrancaId` string, uuid
    - `EstadoParcela` 'Todos' | 'Pendente' | 'Paga' | 'Inadimplente' | 'PendenteRegistro' | 'Cancelada'
    - `Valor` number, double
    - `Vencimento` string, date-time
    - `NossoNumero` string
    - `LinhaDigitavel` string
    - `CodigoBarras` string
    - `QRCodeTexto` string
    - `QRCodeImagem` string

## Other responses

- `400` — Dados inválidos do carnê
- `500` — Erro atualizando carnê

---

[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)