RN AvisoDuplsAVencer: mudanças entre as edições

De Base de Conhecimentos da DataPlus Sistemas
Ir para navegação Ir para pesquisar
Criou página com 'Regra de negócio do tipo habilitadora que pode ser acoplada ao DataPlus ERP e tem por objetivo gerar e-mail notificando os clientes sobre Duplicatas a Receber a vencer. E...'
 
Vinicius (discussão | contribs)
Sem resumo de edição
 
(13 revisões intermediárias por 3 usuários não estão sendo mostradas)
Linha 1: Linha 1:
Regra de negócio do tipo habilitadora que pode ser acoplada ao [[DataPlus ERP]] e tem por objetivo gerar e-mail notificando os clientes sobre Duplicatas a Receber a vencer. Essa regra deve ser testada com cautela.
Regra de negócio do tipo habilitadora que pode ser acoplada ao [[DataPlus ERP]] e tem por objetivo gerar e-mail notificando os clientes sobre Duplicatas a Receber a vencer. Essa regra deve ser testada com cautela.
'''Observação:''' O modelo de mensagem pré-definido para essa regra é: uma variável no cabeçalho, sendo o nome da empresa e 3 variáveis no corpo, sendo: ((1)) = Nome do Cliente, ((2)) - Número da duplicata, ((3)) - Data Vencimento
'''Atenção: '''A regra AvisoDuplsAVencer faz o envio de duplicatas próximas do vencimento, ou seja, todos os dias (dependendo da configuração) ela vai fazer o envio das duplicatas novamente, porém, para empresas que possuem um grande volume de duplicatas para o envio do aviso terão dificuldades de fazer o envio completo de todas as duplicatas com a conta padrão do E-mail, e também do WhatsApp. '''Motivo: '''A conta padrão de alguns servidores '''SMTP''' (E-mail), por exemplo, permitem o envio de 150 mensagens por hora e o WhatsApp com a sua conta padrão, sem fazer a verificação da empresa é 250 (podendo aumentar esse limite para 1.000 verificando a empresa) por dia. Então para uma empresa que possui 3.000 duplicatas pendentes, não vai conseguir fazer o envio completo de todas as duplicatas a vencer, será possível fazer o envio por email de apenas 2.400 (por dia), ficando assim 600 duplicatas pendentes, e apenas de 1.000 (por dia) pelo WhatsApp, ficando 2.000 duplicatas pendentes. Caso a opção da comunicação esteja marcada para enviar mensagem pelo WhatsApp também, será possível fazer o envio de apenas 1.000 (por dia), pois é o limite que o servidor do WhatsApp permite. Ou seja, para empresas que possuem uma determinada quantidade de duplicatas para o aviso, será preciso se adequar a um tipo de conta que comporte todo esse volume.
Para gerar o boleto é preciso definir um caminho padrão para armazenamento, o diretório deve ser informado aqui:
[[Arquivo:Diretorio boletos.png|centro]]


== Acoplamento ==
== Acoplamento ==
Essa regra de negócio só poderá ser acoplada ao [''infra.ControleAvisos'']. Ela está preparada para funcionar com designador Execucao em conjunto com o elemento ''ProcessaAvisos'', no tempo de execução Antes.
Essa regra de negócio só poderá ser acoplada ao '''[''infra.ControleAvisos'']'''. Ela está preparada para funcionar com designador '''Execucao''' em conjunto com o elemento ''' ''ProcessaAvisos'' ''', no tempo de execução '''Antes'''.


== Parâmetros ==
== Parâmetros ==
Linha 12: Linha 18:


'''RepetirEnvioAteVespera:''' Define se a regra deve enviar e-mail de aviso até o dia que antecede o seu vencimento;
'''RepetirEnvioAteVespera:''' Define se a regra deve enviar e-mail de aviso até o dia que antecede o seu vencimento;
'''TagCliente:''' Define qual a descrição (Tag) do e-mail do cadastro do cliente será utilizado para enviar o e-mail de aviso da duplicata a vencer;


'''Remetente:''' Endereço de e-mail que irá ser usado para enviar o alerta de vencimento ao cliente;
'''Remetente:''' Endereço de e-mail que irá ser usado para enviar o alerta de vencimento ao cliente;
Linha 19: Linha 27:
'''UsuarioSMTP:''' Usuário para o envio, geralmente é o mesmo que o remetente;
'''UsuarioSMTP:''' Usuário para o envio, geralmente é o mesmo que o remetente;


'''SenhaSMTP: Senha do e-mail remetente;'''
'''SenhaSMTP:''' Senha do e-mail remetente;


'''Porta:''' Porta de saída do servidor de e-mails, geralmente é 587;
'''Porta:''' Porta de saída do servidor de e-mails, geralmente é 587;
Linha 32: Linha 40:


'''Rodapé:''' Assinatura do Departamento e/ou Empresa (detalhes da duplicata são adicionados antes desse bloco);
'''Rodapé:''' Assinatura do Departamento e/ou Empresa (detalhes da duplicata são adicionados antes desse bloco);
'''CorpoPersonalizado:''' Habilita a personalização do e-mail a ser enviado, definido nas propriedades anteriores. Se desmarcado, mantém o e-mail como o padrão configurado na RN;


'''CopiaRemetente:''' Habilita o uso do recurso CC (Com Cópia). Remetente recebe uma cópia do e-mail;
'''CopiaRemetente:''' Habilita o uso do recurso CC (Com Cópia). Remetente recebe uma cópia do e-mail;


'''UltimaData:''' Última data usada as buscas de [[Duplicatas]].
'''GeraLogE-mail:''' Uma vez selecionado, gera log dos e-mails enviados. O log ficara em arquivo XML na pasta ''users/administrador/local'', com o mesmo nome da RN. (Mesma pasta do DpSettings)
 
'''ModoEnvioArquivo:''' Define o modo de envio do arquivo (Link ou PDF). Tag Ex: #pdf# ou #link#. Obs: Se vazio envia somente o link, pois somente com o Link o boleto já vai anexado.
 
'''CompartilhamentoLivre:''' Se marcado: o compartilhamento do link podera ser acessado por qualquer um. Se desmarcado: apenas para o destinatario.
 
'''QuantidadeEmailsHora:''' Quantidade de E-mails que o servidor permite para envio por hora.
 
'''EnviarMensagemWhatsApp:''' Se marcado o envio será feito por email e WhatsApp (Caso um deles exceda o limite, o envio é abortado).
 
'''EnviarSomenteWhatsApp:''' Se marcado o envio será feito somente pelo WhatsApp.
 
'''TemplateMensagemLink:''' Nome do modelo de mensagem para envio do boleto por Link no WhatsApp. *Configuração necessária somente para API Oficial.
 
'''TemplateMensagemPdf:''' Nome do modelo de mensagem para envio do boleto por PDF no WhatsApp. *Configuração necessária somente para API Oficial.
 
'''QuantidadeMensagemWhatsAppDia:''' Quantidade de mensagens que o WhatsApp permite para envio no dia. *Configuração necessária somente para API Oficial.


'''GeraLogE-mail:''' Uma vez selecionado, gera log dos e-mails enviados. O log ficara em arquivo XML na pasta ''users/administrador/local''. (Mesma pasta do DpSettings)
'''UsuarioParaNotificacao:''' Código dos usuários que receberão a notificação. (Separar por virgulas).


== Funcionamento ==
== Funcionamento ==
Se essa regra estiver ativa, quando o software de [[Controle de Avisos]] em execução no servidor (dpServerApp) detectar uma [[Duplicata]] vencida, será gerado um aviso para o usuário setado, e automaticamente será disparado um e-mail de cobrança para o cliente, informando o pagamento pendente.
Se essa regra estiver ativa, quando o software de [[Controle de Avisos]] em execução no servidor (dpServerApp) detectar uma [[Duplicata]] a vencer automaticamente será disparado um e-mail de cobrança para o cliente, informando o pagamento a vencer. O e-mail será enviado ao endereço que tenha a TAG configurada na RN, pela propriedade "TagCliente".


== Marcadores ==
== Marcadores ==

Edição atual tal como às 16h22min de 30 de julho de 2025

Regra de negócio do tipo habilitadora que pode ser acoplada ao DataPlus ERP e tem por objetivo gerar e-mail notificando os clientes sobre Duplicatas a Receber a vencer. Essa regra deve ser testada com cautela. Observação: O modelo de mensagem pré-definido para essa regra é: uma variável no cabeçalho, sendo o nome da empresa e 3 variáveis no corpo, sendo: ((1)) = Nome do Cliente, ((2)) - Número da duplicata, ((3)) - Data Vencimento

Atenção: A regra AvisoDuplsAVencer faz o envio de duplicatas próximas do vencimento, ou seja, todos os dias (dependendo da configuração) ela vai fazer o envio das duplicatas novamente, porém, para empresas que possuem um grande volume de duplicatas para o envio do aviso terão dificuldades de fazer o envio completo de todas as duplicatas com a conta padrão do E-mail, e também do WhatsApp. Motivo: A conta padrão de alguns servidores SMTP (E-mail), por exemplo, permitem o envio de 150 mensagens por hora e o WhatsApp com a sua conta padrão, sem fazer a verificação da empresa é 250 (podendo aumentar esse limite para 1.000 verificando a empresa) por dia. Então para uma empresa que possui 3.000 duplicatas pendentes, não vai conseguir fazer o envio completo de todas as duplicatas a vencer, será possível fazer o envio por email de apenas 2.400 (por dia), ficando assim 600 duplicatas pendentes, e apenas de 1.000 (por dia) pelo WhatsApp, ficando 2.000 duplicatas pendentes. Caso a opção da comunicação esteja marcada para enviar mensagem pelo WhatsApp também, será possível fazer o envio de apenas 1.000 (por dia), pois é o limite que o servidor do WhatsApp permite. Ou seja, para empresas que possuem uma determinada quantidade de duplicatas para o aviso, será preciso se adequar a um tipo de conta que comporte todo esse volume.

Para gerar o boleto é preciso definir um caminho padrão para armazenamento, o diretório deve ser informado aqui:

Acoplamento

Essa regra de negócio só poderá ser acoplada ao [infra.ControleAvisos]. Ela está preparada para funcionar com designador Execucao em conjunto com o elemento ProcessaAvisos , no tempo de execução Antes.

Parâmetros

GeraAvisosRepetitivos: Gera mais de um aviso para a mesma Duplicata em dias diferentes. É recomendável deixar esta opção desabilitada pois poderá gerar inúmeros avisos e e-mails em um mesmo dia;

FiltroSituacoes: Caso esteja vazio, não exerce qualquer filtro sobre as duplicatas. Caso esteja informado filtra apenas as duplicatas cuja Situação tenha o código contido no Filtro. A análise é feita considerando três caracteres. Exemplo de filtro por situação: 001***002 - nesse exemplo vai gerar aviso apenas das duplicatas que tenham situação de código 1 ou 2;

DiasParaOVencimento: Define com quantos dias de antecedência ao vencimento o e-mail deve ser enviado;

RepetirEnvioAteVespera: Define se a regra deve enviar e-mail de aviso até o dia que antecede o seu vencimento;

TagCliente: Define qual a descrição (Tag) do e-mail do cadastro do cliente será utilizado para enviar o e-mail de aviso da duplicata a vencer;

Remetente: Endereço de e-mail que irá ser usado para enviar o alerta de vencimento ao cliente;

ServidorSMTP: Protocolo de saída do e-mail remetente. Exemplo: smtp.dataplussistemas.com.br;

UsuarioSMTP: Usuário para o envio, geralmente é o mesmo que o remetente;

SenhaSMTP: Senha do e-mail remetente;

Porta: Porta de saída do servidor de e-mails, geralmente é 587;

HabilitaSSL: Habilita o uso de conexão segura (SSL) para enviar o e-mail;

Assunto: Assunto do E-mail;

Saudação: Saudação usada no e-mail;

Corpo: Mensagem do e-mail (detalhes da duplicata são adicionados automaticamente após esse bloco);

Rodapé: Assinatura do Departamento e/ou Empresa (detalhes da duplicata são adicionados antes desse bloco);

CorpoPersonalizado: Habilita a personalização do e-mail a ser enviado, definido nas propriedades anteriores. Se desmarcado, mantém o e-mail como o padrão configurado na RN;

CopiaRemetente: Habilita o uso do recurso CC (Com Cópia). Remetente recebe uma cópia do e-mail;

GeraLogE-mail: Uma vez selecionado, gera log dos e-mails enviados. O log ficara em arquivo XML na pasta users/administrador/local, com o mesmo nome da RN. (Mesma pasta do DpSettings)

ModoEnvioArquivo: Define o modo de envio do arquivo (Link ou PDF). Tag Ex: #pdf# ou #link#. Obs: Se vazio envia somente o link, pois somente com o Link o boleto já vai anexado.

CompartilhamentoLivre: Se marcado: o compartilhamento do link podera ser acessado por qualquer um. Se desmarcado: apenas para o destinatario.

QuantidadeEmailsHora: Quantidade de E-mails que o servidor permite para envio por hora.

EnviarMensagemWhatsApp: Se marcado o envio será feito por email e WhatsApp (Caso um deles exceda o limite, o envio é abortado).

EnviarSomenteWhatsApp: Se marcado o envio será feito somente pelo WhatsApp.

TemplateMensagemLink: Nome do modelo de mensagem para envio do boleto por Link no WhatsApp. *Configuração necessária somente para API Oficial.

TemplateMensagemPdf: Nome do modelo de mensagem para envio do boleto por PDF no WhatsApp. *Configuração necessária somente para API Oficial.

QuantidadeMensagemWhatsAppDia: Quantidade de mensagens que o WhatsApp permite para envio no dia. *Configuração necessária somente para API Oficial.

UsuarioParaNotificacao: Código dos usuários que receberão a notificação. (Separar por virgulas).

Funcionamento

Se essa regra estiver ativa, quando o software de Controle de Avisos em execução no servidor (dpServerApp) detectar uma Duplicata a vencer automaticamente será disparado um e-mail de cobrança para o cliente, informando o pagamento a vencer. O e-mail será enviado ao endereço que tenha a TAG configurada na RN, pela propriedade "TagCliente".

Marcadores

Com envio em massa, se faz necessário o uso de marcadores para personalizar as mensagens. Use-os nos parâmetros Assunto, Saudação, Corpo e Rodapé.

#Numero#: Número da Duplicata;

#Cliente#: Nome do Cliente;

#Valor#: Valor da Duplicata;

#Emissao#: Data de Emissão;

#Vencto#: Data de Vencimento;

#Emitente#: Emitente da Duplicata (Empresa Ativa);

#Linha#: Por padrão, os blocos possuem uma quebra de linha, use esse marcador quando for necessário quebrar a linha do texto ou adicionar espaço entre os blocos. Não funciona no parâmetro Assunto.