--- title: "Atualiza uma cobrança" method: PUT path: "/api/Cobranca" tags: ["Cobranca"] --- # Atualiza uma cobrança `PUT /api/Cobranca` ## Request - Base URL: `https://pagamentos.meuk8.com.br/CobrancasAPI` - URL: `https://pagamentos.meuk8.com.br/CobrancasAPI/api/Cobranca` - Auth: OAuth 2 - Password - Token URL: `/CobrancasAPI/token` scopes: `BknBankCobrancasAPI` Esta API permite a atualização dos dados da cobrança. ### Requisição | **Campo** | **Tipo** | **Descrição** | **Obrigatório** | |--|--|--|--| | Id | GUID | Identificador único da cobrança | Não | | IdentificadorSequencial | Número | Identificador sequencial da cobrança| Não | | ClienteId | GUID | Identificador único do cliente | Sim | | ClienteNome | Texto | Nome do cliente relacionado a cobrança | Não | | Descricao | Texto | Descrição da cobrança | Sim | | Valor | Numérico | Valor a ser pago na cobrança | Sim | | Vencimento | Data | Data de vencimento da cobrança | Sim | | NaoReceberDepoisDe | Data | Data definida para o cliente não receber a cobrança após ela | Não | | Estado | Texto | Situação da cobrança | Sim | | FormasPagamento | Texto | Formas de pagamento da cobrança | Sim | | ProdutoId | GUID |Identificador único do produto(forma simplificada da cobrança) | Não | | Multa | Numérico| Valor da multa a ser aplicada na cobrança | Não | | MultaCorrecao | Número | Tipo da multa a ser aplicada - 0 - "Percentual", 1 - "Valor" | Não | | JurosMes | Numérico | Juros mensais aplicados sobre o valor da cobrança | Não | | JurosCorrecao | Número | Tipo do juros a ser aplicado - 0 - "Percentual", 1 - "Valor" | Não | | DescontoAteVencimento | Numérico | Desconto aplicado até a data do vencimento | Não | | DescontoCorrecao | Número | Tipo do desconto a ser aplicado - 0 - "Percentual", 1 - "Valor" | Não | | Instrucao1 | Texto | Deve ser utilizado para adicionar informações adicionais destinadas ao usuário final| Não | | Instrucao2 | Texto | Deve ser utilizado para adicionar informações adicionais destinadas ao usuário final| Não | | Instrucao3 | Texto | Deve ser utilizado para adicionar informações adicionais destinadas ao usuário final| Não | | Instrucao4 | Texto | Deve ser utilizado para adicionar informações adicionais destinadas ao usuário final| Não | | NotificacaoCobrancaDias | Número | Dias antes do vencimento da cobrança para enviar a notificação | Não | | NotificacaoCobrancaEmail | Booleano | Se esta opção estiver marcada, o cliente receberá uma notificação via e-mail | Não | | NotificacaoCobrancaSMS | Booleano | Se esta opção estiver marcada, o cliente receberá uma notificação via SMS | Não | | NotificacaoCobrancaCartaImpressa | Booleano | Se esta opção estiver marcada, o cliente receberá uma notificação via carta | Não | | PrimeiraTentativaHabilitada | Booleano| Primeira tentativa de notificação com os dias vencidos | Não | | PrimeiraTentativaDias | Número | Número de dias vencidos | Não | | PrimeiraTentativaEmail | Booleano | Primeira tentativa de notificação com os dias vencidos via e-mail | Não | | PrimeiraTentativaSMS | Booleano | Primeira tentativa de notificação com os dias vencidos via SMS | Não | | SegundaTentativaHabilitada| Booleano | Segunda tentativa de notificação com os dias vencidos | Não | | SegundaTentativaDias | Número | Número de dias vencidos | Não | | SegundaTentativaEmail | Booleano | Segunda tentativa de notificação com os dias vencidos via e-mail | Não | | SegundaTentativaSMS | Booleano | Segunda tentativa de notificação com os dias vencidos via SMS | Não | | TerceiraTentativaHabilitada | Booleano | Terceira tentativa de notificação com os dias vencidos | Não | | TerceiraTentativaDias | Número | Número de dias vencidos | Não | | TerceiraTentativaEmail | Booleano | Terceira tentativa de notificação com os dias vencidos via e-mail | Não | | TerceiraTentativaSMS | Booleano | Terceira tentativa de notificação com os dias vencidos via SMS | Não | | QuartaTentativaHabilitada | Booleano | Quarta tentativa de notificação com os dias vencidos | Não | | QuartaTentativaDias | Número | Número de dias vencidos | Não | | QuartaTentativaEmail | Booleano| Quarta tentativa de notificação com os dias vencidos via e-mail | Não | | QuartaTentativaSMS | Booleano | Quarta tentativa de notificação com os dias vencidos via SMS | Não | | QuintaTentativaHabilitada | Booleano | Quinta tentativa de notificação com os dias vencidos | Não | | QuintaTentativaDias | Número | Número de dias vencidos | Não | | QuintaTentativaEmail | Booleano| Quinta tentativa de notificação com os dias vencidos via e-mail | Não | | QuintaTentativaSMS | Booleano | Quinta tentativa de notificação com os dias vencidos via SMS | Não | | SextaTentativaHabilitada | Booleano | Sexta tentativa de notificação com os dias vencidos | Não | | SextaTentativaDias | Número | Número de dias vencidos | Não | | SextaTentativaEmail | Booleano| Sexta tentativa de notificação com os dias vencidos via e-mail | Não | | SextaTentativaSMS | Booleano | Sexta tentativa de notificação com os dias vencidos via SMS | Não | | SetimaTentativaHabilitada | Booleano | Sétima tentativa de notificação com os dias vencidos | Não | | SetimaTentativaDias | Número | Número de dias vencidos | Não | | SetimaTentativaEmail | Booleano| Sétima tentativa de notificação com os dias vencidos via e-mail | Não | | SetimaTentativaSMS | Booleano | Sétima tentativa de notificação com os dias vencidos via SMS | Não | | OitavaTentativaHabilitada | Booleano | Oitava tentativa de notificação com os dias vencidos | Não | | OitavaTentativaDias | Número | Número de dias vencidos | Não | | OitavaTentativaEmail | Booleano| Oitava tentativa de notificação com os dias vencidos via e-mail | Não | | OitavaTentativaSMS | Booleano | Oitava tentativa de notificação com os dias vencidos via SMS | Não | | NonaTentativaHabilitada | Booleano | Nona tentativa de notificação com os dias vencidos | Não | | NonaTentativaDias | Número | Número de dias vencidos | Não | | NonaTentativaEmail | Booleano| Nona tentativa de notificação com os dias vencidos via e-mail | Não | | NonaTentativaSMS | Booleano | Nona tentativa de notificação com os dias vencidos via SMS | Não | | DecimaTentativaHabilitada | Booleano | Décima tentativa de notificação com os dias vencidos | Não | | DecimaTentativaDias | Número | Número de dias vencidos | Não | | DecimaTentativaEmail | Booleano| Décima tentativa de notificação com os dias vencidos via e-mail | Não | | DecimaTentativaSMS | Booleano | Décima tentativa de notificação com os dias vencidos via SMS | Não | | ImgBase64 | Texto | Base64 do PDF do boleto ou link da imagem do QRCode PIX | Não | | NumeroOperacao | Texto | Número referente a operação da cobrança | 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 | | ClientePagamentosId | Texto | Id do cliente do pagamento | Não | | NotaFiscal | Texto | Nota fiscal da cobrança| Não | ## Headers - `Aeskey` string, required ## Request body - BknBankCobrancasAPIModelsCobranca: Modelo de Cobranças - `Id` string: Id da cobrança - `IdentificadorSequencial` integer: Identificador numérico da cobrança, não pode ser re-configurado - `ClienteId` string, uuid: Id do cliente relacionado a cobrança - `ClienteNome` string: Nome do cliente relacionado a cobrança, somente para retornar dados - `Descricao` string: Descrição da cobrança - `Criacao` string, date-time: Data de criação da cobrança - `Valor` number, double: Valor da cobrança - `Vencimento` string, date-time: Data de vencimento da cobrança - `NaoReceberDepoisDe` string, date-time: Data para não aceitar pagamento da cobrança - `Estado` 'Todos' | 'Pendente' | 'Paga' | 'Inadimplente' | 'PendenteRegistro' | 'Cancelada': Estado da cobrança - `FormasPagamento` 'Nenhum' | 'Boleto' | 'Cartao' | 'Pix' | 'Manual' | 'Protesto' | 'SaldoWebConta': Formas de pagamento da cobrança - `ProdutoId` string, uuid: Id do produto relacionado a cobrança - `Multa` number, double: Valor - `MultaCorrecao` 'Percentual' | 'Valor' | 'Diario' | 'Isento': Forma de correcao da multa (percentual ou valor) - `JurosMes` number, double: Valor - `JurosCorrecao` 'Percentual' | 'Valor' | 'Diario' | 'Isento': Forma de correcao dos juros (percentual ou valor) - `DescontoAteVencimento` number, double: Valor - `DescontoCorrecao` 'Percentual' | 'Valor' | 'Diario' | 'Isento': Forma de correcao do desconto (percentual ou valor) - `Desconto2` number, double: Valor - `DescontoCorrecao2` 'Percentual' | 'Valor' | 'Diario' | 'Isento': Forma de correcao do desconto (percentual ou valor) - `DataDesconto2` string, date-time: O desconto será valido até essa data - `Desconto3` number, double: Valor - `DescontoCorrecao3` 'Percentual' | 'Valor' | 'Diario' | 'Isento': Forma de correcao do desconto (percentual ou valor) - `DataDesconto3` string, date-time: O desconto será valido até essa data - `Instrucao1` string: Instrucao1 em texto - `Instrucao2` string: Instrucao2 em texto - `Instrucao3` string: Instrucao3 em texto - `Instrucao4` string: Instrucao4 em texto - `DadosPagamento` BknBankCobrancasAPIModelsPagamento: Modelo de Pagamento - `Id` string: Id do pagamento - `Situacao` 'pendente' | 'pago' | 'atrasado': Situação do pagamento - `DataPagamento` string, date-time: Data do pagamento - `FormaPagamento` 'Nenhum' | 'Boleto' | 'Cartao' | 'Pix' | 'Manual' | 'Protesto' | 'SaldoWebConta': Forma de pagamento - `DadosPagamento` string: Dados do pagamento - `ValorPago` number, double: Valor pago de pagamento - `ValorPrincipal` number, double: Valor principal de pagamento - `ValorMultaJuros` number, double: Valor multa/juros de pagamento - `NumeroPagamento` string: Número do pagamento - `ValorTaxas` number, double: Valor das taxas de pagamento - `ValorLiquido` number, double: Valor líquido de pagamento - `DataDisponibilizacao` string, date-time: Data de disponibilização pagamento - `ReembolsadoAoCliente` boolean: Indicação de reembolsado ao cliente do pagamento - `Antecipado` boolean: Indicativo se o pagamento foi antecipado - `TransacaoId` string, uuid: Id da Transacao relacionada a este pagamento - `CobrancaId` string, uuid: Id da Cobrança relacionada a este pagamento - `CanalPagamento` integer - `MeioPagamento` integer - `NotificacaoCobrancaDias` integer: Dias antes do vencimento para notificar - `NotificacaoCobrancaEMail` boolean: Notificação via EMail - `NotificacaoCobrancaSMS` boolean: Notificação via SMS - `PrimeiraTentativaHabilitada` boolean: Habilitado primeira tentativa em atraso - `PrimeiraTentativaDias` integer: Dias primeira tentativa em atraso - `PrimeiraTentativaEMail` boolean: Email da primeira tentativa em atraso - `PrimeiraTentativaSMS` boolean: SMS da primeira tentativa em atraso - `SegundaTentativaHabilitada` boolean: Habilitado segunda tentativa em atraso - `SegundaTentativaDias` integer: Dias segunda tentativa em atraso - `SegundaTentativaEMail` boolean: Email da segunda tentativa em atraso - `SegundaTentativaSMS` boolean: SMS da segunda tentativa em atraso - `TerceiraTentativaHabilitada` boolean: Habilitado terceira tentativa em atraso - `TerceiraTentativaDias` integer: Dias terceira tentativa em atraso - `TerceiraTentativaEMail` boolean: Email da terceira tentativa em atraso - `TerceiraTentativaSMS` boolean: SMS da terceira tentativa em atraso - `QuartaTentativaHabilitada` boolean: Habilitado quarta tentativa em atraso - `QuartaTentativaDias` integer: Dias quarta tentativa em atraso - `QuartaTentativaEMail` boolean: Email da quarta tentativa em atraso - `QuartaTentativaSMS` boolean: SMS da quarta tentativa em atraso - `QuintaTentativaHabilitada` boolean: Habilitado Quinta tentativa em atraso - `QuintaTentativaDias` integer: Dias Quinta tentativa em atraso - `QuintaTentativaEMail` boolean: Email da Quinta tentativa em atraso - `QuintaTentativaSMS` boolean: SMS da Quinta tentativa em atraso - `SextaTentativaHabilitada` boolean: Habilitado Sexta tentativa em atraso - `SextaTentativaDias` integer: Dias Sexta tentativa em atraso - `SextaTentativaEMail` boolean: Email da Sexta tentativa em atraso - `SextaTentativaSMS` boolean: SMS da Sexta tentativa em atraso - `SetimaTentativaHabilitada` boolean: Habilitado Sétima tentativa em atraso - `SetimaTentativaDias` integer: Dias Sétima tentativa em atraso - `SetimaTentativaEMail` boolean: Email da Sétima tentativa em atraso - `SetimaTentativaSMS` boolean: SMS da Sétima tentativa em atraso - `OitavaTentativaHabilitada` boolean: Habilitado Oitava tentativa em atraso - `OitavaTentativaDias` integer: Dias Oitava tentativa em atraso - `OitavaTentativaEMail` boolean: Email da Oitava tentativa em atraso - `OitavaTentativaSMS` boolean: SMS da Oitava tentativa em atraso - `NonaTentativaHabilitada` boolean: Habilitado Nona tentativa em atraso - `NonaTentativaDias` integer: Dias Nona tentativa em atraso - `NonaTentativaEMail` boolean: Email da Nona tentativa em atraso - `NonaTentativaSMS` boolean: SMS da Nona tentativa em atraso - `DecimaTentativaHabilitada` boolean: Habilitado Décima tentativa em atraso - `DecimaTentativaDias` integer: Dias Décima tentativa em atraso - `DecimaTentativaEMail` boolean: Email da Décima tentativa em atraso - `DecimaTentativaSMS` boolean: SMS da Décima tentativa em atraso - `ImgBase64` string - `NumeroOperacao` string - `SplitValores` BknBankCobrancasAPIModelsSplitCobrancaRequest[]: Definição do split - `ClientePagamentosId` string, uuid: Id da produto associado ao split - `Valor` number, double: Valor nominal de credito para o participante - `ClientePagamentosId` string, uuid - `NotaFiscal` string ## Response `204` Cobrança atualizada - SystemVoid ## Other responses - `400`: Dados inválidos da cobrança - `401`: Não há permissão para acessar esta cobrança - `404`: Cobrança não encontrada - `500`: Id inválido da cobrança ou erro atualizando cobrança --- [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)