1. Identificação da Rotina


Nome da Rotina

Integrações Scania (OFIA541)
ProgramaOFIA541
Módulo ERPOficina (SIGAOFI)
Acesso à Rotina

Atualizações/Move Integração Montadora/Integrações Scania (OFIA541)

Data da Documentação (Última Atualização)

 


2. Descrição Funcional


A rotina Integrações Scania (OFIA541) tem como objetivo realizar a 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 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 da API dentro do Protheus, 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:

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

Premissas de Cadastro (Cadastros pré-requisitos)

Entidade Programa Campo chave 
Cadastro da marcaOFIA950VV1_CODMAR

Categorias 

VEIVA100 VV2_CATVEI
Espécies VEIVA110VV2_ESPVEI
Tipos de veículosVEIVA080VV2_TIPVEI

Grupo de modelos 

VEIVA220VV2_GRUMOD
Modelo de veículoVEIA030

VV1_MODVEI

CoresVEIVA150VV1_CROVEI
Cadastro NCM - VeículoVEIVA710VV1_POTMOT

4. Fluxo de Utilização


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

  1. Acesse o Módulo 14 (Oficina).
  2. Acesse o menu Atualizações → Move Integração Montadora → Integrações Scania (OFIA541).
  3. 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)
    • Content-Type (Fornecidos pela marca ao concessionário)
  4. Preencha os parâmetros obrigatórios na seção Consulta Chassi:
    • Tipo de Autenticação (Bearer Token)
    • URL Base (Fornecidos pela marca ao concessionário)
    • End Point (Fornecidos pela marca ao concessionário)
  5. 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)
  6. Após preencher todos os parâmetros obrigatórios, clique no botão “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ção

Durante 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=1019330273" target="_blank" class="btn-doc">     		
	📄 DVARMIL-11638 DT - API Cadastro de Veículos Scania   
  </a>
  <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=1020363440" target="_blank" class="btn-doc">     
	📄 Ponto de entrada OF544PRE API Scania   
  </a>
   <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=1020364912" target="_blank" class="btn-doc">     
	📄 Ponto de entrada OF544POS API Scania   
  </a> 
</div>