Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Durante a utilização da rotina, a função valida os parâmetros recebidos e com base nessas informações o sistema realiza consultas na API da Scania, assim realizando ou não o pré-cadastro de um chassi ou motorpossibilitará o preenchimento automático dos cadastros de veículos no Protheus.

Após a execução, as informações são gravadas na tabela VV1(Cadastro de veículos), caso o cadastro seja bem sucedido, 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 padroniza e simplifica a configuração da integração Scania dentro do Protheus, garantindo padronização e automatização do pré-cadastro no sistema, tornando reduzindo erros manuais e acelerando o processo mais simplesde registro.


...

3. Pré-requisitos e Configurações

...

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
defaultyes
referenciapasso1
  1. Disparo de função.
    A função é chamada por outra rotina outras rotinas do Protheus mediante a necessidade de:
    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.
    • Consultar dados de um chassi Scania
    • Consultar dados de um motor Scania
    • Efetuar o pré-cadastro automático de um veículo com base nos dados retornados da API Scania
  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. Após preencher todos os parâmetros obrigatórios, clique no botão “OK”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.

Totvs custom tabs box items
defaultno
referenciapasso2


  1. Acesse o Módulo 14 (Oficina).
  2. Acesse o menu Atualizações → Cadastros Oficina → Importação de Serviços Scania (OFIA533).
  3. Preencha os parâmetros obrigatórios:
    • Marca
    • Arquivo XML
    • Quantidade Mecânicos 
    • Ação pós Processamento
  4. No parâmetro Arquivo XML, será exibida uma tela mostrando o servidor (pasta protheus_data) e seus diretórios. Selecione o arquivo XML que será processado pela rotina.
  5. No parâmetro Ação pós Processamento:
    • Selecione a opção Mover Arquivo. Com isso, o parâmetro Mover Para será habilitado, permitindo que seja selecionado o diretório de destino dentro do servidor. Ao final do processamento, o arquivo será movido do diretório de origem para o diretório selecionado.
  6. Após preencher todos os parâmetros obrigatórios, clique no botão “OK”.

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


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

Totvs custom tabs box items
defaultno
referenciapasso3


  1. Acesse o Módulo 14 (Oficina).
  2. Acesse o menu Atualizações → Cadastros Oficina → Importação de Serviços Scania (OFIA533).
  3. Preencha os parâmetros obrigatórios na seção TOKEN:
    • Ambiente 
    • Integração Ativa?
    • Tipo de Autenticação
    • Client ID
    • Client Secret
    • URL
    • Grand Type
    • Content-Type
  4. Preencha os parâmetros obrigatórios na seção Consulta Chassi Scania:
    • Tipo de Autenticação
    • URL Base
    • End Point
  5. Preencha os parâmetros obrigatórios na seção Gerais:
    • 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”.

    • 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 VQL (Informacoes genericas) os registros de log do processamento, 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).


...