01. DADOS GERAIS

Produto:

Linha de Produto:

Segmento:

Tipo de Documento:

Inovação

Módulo:Portal Corporativo
Caminho: Portal Corporativo > Financeiro > Consulta de Títulos Financeiros > Consulta de Títulos Financeiros – PORTALCLI001
Função:Consulta de Títulos Financeiros – PORTALCLI001
País:Brasil
Ticket:
Requisito/Story/Issue (informe o requisito relacionado) :DSUPFORCE-85

02. SITUAÇÃO/REQUISITO

O novo Worker Service de envio de boletos por e-mail foi desenvolvido para substituir o job atualmente existente no banco de dados. Essa inovação traz maior flexibilidade, automação e controle ao processo de envio de boletos, eliminando dependências diretas do banco e facilitando a gestão do serviço. A alteração foi motivada pela necessidade de remover requisições HTTP feitas diretamente pelo banco de dados, eliminar a obrigatoriedade de configuração de servidor wallet para autenticação e simplificar a implantação do serviço em ambientes cloud.

Com a migração do processo, o Worker Service executa o envio automaticamente, sem necessidade de configurações complexas, podendo ser implantado em qualquer ambiente cloud. Em caso de erro, se um envio falhar, o serviço registra o erro e tenta novamente, sem afetar o banco de dados ou outros processos.

03. PRÉ-REQUISITOS

Publicação do pacote GerenciaBoletoServico.

Configurar contatos para envio do e-mail na aplicação de Pessoa.

Configurar o template de envio de boleto por e-mail na aplicação Configuração para Envio de Boletos por E-mail.

Selecionar os boletos para envio na aplicação Emissão de Duplicatas/Boletos - FIEMIDUPLIC.


Alterações ou parametrizações incorretas podem comprometer o desempenho e causar falhas no sistema. Sempre que necessário, consulte um especialista ou a equipe responsável para garantir a configuração correta.

04. SOLUÇÃO

O Worker Service de envio de boletos por e-mail foi implementado para substituir a execução do processo anteriormente realizado por job no banco de dados. O serviço realiza a leitura dos títulos selecionados na aplicação Emissão de Duplicatas/Boletos, considerando a empresa mãe como referência, e organiza os envios de forma agrupada por cliente.

Imagem 1 - Template de envio de e-mail.


Para otimizar a comunicação e evitar excesso de informações em um único envio, o serviço limita a quantidade de boletos anexados a 12 por e-mail. Nos casos em que o cliente possua número superior de boletos, os excedentes são automaticamente agendados para processamento e envio na próxima execução do Worker Service. Adicionalmente, os boletos gerados passam a disponibilizar, quando suportado pelo banco de registro, a opção de pagamento via QR Code.

Imagem 2 - Exemplo de boleto com QRCode.


Essa solução promove maior controle e rastreabilidade do processo, reduz a dependência de configurações específicas no banco de dados, e assegura maior aderência aos ambientes cloud, contribuindo para a simplificação da manutenção, escalabilidade e resiliência operacional.


Imagem 3 - Exemplo do e-mail com boletos em anexo.


A partir da versão 26.01.001, a package PKG_FIENVIABOLETOEMAIL, anteriormente responsável pelo envio de boletos por e-mail, será descontinuada. Com essa mudança, todos os jobs que a referenciam serão invalidados e deixarão de ser necessários, uma vez que o processo de envio passa a ser realizado integralmente pelo Worker Service.


05. REQUISITOS DE VERSÃO

Se estiver na versão 26.01, atualize para o service pack 26.01.001 ou superior.

06. DOCUMENTOS RELACIONADOS

DOCUMENTO(S) DE REFERÊNCIA