1. Identificação da Rotina


Nome da Rotina

Importação de Serviços Scania
ProgramaOFIA533
Módulo ERPOficina (SIGAOFI)
Acesso à RotinaAtualizações/Cadastros Oficina/Importação de Serviços Scania (OFIA533)
Data da Documentação (Ultima Atualização)

 



2. Descrição Funcional


Observação:
Neste tópico, é necessário descrever de forma clara e objetiva a funcionalidade da rotina, explicando qual é seu propósito, por que ela foi criada e qual a sua importância dentro do sistema.


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.

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 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. São elas:

  1. 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.
  2. É necessário incluir manualmente a rotina Importação de Serviços Scania (OFIA533) no menu do Protheus, permitindo assim o acesso à funcionalidade.
  3. 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.



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.


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


  • Tabela VOS - Grupos de Serviços


CampoVOS_GRPSER
TipoCaractere
Grupo de Campos
Ordem09
Tamanho2
Decimal0
Formato@!
Contexto1-Real
Propriedade1-Alterar
TítuloCod Grp Mont
DescriçãoCod Grp Servico Montadora
Val. SistemaOA0200018_VldGrp()
Opções
Inic. Padrão
Inic. Browse
Cons. Padrão
Nível1
UsadoSim
ObrigatórioNão
BrowseNã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

OFIA533OFIA533OFIA533OFIA533OFIA533

Ordem

0102030405

Pergunta

Marca ?Arquivo XML ?Quantidade Mecânicos ?Ação pós Processamento ?Mover Para ?

Tipo

CCNCC
Tamanho3991199
Decimal00000
Var01MV_PAR01MV_PAR02MV_PAR03MV_PAR04MV_PAR05
Formato

@E 9

ValidaçãoExistCpo("VE1",MV_PAR01)OA533002K_ValidPerg()!Vazio() .AND. (MV_PAR03 >= 1 .And. MV_PAR03 <= 9)NaoVazio()OA533002K_ValidPerg()
ObjetoGetGetGetComboGet
Consulta PadrãoVE1



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.


  1. Acessar o Modulo 14 (Oficina)
  2. Acesse o menu Atualizações→ Cadastros Oficina → Importação de Serviços Scania (OFIA533)
  3. teste




  1. Acessar o Modulo 14 (Oficina)
  2. Acesse o menu Atualizações→ Cadastros Oficina → Importação de Serviços Scania (OFIA533)
  3. aaaaaa




  1. Acessar o Modulo 14 (Oficina)
  2. Acesse o menu Atualizações→ Cadastros Oficina → Importação de Serviços Scania (OFIA533)
  3. bbbbbbb






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.


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)



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




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.