Exibir origem

1. Identificação da Rotina

Nome da Rotina	Atualização de Lista de Preços
Programa	OFIA539
Módulo ERP	Oficina (SIGAOFI)
Acesso à Rotina	? / ? /Atualização da Lista de Preços (OFIA539)
Data da Documentação (Última Atualização)	10/12/2025

2. Descrição Funcional

A rotina Atualização da Lista de Preços (OFIA539) 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 PRI9600.TXT que contém os valores de preços de venda, 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 da Lista de Preços (OFIA539), é necessário garantir pré-condições que asseguram a leitura adequada do arquivo XML, o mapeamento dos grupos de serviço e o correto tratamento dos dados entre a Scania e o Protheus DMS. São elas:

O campo “Cod. Grp Mont” deve estar adicionado na rotina Grupos de Serviço (OFIOA020), garantindo o vínculo correto entre os grupos de serviço da montadora Scania e os grupos cadastrados no Protheus.
É necessário incluir manualmente a rotina Importação de Serviços Scania (OFIA533) no menu do Protheus, permitindo assim o acesso à funcionalidade.
Deve-se possuir um arquivo XML válido contendo os serviços enviados pela montadora Scania, que será utilizado como base para o processo de importação.

Item      V.ini   V.Fim   TPDesc.     MC  %MCDesc.  IPIClassif.    PIS  CFS        Publico    Publico 30d         BalcaoPQt.Peca_Emb
1111111   01012025        01NORMAL    1101100011110011111111110  0011001010000000000111111000000000111111000000000111111S1          
2222222   01022025        01NORMAL    2202200022220022222222220  0022002020000000000002222000000000002222000000000002222S1          
3333333   01032025        01NORMAL    3303300033330033333333300  0033300330000000000000333000000000000333000000000000333S1          
4444444   01042025        01NORMAL    4402500044440044444444400  0044400440000000000004044000000000004444000000000004444S1 
1111111   01012025        01NORMAL    1101100011110011111111110  0011001010000000000111111000000000111111000000000111111S1          
2222222   01022025        01NORMAL    2202200022220022222222220  0022002020000000000002222000000000002222000000000002222S1          
3333333   01032025        01NORMAL    3303300033330033333333300  0033300330000000000000333000000000000333000000000000333S1          
4444444   01042025        01NORMAL    4402500044440044444444400  0044400440000000000004044000000000004444000000000004444S1
1111111   01012025        01NORMAL    1101100011110011111111110  0011001010000000000111111000000000111111000000000111111S1          
2222222   01022025        01NORMAL    2202200022220022222222220  0022002020000000000002222000000000002222000000000002222S1          
3333333   01032025        01NORMAL    3303300033330033333333300  0033300330000000000000333000000000000333000000000000333S1          
4444444   01042025        01NORMAL    4402500044440044444444400  0044400440000000000004044000000000004444000000000004444S1

Tamanho do arquivo PRI9600.TXT: Aproximadamente XX MB.
Quantidade de peças existentes no arquivo: Cerca de XX mil peças.
Tempo de processamento do arquivo pela rotina: Aproximadamente XX minutos.

Para que a importação de serviços ocorra corretamente durante o processamento do arquivo XML, é necessário que na rotina Grupos de Serviço (OFIOA020), existam registros cadastrados com o campo “Cod. Grp Mont” devidamente preenchido, conforme os códigos pré-definidos pela montadora Scania.

Essa configuração garante o correto mapeamento entre os grupos de serviço da Scania e os grupos cadastrados no Protheus, permitindo que o sistema identifique e vincule corretamente os serviços durante o processo de importação.

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	?
Submenu	?
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

4. Fluxo de Utilização

Acesse o Módulo 14 (Oficina).
Acesse o menu Atualizações → Cadastros Oficina → Importação de Serviços Scania (OFIA533).
Preencha os parâmetros obrigatórios:
- Marca
- Arquivo XML
- Quantidade Mecânicos
- Ação pós Processamento
No parâmetro Arquivo XML, será exibida uma tela mostrando o servidor (pasta protheus_data) e seus diretórios. Selecione o arquivo XML que será processado pela rotina.
No parâmetro Ação pós Processamento:
- Selecione a opção Nenhuma Ação. Com isso, o arquivo XML permanecerá no diretório original e sem ser movido ou apagado após seu processamento.
Após preencher todos os parâmetros obrigatórios, clique no botão “OK”.
- A rotina processará o arquivo XML e após a inclusão ou atualização de cada serviço 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 Oficina → Importação de Serviços Scania (OFIA533).
Preencha os parâmetros obrigatórios:
- Marca
- Arquivo XML
- Quantidade Mecânicos
- Ação pós Processamento
No parâmetro Arquivo XML, será exibida uma tela mostrando o servidor (pasta protheus_data) e seus diretórios. Selecione o arquivo XML que será processado pela rotina.
No parâmetro Ação pós Processamento:
- Selecione a opção Mover Arquivo. Com isso, o parâmetro Mover Para será habilitado, permitindo que seja selecionado 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 XML e após a inclusão ou atualização de cada serviço 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 Oficina → Importação de Serviços Scania (OFIA533).
Preencha os parâmetros obrigatórios:
- Marca
- Arquivo XML
- Quantidade Mecânicos
- Ação pós Processamento
No parâmetro Arquivo XML, será exibida uma tela mostrando o servidor (pasta protheus_data) e seus diretórios. Selecione o arquivo XML que será processado pela rotina.
No parâmetro Ação pó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 XML e após a inclusão ou atualização de cada serviço 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.

Linha Microsiga Protheus > Atualização da Lista de Preços (OFIA539) > image-2025-12-10_9-41-38.png

5. Integrações e Dependências

Integração

Para o correto funcionamento da rotina, durante a execução da Importação de Serviços Scania (OFIA533) ocorre a integração com a rotina Tabela de Serviços (OFIOA030).
Após o processamento bem-sucedido do arquivo XML, os serviços contidos no arquivo são cadastrados na Tabela de Serviços caso ainda não existam, ou terão o campo "Tmpo Fábrica" (VO6_TEMFAB) atualizado, caso já estejam registrados.
Essa integração garante que os dados enviados pela montadora Scania sejam incorporados ao Protheus, mantendo o cadastro de serviços sempre atualizado e alinhado às informações da montadora.

6. 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=1018563765" target="_blank" class="btn-doc">     		
	📄 Ponto de Entrada OA539LIN - Atualização da Lista de Preços (OFIA539)   
  </a>
  <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=1018563840" target="_blank" class="btn-doc">     
	📄 Ponto de Entrada OA539FIM - Atualização da Lista de Preços (OFIA539)   
  </a>
</div>