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 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, as informações são gravadas os dados do veículo são gravados na tabela VV1 (Cadastro de veículos) 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 simplifica a configuração da integração Scania da API dentro do Protheus, garantindo padronização e , 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:

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)

...

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

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

1. → Move Integração Montadora → Integrações Scania (

1. OFIA541).

1. Dentro da aba Integração API Scob preencha os parâmetros obrigatórios na seção TOKEN:

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

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)
2. Após preencher todos os parâmetros obrigatórios, clique no botão

• 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 VV1(Cadastro de veículos) as informações salvas, 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

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

...

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 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ços Scania (OFIA533)OF544POS API Scania   
  </a> 
</div>