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:
Rotina OFIA541 incluída no menu e configurada para acessar a API.
Retorno válido da API, permitindo preencher automaticamente o cadastro.
Conectividade com o serviço da Scania para consultas.
Gravação dos dados na VV1, disponibilizando o veículo para uso imediato no Protheus.
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).
- 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
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 |
|
|
|
04. DEMAIS INFORMAÇÕES
05. ASSUNTOS RELACIONADOS
