...
A rotina Consulta/Cadastro Chassi Scania(OFIA544) tem como objetivo de realizar a consulta a API Scania via Protheus DMS para a realização de um pré-cadastro de veículo.
Durante a sua utilização da rotina, a função valida os parâmetros recebidos e com base nessas informações o sistema possibilitará o 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 são gravadas na tabela VV1(Cadastro de veículos) , caso o cadastro seja bem sucedido, 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.
...
| 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 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.
- 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
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 processamentoVV1(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).
|
|
...
