...
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 |
|---|
| tabs | Passo 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 |
|---|
| ids | passo1,passo2,passo3,passo4 |
|---|
|
| Totvs custom tabs box items |
|---|
| default | yes |
|---|
| referencia | passo1 |
|---|
| - 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
- 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."
- 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
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 |
|---|
| default | no |
|---|
| referencia | passo2 |
|---|
|
- Acesse o Módulo 14 (Oficina).
- Acesse o menu Atualizações → Cadastros Oficina → Importação de Serviços Scania (OFIA533).
- Preencha os parâmetros obrigatórios:
- Marca
- Arquivo XML
- Quantidade Mecânicos
- Ação pós Processamento
- 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.
- 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.
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 |
|---|
| name | Importação Arquivo XML Mover Arquivo.mp4 |
|---|
| width | 1400 |
|---|
| autostart | true |
|---|
| height | 700 |
|---|
|
|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | passo3 |
|---|
|
- Acesse o Módulo 14 (Oficina).
- Acesse o menu Atualizações → Cadastros Oficina → Importação de Serviços Scania (OFIA533).
- 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
- Preencha os parâmetros obrigatórios na seção Consulta Chassi Scania:
- Tipo de Autenticação
- URL Base
- End Point
- 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.
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 |
|---|
| name | Importação Arquivo XML Apagar Arquivo.mp4 |
|---|
| width | 1400 |
|---|
| autostart | true |
|---|
| height | 700 |
|---|
|
|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | passo4 |
|---|
|
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).

|
|
...