...
| Índice |
|---|
| minLevel | 0 |
|---|
| include | [Identificação da Rotina] |
|---|
| indent | 10px |
|---|
|
...
1. Identificação da Rotina
Nome da Rotina | Configurações Scania - Consulta/Cadastro Chassi Scania |
|---|
| Programa | OFIA541OFIA544 |
|---|
| Módulo ERP | Oficina (SIGAOFI) |
|---|
| Acesso à Rotina | Atualizações/Cadastros Oficina/Importação de Serviços Scania (OFIA533) |
|---|
| Data da Documentação (Ultima Atualização) | |
|---|
...
2. Descrição Funcional
A rotina Consulta/Cadastro Chassi Scania(OFIA541OFIA544) tem como objetivo centralizar e organizar todos os parâmetros necessários para a comunicação entre o Protheus DMS e o serviço disponibilizado pela Scania(API)de realizar a consulta a API Scania via Protheus DMS para a realização de um pré-cadastro de veículo.
Durante a utilização da rotina, é necessário preencher a função valida os parâmetros obrigatórios(URLs, endpoints e configurações gerais). Com 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 motor.
...
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 o processo mais simples.
...
3. Pré-requisitos e Configurações
| Totvs custom tabs box |
|---|
| tabs | Pré-requisitos, Configurações, Atualização de Dicionário/Menu |
|---|
| ids | aba1,aba2,aba3 |
|---|
|
Para o correto funcionamento da rotina Consulta/Cadastro Chassi Scania(OFIA541OFIA544), é necessário garantir pré-requisitos que asseguram a execução correta da mesma. Sendo eles: - É necessária a inclusão manual de cadastros utilizados para executar a rotina OFIA541 sem nenhum impedimento, os cadastros devem ser referentes a Marca Padrão de Cadastro definida na seção Geraisna rotina OFIA544.
Premissas de Cadastro (Cadastros pré-requisitos) 00 Generalidades
01 Motor
02 Sistema de arrefecimento
03 Sistemas de escape/combustível
04 Embreagem
05 Caixa de mudanças
06 Árvore de transmissão
07 Eixo dianteiro
08 Eixo traseiro
09 Cubo e rodas
10 Freios
11 Chassi
12 Suspensão
13 Direção
14 Controle do motor
16 Sistema elétrico
17 Instrumentos
18 Cabina
19 Equipamento complementar
20 Carroceria de carga
21 Reboque
43 Carroceria de ônibus Irizar | Informações |
|---|
|
|
Essas informações são de responsabilidade dos concessionários e deverão ser obtidas junto à Montadora Scania.| Entidade | Programa | Campo chave |
|---|
| Cadastro da marca | OFIA950 | VV1_CODMAR |
Categorias | VEIVA100 | VV2_CATVEI |
| Espécies | VEIVA110 | VV2_ESPVEI |
| Tipos de veículos | VEIVA080 | VV2_TIPVEI |
Grupo de modelos | VEIVA220 | VV2_GRUMOD |
| Modelo de veículo | VEIA030 | VV1_MODVEI |
| Cores | VEIVA150 | VV1_CROVEI |
| Cadastro NCM | VEIVA710 | VV1_POTMOT |
| Totvs custom tabs box items |
|---|
|
Para o correto funcionamento da rotina Consulta/Cadastro Chassi Scania(OFIA541), é necessário garantir pré-condições que asseguram comunicação adequada com a API Scania, o mapeamento dos grupos de serviço e o correto tratamento dos dados entre a Scania e o Protheus DMS. São elas:
- O campo “Cod. Grp Mont” deve estar adicionado na rotina Grupos de Serviço (OFIOA020), garantindo o vínculo correto entre os grupos de serviço da montadora Scania e os grupos cadastrados no Protheus.
- É necessário incluir manualmente a rotina Importação de Serviços Scania (OFIA533) no menu do Protheus, permitindo assim o acesso à funcionalidade.
- Deve-se possuir um arquivo XML válido contendo os serviços enviados pela montadora Scania, que será utilizado como base para o processo de importação.
| Nota |
|---|
|
- Tamanho do arquivo XML: Aproximadamente 11 MB.
- Quantidade de serviços contidos no arquivo: Cerca de 16 mil serviços.
- Tempo de processamento do arquivo pela rotina: Aproximadamente 20 minutos.
|
| Totvs custom tabs box items |
|---|
|
Para que a importação de serviços ocorra corretamente durante o processamento do arquivo XML, é necessário que na rotina Grupos de Serviço (OFIOA020), existam registros cadastrados com o campo “Cod. Grp Mont” devidamente preenchido, conforme os códigos pré-definidos pela montadora Scania.
Essa configuração garante o correto mapeamento entre os grupos de serviço da Scania e os grupos cadastrados no Protheus, permitindo que o sistema identifique e vincule corretamente os serviços durante o processo de importação.
| Dica |
|---|
| title | Exemplos de códigos de Grupos de Serviço montadora Scania |
|---|
|
| Totvs custom tabs box items |
|---|
|
Criação de Campo no arquivo SX3 – Campos:
- Tabela VOS - Grupos de Serviços
| Campo | VOS_GRPSER |
|---|
| Tipo | Caractere |
|---|
| Grupo de Campos |
|
|---|
| Ordem | 09 |
|---|
| Tamanho | 2 |
|---|
| Decimal | 0 |
|---|
| Formato | @! |
|---|
| Contexto | 1-Real |
|---|
| Propriedade | 1-Alterar |
|---|
| Título | Cod Grp Mont |
|---|
| Descrição | Cod Grp Servico Montadora |
|---|
| Val. Sistema | OA0200018_VldGrp() |
|---|
| Opções |
|
|---|
| Inic. Padrão |
|
|---|
| Inic. Browse |
|
|---|
| Cons. Padrão |
|
|---|
| Nível | 1 |
|---|
| Usado | Sim |
|---|
| Obrigatório | Não |
|---|
| Browse | Não |
|---|
| When |
|
|---|
| Pasta |
|
|---|
| Help | Grupo de servico da Montadora |
|---|
- 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:
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 |
|---|
Criação de Pergunte no arquivo SX1 – Pergunta:
Grupo | OFIA533 | OFIA533 | OFIA533 | OFIA533 | OFIA533 |
|---|
Grupo de campo | VE1 |
|
|
|
|
|---|
Ordem | 01 | 02 | 03 | 04 | 05 |
|---|
Pergunta | Marca ? | Arquivo XML ? | Quantidade Mecânicos ? | Ação pós Processamento ? | Mover Para ? |
|---|
Tipo | C | C | N | C | C |
|---|
| Tamanho | 3 | 99 | 1 | 1 | 99 |
|---|
| Decimal | 0 | 0 | 0 | 0 | 0 |
|---|
| Var01 | MV_PAR01 | MV_PAR02 | MV_PAR03 | MV_PAR04 | MV_PAR05 |
|---|
| Formato |
|
| @E 9 |
|
|
|---|
| Validação | ExistCpo("VE1",MV_PAR01) | OA533002K_ValidPerg() | !Vazio() .AND. (MV_PAR03 >= 1 .And. MV_PAR03 <= 9) | NaoVazio() | OA533002K_ValidPerg() |
|---|
| Objeto | Get | Get | Get | Combo | Get |
|---|
| Consulta Padrão | VE1 |
|
|
|
|
|---|
| Pré-Seleção (Combo) |
|
|
| 1 |
|
|---|
| Item 1 |
|
|
| Nenhuma Ação |
|
|---|
| Item 2 |
|
|
| Mover Arquivo |
|
|---|
| Item 3 |
|
|
| Apagar Arquivo |
|
|---|
| Item 4 |
|
|
|
|
|
|---|
| Item 5 |
|
|
|
|
|
|---|
| Help |
|
|
|
|
|
|---|
|
...
4. Fluxo de Utilização
| 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 do Protheus mediante a necessidade de:
- 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:
- 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 Grant 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:- Pré-Cadastro Automático
- Localização padrão
- Exibe Complemento de Cadastro Orçamento Oficina (OFIXX001)
- Exibe Complemento de Cadastro - Abertura de OS (OFIOM010)
- Exibe Complemento de Cadastro - Liberação de OS (OFIOM140)
- Marca padrão para cadastro
Após preencher todos os parâmetros obrigatórios, clique no botão “Confirmar”“OK”. A rotina salvará as informações preenchidas para utiliza-las posteriormente.
| Multimedia |
|---|
| | name | Importação XML Nenhuma Ação.mp4 |
|---|
| width | 1400 |
|---|
| autostart | true |
|---|
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.
height | 700
| 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).
|
|
...
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>
|
...
