Linha Microsiga Protheus

Árvore de páginas

  • Criado por Usuário desconhecido (luis.fnascimento), última alteração em 10 dez, 2025


01. DADOS GERAIS

Produto:

TOTVS DMS

Linha de Produto:

Linha Protheus

Segmento:

Varejo

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.

  • Integração API Scob preenchi da corretamente.

  • 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.

  • Premissas de cadastro previamente realizadas.

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


IMPORTANTE!

Esta atualização de dicionário estará disponível na release 12.01.2610.


05. ASSUNTOS RELACIONADOS

    📄 Configurações - Integrações Scania (OFIA541)       📄 Ponto de entrada OF544PRE API Scania       📄 Ponto de entrada OF544POS API Scania