Histórico da Página
Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
---|
Informações Gerais
Especificação | |||
Produto | Microsiga Protheus | Módulo | SIGAFIN |
Segmento Executor | Serviços & Juridico | ||
Projeto1 | M_CTR0 | IRM1 | PCREQ-XXXX |
Requisito1 | PCREQ-XXXX | Subtarefa1 |
|
Chamado2 |
| ||
Release de Entrega Planejada | 12.1.8 | Réplica |
|
País | ( ) Brasil ( ) Argentina ( ) Mexico ( ) Chile ( ) Paraguai ( ) Equador ( ) USA ( ) Colombia ( x ) Outro: Todos. | ||
Outros | <Caso necessário informe outras referências que sejam pertinentes a esta especificação. Exemplo: links de outros documentos ou subtarefas relacionadas>. |
Legenda: 1 – Inovação 2 – Manutenção (Os demais campos devem ser preenchidos para ambos os processos).
Objetivo
Desenvolver uma rotina para envio, por e-mail, de avisos de pagamento ao fornecedor após a baixa dos títulos a pagar.
Rotina | Tipo de Operação | Opção de Menu | Regras de Negócio |
FINA815 - Aviso de Pagamento | Criação | Miscelânea -> Envio -> Aviso de Pagamento | - |
FINR815 - Aviso de Pagamento | Criação | Não se aplica | - |
Definição da Regra de Negócio
O processo de envio de aviso de pagamento aos fornecedores tem como objetivo minimizar o recebimento de ligações de fornecedores perguntando sobre pagamento de faturas, juntamente com o desejo da agência em ser proativa no relacionamento com seus fornecedores, informando-os sobre a efetivação dos seus pagamentos.
A rotina desenvolvida fará uma avaliação das baixas ocorridas no período selecionado pelo usuário e enviará um e-mail aos fornecedores, informando-os sobre a efetivação do pagamento.
Esta rotina está disponível para acionamento a qualquer instante pelo usuário, ou até mesmo, poderá ser configurada para execução periódica via agendamento (Schedule).
Considerações:
- A rotina sempre enviará o e-mail de aviso de pagamento para os títulos selecionados nos parâmetros. Ou seja, não haverá um controle de envios anteriores, permitindo o reenvio de e-mail, se necessário.
- O sistema montará um único e-mail por Fornecedor e Loja com a relação de todos os seus títulos baixados, conforme informação dos parâmetros.
- O destinatário do e-mail será eleito conforme a regra:
- Caso o parametro MV_INTTUR estiver ativo, o aviso de pagamento será enviado para o(s) e-mail(s) do fornecedor informado no campo “E-mail” da aba “Definições de Cobrança” do cadastro de “Complemento do Fornecedor”
- Caso contrario, irá buscar os dados do cadastro de contatos do fornecedor, caso não existe utilizará o e-mail padrão do fornecedor.
- O e-mail remetente dos avisos de pagamento deverá ser configurado no parâmetro MV_RAVPAG, que será criado para este objetivo.
- O nome da empresa para informação no e-mail, no exemplo Alatur Turismo, será consultado do cadastro de empresas/filial. (Tabela SM0)
- A identificação do título será PREFIXO/NÚMERO/PARCELA/TIPO.
Detalhamento técnico
FINA815 - Aviso de Pagamento
Desenvolver uma tela conforme protótipo de tela 01, que utilize o grupo de perguntas FINA815, para seleção dos fornecedores que serão notificados, com as perguntas:
Pergunta | Conteúdo | Critério de busca |
---|---|---|
Data da Baixa de | Data inicial das baixas | Maior ou igual a FK2_DATA |
Data da Baixa Até | Data final das baixas | Menor ou igual a FK2_DATA |
Fornecedor de | Inicio do range de fornecedores | Maior ou igual a E2_FORNECE |
Fornecedor até | Final do range de fornecedores | Menor ou igual a E2_FORNECE |
Loja de | Inicio do range lojas de fornecedores | Maior ou igual a E2_LOJA |
Loja até | Final do range lojas de fornecedores | Menor ou igual a E2_LOJA |
Prefixo de | Inicio do range de prefixos/serie de nota | Maior ou igual a E2_PREFIXO |
Prefixo até | Final do range de prefixos/serie de nota | Menor ou igual a E2_PREFIXO |
Título de | Inicio do range do Número do título | Maior ou igual a E2_NUM |
Título até | Final do range do Número do título | Menor ou igual a E2_NUM |
Parcela de | Inicio do range de parcela | Maior ou igual a E2_PARCELA |
Parcela até | Final do range de parcela | Menor ou igual a E2_PARCELA |
Seleciona Tipos | Define se usuário filtrará os tipos de títulos | Se for 1 = Sim, apresentará a tela do protótipo 03 para usuário filtrar os tipos de títulos Se for 2 = Não, não apresentará a tela do protótipo 03 e irá considerar todos os tipos de títulos. |
Seleciona Motivo de Baixa | Define se o usuário filtrará os motivos de baixa | Se for 1 = Sim, apresentará a tela do protótipo 05 para usuário filtrar os motivos de baixas Se for 2 = Não, não apresentará a tela do protótipo 05 e irá considerar todos os motivos de baixas |
Seleciona Motivo de Pagamento | Define se o usuário filtrará os motivos de pagamentos, quando o mesmo for realizado por borderô | Se for 1 = Sim, apresentará a tela do protótipo 04 para usuário filtrar os motivos de pagamento Se for 2 = Não, não apresentará a tela do protótipo 04 e irá considerar todos os motivos de pagamento |
Baseado nas perguntas efetuar uma busca na tabela SE2 de títulos baixados parcialmente ou totalmente uma das condições abaixo seja atendidas:
- E2_SALDO seja diferente do campo E2_VALOR
- E2_SDACRES seja diferente do campo E2_ACRESCIMO
- E2_SDDECRE seja diferente do campo E2_DECRESCIMO
- E2_BAIXA preenchido, com movimentos válidas na FK2, ou seja, movimentos de baixas não estornado.
Após essa verificação:
Verificar os movimentos da FK2, se possuem o mesmo motivo de baixa selecionado pelo usuário.
Se o campo E2_NUMBOR estiver preenchido, verificar na tabela SEA se o tipo de pagamento está no range estabelecido pelo usuário.
Ordenar os títulos por fornecedor, para envio dos e-mail e emissão do relatório de conferencia.
Relacionamento entre tabelas:
Para buscar e validar dados serão consultadas as tabelas:
SA2, SE2, FK7, FK2, SEA:
tabelas | Chaves de relacionamento |
---|---|
SA2 X SE2 | A2_COD+A2_LOJA = E2_FORNECE+E2_LOJA |
SE2 X FK7 | E2_FILIAL + E2_PREFIXO + E2_NUM + E2_PARCELA + E2_TIPO E2_FORNECE + E2_LOJA = FK7_CHAVE |
FK7 X FK2 | FK7_IDDOC = FK2_IDDOC |
SE2 X SEA | E2_NUMBOR + E2_PREFIXO + E2_NUM + E2_PARCELA + E2_TIPO + E2_FORNECE + E2_LOJA = EA_NUMBOR + EA_PREFIXO + EA_NUM + EA_PARCELA + EA_TIPO EA_FORNECE + EA_LOJA |
Para cada fornecedor listado será enviado um e-mail com seus respectivos pagamentos, conforme protótipo de tela 06, com a estrutura:
Cabeçalho do e-mail:
Campo | Conteúdo |
---|---|
Emitente | E-mail listado no parâmetro MV_RAVPAG |
Destinatário | o destinatário do e-mail poderá ter três origem: Se o parâmetro MV_INTTUR estiver ativo, deverá buscar do complemento do fornecedor G4V_EMAIL, caso não esteja preenchido:
Se o parâmetro MV_INTTUR estiver desativado:
Importante: Se existir mais de um contato com o campo U5_AVPGTO=1, todos serão notificados. |
Corpo do e-mail:
Campo | Conteúdo |
---|---|
Prefixo | E2_PREFIXO |
Número | E2_NUM |
Parcela | E2_PARCELA |
Tipo | E2_TIPO |
Data de Vencimento | E2_VENCREA |
Data de Pagamento | FK2_DATA |
Valor de Pagamento | FK2_VALOR |
Banco/agencia/conta | Utilizar os campos: E2_FORBCO, E2_FORAGE, E2_FAGEDV, E2_FORCTA, E2_FCTADV. Caso estejam em branco usar os campos: A2_BANCO, A2_AGENCIA, A2_DVAGE, A2_NUMCON, A2_DVCTA. |
Modelo de Pagamento | SEA_MODELO + X5_DESCRI (tabela 58) |
Importante: Durante o processamento deverá apresentar uma barra de progresso, caso não encontre registro o usuário deverá ser notificado.
Após a emissão do e-mail deverá apresentar na tela o relatório de conferência, FINR815.
Gravação de Log de Processamento
Para cada processamento será gravado um log, informando data, hora e usuário que efetuou o processamento e o código do fornecedor/loja processado.
Adicionar uma tratativa, caso a quantidade de código/loja ultrapasse a capacidade do campo CV8_DET, deverá gravar duas ou mais linhas de log.
Após a emissão do e-mail deverá apresentar na tela o relatório de conferência, FINR815.
FINR815 - Relatório de aviso de pagamento
Relatório deverá receber os dados de e-mail enviados e exibir as informações conforme protótipo de tela 07, divido em duas sessões com quebra por fornecedor.
Sessão 1 - Dados do fornecedor
Coluna | Conteúdo |
---|---|
Fornecedor/Loja | E2_FORNECE/E2_LOJA |
Nome reduzido | E2_NOMFOR |
E-mail de Envio | E-mail definido na execução da rotina OBS: Poderá ser mais de um. |
Data de Envio | Data Base do sistema |
Sessão 2 - Dados dos títulos
Coluna | Conteúdo |
---|---|
Filial | E2_FILIAL |
Prefixo | E2_PREFIXO |
Número | E2_NUM |
Parcela | E2_PARCELA |
Tipo | E2_TIPO |
Natureza | E2_NATUREZ |
Vencimento | E2_VENCREA |
Pagamento | E2_VENCREA |
Valor Original | E2_VALOR+E2_ACRESC-E2_DECRESC |
Valor Pago | FK2_VALOR |
Banco/Agencia/Conta | Utilizar os campos: E2_FORBCO, E2_FORAGE, E2_FAGEDV, E2_FORCTA, E2_FCTADV. Caso estejam em branco usar os campos: A2_BANCO, A2_AGENCIA, A2_DVAGE, A2_NUMCON, A2_DVCTA. |
Modelo de Pagamento | SEA_MODELO + X5_DESCRI (tabela 58) |
Tabelas Utilizadas
- SE2 – Cadastro de Contas a Pagar;
- SA2 - Cadastro de fornecedor;
- SU5 - Cadastro de Contatos
- SE5 - Movimentos Bancários;
- FK2 - Baixas a Pagar;
- FK7 - Dados Auxiliares;
- SEA - Títulos enviados ao Banco;
- CV8 - Log de Processamento.
Protótipo de Tela
Protótipo 01
Protótipo 02
Protótipo 03
Seleção de Tipo de título
Protótipo 04
Seleção dos Modelos de Pagamento
Protótipo 05
Seleção dos Motivos de Baixa
Protótipo 06
Exemplo de formato de e-mail:
Protótipo 07
Opcional
Fluxo do Processo
<Nesta etapa incluir representações gráficas que descrevam o problema a ser resolvido e o sistema a ser desenvolvido. Exemplo: Diagrama - Caso de Uso, Diagrama de Atividades, Diagrama de Classes, Diagrama de Entidade e Relacionamento e Diagrama de Sequência>.
Opcional
Dicionário de Dados
Arquivo ou Código do Script: AAA – Negociação Financeira / *Versao=CP.2014.12_03*/
Índice | Chave |
01 | <FI9_FILIAL+FI9_IDDARF+FI9_STATUS> |
02 | <FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_EMISS+FI9_IDDARF> |
03 | <FI9_FILIAL+FI9_FORNEC+ FI9_LOJA+FI9_PREFIX+FI9_NUM+FI9_PARCEL+FI9_TIPO> |
Campo | <AAA_PERESP> |
Tipo | <N> |
Tamanho | <6> |
Valor Inicial | <Varia de acordo com o tipo informado. Por exemplo, quando o campo “tipo” for date, neste campo pode ser informado uma data>. |
Mandatório | Sim ( ) Não ( ) |
Descrição | <Referência Mínima para Cálculo> |
Título | <Ref.Calc.> |
Picture | <@E999.99> |
Help de Campo | <Informar o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociação> |
(Opcional)
Grupo de Perguntas
<Informações utilizadas na linha Protheus>.
Nome: FINSRF2
X1_ORDEM | 01 |
X1_PERGUNT | Emissão De |
X1_TIPO | D |
X1_TAMANHO | 8 |
X1_GSC | G |
X1_VAR01 | MV_PAR01 |
X1_DEF01 | Comum |
X1_CNT01 | '01/01/08' |
X1_HELP | Data inicial do intervalo de emissões das guias de DARF a serem consideradas na seleção dos dados para o relatório |
(Opcional)
Consulta Padrão
<Informações utilizadas na linha Protheus>
Consulta: AMB
Descrição | Configurações de Planejamento |
Tipo | Consulta Padrão |
Tabela | “AMB” |
Índice | “Código” |
Campo | “Código”; ”Descrição” |
Retorno | AMB->AMB_CODIGO |
SU5 - Cadastro de Contatos
Campo | FO0_STATUS |
Tipo | Caractere |
Tamanho | 1 |
Descrição | Status da Simulação |
Título | Status |
Picture | @! |
Obrigatório | Sim |
Usado | Sim |
Browse | Não |
Contexto | Real |
Visual | Alterar |
Val. Sistema | Pertence(“123”) |
Lista opção | 1=Ativo,2=Versionado,3=Cancelado |
Inicializador Padrão | “1” |
Help de Campo | Define o status do registro. 1=Ativo 2=Versionado 3=Cancelado
|
Grupo de Perguntas
Nome: FINA815
Casos de Uso
(Opcional)
Estrutura de Menu
<Informações utilizadas na linha Datasul>.
Procedimentos
Procedimento |
|
|
|
Descrição | (Max 40 posições) | (Max 40 posições) | (Max 40 posições) |
Módulo |
|
|
|
Programa base |
|
|
|
Nome Menu | (Max 32 posições) | (Max 32 posições) | (Max 32 posições) |
Interface | GUI/WEB/ChUI/Flex | GUI/WEB/ChUI/Flex | GUI/WEB/ChUI/Flex |
Registro padrão | Sim | Sim | Sim |
Visualiza Menu | Sim/Não | Sim/Não | Sim/Não |
Release de Liberação |
|
|
|
Programas
Programa |
|
|
|
Descrição | (Max 40 posições) | (Max 40 posições) | (Max 40 posições) |
Nome Externo |
|
|
|
Nome Menu/Programa | (Max 32 posições) | (Max 32 posições) | (Max 32 posições) |
Nome Verbalizado[1] | (Max 254 posições) | (Max 254 posições) | (Max 254 posições) |
Procedimento |
|
|
|
Template | (Verificar lista de opções no man01211) | (Verificar lista de opções no man01211) | (Verificar lista de opções no man01211) |
Tipo[2] | Consulta/Manutenção/ Relatório/Tarefas | Consulta/Manutenção/ Relatório/Tarefas | Consulta/Manutenção/ Relatório/Tarefas |
Interface | GUI/WEB/ChUI/Flex | GUI/WEB/ChUI/Flex | GUI/WEB/ChUI/Flex |
Categoria[3] |
|
|
|
Executa via RPC | Sim/Não | Sim/Não | Sim/Não |
Registro padrão | Sim | Sim | Sim |
Outro Produto | Não | Não | Não |
Visualiza Menu | Sim/Não | Sim/Não | Sim/Não |
Query on-line | Sim/Não | Sim/Não | Sim/Não |
Log Exec. | Sim/Não | Sim/Não | Sim/Não |
Rotina (EMS) |
|
|
|
Sub-Rotina (EMS) |
|
|
|
Localização dentro da Sub Rotina (EMS) |
|
|
|
Compact[4] | Sim/Não | Sim/Não | Sim/Não |
Home[5] | Sim/Não | Sim/Não | Sim/Não |
Posição do Portlet[6] | 0 – Top Left 1 – Top Right 2 – Bottom Left 3 – Bottom Right | 0 – Top Left 1 – Top Right 2 – Bottom Left 3 – Bottom Right | 0 – Top Left 1 – Top Right 2 – Bottom Left 3 – Bottom Right |
Informar os papeis com os quais o programa deve ser vinculado |
|
|
|
Cadastro de Papéis
<O cadastro de papéis é obrigatório para os projetos de desenvolvimento FLEX a partir do Datasul 10>.
<Lembrete: o nome dos papeis em inglês descrito neste ponto do documento, devem ser homologados pela equipe de tradução>.
Código Papel | (máx 3 posições) |
Descrição em Português* |
|
Descrição em Inglês* |
|
[1] Nome Verbalizado é obrigatório para desenvolvimentos no Datasul 10 em diante.
[2] Tipo é obrigatório para desenvolvimento no Datasul 10 em diante
[3] Categorias são obrigatórias para os programas FLEX.
[4] Obrigatório quando o projeto for FLEX
[5] Obrigatório quando o projeto for FLEX
Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
---|