Exibir origem

1. Identificação da Rotina

Nome da Rotina	Configurações Scania - Consulta/Cadastro Chassi Scania
Programa	OFIA544
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)	04/11/2025

2. Descrição Funcional

A rotina Consulta/Cadastro Chassi Scania(OFIA544) tem como objetivo de realizar a consulta a API Scania via Protheus DMS para a realização de um pré-cadastro de veículo.

Durante a utilização da rotina, a função valida os parâmetros recebidos e com base nessas informações o sistema realiza consultas na API da Scania, assim realizando ou não o pré-cadastro de um chassi ou motor.

Após a execução, as informações são gravadas na tabela VV1(Cadastro de veículos), caso o cadastro seja bem sucedido, ficam disponíveis para uso imediato pelos processos de Oficina e para futuras consultas ou ajustes além da possibilidade do complemento do cadastro durante a criação de um orçamento, abertura da OS ou liberação da OS.

Dessa forma, a rotina padroniza e simplifica a configuração da integração Scania dentro do Protheus, garantindo padronização e automatização do pré-cadastro no sistema, tornando o processo mais simples.

3. Pré-requisitos e Configurações

Para o correto funcionamento da rotina Consulta/Cadastro Chassi Scania(OFIA544), é necessário garantir pré-requisitos que asseguram a execução correta da mesma. Sendo eles:

É necessária a inclusão manual de cadastros utilizados na rotina OFIA544.

Premissas de Cadastro (Cadastros pré-requisitos)

Entidade	Programa	Campo chave
Cadastro da marca	OFIA950	VV1_CODMAR
Categorias	VEIVA100	VV2_CATVEI
Espécies	VEIVA110	VV2_ESPVEI
Tipos de veículos	VEIVA080	VV2_TIPVEI
Grupo de modelos	VEIVA220	VV2_GRUMOD
Modelo de veículo	VEIA030	VV1_MODVEI
Cores	VEIVA150	VV1_CROVEI
Cadastro NCM	VEIVA710	VV1_POTMOT

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

Disparo de função.
A função é chamada por outra rotina do Protheus mediante a necessidade de:
- Consultar dados de um chassi Scania
- Consultar dados de um motor Scania
- Efetuar o pré-cadastro automático de um veículo com base nos dados retornados da API Scania
Validação dos parâmetros
A função valida se:
- O chassi foi informado
- O motor foi informado (quando aplicado)
- Os formatos são aderentes aos padrões da API Scania
  Caso algum dado seja inválido, uma mensagem de erro é exibida:
  "Problema: Parametros Enviados Não Encontrados! Verifique o preenchimento e tente novamente."
Montagem da Requisição à API SCANIA / DMS.
A função constrói a requisição com base nos parâmetros recebidos:
- Tipo de autenticação
- Client ID
- Client Secret
- URL
- Grant Type
- Content Type
- URL Base
- End Point
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.

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

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 na seção TOKEN:
- Ambiente
- Integração Ativa?
- Tipo de Autenticação
- Client ID
- Client Secret
- URL
- Grand Type
- Content-Type
Preencha os parâmetros obrigatórios na seção Consulta Chassi Scania:
- Tipo de Autenticação
- URL Base
- End Point
Preencha os parâmetros obrigatórios na seção Gerais:
- 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.

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

Linha Microsiga Protheus > Configurações - Integrações Scania (OFIA541) > image-2025-10-31_15-43-20.png

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

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