Exibir origem

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 Atualização)	01/08/2025

2. Descrição Funcional

A rotina Importação de Serviços Scania (OFIA533) tem como finalidade importar e atualizar automaticamente os serviços enviados pela montadora Scania para o sistema Protheus DMS, a partir de um arquivo XML fornecido pela própria montadora.

Durante a execução da rotina, é necessário preencher os parâmetros obrigatórios. Com base nessas informações e no mapeamento dos Grupos de Serviço previamente cadastrados, o sistema realiza as validações necessárias para identificar e incluir ou atualizar os serviços por meio do processamento do arquivo XML.

Após a importação, o sistema executa as ações de pós processamento configuradas — como 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 dos serviços Scania com o Protheus, mantendo o cadastro sempre atualizado e reduzindo a necessidade de intervenções manuais.

3. Pré-requisitos e Configurações

Observação:
Neste tópico, devem ser informados todos os pré-requisitos e configurações necessárias para o correto funcionamento da rotina, como parametrizações, permissões, cadastros obrigatórios, tabelas envolvidas ou qualquer dependência técnica ou funcional.

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 Scania e o Protheus DMS, sendo elas:

O campo “Cód. Grp Serviço Montadora” 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.

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

Observação:
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.

5. Integrações e Dependências

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.

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)

Observação:
Neste tópico, devem ser listados links ou referências para rotinas, documentos, parametrizações, tabelas ou funcionalidades que possuam relação direta com a rotina documentada. O objetivo é facilitar o entendimento do contexto e oferecer ao leitor acesso a conteúdos complementares que possam auxiliar no uso ou na configuração da funcionalidade, caso não houver assuntos relacionados relevantes favor colocar "Não se aplica" neste tópico.