Histórico da Página
...
| Índice | ||||||
|---|---|---|---|---|---|---|
|
...
1. Identificação da Rotina
Nome da Rotina | Importação Glass |
|---|---|
| Programa | OFIA538 |
| Módulo ERP | Oficina (SIGAOFI) |
| Acesso à Rotina | Atualizações/Cadastros |
| Peças/Importação Glass (OFIA538) |
| Data da Documentação ( |
|---|
| Última Atualização) |
|---|
|
...
2. Descrição Funcional
A rotina Importação GLASS (OFIA538) tem como finalidade facilitar objetivo simplificar a importação e atualização das peças enviadas pela montadora Scania para o sistema Protheus DMS, a partir de um do arquivo GLASS (Global Assortment), disponibilizado pela própria montadora no formato .DAT.
Esse arquivo contém informações sobre peças, peças substituídas e kits de peças.
) (.DAT) fornecido pela montadora. Esse arquivo reúne informações de peças, substituições e kits.
Ao iniciar a rotina, o usuário deve Durante a execução da rotina, é necessário preencher os parâmetros obrigatórios e opcionais na tela inicial de configuração, para garantir , que orientam o comportamento do processo e garantem a consistência dos dados antes de prosseguir com o processamento da leitura do arquivo.
Após as validaçõesa validação dos parâmetros, o sistema interpreta o conteúdo do arquivo GLASS e executa o processamento de realiza a inclusão ou atualização das peças , de acordo com conforme as informações oficiais enviadas pela da Scania.
Concluída a importaçãoFinalizado o processamento, o sistema executa as ações de pós-processamento configuradas, que podem incluir, definidas na configuração, como manter, mover ou apagar excluir o arquivo, e gera além de gerar logs detalhados com o resultado detalhamento da operação.
Dessa formaAssim, a rotina OFIA538 auxilia na Importação GLASS (OFIA538) contribui para a organização e manutenção do cadastro de peças da Scania dentro do no Protheus DMS, tornando o processo mais eficiente e parametrizável, garantindo que o cadastro de peças no Protheus se mantenha atualizado com as informações oficiaisdisponibilizadas pela Scania. e substituindo a rotina OFIIA440, que possuía parâmetros fixos e menor desempenho em arquivos de grande volume., parametrizável e alinhado às informações oficiais da montadora.
...
3. Pré-requisitos e Configurações
| Totvs custom tabs box | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Totvs custom tabs box items |
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. Totvs custom tabs box items |
Criação de Campo no arquivo SX3 – Campos:
Campo | VOS_GRPSER | Tipo | Caractere | Grupo de Campos | Ordem | 09 | Tamanho | 2 | Decimal | 0 | Formato | @! | Contexto | 1-Real | Propriedade | 1-Alterar | Título | Cod Grp Mont | Descrição | Cod Grp Servico Montadora | Val. Sistema | OA0200018_VldGrp() | Opções | Inic. Padrão | Inic. Browse | Cons. Padrão | Nível | 1 | Usado | Sim | Obrigatório | Não | Browse | Não | When | Pasta | Help | Grupo de servico da Montadora
Menu Atualizações Submenu Cadastros Oficina | 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 OFIA533 | OFIA533 | OFIA533 | OFIA533 | OFIA533 | Ordem 01 | 02 | 03 | 04 | 05 | Pergunta Marca ? | Arquivo XML ? | Quantidade Mecânicos ? | Ação pós Processamento ? | Mover Para ? | Tipo C | C | N | C | C | Tamanho | 3 | 99 | 1 | 1 | 99 | Decimal | 0 | 0 | 0 | 0 | 0 | Var01 | MV_PAR01 | MV_PAR02 | MV_PAR03 | MV_PAR04 | MV_PAR05 | Formato | @E 9 | Validação | ExistCpo("VE1",MV_PAR01) | OA533002K_ValidPerg() | !Vazio() .AND. (MV_PAR03 >= 1 .And. MV_PAR03 <= 9) | NaoVazio() | OA533002K_ValidPerg() | Objeto | Get | Get | Get | Combo | Get | Consulta Padrão | VE1 | Pré-Seleção (Combo) | 1 | Item 1 | Nenhuma Ação | Item 2 | Mover Arquivo | Item 3 | Apagar Arquivo | Item 4 | Item 5 | Help | |
4. Fluxo de Utilização
...
| 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 |
...
| default | yes |
|---|---|
| referencia | passo1 |
- Acesse o Módulo 14 (Oficina).
- Acesse o menu Atualizações → Cadastros Oficina → Importação Glass (OFIA538).
- Preencha os parâmetros obrigatórios:
- Grupo Padrão da Peça
- Armazém Padrão
- Seleção de arquivo .DAT
- Ação pós 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 Nenhuma Ação. Com isso, o arquivo .DAT 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 .DAT 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.
| Multimedia | ||||||||
|---|---|---|---|---|---|---|---|---|
|
...
| default | no |
|---|---|
| referencia | passo2 |
- Acesse o Módulo 14 (Oficina).
- Acesse o menu Atualizações → Cadastros Oficina → Importação Scania (OFIA538).
- Preencha os parâmetros obrigatórios:
- Grupo Padrão da Peça
- Armazém Padrão
- Seleção do arquivo .DAT
- Ação pós 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 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 .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, 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.
| Multimedia | ||||||||
|---|---|---|---|---|---|---|---|---|
|
|
...
4. Fluxo de Utilização
| Totvs custom tabs box | ||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||
|
...
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> |
...
| default | no |
|---|---|
| referencia | passo3 |
- 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.
| Multimedia | ||||||||
|---|---|---|---|---|---|---|---|---|
|
...
| default | no |
|---|---|
| referencia | passo4 |
Após a execução da rotina, será possível visualizar na tabela VQL (Informacoes genericas) 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_TIPO (Tipo), será registrado o local de execução da rotina, podendo ser via Menu ou Schedule;
- 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).
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.




