Boletos DDA

Boletos DDA lista os boletos identificados na rede interbancária com o CNPJ de uma conta DDA como pagador. Cada boleto espera a sua decisão: liberar para pagamento ou rejeitar.

Onde fica no painel

Pagamentos > DDA, ícone Ver Boletos DDA na linha da conta DDA (ou o botão Ver Boletos DDA na tela da conta). A tela de boletos tem o link Contas DDA para voltar.

Como os boletos chegam

• Automaticamente: com a conta DDA ativa, os boletos novos chegam pelo provedor de DDA.
• Sincronizar Boletos: o botão busca no provedor os boletos de todas as contas DDA ativas, com vencimento de hoje até um mês à frente. O período não pode ser escolhido. O painel responde Sincronização de boletos DDA solicitada com sucesso. Aguarde um momento enquanto processamos a operação. Sem conta DDA ativa, responde Não foi possível executar a operação. Não existe conta DDA ativa.

Lista

Coluna	Conteúdo
UID	Identificador do boleto DDA, com botão de copiar.
Situação	Situação do boleto na Kobana (veja abaixo).
Recebedor	Nome e CPF/CNPJ de quem emitiu o boleto.
CNPJ	CNPJ pagador (o da conta DDA).
Nosso Número	Número do título no banco emissor.
Emissão e Vencimento	Datas do boleto.
Valor Nominal	Valor original do boleto.
Valor a Pagar	Valor a pagar.

O ícone de olho abre o boleto. O menu de três pontos tem Liberar para Pagamento, Rejeitar, Ver Pagamento (depois da liberação) e Excluir.

Filtros

Filtrar busca por UID, Conta DDA, Situação, Recebedor, CNPJ/CPF do Recebedor, CNPJ (pagador), Quantia (de/até), Data de Emissão, Data de Vencimento e Data de Criação. O mesmo painel define a Ordenação por UID, Vencimento, Emissão, Valor Nominal ou Valor a Pagar, crescente ou decrescente.

Tela do boleto

O título é Boleto no DDA, seguido do valor e do vencimento. Os dados mostrados: UID, Nome do Banco, Mês de Referência (quando houver), Nosso Número, Emissão, Vencimento, Valor Nominal, Valor do Desconto, Valor da Mora/Multa, Valor do Juros/Encargos, Valor a Pagar, Valor Mínimo, Valor Máximo, Recebedor, Pagador e Situação.

A lateral mostra o Código de Barras e a Linha Digitável, cada um com botão de copiar, e os botões da situação atual.

Liberar para pagamento

1. No boleto Disponível, clique em Liberar esse Boleto para Pagamento (lateral) ou Liberar para Pagamento (menu Ações ou menu da lista).
2. A tela Contas de Pagamento pede: Selecione a conta de pagamento para criar o pagamento do boleto DDA. Ela mostra banco, conta financeira, saldo e integrações de cada conta de pagamento.
3. Clique em Selecionar na conta escolhida e confirme.

A Kobana cria um pagamento de boleto com:

Campo do pagamento	Valor
Quantia	O Valor a Pagar do boleto DDA.
Data de Agendamento	O dia da liberação.
Código de Barras ou Linha Digitável	O código de barras do boleto DDA.
Beneficiário	Nome e CPF/CNPJ do recebedor.
Origem	DDA.

O painel abre o pagamento criado com a mensagem DDA liberado para pagamento com sucesso. O boleto passa para Liberado para Pagamento e a lateral mostra o Link do Pagamento.

O pagamento criado segue o fluxo dos demais: para enviá-lo ao banco, inclua-o num lote em Pagamentos > Gerenciar. Veja Lotes e aprovação.

Regras da liberação

• Só boletos Disponível podem ser liberados.
• A Situação no Banco do boleto precisa estar Aberto. Caso contrário, o painel recusa com o motivo: o boleto já foi pago externamente, foi cancelado pelo emissor, foi baixado do sistema ou está bloqueado.
• O pagamento passa pelas mesmas validações de um pagamento criado à mão, como a validação de saldo da conta de pagamento. Se alguma falhar, o painel mostra Não foi possível liberar o DDA com o erro, e o boleto continua Disponível.
• A tela do boleto lembra que é necessário ter o módulo de pagamentos contratado no plano.

Rejeitar

No boleto Disponível, clique em Rejeitar e confirme: Esta ação irá rejeitar o boleto e não será criado um pagamento. Confirma? O boleto passa para Rejeitado e não volta para a fila de disponíveis.

Excluir

Excluir remove o boleto da lista, depois da confirmação Esta ação irá remover o boleto do sistema. Confirma?

Situações do boleto DDA

Situação na Kobana

Situação	Significado
Disponível	Boleto recebido, aguardando liberação ou rejeição.
Liberado para Pagamento	Um pagamento foi criado a partir do boleto.
Rejeitado	Boleto descartado pelo usuário. Não é possível pagá-lo pela liberação.
Pago	O pagamento foi confirmado.

Disponível ──► Liberado para Pagamento ──► Pago
    │
    ├──► Rejeitado
    └──► Pago

Quando o pagamento criado na liberação é confirmado, o boleto DDA passa para Pago. Um boleto Disponível também pode passar direto para Pago.

Situação no Banco

Situação do título no banco emissor: Aberto, Pago, Cancelado, Baixado ou Bloqueado. A Kobana atualiza esse campo pelo provedor de DDA e pelos pagamentos feitos na própria Kobana.

Eventos de webhook

Evento	Quando
payment.dda.bank_billet.db.created	Boleto DDA novo chegou para o CNPJ.
payment.dda.bank_billet.db.updated	Boleto DDA atualizado (liberado, rejeitado ou pago).
payment.dda.bank_billet.external_status_changed	A situação no banco mudou.

O pagamento criado na liberação dispara os eventos de pagamento, como payment.db.created. Lista completa em Eventos de webhook.

Permissões

Módulo Pagamento, produto Boletos no DDA: Ações Básicas para ver, sincronizar, rejeitar e excluir; Criar para liberar para pagamento.

Pela API

Referência em API v2.