Melhorias - Tabela de Tarifas de Reparo (

DEPOT)

Características do Requisito

Descrição

Escreva aqui a descrição da nova implementação ou melhoria.

Importante

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

Antes de executar o compatibilizador informe o nome do compatibilizador é imprescindível:

• Realizar o backup da base de dados do produto que será executado o compatibilizador (diretório PROTHEUS_DATA\DATA, se versão 10, ou \PROTHEUS11_DATA\DATA, se versão 11) e dos dicionários de dados SXs (diretório PROTHEUS_DATA_SYSTEM, se versão 10, ou \PROTHEUS11_DATA\SYSTEM, se versão  11).
• Os diretórios acima mencionados correspondem à instalação padrão do Protheus, portanto, devem ser alterados conforme o produto instalado na empresa.
• Essa rotina deve ser executada em modo exclusivo, ou seja, nenhum usuário deve estar utilizando o sistema.
• Se os dicionários de dados possuírem índices personalizados (criados pelo usuário), antes de executar o compatibilizador, certifique-se de que estão identificados pelo nickname. Caso o compatibilizador necessite criar índices, irá adicioná-los a partir da ordem original instalada pelo Protheus, o que poderá sobrescrever índices personalizados, caso não estejam identificados pelo nickname.
• O compatibilizador deve ser executado com a Integridade Referencial desativada*.

1. Em Microsiga Protheus TOTVS Smart Client (se versão 10), digite o nome do compatibilizador no campo Programa Inicial. Descreva se o compatibilizador deve ter uma data específica ou superior para que a atualização nos dicionários seja efetuada corretamente. Importante: Para a correta atualização do dicionário de dados, certifique-se que a data do compatibilizador seja igual ou superior a ___/___/____.
2. Clique em OK para continuar.
3. Após a confirmação é exibida uma tela para a seleção da empresa em que o dicionário de dados será modificado ou é apresentada a janela para seleção do compatibilizador. Selecione o programa xxxx().
4. Ao confirmar é exibida uma mensagem de advertência sobre o backup e a necessidade de sua execução em modo exclusivo.
   1. Clique em Processar para iniciar o processamento. O primeiro passo da execução é a preparação dos arquivos.
      É apresentada uma mensagem explicativa na tela.
   2. Em seguida, é exibida a janela Atualização concluída com o histórico (log) de todas as atualizações processadas. Nesse log de atualização são apresentados somente os campos atualizados pelo programa. O compatibilizador cria os campos que ainda não existem no dicionário de dados.
   3. Clique em Gravar para salvar o histórico (log) apresentado.
   4. Clique em OK para encerrar o processamento.

Descreva se há algum procedimento necessário após a aplicação do compatibilizador.

Procedimento para Implantação

O sistema é atualizado logo após a aplicação do pacote de atualizações (Patch) deste chamado.

1. Aplique o patch do chamado e execute uma vez a rotina Informe o nome da rotina.
2. No módulo informe o nome do módulo acesse informe o caminho e verifique que o parâmetro informe o nome do parâmetro é criado conforme especificações abaixo:

Atualizações do Compatibilizador

(Apenas para Microsiga Protheus, versões anteriores à versão 12)

1. Criação ou Alteração de Perguntas no arquivo SX1 – Cadastro de Perguntes:

2.    Criação ou Alteração de tabela no arquivo SX2– Tabelas:

3.  Criação ou Alteração de Tabelas Genéricas no arquivo SX5 – Tabelas Genéricas:

4.  Criação ou Alteração (mantenha somente a instrução correspondente) de Campos no arquivo SX3 – Campos:

• Tabela BGD - Prod x Cob x Proc x Co-Part:

Importante:

O tamanho dos campos que possuem grupo pode variar conforme ambiente em uso.

5.  Criação ou Alteração de Consulta Padrão no arquivo SXB – Consulta Padrão:

• Pesquisa B05PLS:

6.  Criação ou Alteração de Índices no arquivo SIX – Índices:

7.  Criação ou Alteração de Parâmetros no arquivo SX6 – Parâmetros:

8.  Criação ou Alteração (mantenha somente a instrução correspondente) de Gatilhos no arquivo SX7 – Gatilhos:

• Tabela BD5 – Contas Médicas:

Procedimento para Configuração

(Estes procedimentos devem ser feitos quando for necessário configurar parâmetros e/ou  rotinas no menu).

CONFIGURAÇÃO DE PARÂMETROS

1. No Configurador (SIGACFG), acesse Ambientes/Cadastros/Parâmetros (CFGX017). Crie/configure (mantenha somente a instrução correspondente) o(s) parâmetro(s) a seguir:
   (É necessário criar uma tabela para cada parâmetro descrito no item Parâmetro(s), da tabela Características do Requisito)

CONFIGURAÇÃO DE MENUS

2.  No Configurador (SIGACFG), acesse Ambientes/Cadastro/Menu (CFGX013). Informe a nova opção de menu do informe o nome do módulo, conforme instruções a seguir:

Procedimento para Utilização

• Descreva os procedimentos, passo a passo (caso de uso), que serão realizados pelos usuários para que a melhoria seja visualizada identificando as seguintes informações:
• Localização da rotina no menu;
• Localização dos novos campos e/ou perguntas e respectivas pastas de cadastro que são visualizadas pelo usuário;
• Caso seja necessário ter algum cadastro feito previamente, faça uma observação.

Exemplo:

       1.            No Plano de Saúde (SIGAPLS), acesse Atualizações / Produto Saúde / Produto Saúde (PLSA800).

O sistema apresenta a janela de produtos cadastrados.

       2.            Posicione o cursor em um produto e clique em Alterar.

       3.            Na pasta Cobertura/Carências selecione a subpasta Tipo de Prestador.

       4.            Dê duplo clique no campo TP Prestador (BCW_TIPPRE).

O sistema apresenta a janela Tipo de Prestador – Coparticipação – Alterar.

       5.            Informe os dados conforme orientação do help de campo e observe o preenchimento do novo campo:

                      Som. p/Compra (BCW_SOMCOM): selecione Sim para indicar se a coparticipação cadastrada será válida somente para efeito de compra de procedimentos ou Não, caso contrário.

       6.            Confira os dados e confirme.

Vídeo

• Vídeo hospedado no youtube e inserido no template por meio da macro Widget Connector.

** Canal do youtube e software de vídeoem definição.

Implementadas melhorias nos cadastros de Tarifa do DEPOT. Com as novas implementações foram adicionados:

• Um campo para determinar o Valor H/H de uma tarifa.
• A possibilidade de clonar, na criação de uma nova tabela de tarifas, uma tabela de tarifa do Armador já existente.
• Uma melhoria no cadastro de Itens da Tarifa, alterando e adicionando novos campos que agora são: Item de tarifa, Descrição, Serviço SARA, Dimensão inicial (cm), Dimensão adicional (cm), Área (cm²), H/H inicial, H/H adicional, Material inicial, Material adicional, Tipo de cálculo e Valor de um serviço. 
• Também foi adicionada uma nova funcionalidade que permite importar uma tabela de tarifas de um Armador, conforme modelo definido (para conhecer o modelo que deve ser seguido para importação, clique aqui). 
• Com as melhorias adicionadas, o sistema será capaz de realizar os cálculos para as estimativas do DEPOT, de acordo com o tipo de cálculo selecionado, que tem por base os campos informados em tela.

Antes destas melhorias, o Valor H/H era um campo informado no próprio item de tarifa. Entretanto, o Valor H/H de trabalho não varia por item de tarifa (serviço de reparo), mas trata-se de um valor negociado entre o Armador e a unidade DEPOT e é válido para todos os serviços de reparos da unidade.

A medida que modifica o Valor H/H a ser cobrado em um item de tarifa é medido em horas de trabalho por homem multiplicado pelo valor H/H negociado entre unidade e o Armador. Deste modo, o campo Valor H/H foi transferido para o cadastro da Tabela de Tarifas e, no cadastro de Itens da Tarifa, foi adicionado o tempo em homem/hora para a realização do serviço.

Para que fosse possível tratar as regras de cálculo para os valores adicionais de homem/hora e material, a figura da dimensão inicial e adicional foi acrescentada ao cadastro de Itens da Tarifa. Validando a dimensão para o reparo informado na vistoria do container e na estimativa será possível verificar se esta supera o valor da dimensão inicial parametrizado para o item de tarifa e quanto de adicional será incluído, sendo que desta forma o sistema será capaz de identificar se devem ser cobrados os adicionais ou não.

Outra modificação importante é que anteriormente não existia a possibilidade de que cada Armador possuísse seu próprio item de tarifa cadastrado com o próprio código de serviço. Isto impossibilitava que cada Armador tivesse seus próprios códigos e, no envio de EDIs, que fosse enviado o código correto para o Armador. Com a nova implementação, cada Armador cadastra seu próprio item de tarifa (serviço de reparo) e aponta (relaciona) ao serviço do SARA correspondente. Deste modo, o vistoriador deverá conhecer apenas os códigos de serviço do SARA e o analista de estimativa, com auxilio do próprio sistema, será capaz de identificar o serviço do Armador correspondente, de forma correta.

Importante!

 No quadro abaixo estão descritas as regras de cálculo, de acordo com o Tipo de cálculo selecionado para um item de tarifa.

Procedimento para Implantação

• Atualização do banco de dados por meio do AtualizaDB.
• Atualização dos executáveis do pacote. 
• Execução dos scripts do pacote.

Procedimento para Utilização

Tela de Tabela de Tarifas de Reparo (DEPOT)

1. Acesse o módulo Faturamento, menu DEPOT / Tabela de Tarifas de Reparo.
   O sistema deve apresentar a tela de cadastro de tabela de tarifas de reparo.
2. Valide se o campo Valor H/H está presente na tela.
3. Valide se a coluna Valor H/H está no grid entre as colunas Tipo de cotação e Cadastro.
4. Valide se a opção Clonar Tarifa está presente em Outras Ações da tela.
5. Insira uma nova tabela de tarifa informando o Valor h/h da tabela.
6. Clique em Gravar.
   O sistema deve efetivar o registro no banco de dados e recarregar as informações em tela.
7. Edite uma tabela de tarifa modificando o Valor h/h da tabela.
8. Clique em Gravar.
   O sistema deve efetivar o registro no banco de dados e recarregar as informações em tela.

Tela de Itens de Tarifa (DEPOT)

1. Acesse o módulo Faturamento, menu DEPOT / Tabela de Tarifas de Reparo.
   O sistema deve apresentar a tela de cadastro de tabela de tarifas de reparo.
2. Selecione uma tarifa ou crie uma nova e clique em Outras Ações / Itens da Tarifa.
   O sistema deve apresentar a tela de cadastro de Itens da Tarifa DEPOT).
3. Valide se os campos do agrupador Tarifa foram carregados corretamente.
4. Insira um novo Item de tarifa sem informar o Serviço do SARA.
   O sistema deve gravar o registro sem reclamar de campo não preenchido.
   Importante: os demais campos da tela são de preenchimento obrigatório, mas aceitam o valor 0 (zero) nos campos numéricos.
5. Valide se o campo Dt. Atualização foi atualizado automaticamente.
6. Insira um novo Item de tarifa informando o campo Serviço do SARA.
   O sistema deve gravar o registro mantendo o relacionamento.
7. Insira um novo Item de tarifa deixando os campos Dimensão inicial, Dimensão adicional, Área, H/H inicial, H/H adicional, Material inicial, Material adicional e Valor de um serviço com o valor 0 (zero).
   O sistema deve assumir o valor 3 - Livre no campo Tipo de cálculo, bem como, deve gravar o registro no banco de dados corretamente.
8. Insira um novo Item de tarifa deixando os campos H/H adicional e Material adicional com o valor 0 (zero). Informe os demais campos, exceto o campo Valor de um serviço.
   O sistema deve assumir o valor 1 - Calculado sem adicional no campo Tipo de cálculo, deve preencher automaticamente o valor de cálculo no campo Valor de um serviço e também deve gravar o registro no banco de dados corretamente.
9. Insira um novo Item de tarifa deixando um dos campos H/H adicional ou Material adicional com o valor 0 (zero), e informe os demais campos, exceto o campo Valor de um serviço.
   O sistema deve assumir o valor 2 - Calculado com adicional no campo Tipo de cálculo, deve informar automaticamente o valor de cálculo no campo Valor de um serviço e também deve gravar o registro no banco de dados corretamente.
10. Execute o mesmo procedimento do item anterior, mas agora informando os dois campos de adicional.
    O sistema deve ter o mesmo comportamento do item anterior;
11. Insira um novo item de tarifa agora, mas informando apenas o Valor de um serviço.
    O sistema deve assumir o valor 0 - Fixo valor informado no campo Tipo de cálculo, bem como, deve gravar o registro no banco de dados corretamente.
12. Valide se ao alterar a seleção no campo Tipo de cálculo para 0 - Fixo valor informado, o campo Valor de um serviço é habilitado.
13. Valide se ao alterar a seleção no campo Tipo de cálculo para 1 - Calculado sem adicional, o campo Valor de um serviço é desabilitado e o cálculo é informado automaticamente.
14. Valide se ao alterar a seleção no campo Tipo de cálculo para 2 - Calculado com adicional, o campo Valor de um serviço é desabilitado e o cálculo é informado automaticamente.
15. Valide se ao alterar a seleção no campo Tipo de cálculo para 3 - Livre, o campo Valor de um serviço é habilitado.
16. Selecione no grid um Item de tarifa cadastrado.
17. Edite o registro e grave novamente. O sistema deve ter o mesmo comportamento da inclusão e alterar os dados no banco de dados.

Tela de Importar Tarifas do Armador (DEPOT)

1. Acesse o módulo Faturamento, menu DEPOT / Tabela de Tarifas de Reparo.
   O sistema deve apresentar a tela de cadastro de tabela de tarifas de reparo.
2. Selecione uma tarifa ou crie uma nova e clique em Outras Ações / Itens da Tarifa.
   O sistema deve apresentar a tela de cadastro de Itens da Tarifa (DEPOT).
3. Clique em Outras Ações / Importar Tarifas.
   O sistema deve apresentar a tela de importação de tarifas do Armador.
4. Valide se o agrupador Tarifa é carregado corretamente.
5. Acione Abrir Arquivo Excel.
   O sistema deve abrir a tela, permitindo selecionar um arquivo Excel no modelo de importação de tarifas.
6. Ao selecionar o arquivo, valide se o campo Arquivo é preenchido com o caminho do arquivo Excel, e se o grid é carregado com os itens do arquivo Excel.
   Enquanto o sistema carrega o arquivo, um label com a mensagem Aguarde enquanto o sistema carrega os dados... deve aparecer ao lado de Executar Importação.
7. Clique em Executar Importação.
   O sistema deve exibir o label Aguarde enquanto o sistema importa os dados... e deve gravar os registros no banco de dados.
   Em cada linha do grid que for gravado com sucesso no banco de dados deve aparecer uma marcação indicando Sucesso.
   Em caso de falha na gravação de uma linha no grid deverá aparecer uma marcação de falha no grid.
8. Se no grid houver itens com marcação de falha após a importação, a opção Exportar Itens não Importados deve gerar uma nova planilha Excel somente com estes itens no mesmo padrão do modelo.
9. Feche a tela.
   O sistema deve retornar à tela anterior e carregar os dados importados automaticamente.
   O sistema deve aplicar as regras de cálculo no Tipo de cálculo, automaticamente durante a importação.

Tela de Clonar Tarifa do Armador (DEPOT)

1. Acesse o módulo Faturamento, menu DEPOT / Tabela de Tarifas de Reparo.
   O sistema deve apresentar a tela de cadastro de tabela de tarifas de reparo.
2. Crie uma nova tabela de tarifa e clique em Outras Ações / Clonar Tarifa.
   O sistema deve apresentar a tela para clonar uma tarifa do Armador.
3. Valide se o agrupador Tarifa é carregado corretamente.
4. Pesquise uma tarifa anterior no agrupador Clonar de.
   O sistema deve permitir que sejam pesquisadas somente Tarifas do mesmo Armador, com a mesma moeda parametrizada e que estejam no status de vencida ou cancelada.
   O sistema deve carregar os dados da tabela de tarifa e no grid carregar os itens da tarifa.
5. Clique em Clonar tarifa.
   O sistema deve exibir ao lado do botão uma mensagem com a seguinte frase Aguarde enquanto o sistema clona os dados da tarifa..., enquanto efetua a clonagem de tarifa.
   Ao término o sistema deve apresentar a mensagem Tarifa clonada com sucesso!, com a opção OK para confirmação.
6. Clique em OK.
   O sistema deve fechar a tela e retornar à tela anterior.

Ponto de Entrada

Exemplo:

#Include 'Protheus.ch'

User Function CN120ALT()

Local aCab:= PARAMIXB[1]

Local cTipo:= PARAMIXB[2]

If cTipo == '1'

    aCab[4][2]:= 'NF' //Validações do usuário

EndIf