CobrancaCarne

Atualiza o carnê

Esta API permite atualizar um carnê.

Requisição

CampoTipoDescriçãoObrigatório
CarneIdGUIDID do carnê já cadastradoSim
DescricaoTextoDescrição do carnêNão
ValorNuméricoValor individual de cada parcela do carnêNão
QuantidadeParcelasNúmeroQuantidade de parcelas do carnê (mínimo de duas parcelas)Não
VencimentoDataData de vencimento do carnêNão
NaoReceberDepoisDeDataData limite para pagamento após o vencimento da cobrançaNão
MultaNuméricoValor da multa que será aplicado em todas as cobrança/parcela, em abertoNão
MultaCorrecaoTextoTipo da multa a ser aplicada - Percentual, ValorNão
JurosMesNuméricoJuros mensais que será aplicado em todas as cobranças/parcelas, em abertoNão
JurosCorrecaoTextoTipo do juros a ser aplicado - Percentual, ValorNão
DescontoAteVencimentoNuméricoDesconto aplicado até a data do vencimento que será aplicado em todas as cobrança/parcela, em abertoNão
DescontoCorrecaoTextoTipo do desconto a ser aplicado - Percentual, ValorNão
Instrucao1TextoInstrução adicional para o carnêNão
Instrucao2TextoInstrução adicional para o carnêNão
Instrucao3TextoInstrução adicional para o carnêNão
Instrucao4TextoInstrução adicional para o carnêNão

Resposta

CampoTipoDescrição
CarneIdGUIDIdentificador único do carnê gerado
EstadoTextoEstado que o carnê se encontra
ImgBase64TextoBase64 do PDF completo do carnê
ParcelasLista de ObjetosLista com o detalhamento de cada parcela
CobrancaIdGUIDIdentificador único da Cobrança gerada
EstadoParcelaTextoEstado da cobrança
ValorNuméricoValor da parcela
VencimentoDataData de vencimento da parcela
NossoNumeroTextoNosso Número do boleto gerado
LinhaDigitavelTextoLinha digitável do boleto gerado
CodigoBarrasTextoCódigo de Barras do boleto gerado
QRCodeTextoTextoCopia e cola do pix (se for gerado como Boleto Híbrido)
QRCodeImagemTextoImagem do QRCode do pix (se for gerado como Boleto Híbrido)
DadosPagamentoObjetoDados do pagamento
put/api/CobrancaCarne/AtualizaCarne

Request

  • Base URL
    https://pagamentos.meuk8.com.br/CobrancasAPI
  • URL
    https://pagamentos.meuk8.com.br/CobrancasAPI/api/CobrancaCarne/AtualizaCarne
  • Auth
    OAuth 2
    Password
    Token URL: /CobrancasAPI/token scopes: BknBankCobrancasAPI

Headers

Aeskeystring required

Request body

CarneIdstring uuid
Descricaostring
Valornumber double
QuantidadeParcelasinteger
Vencimentostring date-time
NaoReceberDepoisDestring date-time
Multanumber double
MultaCorrecao'Percentual' | 'Valor' | 'Diario' | 'Isento'
JurosMesnumber double
JurosCorrecao'Percentual' | 'Valor' | 'Diario' | 'Isento'
DescontoAteVencimentonumber double
DescontoCorrecao'Percentual' | 'Valor' | 'Diario' | 'Isento'
Instrucao1string
Instrucao2string
Instrucao3string
Instrucao4string

Example request

{
  "CarneId": "00000000-0000-0000-0000-000000000000",
  "Descricao": "Cobrança do Tipo Carnê",
  "Valor": 125,
  "QuantidadeParcelas": 4,
  "Vencimento": "2026-09-03T10:12:01.41946-03:00",
  "NaoReceberDepoisDe": "2026-09-18T10:12:01.41946-03:00",
  "Multa": 2.5,
  "MultaCorrecao": 1,
  "JurosMes": 0.5,
  "JurosCorrecao": 1,
  "DescontoAteVencimento": 11.55,
  "DescontoCorrecao": 0,
  "Instrucao1": "",
  "Instrucao2": "",
  "Instrucao3": "",
  "Instrucao4": ""
}

Response

Cobrança do tipo carnê atualizada com sucesso.

CarneIdstring uuid
Estado'Todos' | 'EmDia' | 'Finalizada' | 'Cancelada' | 'GerandoCarne' | 'Erro'
ImgBase64string

Example response

{
  "CarneId": "00000000-0000-0000-0000-000000000000",
  "Parcelas": [
    {
      "CobrancaId": "00000000-0000-0000-0000-000000000000",
      "DadosPagamento": {
        "TransacaoId": "00000000-0000-0000-0000-000000000000",
        "CobrancaId": "00000000-0000-0000-0000-000000000000"
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.