RN AvisoDuplsReceberVencidas: 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 habilitar o monitoramento e geração de avisos, a cada dia, sobre quais pr...'
 
Vinicius (discussão | contribs)
Sem resumo de edição
 
(6 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 habilitar o monitoramento e geração de avisos, a cada dia, sobre quais produtos atingiram o estoque mínimo. Essa regra filtra duplicatas que tenham vencido dois dias atrás, estejam abertas, não descontadas e não sejam resultado de uma operação por cartão de crédito/débito.
Regra de negócio do tipo Habilitadora que pode ser acoplada ao [[DataPlus ERP]] e tem por objetivo habilitar o monitoramento e geração de avisos, a cada dia, sobre duplicatas a receber que estejam vencidas. Essa regra filtra duplicatas que tenham vencido '''dois dias atrás''', estejam abertas, não descontadas e não sejam resultado de uma operação por cartão de crédito/débito.


Essa regra pode também enviar e-mail para o cliente, notificando sobre o vencimento.
Essa regra pode também enviar e-mail para o cliente e mensagens pelo whatsapp, notificando sobre o vencimento. É preciso testar com cautela, quando a opção de enviar e-mail estiver habilitada.
 
Atenção: A regra AvisoDuplsReceberVencidas 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]]




Linha 10: Linha 15:
'''GeraAvisosRepetitivos:''' Se verdadeiro, habilita a geração de avisos mais de uma vez no mesmo dia. (Em produção, manter este parâmetro desmarcado);
'''GeraAvisosRepetitivos:''' Se verdadeiro, habilita a geração de avisos mais de uma vez no mesmo dia. (Em produção, manter este parâmetro desmarcado);


'''UsuarioParaNotificacao:''' Código do usuário que receberá a notificação dos avisos.
'''DiasEmail:''' Indica por quantos dias será enviado o e-mail ao cliente, enquanto a duplicata permanecer aberta.
 
'''DiasVencida:''' Define quantos dias o sistema aguardará até considerar a duplicata vencida. Lembrando que por padrão, a RN considera 2 dias, então, caso seja informado "1" nessa propriedade o ERP irá considerar 3 dias.  


'''EnviaEmail:''' Enviar e-mail de notificação para o Cliente.
'''FiltroSituaçoes:''' Lista quais Situações de Cobrança deverão ser consideradas para gerar o aviso. Caso esteja em branco, todas as situações são consideradas.
 
'''UsuarioParaNotificacao:''' Código do usuário que receberá a notificação dos avisos. Podem ser informados diversos usuários, sempre separados por vírgula. Ex.: "1,2,5"
 
'''EnviaEmail:''' Habilita ou desabilita o envio do e-mail de notificação para o Cliente.
 
'''TagCliente:''' Descrição (tag) do e-mail constante no cadastro do cliente, para ser considerado.


'''Remetente:''' Endereço de e-mail do remetente. Deverá ser informado o endereço de e-mail que irá constar como remetente na mensagem enviada.
'''Remetente:''' Endereço de e-mail do remetente. Deverá ser informado o endereço de e-mail que irá constar como remetente na mensagem enviada.
Linha 35: Linha 48:


'''CopiaRemetente:''' Define se uma cópia do e-mail deve ser enviada para o remetente.
'''CopiaRemetente:''' Define se uma cópia do e-mail deve ser enviada para o remetente.
'''NotificarRepresentante:''' Define se o representante vinculado ao cliente também será notificado.
'''TagRepresentante:''' Define a tag de envio de email cadastrada no cadastro do representante.


'''GeraLogEmail:''' Define se a regra deve gerar um arquivo de log com todos os e-mails enviados com sucesso. Caso esse parâmetro seja verdadeiro, é gerado um arquivo texto na mesma pasta da aplicação com o nome AivosDuplsReceberVencidas.log
'''GeraLogEmail:''' Define se a regra deve gerar um arquivo de log com todos os e-mails enviados com sucesso. Caso esse parâmetro seja verdadeiro, é gerado um arquivo texto na mesma pasta da aplicação com o nome AivosDuplsReceberVencidas.log


'''ModoEnvioArquivo:''' Define o modo de envio do arquivo (Link ou PDF). Tag Ex: #pdf# ou #link#. Obs: Se vázio envia somente o link, pois somente com o Link o boleto já vai anexado.
'''QuantidadeEmailsHora:''' Quantidade de E-mails que o servidor permite para envio por hora.
'''EnviarMensagemWhatsApp:''' Se marcado o envio será feito por email e 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.


Os parâmetros Assunto, Saudacao, Corpo e Rodape, podem utilizar variáveis de substituição dos dados, para compor as mensagens, são elas:
Os parâmetros Assunto, Saudacao, Corpo e Rodape, podem utilizar variáveis de substituição dos dados, para compor as mensagens, são elas:
Linha 47: Linha 75:
#Vencto# : Data de Vencimento
#Vencto# : Data de Vencimento
#Emitente# : Emitente da Duplicata (Empresa Ativa)
#Emitente# : Emitente da Duplicata (Empresa Ativa)
#Linha# : Por padrão, os blocos possuem uma quebra de linha,use esse marcador quando quiser quebrar a linha do texto ou adicionar espaço entre os blocos
#Linha# : Por padrão, os blocos possuem uma quebra de linha, use esse marcador quando quiser quebrar a linha do texto ou adicionar espaço entre os blocos

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

Regra de negócio do tipo Habilitadora que pode ser acoplada ao DataPlus ERP e tem por objetivo habilitar o monitoramento e geração de avisos, a cada dia, sobre duplicatas a receber que estejam vencidas. Essa regra filtra duplicatas que tenham vencido dois dias atrás, estejam abertas, não descontadas e não sejam resultado de uma operação por cartão de crédito/débito.

Essa regra pode também enviar e-mail para o cliente e mensagens pelo whatsapp, notificando sobre o vencimento. É preciso testar com cautela, quando a opção de enviar e-mail estiver habilitada.

Atenção: A regra AvisoDuplsReceberVencidas 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 deve ser acoplada ao formulário de Controle de Avisos (Infra.ControleAvisos). Ela esta preparada para funcionar com designador Execucao em conjunto com o elemento ProcessaAvisos, no tempo de execução Antes.

Parâmetros

GeraAvisosRepetitivos: Se verdadeiro, habilita a geração de avisos mais de uma vez no mesmo dia. (Em produção, manter este parâmetro desmarcado);

DiasEmail: Indica por quantos dias será enviado o e-mail ao cliente, enquanto a duplicata permanecer aberta.

DiasVencida: Define quantos dias o sistema aguardará até considerar a duplicata vencida. Lembrando que por padrão, a RN considera 2 dias, então, caso seja informado "1" nessa propriedade o ERP irá considerar 3 dias.

FiltroSituaçoes: Lista quais Situações de Cobrança deverão ser consideradas para gerar o aviso. Caso esteja em branco, todas as situações são consideradas.

UsuarioParaNotificacao: Código do usuário que receberá a notificação dos avisos. Podem ser informados diversos usuários, sempre separados por vírgula. Ex.: "1,2,5"

EnviaEmail: Habilita ou desabilita o envio do e-mail de notificação para o Cliente.

TagCliente: Descrição (tag) do e-mail constante no cadastro do cliente, para ser considerado.

Remetente: Endereço de e-mail do remetente. Deverá ser informado o endereço de e-mail que irá constar como remetente na mensagem enviada.

ServidorSMTP: Servidor de e-mails SMTP que será utilizado. Ex: smtp.gmail.com

UsuarioSMTP: Usuário válido para ser autenticado no Servidor informado. Ex: dataplus@dataplussistemas.com.br

SenhaSMTP: Senha da conta SMTP informada.

Porta: Porta IP para ser utilizada na autenticação no servidor. Ex: 485

HabilitaSSL: Habilita o uso de conexão segura (SSL). Essa configuração é necessária para alguns servidores de e-mail, exemplo: gmail

Assunto: Assunto/Título do E-mail.

Saudacao: Saudação do E-mail.

Corpo: Corpo do E-mail.

Rodape: Rodapé do E-mail.

CopiaRemetente: Define se uma cópia do e-mail deve ser enviada para o remetente.

NotificarRepresentante: Define se o representante vinculado ao cliente também será notificado.

TagRepresentante: Define a tag de envio de email cadastrada no cadastro do representante.

GeraLogEmail: Define se a regra deve gerar um arquivo de log com todos os e-mails enviados com sucesso. Caso esse parâmetro seja verdadeiro, é gerado um arquivo texto na mesma pasta da aplicação com o nome AivosDuplsReceberVencidas.log

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

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

EnviarMensagemWhatsApp: Se marcado o envio será feito por email e 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.

Os parâmetros Assunto, Saudacao, Corpo e Rodape, podem utilizar variáveis de substituição dos dados, para compor as mensagens, são elas:

  1. Numero# : Número da Duplicata
  2. Cliente# : Cliente
  3. Valor# : Valor da Duplicata
  4. Emissao# : Data de Emissão
  5. Vencto# : Data de Vencimento
  6. Emitente# : Emitente da Duplicata (Empresa Ativa)
  7. Linha# : Por padrão, os blocos possuem uma quebra de linha, use esse marcador quando quiser quebrar a linha do texto ou adicionar espaço entre os blocos