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

De Base de Conhecimentos da DataPlus Sistemas
Ir para navegação Ir para pesquisar
Huriel (discussão | contribs)
Vinicius (discussão | contribs)
Sem resumo de edição
 
(12 revisões intermediárias por 2 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. O E-mail será enviado ao primeiro E-mail cadastrado no cadastro de parceiro.
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.