01. DADOS GERAIS
| Produto: |
TOTVS DMS |
|---|---|
| Linha de Produto: | Linha Protheus |
| Segmento: | Varejo |
| Módulo: |
Totvs DMS (Linha Protheus) - Oficina (SIGAOFI) |
| Função: | Atualização de Preço Garantia e Contrato (OFIA537) |
| País: | Brasil |
| Ticket: | Não há/Não se aplica. |
| Requisito/Story/Issue: | DVARMIL-10892 |
02. SITUAÇÃO/REQUISITO
Após levantamentos realizados sobre estudos baseando-se nos processos e regras de negócio da montadora Scania, foi identificada a necessidade de criar uma rotina que permita realizar a atualização de preço das peças fornecidas pela montadora Scania por meio de um arquivo PRI RM.TXT, facilitando o recebimento e a atualização dessas informações dentro do sistema Protheus DMS.
03. SOLUÇÃO
A solução implementada consistiu na criação da rotina Atualização de Preço Garantia e Contrato (OFIA537), que realiza a leitura de arquivos PRI RM.TXT enviados pela montadora Scania e permite a atualização dos preços de peças no cadastro de Peças do sistema Protheus DMS.
Para que a rotina funcione corretamente, é necessário garantir algumas condições que asseguram a leitura adequada do arquivo PRI RM.TXT, o mapeamento das peças previamente cadastradas e o correto tratamento dos dados no sistema. São elas:
- As peças existentes no arquivo PRI RM.TXT devem ter sido previamente cadastradas na rotina de Peças (MATA010) ou pela rotina Importação Glass (OFIA538).
- É necessário incluir manualmente a rotina Atualização de Preço Garantia e Contrato (OFIA537) no menu do Protheus, permitindo assim o acesso à funcionalidade.
- Deve-se possuir um arquivo PRI RM.TXT válido contendo as informações e preços das peças enviados pela montadora Scania, que será utilizado como base para execução da rotina.
- Configurar corretamente o parâmetro "MV_ARQPROD" que é responsável por determinar se os dados dos indicadores de produto serão considerados pela tabela "Descrição Genérica do Produto" (SB1) ou pela tabela "Indicadores de Produtos" (SBZ).
- Acesse o Módulo 14 (Oficina).
- Acesse o menu Atualizações → Cadastros Peças → Atualização de Preço Garantia e Contrato (OFIA537).
- Preencha os parâmetros:
- No parâmetro Arquivo para Importação? que possui preenchimento obrigatório, ao sair do campo, será exibida uma tela mostrando o servidor (pasta protheus_data) e seus diretórios. Selecione o arquivo PRI RM.TXT que será processado pela rotina.
- No parâmetro Grupo a considerar? que possui preenchimento obrigatório, será necessário preencher o(s) grupo(s) vinculado(s) às peças já cadastradas no Protheus e existentes na rotina Grupos de Peças (MATA035).
- No parâmetro Dest. P.Dealer_Contrat?, ao clicar no ícone da lupa, será exibida uma listagem onde deve ser selecionado o preço de venda desejado.
- No parâmetro Dest. P.Dealer_Normal?, ao clicar no ícone da lupa, será exibida uma listagem onde deve ser selecionado o preço de venda desejado.
- No parâmetro Dest. P.Balcão_Contrat?, ao clicar no ícone da lupa, será exibida uma listagem onde deve ser selecionado o preço de venda desejado.
- No parâmetro Dest. P.Balcão_Normal?, ao clicar no ícone da lupa, será exibida uma listagem onde deve ser selecionado o preço de venda desejado.
Atualização dos preços: A listagem apresentada nos parâmetros acima consiste nos seguintes campos:
- Preco Venda2 (B5_PRV2)
- Preco Venda3 (B5_PRV3)
- Preco Venda4 (B5_PRV4)
- Preco Venda5 (B5_PRV5)
- Preco Venda6 (B5_PRV6)
- Preco Venda7 (B5_PRV7)
Esses campos estão presentes na aba Vendas, seção Dados Adicionais do Produto, rotina Peças (MATA010).
A atualização ocorrerá da seguinte forma: o campo referente ao preço selecionado no parâmetro será atualizado com o valor correspondente existente no arquivo PRI RM.TXT.
Exemplo: Se no parâmetro Dest. P.Dealer_Contrat? for selecionado o preço "B5_PRV4", o campo Preco Venda4 da rotina Peças (MATA010) será atualizado com o valor da coluna "P.Dealer_Contrato" do arquivo.
Observação: Não é permitido utilizar o mesmo preço de venda em parâmetros diferentes, ou seja, caso um preço de venda já tenha sido selecionado em um parâmetro, se selecionado o mesmo preço em um segundo parâmetro ao clicar no botão OK para execução da rotina ocorrerá a validação dos parâmetros e será exibida uma mensagem em tela abortando a operação.
- No parâmetro Atualiza Qtd. por Embalagem? que possui preenchimento obrigatório, caso seja selecionada a opção 1 - Sim, a quantidade de peças por embalagem será atualizada de acordo com a configuração realizada anteriormente para o parâmetro "MV_ARQPROD". Caso seja selecionada a opção 2 - Não, não haverá atualização da quantidade de peças por embalagem.
No parâmetro Ação após processamento, selecione uma das opções abaixo:
Nenhuma Ação: o arquivo PRI RM.TXT permanecerá no diretório original, sem ser movido, nem apagado após o processamento.
Mover Arquivo: o parâmetro Mover Para? será habilitado, permitindo selecionar o diretório de destino dentro do servidor. Ao final do processamento, o arquivo será movido automaticamente do diretório original para o diretório informado.
Apagar Arquivo: ao término do processamento, o arquivo PRI RM.TXT será excluído do diretório original.
Após preencher todos os parâmetros obrigatórios, clique no botão “OK”.
A rotina processará o arquivo PRI RM.TXT e, após a atualização de preço e da quantidade por embalagem de cada peça, serão executadas ações personalizadas definidas através do ponto de entrada criado para execução após o processamento de cada item.
Ao final do processamento, quando o arquivo for concluído com sucesso, serão executadas ações personalizadas definidas através do ponto de entrada destinado à conclusão da rotina, e o sistema aplicará a ação de pós-processamento selecionada (manter, mover ou apagar o arquivo).
- No Configurador (SIGACFG), acesse Ambientes/Cadastros/Menu (CFGX013) e informe as novas opções de menu do módulo de Oficina (SIGAOFI) conforme instruções a seguir:
Menu | Atualizações |
|---|---|
Submenu | Cadastros Peças |
Nome da Rotina | Atualização de Preço Garantia e Contrato |
Programa | OFIA537 |
Módulo | Oficina (SIGAOFI) |
Tipo | Função Protheus |
Criação de Pergunte no arquivo SX1 – Pergunta:
Grupo | OFIA537 | OFIA537 | OFIA537 | OFIA537 | OFIA537 |
|---|---|---|---|---|---|
Grupo de campo | |||||
Ordem | 01 | 02 | 03 | 04 | 05 |
Pergunta | Arquivo para Importação? | Grupo a Considerar? | Dest. P.Dealer_Contrat | Dest. P.Dealer_Normal? | Dest. P.Balcão_Contrat |
Tipo | C | C | C | C | C |
| Tamanho | 80 | 99 | 10 | 10 | 10 |
| Decimal | 0 | 0 | 0 | 0 | 0 |
| Var01 | MV_PAR01 | MV_PAR02 | MV_PAR03 | MV_PAR04 | MV_PAR05 |
| Formato | |||||
| Validação | OA537009M_VldFldOk(1) | !Vazio() .And. OA537VlGrp() | Vazio() .OR. OA537009M_VldFldOk(2) | Vazio() .OR. OA537009M_VldFldOk(2) | Vazio() .OR. OA537009M_VldFldOk(2) |
| Objeto | Get | Get | Get | Get | Get |
| Consulta Padrão | VX5PRC | VX5PRC | VX5PRC | ||
| Pré-Seleção (Combo) | |||||
| Item 1 | |||||
| Item 2 | |||||
| Item 3 | |||||
| Item 4 | |||||
| Item 5 | |||||
| Help |
Grupo | OFIA537 | OFIA537 | OFIA537 | OFIA537 |
|---|---|---|---|---|
Grupo de campo | ||||
Ordem | 06 | 07 | 08 | 09 |
Pergunta | Dest. P.Balcão_Normal? | Atualiza Qtd. por Embalagem? | Ação após Processamento? | Mover Para? |
Tipo | C | N | N | C |
| Tamanho | 10 | 1 | 1 | 80 |
| Decimal | 0 | 0 | 0 | 0 |
| Var01 | MV_PAR06 | MV_PAR07 | MV_PAR08 | MV_PAR09 |
| Formato | ||||
| Validação | Vazio() .OR. OA537009M_VldFldOk(2) | If( MV_PAR08==2, OA537009M_VldFldOk(3) ,Vazio()) | ||
| Objeto | Get | Combo | Get | Get |
| Consulta Padrão | VX5PRC | |||
| Pré-Seleção (Combo) | 2 | 1 | ||
| Item 1 | Sim | Nenhuma Ação | ||
| Item 2 | Não | Mover Arquivo | ||
| Item 3 | Apagar Arquivo | |||
| Item 4 | ||||
| Item 5 | ||||
| Help |
04. DEMAIS INFORMAÇÕES
| Pacote gerados | 12.1.2210: https://r.totvs.io/p/1227898 12.1.2310: https://r.totvs.io/p/1227899 12.1.2410: https://r.totvs.io/p/1227900 12.1.2510: https://r.totvs.io/p/1227901 |
|---|
Esta atualização de dicionário estará disponível na release 12.01.2610. IMPORTANTE!
05. ASSUNTOS RELACIONADOS