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 da Lista de Preços (OFIA539) |
| País: | Brasil |
| Ticket: | Não se aplica |
| Requisito/Story/Issue: | DVARMIL-10944 |
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 de venda das peças fornecidas pela montadora Scania por meio de um arquivo PRI9600.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 da Lista de Preços (OFIA539), que lê arquivos PRI9600.TXT enviados pela montadora Scania e atualiza os preços de venda 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 PRI9600.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 PRI9600.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 da Lista de Preços (OFIA539) no menu do Protheus, permitindo o acesso à funcionalidade.
- Deve-se possuir um arquivo PRI9600.TXT válido, contendo as informações e preços de venda 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 da Lista de Preços (OFIA539).
- Preencha os parâmetros:
- No parâmetro Diretório do Arquivo? 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 PRI9600.TXT que será processado pela rotina.
- No parâmetro Grupos de Produto? 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 Destino Público?, ao clicar no ícone da lupa, será exibida uma listagem onde deve ser selecionado o preço de venda desejado.
- No parâmetro Destino Público 30d?, ao clicar no ícone da lupa, será exibida uma listagem onde deve ser selecionado o preço de venda desejado.
- No parâmetro Destino Balcão?, 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 Venda (B1_PRV1)
- Preco Venda2 (B5_PRV2)
- Preco Venda3 (B5_PRV3)
- Preco Venda4 (B5_PRV4)
- Preco Venda5 (B5_PRV5)
- Preco Venda6 (B5_PRV6)
- Preco Venda7 (B5_PRV7)
Sendo o campo Preco Venda (B1_PRV1) presente na aba Cadastrais, seção Descrição Genérica do Produto, e os outros campos de venda 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 PRI9600.TXT.
Exemplo: Se no parâmetro Destino Público? for selecionado o preço "B1_PRV1", o campo Preco Venda da rotina Peças (MATA010) será atualizado com o valor da coluna "Publico" 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 Atu. Quant. 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 PRI9600.TXT permanecerá no diretório original, sem ser movido, nem apagado após o processamento.
Mover Arquivo: o parâmetro Mover Para? será habilitado e terá preenchimento obrigatório, 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 PRI9600.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 PRI9600.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 da Lista de Preços |
Programa | OFIA539 |
Módulo | Oficina (SIGAOFI) |
Tipo | Função Protheus |
Criação de Pergunte no arquivo SX1 – Pergunta:
Grupo | OFIA539 | OFIA539 | OFIA539 | OFIA539 |
|---|---|---|---|---|
Grupo de campo | ||||
Ordem | 01 | 02 | 03 | 04 |
Pergunta | Diretório do Arquivo | Grupos de Produto | Destino Público | Destino Público 30d |
Tipo | C | C | C | C |
| Tamanho | 99 | 80 | 40 | 40 |
| Decimal | 0 | 0 | 0 | 0 |
| Var01 | MV_PAR01 | MV_PAR02 | MV_PAR03 | MV_PAR04 |
| Formato | ||||
| Validação | OA539005M_PreValid(1) | !Vazio() .And. OA539005M_PreValid(2) | Vazio() .Or. OA539005M_PreValid(3) | Vazio() .Or. OA539005M_PreValid(3) |
| Objeto | Get | Get | Get | Get |
| Consulta Padrão | VX5PRV | VX5PRV | ||
| Pré-Seleção (Combo) | ||||
| Item 1 | ||||
| Item 2 | ||||
| Item 3 | ||||
| Item 4 | ||||
| Item 5 | ||||
| Help |
Grupo | OFIA539 | OFIA539 | OFIA539 | OFIA539 |
|---|---|---|---|---|
Grupo de campo | ||||
Ordem | 05 | 06 | 07 | 08 |
Pergunta | Destino Balcão | Atu. Quant. por Embalagem | Ação após Processamento | Mover Para |
Tipo | C | C | C | C |
| Tamanho | 40 | 1 | 1 | 99 |
| Decimal | 0 | 0 | 0 | 0 |
| Var01 | MV_PAR05 | MV_PAR06 | MV_PAR07 | MV_PAR08 |
| Formato | ||||
| Validação | Vazio() .Or. OA539005M_PreValid(3) | If( MV_PAR07==2, OA539005M_PreValid(4) ,Vazio()) | ||
| Objeto | Get | Combo | Combo | Get |
| Consulta Padrão | VX5PRV | |||
| 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/1230276 12.1.2310:https://r.totvs.io/p/1230277 12.1.2410:https://r.totvs.io/p/1230278 12.1.2510:https://r.totvs.io/p/1230279 |
|---|
Esta atualização de dicionário estará disponível na release 12.01.2610. IMPORTANTE!
05. ASSUNTOS RELACIONADOS