01. DADOS GERAIS
| Produto: | |
|---|
| Linha de Produto: | |
|---|
| Segmento: | |
|---|
| 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 o cadastro 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).
- É 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 configurar se os dados de indicadores de produto serão considerados pela tabela "Descrição Genérica do Produto" (SB1) ou se serão considerados pela tabela "Indicadores de Produtos" (SBZ).
- Acesse o Módulo 14 (Oficina).
- Acesse o menu ? → ? → 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.
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 | ? |
|---|
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

05. ASSUNTOS RELACIONADOS
<style>
.link_container {
display: flex;
flex-direction: column;
align-items: flex-start; /* Alinhado à esquerda */
width: 100%;
gap: 8px; /* Espaçamento entre os itens */
}
.btn-doc,
.btn-doc:link,
.btn-doc:visited {
display: inline-block;
padding: 12px 24px;
font-size: 16px;
font-weight: 600;
color: #FFFFFF !important; /* Força o texto branco */
background-color: #08244C; /* Fundo azul escuro */
border: none;
border-radius: 8px;
text-decoration: none;
text-align: left;
transition: background-color 0.3s ease, transform 0.2s ease, color 0.3s ease;
}
.btn-doc:hover {
background-color: #FFFFFF; /* Azul mais claro no hover */
color: #08244C !important; /* Mantém texto branco */
transform: scale(1.03);
}
.btn-doc:active {
background-color: #061B3B; /* Azul ainda mais escuro no clique */
color: #FFFFFF !important; /* Mantém texto branco */
transform: scale(0.98);
}
</style>
<div class="link_container">
<a href="https://tdn.totvs.com/pages/viewpage.action?pageId=1017443440" target="_blank" class="btn-doc">
📄 Atualização de Preço Garantia e Contrato (OFIA537)
</a>
<a href="https://tdn.totvs.com/pages/viewpage.action?pageId=1017446392" target="_blank" class="btn-doc">
📄 Ponto de Entrada OFA537GR - Atualização de Preço Garantia e Contrato (OFIA537)
</a>
<a href="https://tdn.totvs.com/pages/viewpage.action?pageId=1018563130" target="_blank" class="btn-doc">
📄 Ponto de Entrada OFA537FI - Atualização de Preço Garantia e Contrato (OFIA537)
</a>
</div> |
