01. DADOS GERAIS

Produto:

Linha de Produto:

Segmento:

Módulo:

Totvs DMS (Linha Protheus) - Oficina (SIGAOFI)

Função:Integrações Scania (OFIA541)
País:Brasil
Ticket:Não há/Não se aplica
Requisito/Story/Issue:DVARMIL-11638

02. SITUAÇÃO/REQUISITO

Após levantamentos realizados sobre os processos e regras de negócio da montadora Scania, foi identificada a necessidade de criar uma rotina que permita realizar a consulta à API para o pré-cadastro de veículos, facilitando o recebimento e o cadastro automático dessas informações dentro do sistema Protheus DMS. Essa rotina, implementada na Integrações Scania (OFIA541), valida os parâmetros recebidos e, com base neles, preenche automaticamente o cadastro de veículos, registrando-os na tabela VV1 e disponibilizando-os imediatamente para os processos de Oficina.

03. SOLUÇÃO

Foi criada a rotina OFIA541 – Configurações da Integração Scania, que consulta a API da Scania para buscar dados por chassi ou número do motor e realizar o cadastro/atualização automática de veículos na tabela VV1 do Protheus.

Para funcionamento correto, são necessários:

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

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. Dentro da aba Integração API Scob 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

04. DEMAIS INFORMAÇÕES



05. 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/editpage.action?pageId=1017432906" target="_blank" class="btn-doc">     		
	📄 Configurações - Integrações Scania (OFIA541)   
  </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>