Histórico da Página

...

Índice

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

...

1. Identificação da Rotina

Nome da Rotina	Configurações Scania - Consulta/Cadastro Chassi ScaniaIntegrações Scania (OFIA541)
Programa	OFIA541
Módulo ERP	Oficina (SIGAOFI)
Acesso à Rotina	Atualizações/ Cadastros Oficina/Importação de Serviços Move Integração Montadora/Integrações Scania ( OFIA533 OFIA541)
Data da Documentação (Ultima Última Atualização)	04/11/2025

...

2. Descrição Funcional

A rotina Consulta/Cadastro Chassi rotina Integrações Scania (OFIA541) tem como objetivo centralizar e organizar todos os parâmetros necessários para a comunicação entre o Protheus DMS e o serviço disponibilizado pela Scania(API).

Durante a utilização da rotina, é necessário preencher os parâmetros obrigatórios(URLs, endpoints e configurações gerais). 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.

principal objetivo apresentar a aba Integração API Scob onde são preenchidas as informações utilizadas na consulta à API da Scania via Protheus DMS para a realização de um pré-cadastro de veículo.

Durante sua utilização, a função valida os parâmetros recebidos e com base nessas informações o sistema possibilitará o preenchimento automático dos cadastros de veículos no Protheus.

Após a execução, caso o cadastro seja bem-sucedido, os dados do veículo são gravados Após a execução, as informações são gravadas na tabela VV1 (Cadastro de veículos) , caso o cadastro seja bem sucedido e 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 da API dentro do Protheus, tornando o processo mais simples e reduzindo a necessidade de intervenções manuais, garantindo padronização, automatização do pré-cadastro no sistema, assim reduzindo erros manuais e acelerando o processo de registro.

...

3. Pré-requisitos e

...

Configurações

...

Para o correto funcionamento da rotina

...

Integrações Scania (OFIA541)

...

é necessário garantir pré-

...

requisitos que asseguram

...

a execução correta. Sendo eles:

É necessário incluir manualmente a rotina Integrações Scania (OFIA541) no

...

menu do Protheus, permitindo assim o acesso à

...

aba Integração API Scob.
Deve-se possuir

...

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.

...

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.

...

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.

todos os dados de acesso à API para o preenchimento dos campos da aba Integração API Scob.
É necessária a inclusão manual de premissas de cadastro.

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 - Veículo	VEIVA710	VV1_POTMOT

...

4. Fluxo de Utilização

...

default	no
referencia	aba3

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

Tabela VOS - Grupos de Serviços

...

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

...

Nome da Rotina

...

Programa

...

OFIA533

...

Módulo

...

Oficina (SIGAOFI)

...

Tipo

...

Função Protheus

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

...

Grupo

...

Grupo de campo

...

Ordem

...

Pergunta

...

Tipo

...

4. Fluxo de Utilização

...

yes
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
Tipo de Autenticação (Bearer Token)
URL Base (Fornecidos pela marca ao concessionário)
End Point (Fornecidos pela marca ao concessionário)
Preencha os parâmetros obrigatórios na seção Gerais:
Pré-Cadastro Automático (Sim ou Não)
Local Padrão (Selecionar local padrão)
Exibe tela de complementação do cadastro? (Não exibe/Orçamento Oficina/Abertura da OS/Liberação da OS)
, 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.
Totvs custom tabs box items
default
no
referencia passo1
Configuração Inicial – Integrações Scania (OFIA541)
Acesse o Módulo 14 (Oficina).
Acesse o menu Atualizações
→ Cadastros Oficina →Importação de Serviços
→ Move Integração Montadora → Integrações Scania (
OFIA533
OFIA541).
// n sei onde vai ficar
Dentro da aba Integração API Scob preencha
Preencha
os parâmetros obrigatórios na seção TOKEN

:
Ambiente

(Produção ou Homologação)
Integração Ativa? (Sim ou Não)
Tipo de Autenticação (Basic Auth)
Client ID (Fornecidos pela marca ao concessionário)
Client Secret (Fornecidos pela marca ao concessionário)
URL

(Fornecidos pela marca ao concessionário)
Grand Type (Fornecidos pela marca ao concessionário)
Grant Type
Content-Type (Fornecidos pela marca ao concessionário)
Preencha
os
os parâmetros obrigatórios na seção
Consulta
Consulta Chassi
Scania
:
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, o arquivo XML 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 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.
Multimedia
name Importação XML Nenhuma Ação.mp4
width 1400
autostart true
height 700
Totvs custom tabs box items
default no
referencia passo2
Multimedia
name Importação Arquivo XML Mover Arquivo.mp4
width 1400
autostart true
height 700
Totvs custom tabs box items
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
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 Removed
“Confirmar”:
Ao confirmar:
Todos os valores são salvos na tabela VRN (JSON)
Se o ambiente mudar, os parâmetros correspondentes são carregados automaticamente
Campos obrigatórios são validados.
Parâmetros configurados e aptos para uso

Multimedia
name OFIA541.mp4
width 1280
height 720

...

5. Integrações e Dependências

IntegraçãoPara

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 montadoraDurante a execução, é acionada a função de pré-cadastro de veículos via API. As informações importadas da montadora passam a estar disponíveis para uso durante a Abertura de Atendimento Digital Dealer, na Geração da Senha de Priorização de Atendimento e em outras rotinas que dependem da consulta ou inclusão automática dos dados do veículo.

...

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=9730468631019330273" target="_blank" class="btn-doc">     		
	📄 NovoDVARMIL-11638 campoDT Cod- GrpAPI ServicoCadastro Montadorade -Veículos GruposScania de Serviço (OFIOA020)  
  </a>
  <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=10086976021020363440" target="_blank" class="btn-doc">     		
	📄 Ponto de Entradaentrada OF533SER - Importação de Serviços Scania (OFIA533)OF544PRE API Scania   
  </a>
   <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=10086998581020364912" target="_blank" class="btn-doc">     
	📄 Ponto de Entradaentrada OF533FIM - Importação de ServiçosOF544POS API Scania (OFIA533)   
  </a> 
</div>

Árvore de páginas

Versões comparadas

Versão antiga 5

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

4. Fluxo de Utilização

5. Integrações e Dependências

6. Assuntos Relacionados