--- title: "Insere uma cobrança" method: POST path: "/api/Cobranca" tags: ["Cobranca"] --- # Insere uma cobrança `POST /api/Cobranca` Esta API permite que seja inserido uma nova cobrança, através dos dados do cliente. ### Requisição | **Campo** | **Tipo** | **Descrição** | **Obrigatório** | |--|--|--|--| | ClienteId | GUID | Identificador único do cliente | Sim | | ClienteNome | Texto | Nome do cliente relacionado a cobrança | Não | | Descricao | Texto | Descrição com mais detalhes sobre a cobrança | Sim | | Valor | Data | 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 | | Tipo | Texto | Tipo da cobrança, sendo possível apenas avulsa | Não | | Estado | Texto | Situação da cobrança | Não | | 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 aplicado na cobrança | Não | | MultaCorrecao | Texto | Tipo da multa a ser aplicada | Não | | JurosMes | Numérico | Juros mensais aplicados sobre o valor da cobrança | Não | | JurosCorrecao | Texto | Tipo do juros a ser aplicado | Não | | DescontoAteVencimento | Numérico | Desconto aplicado até a data do vencimento | Não | | DescontoCorrecao | Texto | Tipo do desconto a ser aplicado | 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 | | DadosPagamento | Objeto | Situação sobre os dados do pagamento da cobrança, contendo ID, situação, Data/Forma/Dados do pagamento, Valor Pago/Principal/ Multa Juros/ Taxa/ Líquido, Número Pagamento, Data da disponibilização, Reembolso ao Cliente e Antecipado | Não | | NotificacaoCobrancaDias | Numérico | 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 | | PrimeiraTentativaHabilitada | Booleano| Primeira tentativa de notificação com os dias vencidos | Não | | PrimeiraTentativaDias | Numérico | 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 | Numérico | 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 | Numérico | 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 | Numérico | 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 | Quarta tentativa de notificação com os dias vencidos | Não | | QuintaTentativaDias | Numérico | Número de dias vencidos | Não | | QuintaTentativaEmail | Booleano| Quarta tentativa de notificação com os dias vencidos via e-mail | Não | | QuintaTentativaSMS | Booleano | Quarta tentativa de notificação com os dias vencidos via SMS | Não | | SextaTentativaHabilitada | Booleano | Quarta tentativa de notificação com os dias vencidos | Não | | SextaTentativaDias | Numérico | Número de dias vencidos | Não | | SextaTentativaEmail | Booleano| Quarta tentativa de notificação com os dias vencidos via e-mail | Não | | SextaTentativaSMS | Booleano | Quarta tentativa de notificação com os dias vencidos via SMS | Não | | SetimaTentativaHabilitada | Booleano | Quarta tentativa de notificação com os dias vencidos | Não | | SetimaTentativaDias | Numérico | Número de dias vencidos | Não | | SetimaTentativaEmail | Booleano| Quarta tentativa de notificação com os dias vencidos via e-mail | Não | | SetimaTentativaSMS | Booleano | Quarta tentativa de notificação com os dias vencidos via SMS | Não | | OitavaTentativaHabilitada | Booleano | Quarta tentativa de notificação com os dias vencidos | Não | | OitavaTentativaDias | Numérico | Número de dias vencidos | Não | | OitavaTentativaEmail | Booleano| Quarta tentativa de notificação com os dias vencidos via e-mail | Não | | OitavaTentativaSMS | Booleano | Quarta tentativa de notificação com os dias vencidos via SMS | Não | | NonaTentativaHabilitada | Booleano | Quarta tentativa de notificação com os dias vencidos | Não | | NonaTentativaDias | Numérico | Número de dias vencidos | Não | | NonaTentativaEmail | Booleano| Quarta tentativa de notificação com os dias vencidos via e-mail | Não | | NonaTentativaSMS | Booleano | Quarta tentativa de notificação com os dias vencidos via SMS | Não | | DecimaTentativaHabilitada | Booleano | Quarta tentativa de notificação com os dias vencidos | Não | | DecimaTentativaDias | Numérico | Número de dias vencidos | Não | | DecimaTentativaEmail | Booleano| Quarta tentativa de notificação com os dias vencidos via e-mail | Não | | DecimaTentativaSMS | Booleano | Quarta tentativa de notificação com os dias vencidos via SMS | Não | | ImgBase64 | Imagem | Imagem | Não | | NumeroOperacao | Numérico | Número referente a operação da cobrança | Não | | SplitValores | Array | 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| Não | | ClientePagamentosId | GUID | Id do cliente do pagamento | Não | | NotaFiscal | Texto | Nota fiscal da Cobrança | Não | ## Headers - `Aeskey` string, required ## Request body - BknBankCobrancasAPIModelsCobrancaPostModel - `Id` string - `IdentificadorSequencial` integer - `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 - `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 — Multa percentual da cobrança - `MultaCorrecao` 'Percentual' | 'Valor' | 'Diario' | 'Isento' — Forma de correcao da multa (percentual ou valor) - `JurosMes` number, double — Juros mensal percentual da cobrança - `JurosCorrecao` 'Percentual' | 'Valor' | 'Diario' | 'Isento' — Forma de correcao dos juros (percentual ou valor) - `DescontoAteVencimento` number, double — Desconto percentual até o vencimento da cobrança - `DescontoCorrecao` 'Percentual' | 'Valor' | 'Diario' | 'Isento' — Forma de correcao do desconto (percentual ou valor) - `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 - `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 Setima tentativa em atraso - `SetimaTentativaDias` integer — Dias Setima tentativa em atraso - `SetimaTentativaEMail` boolean — Email da Setima tentativa em atraso - `SetimaTentativaSMS` boolean — SMS da Setima 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 Decima tentativa em atraso - `DecimaTentativaDias` integer — Dias Decima tentativa em atraso - `DecimaTentativaEMail` boolean — Email da Decima tentativa em atraso - `DecimaTentativaSMS` boolean — SMS da Decima 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 `200` OK - object ## Other responses - `201` — Cobrança criada - `400` — Dados inválidos da cobrança - `500` — Erro criando cobrança --- [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)