Histórico da Página

...

...

1. Identificação da Rotina

...

2. Descrição Funcional

A rotina Consulta/Cadastro Chassi rotina Integrações Scania (OFIA544OFIA541) tem como principal objetivo de realizar a consulta a API 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 a sua 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 motorpossibilitará o preenchimento automático dos cadastros de veículos no Protheus.

Após a execução, as informações são gravadas caso o cadastro seja bem-sucedido, os dados do veículo são gravados 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, garantindo padronização e , automatização do pré-cadastro no sistema, tornando assim reduzindo erros manuais e acelerando o processo mais simplesde 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:

1. É necessário incluir manualmente a rotina Integrações Scania (OFIA541) no menu do Protheus, permitindo assim o acesso à aba Integração API Scob.
2. Deve-se possuir todos os dados de acesso à API para o preenchimento dos campos da aba Integração API Scob.
3. É necessária a inclusão manual de

...

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

...

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

...

yespasso2

Configuração Inicial – Integrações Scania (OFIA541)

1. Acesse o Módulo 14 (Oficina).
2. Acesse o menu Atualizações

→ Cadastros Oficina →Importação de Serviços

1. → Move Integração Montadora → Integrações 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.

1. OFIA541).
2. Dentro da aba Integração API Scob preencha

passo1,passo2,passo3,passo4
Totvs custom tabs box items
default	no referencia passo1
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.
Totvs custom tabs box items
default	no
referencia

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

1. os parâmetros obrigatórios na seção TOKEN:

Ambiente 

1. • 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)
   • Content-Type (Fornecidos pela marca ao concessionário)
2. Preencha os parâmetros obrigatórios na seção Consulta Chassi

Scania

1. :
   • Tipo de Autenticação (Bearer Token)
   • URL Base (Fornecidos pela marca ao concessionário)
   • End Point (Fornecidos pela marca ao concessionário)
2. Preencha os parâmetros obrigatórios na seção Gerais:

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

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.

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

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

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

...

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

<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 OF533SEROF544PRE - Importação de Serviços API Scania (OFIA533)   
  </a>
   <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=10086998581020364912" target="_blank" class="btn-doc">     
	📄 Ponto de Entradaentrada OF533FIMOF544POS - Importação de Serviços Scania (OFIA533)API Scania   
  </a> 
</div>