Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Fluxo de utilização

...

Índice
minLevel0
include[Identificação da Rotina]
indent10px


...

1. Identificação da Rotina


Nome da Rotina

Configurações Scania - Consulta/Cadastro Chassi Scania
ProgramaOFIA544OFIA541
Módulo ERPOficina (SIGAOFI)
Acesso à RotinaAtualizações

Configurações Scania/

Cadastros Oficina/Importação de Serviços Scania (OFIA533

Consulta/Cadastro Chassi Scania, (OFIA541)

Data da Documentação (Ultima Atualização)

 


...

2. Descrição Funcional


A rotina Consulta/Cadastro Chassi Scania(OFIA544OFIA541) tem como objetivo de realizar a consulta a API Scania via Protheus DMS para a realização de um pré-cadastro de veículoveículos.

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, as informações os dados são gravadas 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 Scania dentro do Protheus, garantindo padronização e automatização do pré-cadastro no sistema, reduzindo erros manuais e acelerando o processo de registro.


...

3. Pré-requisitos e Configurações


Criação de Campo no arquivo SX3 – Campos:

  • Tabela VOS - Grupos de Serviços
  • No Configurador (SIGACFG), acesse Ambientes/Cadastros/Menu (CFGX013) e informe as novas opções de menu do módulo de Oficina (SIGAOFI) conforme instruções a seguir:

Criação de Pergunte no arquivo SX1 – Pergunta

Nenhuma Ação
Totvs custom tabs box
tabsPré-requisitos, Configurações, Atualização de Dicionário/Menu
idsaba1,aba2,aba3

Para o correto funcionamento da rotina Consulta/Cadastro Chassi Scania(OFIA544OFIA541), é necessário garantir pré-requisitos que asseguram a execução correta da mesma. Sendo eles:

  1. É necessário incluir manualmente a rotina Cadastro de configurações SCANIA (OFIA541) no menu do Protheus, permitindo assim o acesso à funcionalidade.
  2. Deve-se possuir todos os dados de acesso a API Scania para o preenchimento do Cadastro de configurações SCANIA (OFIA541).
  3. É necessária a inclusão manual de cadastros pré-requisitos utilizados na rotina função OFIA544.

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 NCMVEIVA710VV1_POTMOT
Totvs custom tabs box items
defaultno
referenciaaba3
CampoVOS_GRPSER
TipoCaractere
Grupo de Campos
Ordem09
Tamanho2
Decimal0
Formato@!
Contexto1-Real
Propriedade1-Alterar
TítuloCod Grp Mont
DescriçãoCod Grp Servico Montadora
Val. SistemaOA0200018_VldGrp()
OpçõesInic. PadrãoInic. BrowseCons. Padrão
Nível1
UsadoSim
ObrigatórioNão
BrowseNão
WhenPasta
Help

Grupo de servico da Montadora

Menu

Atualizações

Submenu

Cadastros Oficina

Nome da Rotina

Importação de Serviços Scania

Programa

OFIA533

Módulo

Oficina (SIGAOFI)

Tipo

Função Protheus

Grupo

OFIA533OFIA533OFIA533OFIA533OFIA533

Grupo de campo

VE1

Ordem

0102030405

Pergunta

Marca ?Arquivo XML ?Quantidade Mecânicos ?Ação pós Processamento ?Mover Para ?

Tipo

CCNCC
Tamanho3991199
Decimal00000
Var01MV_PAR01MV_PAR02MV_PAR03MV_PAR04MV_PAR05
Formato@E 9
ValidaçãoExistCpo("VE1",MV_PAR01)OA533002K_ValidPerg()!Vazio() .AND. (MV_PAR03 >= 1 .And. MV_PAR03 <= 9)NaoVazio()OA533002K_ValidPerg()
ObjetoGetGetGetComboGet
Consulta PadrãoVE1Pré-Seleção (Combo)1Item 1
Item 2Mover ArquivoItem 3Apagar ArquivoItem


...

4

...

. Fluxo de Utilização


Totvs custom tabs box
tabsPasso a passo: Ação pós Processamento - Nenhuma Ação, Passo a passo: Ação pós Processamento - Mover Arquivo, Passo a passo: Ação pós Processamento - Apagar Arquivo, Gravação de Logs
idspasso1,passo2,passo3,passo4
Totvs custom tabs box items
defaultyesno
referenciapasso1
  1. Disparo de função.
    A função é chamada por outras rotinas do Protheus como:
    • Abertura de atendimento no Digital Dealer: quando o veículo informado ainda não estiver cadastrado no Protheus;
    • Geração da senha de priorização de atendimento: quando a placa inserida não possuir cadastro prévio;
    • Outras rotinas que necessitem de consulta e inclusão automática do veículo.
  2. Validação dos parâmetros
    A função valida se:
    • O chassi foi informado
    • O motor foi informado (quando aplicado)
    • Os formatos são aderentes aos padrões da API Scania
      Caso algum dado seja inválido, uma mensagem de erro é exibida:
      "Problema: Parametros Enviados Não Encontrados! Verifique o preenchimento e tente novamente."
  3. Montagem da Requisição à API SCANIA / DMS.
    A função constrói a requisição com base nos parâmetros recebidos:
    • Tipo de autenticação
    • Client ID
    • Client Secret
    • URL
    • Grant Type
    • Content Type
    • URL Base
    • End Point
  4. Mapeamento dos Campos Retornados pela API.

    • A rotina processará o arquivo XML e após a inclusão ou atualização de cada serviço serão executadas ações personalizadas definidas através do ponto de entrada.

    • Ao final do processamento, quando o arquivo for processado com sucesso, serão executadas ações personalizadas definidas através do ponto de entrada de conclusão da rotina, e o arquivo será movido do diretório original para o diretório destino indicado no parâmetro Mover Para.

passo3
Totvs custom tabs box items
defaultno
referenciapasso3

Configuração Inicial – Tela Configurações Scania (OFIA541)

  1. Acesse o Módulo 14 (Oficina).
  2. Acesse o menu Atualizações → Cadastros Oficina → Importação de Serviços Scania (OFIA533 Configurações Scania → Consulta/Cadastro Chassi Scania, (OFIA541).
  3. Preencha os parâmetros obrigatórios na seção TOKEN:
    • Ambiente Ambiente (Produção ou Homologação)
    • Integração Ativa? (Sim ou Não)
    • Tipo de Autenticação (Basic Auth)
    • Client ID (VERIFICAR COM QUEM PEGA ISSO AQUI)
    • Client Secret (VERIFICAR COM QUEM PEGA ISSO AQUI)
    • URL (VERIFICAR COM QUEM PEGA ISSO AQUI)
    • Grand Type (VERIFICAR COM QUEM PEGA ISSO AQUI)
    • Content-Type (VERIFICAR COM QUEM PEGA ISSO AQUI)
  4. Preencha os parâmetros obrigatórios na seção Consulta Chassi Scania:
    • Tipo de Autenticação (Bearer Token)
    • URL Base (VERIFICAR COM QUEM PEGA ISSO AQUI)
    • End Point (VERIFICAR COM QUEM PEGA ISSO AQUI)
  5. Preencha os parâmetros obrigatórios na seção Gerais:

    • Pré-Cadastro Automático (Sim ou Não)
    • Local Padrão
    • Exibe tela de complementação do cadastro? (Não exibe/Orçamento Oficina/Abertura da OS/Liberação da OS)Selecione a opção Apagar Arquivo. Com isso, ao término do processamento do arquivo, ele será apagado do diretório de onde foi selecionado.
  6. Após preencher todos os parâmetros obrigatórios, clique no botão “OK”.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
    • A rotina processará o arquivo XML e após a inclusão ou atualização de cada serviço serão executadas ações personalizadas definidas através do ponto de entrada.

    • Ao final do processamento, quando o arquivo for processado com sucesso, serão executadas ações personalizadas definidas através do ponto de entrada de conclusão da rotina, e o arquivo será apagado do diretório original onde foi selecionado.


Multimedia
nameImportação Arquivo XML Apagar Arquivo.mp4
width1400
autostarttrue
height700

Totvs custom tabs box items
defaultno
referenciapasso4

Após a execução da rotina, será possível visualizar na tabela VV1(Cadastro de veículos) as informações salvas, conforme o exemplo apresentado na imagem abaixo.

  • Na coluna VQL_AGROUP (Agrupador), será registrado o nome do fonte da rotina;
  • Na coluna VQL_TIPO (Tipo), será registrado o local de execução da rotina, podendo ser via Menu ou Schedule;
  • Na coluna VQL_MSGLOG (Mensagens de Log), será registrada a mensagem de log referente ao status de execução da rotina (Início, Processamento, Finalização ou Erro).
Image Removed


...

5. Integrações e Dependências


Integração

Para o correto funcionamento da rotina, durante a execução da Importação de Serviços Scania (OFIA533) ocorre a integração com a rotina Tabela de Serviços (OFIOA030).
Após o processamento bem-sucedido do arquivo XML, os serviços contidos no arquivo são cadastrados na Tabela de Serviços caso ainda não existam, ou terão o campo "Tmpo Fábrica" (VO6_TEMFAB) atualizado, caso já estejam registrados.
Essa integração garante que os dados enviados pela montadora Scania sejam incorporados ao Protheus, mantendo o cadastro de serviços sempre atualizado e alinhado às informações da montadora.


...

6. Assuntos Relacionados


HTML
<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/viewpage.action?pageId=973046863" target="_blank" class="btn-doc">     
	📄 Novo campo Cod Grp Servico Montadora - Grupos de Serviço (OFIOA020)
  </a>
  <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=1008697602" target="_blank" class="btn-doc">     		
	📄 Ponto de Entrada OF533SER - Importação de Serviços Scania (OFIA533)   
  </a>
  <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=1008699858" target="_blank" class="btn-doc">     
	📄 Ponto de Entrada OF533FIM - Importação de Serviços Scania (OFIA533)   
  </a>
</div>
    

...