Histórico da Página

...

1. Identificação da Rotina

Data da Documentação (
Nome da Rotina	Importação Glass
Programa	OFIA538
Módulo ERP	Oficina (SIGAOFI)
Acesso à Rotina	Atualizações/Cadastros Peças/Importação Glass (OFIA538)

Ultima

Última Atualização)

24

05/

11

12/2025

...

2. Descrição Funcional

A rotina Importação GLASS (OFIA538) tem como objetivo simplificar a importação e atualização das peças enviadas pela Scania para o Protheus DMS, a partir do arquivo GLASS (Global Assortment) (.DAT) fornecido pela montadora. Esse arquivo reúne informações de peças, substituições e kits.

...

Finalizado o processamento, o sistema executa as ações de pós-processamento definidas definidas na configuração, como manter, mover ou excluir o arquivo, além de gerar logs com o detalhamento da operação.

Assim, a rotina Importação GLASS (OFIA538 contribui ) contribui para a organização e manutenção do cadastro de peças da Scania no Protheus DMS, tornando o processo mais eficiente, parametrizável e alinhado às informações oficiais da montadora.

...

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:

Criação de Pergunte no arquivo SX1 – Pergunta:

Totvs custom tabs box

tabs	Pré-requisitos, Atualização de Dicionário/Menu
ids	aba1,aba3aba2

Totvs custom tabs box items

default	yes
referencia	aba1

Para o correto funcionamento da rotina Importação Glass (OFIA538), é necessário garantir pré-condições que asseguram a leitura adequada do arquivo .DAT:

É necessário incluir manualmente a rotina Importação Glass (OFIA538)

ao

Tamanho do arquivo .DAT: Aproximadamente 224 MB*.
Quantidade de peças contidos no arquivo: Aproximadamente 1 270 588 peças*.
Tempo de processamento do arquivo pela rotina: Aproximadamente 30 minutos*.

*Essas informações podem variar de acordo com o arquivo e a quantidade de filiais.

no menu do Protheus, permitindo assim o acesso à funcionalidade.
Deve-se possuir um arquivo com a extensão .DAT contendo as peças enviadas pela montadora Scania, que será utilizado como base para o processo de importação.

Bloco de código

theme	RDark
title	Exemplo arquivo DAT

010000001PECA TESTE

TESTE

                 TESTE          ITEM SUBSTITUIDO              ARTICULO REEMPLAZADO          REPLACED ITEM

000010000001N0000560PECA FORJADA

000010000001N0000560PECA TESTE                         99
0400000013170991   0000001                                                                                                                        99
010001200TESTE - TESTE TESTE

99 010001200TUBO

-

TESTE

SISTEMA

TUBO

       ITEM DESATIVADO

TUBE

        ARTICULO DESATIVADO

ITEM

DESATIVADO

        DEACTIVED ITEM

ARTICULO

DESATIVADO

DEACTIVED

109400000001I0001530TESTE

ITEM

- TESTE TESTE                99
0400012000811288   0000001

109400000001I0001530TUBO

-

SISTEMA

FREIO

99 0400012000811288

0000001

                                                                                              99
010001400TESTE-TESTE TESTE             TESTE          ITEM SUBSTITUIDO              ARTICULO REEMPLAZADO

99 010001400TUBO-ACO

S/COSTTUBO

    REPLACED ITEM

TUBE

ITEM

SUBSTITUIDO

 109400000001I0000500TESTE TESTE - TESTE

ARTICULO

REEMPLAZADO

     99
020001400TESTE

REPLACED

ITEM

109400000001I0000500TUBO-ACO

S/COSTURA

99 020001400L/LS101

                                                                                 99
020001400LK140

99 020001400LK140

                                                                           99
0400014000811285   0000001

99 0400014000811285

0000001

                                                       99
010001683PECA TESTE                    TESTE          ITEM DESCONTINUADO            ARTICULO DESCONTINUADO        DESCONTINUED                    199100000001I0004030TESTE

99 010001683ANEL DISTANCIADANILLO

RING

99
020001683TESTE.T

ITEM

DESCONTINUADO

ARTICULO

DESCONTINUADO

DESCONTINUED

ITEM

199100000001I0004030ANEL

DISTANCIADOR

99 020001683MAR.14

                                                              99
010001719TESTE                         TESTE          ITEM DESCONTINUADO            ARTICULO DESCONTINUADO        DESCONTINUEDD                   019990000001I0000000TESTE

99 010001719PROLONGADOR

X

PROLONG

99
020001719TESTE.T

ITEM

DESCONTINUADO

ARTICULO

DESCONTINUADO

DESCONTINUED

ITEM

019990000001I0000000PROLONGADOR

99 020001719MAR.14

                                                     99
010001721TESTE(TESTE)                  TESTE          ITEM DESCONTINUADO            ARTICULO DESCONTINUADO        DESCONTINUED                    019660000001I0000000TESTE(TESTE)                       99
020001721TESTE.T

99 010001721FLANGE(AMORTECEX

FLANGE

ITEM

DESCONTINUADO

ARTICULO

DESCONTINUADO

DESCONTINUED

ITEM

019660000001I0000000FLANGE(AMORTECEDOR

VIBRACOES-MOTOR)99 020001721MAR.14

                                                       99
010001722TESTE                         TESTE          ITEM DESCONTINUADO            ARTICULO DESCONTINUADO        DESCONTINUED                    199010000001N0000000TESTE TESTE

99 010001722PARAFUSO

ALLEN

X BOLT ITEM DESCONTINUADO ARTICULO DESCONTINUADO DESCONTINUED ITEM 199010000001N0000000PARAFUSO ALLEN 12X120 99

Nota

title	Informativo

Nota

title	Informativo

Tamanho do arquivo .DAT: Aproximadamente 224 MB*.
Quantidade de peças contidas no arquivo: Aproximadamente 1 270 588 peças*.
Tempo de processamento do arquivo pela rotina: Aproximadamente 30 minutos*.

*Essas informações podem variar de acordo com o arquivo e a quantidade de filiais.

35

Totvs custom tabs box items

default	no
referencia	aba2

Criação de Campo no arquivo VE9 – Campos:

Tabela VE9 - Substituição de Itens

Campo	VE9_SEGMEN	VE9_STAGLA	VE9_APLICA	VE9_STATUS
Tipo	Caractere	Caractere	Caractere	Caractere
Grupo de Campos
Ordem	16	17	18	19
Tamanho	2	30	35	2
Decimal	0	0	0	0
Formato	@!	@!	@!	@!
Contexto	1-Real	1-Real	1-Real	1-Real
Propriedade	1-Alterar	1-Alterar	1-Alterar	1-Alterar
Título	Segmento Reg	Status Glass	Aplica Item	Status
Descrição	Segmento do registro	Descrição Status Glass	Aplicação do Item	Status
Val. Sistema	Pertence("01/02/03/04/05/06")
Opções
Inic. Padrão
Inic. Browse
Cons. Padrão
Nível
Usado	Sim	Sim	Sim	Sim
Obrigatório	Não	Não	Não	Não
Browse
When
Pasta
Help	Campo utilizado para indicar o tipo de informação vinculada ao item, permitindo ao sistema classificar e tratar corretamente o registro. Opções: 01 Informação Básica do Item 02 Informação Utilização do Item 03 Observação do Item 04 Informação Substituição do Item 05 Observação da Substituição do Item 06 Informação Composição do Kit	Indica a descrição do status do item importado do arquivo Glass, exclusivo da montadora Scania.	Informa os dados de utilização do item, exclusivos da montadora Scania.	Indica o status do item importado do arquivo Glass, exclusivo da montadora Scania.

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	Importação Glass
Programa	OFIA538
Módulo	Oficina (SIGAOFI)
Tipo	Função Protheus

Criação de Pergunte no arquivo SX1 – Pergunta:

Grupo	OFIA538	OFIA538	OFIA538	OFIA538
Grupo de Campo	162	003	004	024
Ordem	01	02	03	04
Pergunta	Grupo Padrão Da Peça	Conta Contábil Padrão Peça	Centro De Custo Padrão Peça	Armazém Padrão da Peça
Tipo	C	C	N	C
Tamanho	2	20	2

Totvs custom tabs box items

default	no
referencia	aba3

Criação de Campo no arquivo VE9 – Campos:

Tabela VE9 - Substituição de Itens

Campo

VE9_SEGMEN

VE9_STAGLA

VE9_APLICA

VE9_STATUS

Tipo

Caractere

Grupo de Campos

Ordem

16

17

18

19

Tamanho

2

30

Formato
	2
Decimal	0	0	0	0
Var01	MV_PAR01	MV_PAR02	MV_PAR03	MV_PAR04

@!

Contexto

1-Real

Propriedade

1-Alterar

Segmento Reg

Status Glass

Aplica Item

Status

Descrição

Segmento do registro

Descrição Status Glass

Aplicação do Item

Status

Val. Sistema

Pertence("01/02/03/04/05/06")

Opções

Inic. Padrão

Inic. Browse

Cons. Padrão

Nível

Usado

Sim

Obrigatório

Não

Browse

When

Pasta

Help

Campo utilizado para indicar o tipo de informação vinculada ao item, permitindo ao sistema classificar e tratar corretamente o registro.

Opções:

01 Informação Básica do Item

02 Informação Utilização do Item

03 Observação do Item

04 Informação Substituição do Item

05 Observação da Substituição do Item

06 Informação Composição do Kit

Indica a descrição do status do item importado do arquivo Glass, exclusivo da montadora Scania.

Informa os dados de utilização do item, exclusivos da montadora Scania.

Indica o status do item importado do arquivo Glass, exclusivo da montadora Scania.

Menu

Atualizações

Submenu

Cadastros Peças

Nome da Rotina

Importação Glass

Programa

OFIA538

Módulo

Oficina (SIGAOFI)

Tipo

Função Protheus

Grupo

OFIA538

Grupo de Campo

162

003

004

024

Ordem

01

02

03

04

Pergunta

Grupo Padrão Da Peça

Conta Contábil Padrão Peça

Centro De Custo Padrão Peça

Armazém Padrão da Peça

Tipo

C

N

C

Tamanho

2

20

2

Decimal

0

Var01

MV_PAR01

MV_PAR02

MV_PAR03

MV_PAR04

Formato

Validação

OA538016J()

OA538017J()

OA538018J()

OA538019J()

Objeto

Get

Consulta Padrão

SBM

CT1

CTT

NNR

Pré-Seleção (Combo)

0

Item 1

Item 2

Item 3

Item 4

Item 5

Help

Grupo

OFIA538

Grupo de Campo

Ordem

05

06

07

Pergunta

Arquivo .DAT

Ação Após o Processamento

Mover Para

Tipo

C

Tamanho

99

1

50

Decimal

0

Var01

MV_PAR05

MV_PAR06

MV_PAR07

Formato

Validação

OA538022J_ValidPerg()

Objeto

File

Combo

Get

Consulta Padrão

Pré-Seleção (Combo)

0

Item 1

Nenhuma Ação

Item 2

Mover Arquivo

Item 3

Apagar Arquivo

Item 4

Item 5

Help

4. Fluxo de Utilização


Validação	OA538016J()	OA538017J()	OA538018J()	OA538019J()
Objeto	Get	Get	Get	Get
Consulta Padrão	SBM	CT1	CTT	NNR
Pré-Seleção (Combo)	0	0	0	0
Item 1
Item 2
Item 3
Item 4
Item 5
Help

Grupo	OFIA538	OFIA538	OFIA538
Grupo de Campo
Ordem	05	06	07
Pergunta	Arquivo .DAT	Ação Após o Processamento	Mover Para
Tipo	C	C	C
Tamanho	99	1	50
Decimal	0	0	0
Var01	MV_PAR05	MV_PAR06	MV_PAR07
Formato
Validação			OA538022J_ValidPerg()
Objeto	File	Combo	Get
Consulta Padrão
Pré-Seleção (Combo)	0	0	0
Item 1		Nenhuma Ação
Item 2		Mover Arquivo
Item 3		Apagar Arquivo
Item 4
Item 5
Help

...

4. Fluxo de Utilização

Totvs custom tabs box

tabs	Passo a passo: Ação pós Processamento - Nenhuma Ação, Passo a passo: Ação pós Processamento - Mover Arquivo, Passo a passo: Ação pós Processamento - Apagar Arquivo, Gravação de Logs
ids	passo1,passo2,passo3,passo4

Totvs custom tabs box

tabs	Passo a passo: Ação pós Processamento - Nenhuma Ação, Passo a passo: Ação pós Processamento - Mover Arquivo, Passo a passo: Ação pós Processamento - Apagar Arquivo, Gravação de Logs
ids	passo1,passo2,passo3,passo4

Totvs custom tabs box items

default	yes
referencia	passo1

Acesse o Módulo 14 (Oficina).
Acesse o menu Atualizações → Cadastros Peças → Importação Glass (OFIA538).
Preencha os parâmetros obrigatórios:
- Grupo Padrão da Peça
- Armazém Padrão da Peça
- Arquivo .DAT
- Ação Após o Processamento
No parâmetro Arquivo .DAT, será exibida uma tela mostrando o servidor (pasta protheus_data) e seus diretórios. Selecione o arquivo .DAT que será processado pela rotina.
No parâmetro Ação Após o Processamento:
- Selecione a opção Nenhuma Ação. Com isso, o arquivo .DAT permanecerá no diretório originalsem ser movido ou apagado após o processamento.
Após preencher todos os parâmetros obrigatórios, clique no botão “OK”.
- A rotina processará o arquivo .DAT e após a inclusão ou atualização das peças serão executadas ações personalizadas definidas através do ponto de entrada.
- Ao final do processamento, serão executadas ações personalizadas definidas através dos pontos de entrada de conclusão da rotina.

Image Added

Totvs custom tabs box items

default	no
referencia	passo2

Acesse o Módulo 14 (Oficina).
Acesse o menu Atualizações → Cadastros Peças → Importação Glass (OFIA538).
Preencha os parâmetros obrigatórios:
- Grupo Padrão da Peça
- Armazém Padrão da Peça
- Arquivo .DAT
- Ação Após o Processamento
No parâmetro Arquivo .DAT, será exibida uma tela mostrando o servidor (pasta protheus_data) e seus diretórios. Selecione o arquivo .DAT que será processado pela rotina.
No parâmetro Ação Após o Processamento:
- Selecione a opção Mover Arquivo. Com isso, o parâmetro Mover Para será habilitado, permitindo que seja selecionado o diretório destino no 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 .DAT e após a inclusão ou atualização das peças serão executadas ações personalizadas definidas através do ponto de entrada.
- Ao final do processamento, 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.

Image Added

Totvs custom tabs box items

default	no
referencia	passo3

Acesse o Módulo 14 (Oficina).
Acesse o menu Atualizações → Cadastros Peças → Importação Glass (OFIA538).
Preencha os parâmetros obrigatórios:
- Grupo Padrão da Peça
- Armazém Padrão da Peça
- Arquivo .DAT
- Ação Após o Processamento
No parâmetro Arquivo .DAT, será exibida uma tela mostrando o servidor (pasta protheus_data) e seus diretórios. Selecione o arquivo .DAT 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, o arquivo será apagado do diretório onde foi selecionado.
Após preencher todos os parâmetros obrigatórios, clique no botão “OK”.
- A rotina processará o arquivo .DAT e após a inclusão ou atualização das peças, serão executadas ações personalizadas definidas através do ponto de entrada.
- Ao final do processamento, 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.

Image Added

Acesse o Módulo 14 (Oficina).

Acesse o menu Atualizações → Cadastros Peças → Importação Glass (OFIA538).

Preencha os parâmetros obrigatórios:

Grupo Padrão da Peça
Armazém Padrão da Peça
Arquivo .DAT
Ação Após o Processamento

No parâmetro Arquivo .DAT, será exibida uma tela mostrando o servidor (pasta protheus_data) e seus diretórios. Selecione o arquivo .DAT que será processado pela rotina.

No parâmetro Ação Após o Processamento:Selecione a opção Nenhuma Ação. Com isso, o arquivo .DAT permanecerá no diretório originalsem ser movido ou apagado após o processamento.

Após preencher todos os parâmetros obrigatórios, clique no botão “OK”.

A rotina processará o arquivo .DAT e após a inclusão ou atualização das peças serão executadas ações personalizadas definidas através do ponto de entrada.
Ao final do processamento, serão executadas ações personalizadas definidas através dos pontos de entrada de conclusão da rotina.Image Removed

Acesse o Módulo 14 (Oficina).
Acesse o menu Atualizações → Cadastros Peças → Importação Glass (OFIA538).
Preencha os parâmetros obrigatórios:
- Grupo Padrão da Peça
- Armazém Padrão da Peça
- Arquivo .DAT
- Ação Após o Processamento
No parâmetro Arquivo .DAT, será exibida uma tela mostrando o servidor (pasta protheus_data) e seus diretórios. Selecione o arquivo .DAT que será processado pela rotina.
No parâmetro Ação Após o Processamento:
- Selecione a opção Mover Arquivo. Com isso, o parâmetro Mover Para será habilitado, permitindo que seja selecionado o diretório destino no 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 .DAT e após a inclusão ou atualização das peças serão executadas ações personalizadas definidas através do ponto de entrada.
- Ao final do processamento, 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.

Image Removed

Acesse o Módulo 14 (Oficina).
Acesse o menu Atualizações → Cadastros Peças → Importação Glass (OFIA538).
Preencha os parâmetros obrigatórios:
- Grupo Padrão da Peça
- Armazém Padrão da Peça
- Arquivo .DAT
- Ação Após o Processamento
No parâmetro Arquivo .DAT, será exibida uma tela mostrando o servidor (pasta protheus_data) e seus diretórios. Selecione o arquivo .DAT 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, o arquivo será apagado do diretório onde foi selecionado.
Após preencher todos os parâmetros obrigatórios, clique no botão “OK”.
- A rotina processará o arquivo .DAT e após a inclusão ou atualização das peças, serão executadas ações personalizadas definidas através do ponto de entrada.
- Ao final do processamento, 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.

Image Removed

Após a execução da rotina, será possível visualizar na tabela VQL os registros de logs gerados pelo processamento, conforme o exemplo na imagem abaixo.

Na coluna VQL_AGROUP (Agrupador), será registrado o nome do fonte da rotina;
Na coluna VQL_TIPO (Tipo), será registrado o status da ação após o processamento, se houve sucesso, erro e também o início da ação.
Na coluna VQL_MSGLOG (Mensagens de Log), será registrada a mensagem de log referente ao status de execução da rotina (Início, Processamento, Finalização ou Erro).

Image Removed

Totvs custom tabs box items

default	yes
referencia	passo1

Totvs custom tabs box items

default	no
referencia	passo2

Totvs custom tabs box items

default	no
referencia	passo3

Totvs custom tabs box items

default	no
referencia	passo4

5. Integrações e Dependências

Integrações

...

no
referencia	passo4

Após a execução da rotina, será possível visualizar na tabela VQL os registros de logs gerados pelo processamento, conforme o exemplo na imagem abaixo.

Na coluna VQL_AGROUP (Agrupador), será registrado o nome do fonte da rotina;
Na coluna VQL_TIPO (Tipo), será registrado o status da ação após o processamento, se houve sucesso, erro e também o início da ação.
Na coluna VQL_MSGLOG (Mensagens de Log), será registrada a mensagem de log referente ao status de execução da rotina (Início, Processamento, Finalização ou Erro).

Image Added

...

5. Integrações e Dependências

Integrações

Ao final da execução, as peças importadas pela rotina Importação Glass (OFIA538) estarão disponíveis nas rotinas de Cadastro de Peças (MATA010), Peças Substituídas (OFIPA910) e Kits (OFIPA920).

Principais campos importados após o processamento do arquivo DAT
Cadastro de Peças			Substituição de Itens					Cadastro de Kits
Tabela SB1(Segmento 01)	Tabela SB5	Tabela SBZ	Tabela VE9					Tabela VEH(Cabeçalho)	Tabela VE8(Itens do Kit)
B1_DATCAD	B5_COD	BZ_COD	Todos Segmentos	Segmento 01	Segmento 02	Segmento 04	Segmento 06	Segmento 06
B1_COD	B5_CEME	BZ_LOCPAD	VE9_FILIAL	VE9_STAGLA	VE9_APLICA	VE9_ITENOV	VE9_ITENOV	VEH_FILIAL	VE8_FILIAL
B1_GRUPO	B5_UMIND		VE9_SEGMEN	VE9_ITENOV	VE9_ITENOV	VE9_QTDADE	VE9_QTDADE	VEH_TIPO	VE8_TIPO
B1_CODITE			VE9_NROSEQ			VE9_DATSUB		VEH_GRUKIT	VE8_GRUKIT
B1_FABRIC			VE9_NROSUB			VE9_QTDSUB		VEH_CODKIT	VE8_CODKIT
B1_DESC			VE9_GRUITE			VE9_STATUS		VEH_DESKIT	VE8_GRUITE
B1_UM			VE9_GRUNOV					VEH_VALKIT	VE8_CODITE
B1_SEGUM			VE9_ITEANT						VE8_QTDADE
B1_TIPO
B1_LOCPAD
B1_CONTA
B1_CC

...

6. Assuntos Relacionados

HTML

<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=1014654380" target="_blank" class="btn-doc">     		
	📄 Ponto de Entrada OF538PRO - Importação Glass (OFIA538)   
  </a>
  <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=1014655032" target="_blank" class="btn-doc">     
	📄 Ponto de Entrada OF538FIM - Importação Glass (OFIA538)   
  </a>
</div>

...

Árvore de páginas

Versões comparadas

Versão antiga 55

Nova versão Atual

Chave

1. Identificação da Rotina

2. Descrição Funcional

4. Fluxo de Utilização

4. Fluxo de Utilização

5. Integrações e Dependências

5. Integrações e Dependências

6. Assuntos Relacionados