Boleto DDA

O DDA (Débito Direto Autorizado) é um serviço do sistema bancário brasileiro que permite a centralização eletrônica dos boletos de cobrança emitidos contra um CNPJ ou CPF. Por meio do DDA, os boletos deixam de ser enviados em papel ou por e-mail e passam a ser disponibilizados diretamente no internet banking da instituição financeira do sacado.

Nesse modelo, o banco recebe as informações do boleto registradas pelo emissor e as apresenta ao cliente de forma digital, possibilitando visualização, conferência e pagamento dentro do próprio ambiente bancário. O DDA não realiza o débito automaticamente, sendo necessária a autorização do usuário para efetuar o pagamento.

Portanto, visando acompanhar os métodos mais modernos do sistema bancário, trouxemos essa funcionalidade ao sistema para permitir ao usuário a emissão utilizando o sistema DDA, inicialmente apenas com o banco Sicoob.

Configurações

:::important Importante Para habilitar a geração de boletos via DDA, entre em contato com a equipe comercial para contratação do serviço. :::

Para realizar a configuração, foram criados alguns campos novos na janela "Integração Bancária":

• Gerar Via Integração: Quando marcado irá gerar usando a integração com a API do banco informado no campo integração.
  • Visível quando "Gerar CNAB" estiver desmarcado e "Gerar Boleto" estiver marcado;
• Consultar Boletos DDA: Flag que mostra se irá consultar boleto DDA.
  • Visível quando "Gerar Via Integração" estiver marcado;
• ID Integração Webhook: Quando Registrado no Sicoob, é retornado um id do webhook, salvo aqui.
  • Visível quando "Gerar Via Integração" estiver marcado;
• Código da Espécie de Documento: Espécie do Documento, campo tipo lista com os valores já cadastrados.
  • Visível quando "Gerar Via Integração" estiver marcado;
• Modalidade do Boleto de Recebimento: Número que identifica a modalidade do boleto.
  • Visível quando "Gerar Via Integração" estiver marcado;
• Ocorrência Bancária de Liquidação: Registra ocorrências bancárias do tipo Liquidação ('L').
  • Visível quando "Gerar Via Integração" estiver marcado;
• Email Integração Bancária: Email que é atrelado ao webhook para o banco.
  • Visível quando "Gerar Via Integração" estiver marcado;

Deve ser informado o "Gerador de Dígito Verificador" da Sicoob (org.brerp.bancosbrasileiros.util.NossoNumeroSicoob).

Também devem ser preenchidos os campos de Conta, Número do Convênio, Número da Agência, Número da Conta e os dígitos.

Após configurar todos os campos necessários informados acima, deverá ser executado o processo Cadastrar Webhook Cobrança de Recebimento.

Geração

Após configurar a integração e adicionar o ID do Webhook, ela estará disponível no formulário "Geração de Boletos"

Ao gerar o boleto, irá aparecer em sua tela o mesmo, já sendo possível realizar o pagamento sem ser necessário enviar ao banco.

Após o pagamento ser realizado pelo cliente, o título irá automaticamente ser baixado no sistema, dentro de um prazo de até 24 horas. Ao alterar a data de vencimento ou adicionar desconto/multa/juros, também será atualizado no prazo acima.

O boleto gerado irá aparecer janela "Título Bancário" e possuirá as flags "Boleto Gerado" e "Gerado Via Integração API" marcadas.

Também foram adicionados os processos abaixo na janela Título Bancário:

• "Negativar Pagador"
• "Cancelar Apontamento de Negativação de Pagador"
• "Baixar Negativação"
• "Protestar Boleto"
• "Cancelar Apontamento de Protesto"
• "Desistir de Protesto de Boleto"

:::warning Cuidado ao executar! Somente usar esses processos caso for realmente necessário, pois ao serem executados, eles irão enviar as informações direto ao banco. :::

Consulta DDA

Para a utilização da Consulta DDA de boletos emitidos contra você, foi criada uma nova info "Informações Boletos DDA" e uma janela "Boletos DDA".

Na info, será possível executar o processo Consultar Boleto DDA, que irá realizar a consulta de boletos DDA e atualizar as informações destes de acordo com o retorno das informações pelo banco.

Os boletos que forem encontrados, estarão disponíveis na janela Boletos DDA: