1. Identificação da Rotina
Nome da Rotina | Atualização de Preço Garantia e Contrato |
|---|---|
| Programa | OFIA537 |
| Módulo ERP | Oficina (SIGAOFI) |
| Acesso à Rotina | Atualizações/Cadastros Peças/Atualização de Preço Garantia e Contrato (OFIA537) |
| Data da Documentação (Última Atualização) |
|
2. Descrição Funcional
A rotina Atualização de Preço Garantia e Contrato (OFIA537) tem como finalidade facilitar a atualização dos preços de peças no sistema Protheus DMS de acordo com a tabela da montadora Scania, a partir da leitura do arquivo PRI RM.TXT que contém os valores de contrato e garantia, fornecido pela própria montadora.
Antes da execução da rotina, é necessário que as peças existentes no arquivo fornecido pela montadora já tenham sido previamente cadastradas na rotina de Peças (MATA010), seja pelo próprio cadastro ou pela rotina Importação Glass (OFIA538).
Durante a execução da rotina, é necessário preencher os parâmetros obrigatórios. Com base nessas informações e no mapeamento das peças previamente cadastradas, o sistema realiza as validações necessárias para identificar e atualizar os preços e a quantidade de peças por embalagem por meio do processamento do arquivo.
Após a importação, o sistema executa as ações de pós-processamento configuradas, que podem incluir mover, apagar ou manter o arquivo, e registra logs com o resultado da operação.
Dessa forma, a rotina auxilia na manutenção e atualização do cadastro das peças da Scania no Protheus, tornando o processo mais simples e reduzindo a necessidade de intervenções manuais.
3. Pré-requisitos e Configurações
Para o correto funcionamento da rotina Atualização de Preço Garantia e Contrato (OFIA537), é necessário garantir pré-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 entre a Scania e o Protheus DMS. 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 os preços das peças enviados pela montadora Scania, que será utilizado como base para a execução da rotina.
Cod.Item Descrição_Item Status Qt.Peça_Emb. PRG Descr.PRG Preço_Harm. %Desc.PRG Grupo Descr.Grupo Vig.Inicial %IPI %PIS %COFINS P.Dealer_Contrato P.Dealer_Normal MC_Contrato P.Balcao_Contrato P.Balcao_Normal Clas.Fiscal ---------- -------------------- ------ ------------ ----- ------------- ----------- --------- ----- --------------- ----------- ----- ----- ------- ----------------- --------------- ----------- ----------------- --------------- ----------- 0000000 PECA DE TESTES A A 1 444 Test Part S 1.1 1 GRUPO TESTE 01/02/2025 1.11 3.3 22.2 999.99 888.88 11 6666.66 1111.11 00000000 1111111 PECA DE TESTES B I 2 333 Test Part S 2.2 2 GRUPO TESTE 01/01/2025 2.22 4.4 33.3 88.88 77.77 22 55.55 22.22 11111111 2222222 PECA DE TESTES C A 3 222 Test Part S 3.3 3 GRUPO TESTE 01/03/2025 1.1 1.11 4.4 7.77 6.66 33 4.44 3.33 22222222 3333333 PECA DE TESTES D I 4 111 Test Part S 4.4 4 GRUPO TESTE 01/04/2025 2.2 2.22 1.1 6 5.55 44 3.33 44.44 33333333 0000000 PECA DE TESTES A A 1 444 Test Part S 1.1 1 GRUPO TESTE 01/02/2025 1.11 3.3 22.2 999.99 888.88 11 6666.66 1111.11 00000000 1111111 PECA DE TESTES B I 2 333 Test Part S 2.2 2 GRUPO TESTE 01/01/2025 2.22 4.4 33.3 88.88 77.77 22 55.55 22.22 11111111 2222222 PECA DE TESTES C A 3 222 Test Part S 3.3 3 GRUPO TESTE 01/03/2025 1.1 1.11 4.4 7.77 6.66 33 4.44 3.33 22222222 3333333 PECA DE TESTES D I 4 111 Test Part S 4.4 4 GRUPO TESTE 01/04/2025 2.2 2.22 1.1 6 5.55 44 3.33 44.44 33333333 0000000 PECA DE TESTES A A 1 444 Test Part S 1.1 1 GRUPO TESTE 01/02/2025 1.11 3.3 22.2 999.99 888.88 11 6666.66 1111.11 00000000
Informativo
- Tamanho do arquivo PRI RM.txt: Aproximadamente 40 MB.
Para que a atualização de preços e de quantidade por embalagem ocorra corretamente durante o processamento do arquivo PRI RM.TXT, é necessário que o parâmetro "MV_ARQPROD" esteja configurado corretamente.
Esse parâmetro determina 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).
Caso nos parâmetros do pergunte seja selecionado para atualizar a quantidade por embalagem, durante a execução da rotina o sistema gravará esse valor no local apropriado:
- Na coluna "B1_QE" da tabela SB1, caso o parâmetro indique uso da tabela SB1, que corresponde ao campo Qtd. Embalag. existente na seção "Descrição Genérica do Produto", aba MRP/Suprimentos da rotina Peças (MATA010);
- Na coluna "BZ_QE" da tabela SB1, caso o parâmetro indique uso da tabela SBZ, correspondente à coluna Qtd. Embalag. da tabela presente na seção "Indicadores de Produtos".
Essa configuração garante a identificação e a atualização dos preços e das quantidades das peças de forma correta.
- 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 |
4. Fluxo de Utilização
- 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 a opção Nenhuma Ação. Com isso, o arquivo PRI RM.TXT permanecerá no diretório original, sem ser movido nem apagado após o processamento.
- 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 quantidade por embalagem de cada peça, serão executadas ações personalizadas definidas através do ponto de entrada.
- Ao final do processamento, quando o arquivo for processado com sucesso, serão executadas ações personalizadas definidas através do ponto de entrada de conclusão da rotina.
- 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 a opção Mover Arquivo. Com isso, 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 do diretório de origem para o diretório selecionado.
- 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 quantidade por embalagem de cada peça, serão executadas ações personalizadas definidas através do ponto de entrada.
- Ao final do processamento, quando o arquivo for processado com sucesso, serão executadas ações personalizadas definidas através do ponto de entrada de conclusão da rotina, e o arquivo será movido do diretório original para o diretório destino indicado no parâmetro Mover Para.
- 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 a opção Apagar Arquivo. Com isso, ao término do processamento do arquivo, ele será apagado do diretório de onde foi selecionado.
- 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 quantidade por embalagem de cada peça, serão executadas ações personalizadas definidas através do ponto de entrada.
- Ao final do processamento, quando o arquivo for processado com sucesso, serão executadas ações personalizadas definidas através do ponto de entrada de conclusão da rotina, e o arquivo será apagado do diretório original onde foi selecionado.
Após a execução da rotina, será possível visualizar na tabela VQL (Informações genéricas) os registros de log do processamento, conforme o exemplo apresentado na imagem abaixo.
- Na coluna VQL_AGROUP (Agrupador), será registrado o nome do fonte da rotina;
- Na coluna VQL_MSGLOG (Mensagens de Log), será registrada a mensagem de log contendo informações como mensagem (Processamento ou Erro), empresa, filial, usuário, modo de execução (manual ou schedule) e os valores informados nos parâmetros da rotina.
5. Integrações e Dependências
Integração
Para o correto funcionamento da rotina, durante a execução da Atualização de Preço Garantia e Contrato (OFIA537) ocorre a integração com as rotinas Peças (MATA010) e Complemento Peça (MATA180).
Essa integração garante que os dados das peças no Protheus sejam atualizados de acordo com a tabela da montadora Scania, mantendo o cadastro de peças sempre atualizado e alinhado às informações da montadora.
