Assinatura5

Cliente6

Cobranca6

CobrancaAnexo4

CobrancaBaixaManual2

CobrancaCarne3

CobrancaFechamentoCaixa1

CobrancaImprimirBoleto1

CobrancaPorClienteId1

CobrancaTemBoletoGerado1

CobrancaVisualizar1

LinkPagamento5

LinkPagamentoEstatistica1

LinkPagamentoVisualizar1

NotaFiscal3

NotaFiscalConfiguracaoEmpresa3

NotaFiscalConfiguracaoServico5

NotaFiscalConsultaServicos1

NotaFiscalMensagens1

NotaFiscalRegimesEspeciaisTributacao1

Produto5

Protesto5

ProtestoHistorico1

ProtestoV21

Seller3

CobrancaCarne

Cria cobrança do tipo carnê

Esta API permite cadastrar uma cobrança do tipo carnê.

Requisição

Campo	Tipo	Descrição	Obrigatório
ClienteId	GUID	ID do pagador já cadastrado	Sim
Descricao	Texto	Descrição do carnê	Sim
Valor	Numérico	Valor individual de cada parcela do carnê	Sim
QuantidadeParcelas	Número	Quantidade de parcelas do carnê (mínimo de duas parcelas)	Sim
Vencimento	Data	Data de vencimento do carnê	Sim
NaoReceberDepoisDe	Data	Data definida para o cliente não receber a cobrança após ela	Não
Multa	Numérico	Valor da multa a ser aplicada na cobrança	Não
MultaCorrecao	Texto	Tipo da multa a ser aplicada - Percentual, Valor	Não
JurosMes	Numérico	Juros mensais aplicados sobre o valor da cobrança	Não
JurosCorrecao	Texto	Tipo do juros a ser aplicado - Percentual, Valor	Não
DescontoAteVencimento	Numérico	Desconto aplicado até a data do vencimento	Não
DescontoCorrecao	Texto	Tipo do desconto a ser aplicado - Percentual, Valor	Não
Instrucao1	Texto	Instrução adicional para o carnê	Não
Instrucao2	Texto	Instrução adicional para o carnê	Não
Instrucao3	Texto	Instrução adicional para o carnê	Não
Instrucao4	Texto	Instrução adicional para o carnê	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	Lista de Objetos	Lista com o detalhamento de cada parcela
CobrancaId	GUID	Identificador único da Cobrança gerada
EstadoParcela	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)
DadosPagamento	Objeto	Dados do pagamento

post/api/CobrancaCarne/InsereCarne

Request

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

Headers

Aeskeystring required

Request body

ClienteIdstring 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

{
  "ClienteId": "214e5bed-0b15-409b-81c3-d3f94d1f8d8b",
  "Descricao": "Cobrança do Tipo Carnê",
  "Valor": 125,
  "QuantidadeParcelas": 4,
  "Vencimento": "2026-09-03T10:12:01.4162388-03:00",
  "NaoReceberDepoisDe": "2026-09-18T10:12:01.4162388-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ê criada com sucesso.

CarneIdstring uuid

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.