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 | Protheus | Módulo | sigatec |
Segmento Executor | Serviços - Gestão de Serviços | ||
Projeto1 | M_SER_SER014 | IRM1 | PCREQ-4385 |
Requisito1 | PCREQ-4452 | Subtarefa1 | PDR_SER_TEC001-317 |
Chamado2 |
| ||
Release de Entrega Planejada | 12.1.78 | Réplica | Não |
País | ( x ) Brasil ( ) Argentina ( ) Mexico ( ) Chile ( ) Paraguai ( ) Equador ( ) USA ( ) Colombia ( ) Outro _____________. | ||
Outros |
|
Objetivo
O Encerramento de posto será o conjunto de processos e conferências a ser utilizado pelo usuário para identificar se um determinado posto está pronto para ser devidamente encerrado ou se pode ser considerado encerrado dentro do sistema. Esses processos incluem Revisão de Contratos para adicionar data final aos postos, Consulta de Alocações de Pessoas e Equipamentos além da verificação de Materiais de Implantação (materiais operacionais) que estão disponíveis para a prestação do serviço nos postos.
Definição da Regra de Negócio
Para o desenvolvimento do requisito será realizada alteração
Rotina | Tipo de Operação | Opção de Menu | Regras de Negócio |
[ACAA040 – Parâmetros] | [Alteração] | [Atualizações -> Acadêmico-> Tesouraria] | - |
[ACAA050 – Negociação Financeira] | [Envolvida] | [Atualizações -> Acadêmico-> Tesouraria] | - |
[ACAA060 – Cadastro de Pedidos] | [Criação] | [Atualizações -> Acadêmico-> Cadastros] | - |
Exemplo de Aplicação:
- Criar o campo “% Mínimo Espécie” (AAA_PERESP) onde o usuário informará o % que o aluno pagará em dinheiro. Esse % poderá ser alterado durante a negociação.
- Criar o campo “Referência Mínima para Cálculo” (AAA_REFCAL) onde o usuário informará um dos 4 valores disponíveis para pagamento das mensalidades como a referência mínima para calcular o débito total do aluno.
- Criar o parâmetro MV_ACPARNE que definirá se as informações de “% Mínimo Espécie” e “Referência Mínima para Cálculo” serão obrigatórias.
- O parâmetro MV_ACPARNE deve ter as seguintes opções: 1=Obrigatório e 2=Opcional. Deve ser inicializado como opcional>.
Definição Técnica
Tabelas Utilizadas
- SE2 – Cadastro de Contas a Pagar
- FI9 – Controle de Emissão de DARF>.
Opcional
Protótipo de Tela
<Caso necessário inclua protótipos de telas com o objetivo de facilitar o entendimento do requisito, apresentar conceitos e funcionalidades do software>.
Protótipo 01
Protótipo 02
Protótipo 03
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>.
TECA870 – Revisão de Contrato | Alteração | Atualizações / Gestão dos Contratos / Gestão de Contrato | - |
TECA890 – Apontamento de Materiais | Alteração | Atualizações / Centro de Serviços / Apontamento de Materiais | - |
TECA800 – Movimentações | Alteração | Atualizações / Locação / Movimentações | - |
TECA330 - Alocação de Atendentes | Envolvida | rotina interna | - |
TECA330A - Gestão de Escala | Envolvida | rotina interna | - |
TECA893 - Retornar Material de Implantação | Inclusão | rotina interna | - |
TECA352 - Benefícios do Posto | Alteração | rotina interna | - |
TECA871 - Efetivar Encerramento de Posto | Inclusão | rotina interna | - |
Para o desenvolvimento do processo de encerramento as rotinas alteradas serão: Revisão de Contratos, Alocação de Atendentes, Movimentos de equipamentos e Apontamentos de Materiais. Além dessas alterações será adicionada uma rotina para realizar o retorno dos materiais de implantação que estiverem alocados nos postos para a prestação de serviço.
A seguir as alterações são descritas individualmente para cada rotina.
Revisão de Contratos
A alteração será para determinar a data final dos locais no contrato e itens oferecidos nele. O usuário irá executar a inclusão das datas de fim através da revisão e portanto as movimentações futuras serão bloqueadas como o sistema já faz.
Será adicionado campo no local do contrato para indicar se o local pode sofrer alterações ou se já sofreu a efetivação de encerramento. Este campo será alimentado pela rotina "Efetivar Encerramento do Posto" descrita em detalhes a seguir. Quando o local no contrato já estiver sido encerrado, não será mais possível alterar as informações contidas de equipamentos, itens para alocação de recursos humanos, benefícios do contrato, etc.
Apontamento de Materiais
A alteração será para assegurar que o sistema não fará o envio de itens quando a data do sistema estiver maior que a data final da vigência do material ou local do contrato.
Assim para o itens que tiverem a vigência ultrapassada não será possível realizar o lançamento dos materiais de consumo ou implantação e será exibida a mensagem: "Local com a vigência encerrada não é possível realizar o apontamento de materiais."
Movimentações
A alteração na rotina será para identificar se existem equipamentos em postos encerrados, será adicionada mais uma legenda que identifique os movimentos de alocação dos equipamentos que estão em postos encerrados.
Além da legenda será adicionado no filtro também para que o usuário consiga de forma simples realizar uma ação que liste somente esta situação específica e providencie o retorno dos equipamentos. O título do filtro deve ser "Alocações em Postos Encerrados".
Alocação de Atendentes / Gestão de Escala
A alteração nas rotinas será para garantir que agendas não sejam geradas para itens que estejam vinculados a locais de contrato que estejam marcados como encerrados e que portanto, não gerarão mais faturamento.
Benefícios do Posto
Ao realizar a Revisão do Contrato a vigência dos benefícios relacionados ao contrato e posto do contrato deverão ser atualizados para que os valores sejam corretamente pagos para os atendentes alocados nesses postos ou contratos.
Esta atualização precisa ser coordenada em conjunto com a equipe de Recursos Humanos da empresa cliente, pois ao executar a atualização da vigência dos benefícios pode influenciar o valor a ser pago de beneficio para os atendentes que possuem o planejamento de alocação naquele posto ou contrato.
Retornar Material de Implantação
Esta rotina será criada e disponibilizada no menu em Atualizações / Centro de Serviços / Retornar Material (função TECA893).
Será exibido browse (semelhante ao protótipo 02, com o título "Retornar Material") com os locais de contratos no sistema e devem ser exibidas duas legendas que indicarão: a situação do contrato "não iniciado", "ativo" ou "encerrado" e a situação dos materiais de implantação "não atendido", "atendido", "não retornado", "retornado".
O objetivo das legendas é facilitar a identificação de materiais que precisam ser retornados em função do encerramento do contrato.
A janela para realizar o retorno de materiais deverá ser conforme o protótipo 01 e nela o usuário irá selecionar o item que deseja executar o retorno dos materiais e ir adicionando as informações conforme os materiais vão retornando.
Efetivar Encerramento do Posto
A rotina será adicionada as opções da Gestão dos Contratos e irá realizar a marcação dos locais, postos para recursos humanos (itens de rh) e equipamentos (locação) que não estarão mais ativos e portanto não sofrerão mais atualizações, seja para serviços extras, reforços ou mesmo durante uma revisão. O título da opção deve ser "Encerrar Postos".
A alteração irá acontecer no campo "Encerrado?" que ficará com o conteúdo igual a sim, para isso será adicionado este novo campo nas três tabelas locais do contrato (TFL), itens de RH (TFF) e itens de locação (TFI).
A rotina irá exibir todos os locais vinculados ao contrato selecionado e o usuário irá marcar quais itens deseja realizar o encerramento (vide protótipo 03). Na avaliação dos encerramento será realizada uma verificação que irá identificar se ainda há recursos (humanos, materiais ou equipamentos) alocado nos itens deste local e quando identificar será exibido ao usuário a informação e não será permitido efetivar o encerramento do posto. Assim é garantido que os postos só serão encerrados quando todos itens alocados nele forem removidos.
Consulta Recurso no Posto
A consulta deverá ser chamada quando for acionada a validação geral do encerramento de posto. Nela deverá ser avaliado se o item ainda possui recurso alocado e quando identificar não permitir o encerramento.
A avaliação a ser feita é:
- equipamentos de locação que ainda não foram retornados;
- atendentes com agendas futuras geradas e;
- materiais de implantação não retornados quando vinculados a alocação de recursos humanos (formato de orçamento de serviços sem a precificação, quando o parâmetro MV_ORCPRC está desabilitado).
O retorno da consulta deve ser uma mensagem para o usuário indicando quais itens não poderão ser encerrados e os respectivos motivos, no seguinte formato:
"Código: 001390 | Local 0789 - Descrição
RH - Item 01: material não retornado. Código Material [0059], prod. [100 - guarda-chuva], qtde [2].
LE - Item 02: equipamento não retornado. Código Locação [0024], prod. [210 - bastão de ronda], número de série [SER_0040].
RH - Item 05: atendente alocado. Código Item RH [0030], prod. [130 - copeira], atendente [003901 - Jucelia]
..."
A identificação de ocorrência deverá bloquear a sequência de processamento e retornar a janela de seleção dos postos a serem encerrados para que o usuário faça a seleção somente dos postos que possuem a possibilidade de encerramento.
Definição Técnica
Nos tópicos a seguir serão abordados em cada rotina as alterações necessárias para atender o processe de encerramento de postos no módulo gestão de serviços.
Alocação de Atendentes (TECA330) / Gestão de Escala (TECA330A)
A alteração exigida nas duas rotinas é para bloquear a geração de agendas para postos encerrados. Na rotina de alocação TECA330 (modelo tradicional) a alteração deve acontecer no momento de validação da seleção do item de alocação de recursos humanos. Já na rotina de alocação por escala TECA330A (gestão de escala) a validação deve acontecer no momento de acionamento da opção "Alocação de Atendentes", caso o item esteja encerrado deve exibir mensagem ao usuário informando o problema e não realizando o processo.
Revisão de Contratos (TECA870) / Benefícios do Posto (TECA352)
Durante uma revisão de contrato quando acontecer a alteração da data final de um item de recurso humano (tabela TFF) deverá ser realizada avaliação se há benefício vinculado ao posto e executar a alteração no benefício. Ajustando o conteúdo do campo LY_DTFIM para o novo valor de fim do item da TFF. Essa atualização deve acontecer no momento da efetivação da revisão na função At870VlEfR e através do modelo de dados utilizado na função AT352TDX (fonte TECA352).
Apontamento de Materiais (TECA890)
A alteração deve acontecer no acionamento da opção Apontamento de Materiais no browse e na seleção do item de material de implantação para realizar o apontamento. Nestes momentos deve ser avaliado ser o item Rh vinculado ou o local do contrato estão marcados como encerrados e quando estiverem não poderá permitir realizar o apontamento. Portanto, as alterações serão: na função At890Apon para verificar se o local já está encerrado; a função At890ConMI que exibe os produtos de materiais de implantação conforme o item de Rh para verificar se o item está ativo; e a validação do campo TFS_CODTFG para não permitir itens de materiais vinculados a itens de Rh já encerrados (caso em que o usuário digita o valor diretamente).
Em função do desenvolvimento do retorno dos materiais a função de validação da quantidade At890ValdQnt apontada de materiais precisará de alteração para passar a considerar o campo TFS_MOV que irá receber conteúdo '1' para envio e '2' para retorno, portanto o cálculo da quantidade já enviada deverá considerar as linhas de TFS que sejam diferente de '2'.
Retornar Material de Implantação (TECA893)
Esta rotina irá executar a devolução dos materiais de implantação movimentados pelo apontamento de materiais (teca890) e registrados na tabela TFS. A devolução deve acontecer através de execauto da rotina de movimentos internos MATA240, com um tipo de movimento interno que seja para Devolução (campo F5_TIPO = "D" tabela SF5). A rotina será acessível através do menu Atualizações / Centro de Serviços / Apontamento de Materiais (função TECA890) e a opção para Retornar Materiais, deve ser adicionada as outras ações do browse (protótipo 02). Quando esta opção for acionada a interface deve ser conforme o protótipo 01 que é organizado da seguinte forma:
- grid superior com as informações da tabela TFG que são os itens de material de implantação daquele local do contrato.
- grid inferior com as informações da tabela TFS que serão os itens de retorno dos materiais.
Os tipos associados ao campo TFS_TM devem ser de devolução e o campo TFS_MOV deve ter inicializador padrão de conteúdo para "2=Retorno" (somente nesta rotina). A gravação dos dados desta rotina deve ser específica para manter em transação as rotinas automáticas necessárias para lançamento dos retornos de material preenchidos pelo usuário. Os produtos e a quantidade de material a ser retornada precisa existir na tabela TFS como material enviado para o posto, portanto é necessário permitir somente os produtos e a quantidade que tenham sido enviado previamente para aqueles posto (utilizar como referência os campos TFS_CODTFG igual ao TFG_COD e TFS_MOV diferente de '2').
Para os casos em que o retorno não acontecerá e é necessário assumir a perda pela prestadora do serviço, deve ser criada a opção para eliminar resíduo no botão outras ações. Esta opção irá utilizar a linha posicionada no grid superior e questionar o usuário se realmente deseja lançar o saldo não retornado como resíduo. A pergunta deve ser semelhante a: "Tem certeza que deseja lançar a quantidade xx como resíduo? Esse lançamento não poderá ser desfeito.", com a confirmação do usuário o valor deve ser inserido no campo "Resíduo Eliminado" e posteriormente gravado na tabela TFG campo TFG_RESRET.
F3 Material Implantação no Posto
A consulta padrão de produto deverá realizar um distinct dos produtos apontados e enviados para o posto. Para identificar estes produtos deverá ser utilizado o campo TFS_CODTFG que deve ter o mesmo conteúdo do campo TFG_COD (grid superior) e o campo TFS_MOV diferente de '2'. Essa consulta deverá ser específica e será a partir do campo TFS_PRODUT. Os campos que devem ser exibidos para o usuário são: código do produto, descrição do produto, unidade de medida e o total enviado.
O código da consulta no dicionário será TFSRET, a função de chamada da interface "At893F3Cn" e a função de retorno do conteúdo "At893F3Ret".
Efetivar Encerramento do Posto (TECA871)
Esta rotina ficará disponível no menu de gestão de contrato em Atualizações / Gestão de Contratos / Gestão do Contrato no botão outras ações. Conforme o contrato selecionado será exibidos os locais e respectivos itens de recursos humanos e locação de equipamentos para marcar o encerramento.
A interface deve ser conforme o protótipo 03, onde o usuário irá marcar quais itens deseja encerrar e acionar o botão gravar. A validação dos itens a serem encerrados irá verificar se todos os recursos envolvidos com a prestação do serviço já foram recolhidos e caso não tenham o usuário receberá uma mensagem informando o problema e deverá providenciar o retorno dos recursos para depois efetivar o encerramento.
A efetivação do encerramento irá atualizar os campos TFL_ENCE, TFF_ENCE, TFI_ENCE respectivamente para local de contrato, item de recurso humano e item de locação que for marcado para executar o encerramento. O conteúdo a ser inserido nestes campos é "1" (Sim). A interface deve ser organizada da seguinte forma:
- grid superior com os locais do contrato (tabela TFL).
- aba para grids inferiores sendo: o primeiro grid para os itens de Rh (tabela TFF) e o segundo para os itens de locação (tabela TFI).
Consulta Recursos no Posto (função At871RecPen)
Esta consulta será chamada na validação dos postos a serem encerrados e deverá exibir quais os itens que estão bloqueando o encerramento dos itens de rh ou locação nos locais.
Como mencionado na regra de negócio os 3 critérios a serem avaliados são:
- agendas futuras criadas para os atendentes (bloqueia o encerramento dos itens de rh). Para identificar esta situação utilizar a data final do item de RH (TFF_PERFIM) e verificar se existem agendas com data superior (tabela ABB e campo ABB_DTINI). É necessário fazer relacionamento usando a tabela ABQ (configuração de alocação) para identificar corretamente as agendas.
- materiais de implantação não retornados (bloqueia o encerramento dos itens de rh ). Para calcular o material retornado é necessário identificar todos os materiais vinculado ao item de recurso humano e somar a quantidade retornada na tabela TFS utiilizando o código do material (TFG_COD com o campo TFS_CODTFG e sendo movimento de retorno identificado através do campo TFS_MOV = '2') com o valor de resíduo eliminado no campo TFG_RESRET. Caso essa operação dê uma quantidade menor que o enviado para o posto o bloqueio deve do encerramento deve acontecer.
- equipamentos não retornados (bloqueia o encerramento dos itens de locação). Para identificar a situação é necessário verificar se todos os movimentos do item de locação (TFI_COD) estão retornados na tabela de movimentação (campo TEW_CODEQU igual a TFI_COD e TEW_DTFIM preenchido).
Tabelas Utilizadas
- TFL – Local do Contrato
- TFF – Item de Recurso Humano
- TFI - Item de Locação
- TFG - Item de Material de Implantação
- ABS - Local de Atendimento
- TFS - Apontamento Material Operacional
- ABQ - Configuração de Alocação de Recurso Humano
- SF5 - Tipo de Movimento Interno
- SD3 - Movimentações Internas
- TEW - Movimentações de locação
- SLY - Lançamento Vínculo de Benefícios
Protótipo de Tela
Protótipo 01
Protótipo 02
Protótipo 03
Fluxo do Processo
Dicionário de Dados
Arquivo: TFS - Apontamento Material Operacional
Campo | TFS_MOV |
Tipo | C |
Tamanho | 1 |
Valor Inicial | "1" |
Mandatório | Sim ( ) Não ( x ) |
Descrição | Movimento |
Título | Movimento |
Picture | @9 |
Help de Campo | Define se o movimento é de envio(1) ou de retorno(2) do material. |
Validação Sistema | Pertence("12") |
Combo | 1=Envio;2=Retorno |
Visualiza | ( x ) Visualizar ( ) Alterar |
Contexto | ( x ) Real ( ) Virtual |
Browse | Sim |
Arquivo: TFG - Item Material de Implantação
Campo | TFG_RESRET |
Tipo | N |
Tamanho | 11 (2 decimal) |
Valor Inicial | 0 |
Mandatório | Sim ( ) Não ( x ) |
Descrição | Resíduo Eliminado |
Título | Res. Elim. |
Picture | @E 99,999,999.99 |
Help de Campo | Indica a quantidade de material que não retornou do posto e portanto foi eliminada por resíduo. |
Browse | Sim |
Visualiza | ( x ) Visualizar ( ) Alterar |
Contexto | ( x ) Real ( ) Virtual |
Arquivo: TFL - Local do Contrato
Campo | TFL_ENCE |
Tipo | C |
Tamanho | 1 |
Valor Inicial | "2" |
Mandatório | Sim ( ) Não ( x ) |
Descrição | Encerrado? |
Título | Encerrado? |
Picture | @9 |
Help de Campo |
Define se o item está encerrado e não pode mais sofrer atualização. |
Validação Sistema | Pertence("12") |
Combo | 1=Sim;2=Não |
Visualiza | ( x ) Visualizar ( ) Alterar |
Contexto | ( x ) Real ( ) Virtual |
Browse | Sim |
Arquivo: TFF - Item Recurso Humano
Campo | TFF_ENCE |
Tipo | C |
Tamanho | 1 |
Valor Inicial | "2" |
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
| |
Mandatório | Sim ( ) Não ( |
x ) |
Descrição |
Encerrado? |
Título |
Encerrado? |
Picture |
@9 |
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 |
Define se o item está encerrado e não pode mais sofrer atualização. | |
Validação Sistema | Pertence("12") |
Combo | 1=Sim;2=Não |
Visualiza | ( x ) Visualizar ( ) Alterar |
Contexto | ( x ) Real ( ) Virtual |
Browse | Sim |
Arquivo: TFI - Item Locação de Equipamento
Campo | TFI_ENCE |
Tipo | C |
Tamanho | 1 |
Valor Inicial | "2" |
Mandatório | Sim ( ) Não ( x ) |
Descrição | Encerrado? |
Título | Encerrado? |
Picture | @9 |
Help de Campo |
Define se o item está encerrado e não pode mais sofrer atualização. |
Validação Sistema | Pertence("12") |
Combo | 1=Sim;2=Não |
Visualiza | ( x ) Visualizar ( ) Alterar |
Contexto | ( x ) Real ( ) Virtual |
Browse | Sim |
Grupo de Perguntas
Consulta Padrão
Consulta: TFSRET
Descrição | Retorno Mat. Implantação |
Tipo | Consulta Específica |
Tabela | “TFS” |
(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””Produto”; "Desc. Produto"; "Quantidade" |
Retorno |
At893F3Ret() AMB->AMB_CODIGO |
Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
---|