Histórico da Página

...

Índice

minLevel	0
include	[Identificação da Rotina]
indent	10px

...

1. Identificação da Rotina

Nome da Rotina	Importação de Serviços Scania
Programa	OFIA533
Módulo ERP	Oficina (SIGAOFI)
Acesso à Rotina	Atualizações/Cadastros Oficina/Importação de Serviços Scania (OFIA533)
Data da Documentação (Ultima Última Atualização)	0104/0811/2025

...

2. Descrição Funcional

...

A rotina Importação de Serviços Scania (OFIA533) tem como finalidade importar e atualizar automaticamente os facilitar a importação e atualização dos serviços enviados pela montadora Scania para o sistema Protheus DMS, a partir de um arquivo XML fornecido pela própria montadora.
...
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 garante a integração automática e segura auxilia na organização e manutenção do cadastro dos serviços Scania com o dentro do Protheus, mantendo o cadastro sempre atualizado tornando o processo mais simples e reduzindo a necessidade de intervenções manuais.

...

3. Pré-requisitos e Configurações

...

Totvs custom tabs box

tabs	Pré-requisitos, Configurações, Atualização de Dicionário/Menu
ids	aba1,aba2,aba3

Totvs custom tabs box items

default	yes
referencia	aba1

Para o correto funcionamento da rotina Importação de Serviços Scania (OFIA533), é necessário garantir pré-condições que asseguram a leitura adequada do arquivo XML, o mapeamento dos grupos de serviço e a integração completa entre os dados da 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.

Bloco de código

language	xml
theme	RDark
title	Estrutura do arquivo XML

<dataroot xmlns:od="urn:schemas-microsoft-com:officedata" xmlns:xsi="http://www.w3.org/2000/10/XMLSchema-instance" xsi:noNamespaceSchemaLocation="standardtimes_pt-BR.xsd">
<STDTID>
<STDCODE>00000000-0</STDCODE>
<LANGUAGE_CODE>pt</LANGUAGE_CODE>
<WORKOBJECT>Teste objeto exemplo</WORKOBJECT>
<WORKTYPE>fazer</WORKTYPE>
<DESCR>Classificação, com seus itens.</DESCR>
<VARIANT>A,L,Z</VARIANT>
<TIMETYPE>N</TIMETYPE>
<ECC_KATEGORY>B</ECC_KATEGORY>
<TIME>0.1</TIME>
<TU>13</TU>
<PU>20</PU>
<INVOICE_TEXT>Teste objeto exemplo fazer</INVOICE_TEXT>
<COMPONENT_CODE/>
<P3TRUCK> </P3TRUCK>
<P3BUS> </P3BUS>
<P4TRUCK> </P4TRUCK>
<P4BUS>Y</P4BUS>
<P5TRUCK> </P5TRUCK>
<P5BUS> </P5BUS>
<P6TRUCK> </P6TRUCK>
<P6BUS> </P6BUS>
<P4IM> </P4IM>
<P5IM> </P5IM>
</STDTID>
</dataroot>

Nota

title	Informativo

Tamanho do arquivo XML: Aproximadamente 11 MB.
Quantidade de serviços contidos no arquivo: Cerca de 16 mil serviços.
Tempo de processamento do arquivo pela rotina: Aproximadamente 20 minutos.

Totvs custom tabs box items

default	no
referencia	aba2

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.

Dica

title	Exemplos de códigos de Grupos de Serviço montadora Scania

00 Generalidades
01 Motor
02 Sistema de arrefecimento
03 Sistemas de escape/combustível
04 Embreagem
05 Caixa de mudanças
06 Árvore de transmissão
07 Eixo dianteiro
08 Eixo traseiro
09 Cubo e rodas
10 Freios
11 Chassi
12 Suspensão
13 Direção
14 Controle do motor
16 Sistema elétrico
17 Instrumentos
18 Cabina
19 Equipamento complementar
20 Carroceria de carga
21 Reboque
43 Carroceria de ônibus Irizar

Informações

title	Aviso

Essas informações são de responsabilidade dos concessionários e deverão ser obtidas junto à Montadora Scania.

Totvs custom tabs box items

default	no
referencia	aba3

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

Tabela VOS - Grupos de Serviços

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

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 Oficina
Nome da Rotina	Importação de Serviços Scania
Programa	OFIA533
Módulo	Oficina (SIGAOFI)
Tipo	Função Protheus

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

Grupo	OFIA533	OFIA533	OFIA533	OFIA533	OFIA533
Grupo de campo	VE1
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

Observação:
Neste tópico, deve ser descrito o passo a passo do fluxo de utilização da rotina, apresentando de forma sequencial e didática como o usuário deve operar a funcionalidade, desde a etapa inicial até a final, incluindo interações com outras rotinas, validações e resultados esperados.

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

Observação:

Totvs custom tabs box items

default	yes
referencia	passo1

Prints e vídeos utilizados na documentação devem seguir o tema padrão do Protheus (Azul). O nome do usuário exibido deve ser apropriado e nunca deve ser utilizado o usuário "Admin".
Além disso, o passo a passo deve ser descrito de forma clara e objetiva, orientando o usuário pelo fluxo padrão da rotina, indicando visualmente onde clicar na tela e como utilizar as funcionalidades envolvidas.

Acesse o Modulo Acesse o Módulo 14 (Oficina).
Acesse o menu Atualizações→ Cadastros Atualizações → Cadastros Oficina → Importação de Serviços Scania (OFIA533).
Preencha os parâmetros obrigatórios:
- Marca
- Arquivo XML
- Quantidade Mecânicos 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, para o arquivo XML permanecer permanecerá no diretório original e nenhuma operação de mover ou apagar ser realizada com o arquivo selecionado após 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 , exibindo mensagens relacionadas à execução 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 para cada serviço incluído ou atualizado.
- Ao final do processamento, quando o arquivo for processado com sucesso, será exibida a mensagem referente à execução serão executadas ações personalizadas definidas através do ponto de entrada de conclusão da rotina.

Multimedia

name	Importação XML Nenhuma Ação.mp4
width	18001400
autostart	true
height	900700

Totvs custom tabs box items

default	no
referencia	passo2

Acessar Acesse o Modulo Módulo 14 (Oficina).
Acesse o menu Atualizações→ Cadastros 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.

Multimedia

name	Importação Arquivo XML Mover Arquivo.mp4
width	1400
autostart	true
height	700

Totvs custom tabs box items

default	no
referencia	passo3

Acessar Acesse o Modulo Módulo 14 (Oficina).
Acesse o menu Atualizações→ Cadastros Atualizações → Cadastros Oficina → Importação de Serviços Scania (OFIA533)

...

.

...

Observação:
Neste tópico, devem ser detalhadas todas as integrações com outros sistemas ou rotinas, bem como as dependências existentes para o correto funcionamento da rotina. Especifique, de forma clara e objetiva, os sistemas integrados, os protocolos de comunicação, as interfaces utilizadas e quaisquer requisitos técnicos que influenciem a operação e a manutenção da funcionalidade, caso não houver integrações relevantes favor colocar "Não se aplica" neste tópico.

Integração: Atualizações > Cadastros Oficina > Tabela de Serviços (OFIOA030)

6. Assuntos Relacionados

DT DMS SCANIA - Implementado campo Cod Grp Servico Montadora na rotina Grupo de Servicos (OFIOA020)

PE OF533SER para que seja possível executar ações personalizadas após a inclusão ou atualização de serviços durante o processo de importação na rotina Importação de Serviços Scania (OFIA533)

PE OF533FIM para que seja possível executar ações personalizadas após a conclusão do processamento completo do arquivo XML na rotina 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

name	Importação Arquivo XML Apagar Arquivo.mp4
width	1400
autostart	true
height	700

Totvs custom tabs box items

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).

Image Added

...

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

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=973046863" target="_blank" class="btn-doc">     
	📄 Novo campo Cod Grp Servico Montadora - Grupos de Serviço (OFIOA020)
  </a>
  <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=1008697602" target="_blank" class="btn-doc">     		
	📄 Ponto de Entrada OF533SER - Importação de Serviços Scania (OFIA533)   
  </a>
  <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=1008699858" target="_blank" class="btn-doc">     
	📄 Ponto de Entrada OF533FIM - Importação de Serviços Scania (OFIA533)   
  </a>
</div>

...

Árvore de páginas

Versões comparadas

Versão antiga 52

Nova versão Atual

Chave

1. Identificação da Rotina

2. Descrição Funcional

3. Pré-requisitos e Configurações

4. Fluxo de Utilização

6. Assuntos Relacionados

5. Integrações e Dependências

6. Assuntos Relacionados