1. Identificação da Rotina
Nome da Rotina | Integrações Scania (OFIA541) |
|---|---|
| Programa | OFIA541 |
| Módulo ERP | Oficina (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 principal objetivo 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, 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 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:
- É necessário incluir manualmente a rotina Integrações Scania (OFIA541) no menu do Protheus, permitindo assim o acesso à aba Integração API Scob.
- Deve-se possuir todos os dados de acesso à API para o preenchimento dos campos da aba Integração API Scob.
- É necessária a inclusão manual de 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 |
4. Fluxo de Utilização
Configuração Inicial – Integrações Scania (OFIA541)
- Acesse o Módulo 14 (Oficina).
- Acesse o menu Atualizações → Move Integração Montadora → Integrações Scania (OFIA541).
- 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)
- 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)
- 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)
- 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.