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