01. DADOS GERAIS
| Produto: | | Solucoes_totvs_parceirosexptotvs |
|---|
| SolucaoParcsExpsTOTVS | TOTVS DMS |
|---|
|
|
|---|
| Linha de Produto: | |
|---|
| Segmento: | |
|---|
| Módulo: | | Modulos_totvs_prestadores_de_servicos |
|---|
Totvs DMS (Linha Protheus) - Oficina (SIGAOFI) |
|---|
| Função: | Integrações Scania (OFIA541) |
|---|
| País: | Brasil |
|---|
| Ticket: | Não há/Não se aplica |
|---|
| Requisito/Story/Issue: | DVARMIL-11638 |
|---|
02. SITUAÇÃO/REQUISITO
Após levantamentos realizados sobre os processos e regras de negócio da montadora Scania, foi identificada a necessidade de criar uma rotina que permita realizar a consulta à API para o pré-cadastro de veículos, facilitando o recebimento e o cadastro automático dessas informações dentro do sistema Protheus DMS. Essa rotina, implementada na Integrações Scania (OFIA541), valida os parâmetros recebidos e, com base neles, preenche automaticamente o cadastro de veículos, registrando-os na tabela VV1 e disponibilizando-os imediatamente para os processos de Oficina.
03. SOLUÇÃO
Foi criada a rotina OFIA541 – Configurações da Integração Scania, que consulta a API da Scania para buscar dados por chassi ou número do motor e realizar o cadastro/atualização automática de veículos na tabela VV1 do Protheus.
...
Rotina OFIA541 incluída no menu e configurada para acessar a API.
- Integração API Scob preenchi da corretamente.
Retorno válido da API, permitindo preencher automaticamente o cadastro.
Conectividade com o serviço da Scania para consultas.
Gravação dos dados na VV1, disponibilizando o veículo para uso imediato no Protheus.
- Premissas de cadastro previamente realizadas.
Premissas de Cadastro (Cadastros pré-requisitos)
| 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 - Veículo | VEIVA710 | VV1_POTMOT |
| Totvs custom tabs box |
|---|
| tabs | Passo a passo para utilização |
|---|
| ids | passo1 |
|---|
|
| Totvs custom tabs box items |
|---|
| default | yes |
|---|
| referencia | passo1 |
|---|
| Configuração Inicial – Integrações Scania (OFIA541) - Acesse o Módulo 14 (Oficina).
- Acesse o menu Atualizações → Move Integração Montadora → Integrações Scania (OFIA541).
- Preencha os Dentro da aba Integração API Scob preencha os parâmetros obrigatórios na seção TOKEN:
- Ambiente (Produção ou Homologação)
- Integração Ativa? (Sim ou Não)
- Tipo de Autenticação (Basic Auth)
- Client ID (Fornecidos pela marca ao concessionário)
- Client Secret (Fornecidos pela marca ao concessionário)
- URL (Fornecidos pela marca ao concessionário)
- Grand Type (Fornecidos pela marca ao concessionário)
- Content-Type (Fornecidos pela marca ao concessionário)
- Preencha os parâmetros obrigatórios na seção Consulta Chassi:
- Tipo de Autenticação (Bearer Token)
- URL Base (Fornecidos pela marca ao concessionário)
- End Point (Fornecidos pela marca ao concessionário)
- Preencha os parâmetros obrigatórios na seção Gerais:
- Pré-Cadastro Automático (Sim ou Não)
- Local Padrão (Selecionar local padrão)
- Exibe tela de complementação do cadastro? (Não exibe/Orçamento Oficina/Abertura da OS/Liberação da OS)
- Após preencher todos os parâmetros obrigatórios, clique no botão “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
| Totvs custom tabs box items |
|---|
| | default | no |
|---|
| referencia | passo1 |
|---|
| Premissas de Cadastro (Cadastros pré-requisitos) | 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 - Veículo | VEIVA710 | VV1_POTMOT | | Multimedia |
|---|
| name | Execução OFIA541.mp4 |
|---|
| width | 1280 |
|---|
| height | 720 |
|---|
|
|
| Card documentos |
|---|
| Informacao | Esta atualização de dicionário estará disponível na release 12.01.2610. |
|---|
| Titulo | IMPORTANTE! |
|---|
|
05. 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/viewpageeditpage.action?pageId=9730468631017432906" target="_blank" class="btn-doc">
📄 Novo campo Cod Grp Servico Montadora Configurações - GruposIntegrações de ServiçoScania (OFIOA020)
</a>
<a href="https://tdn.totvs.com/pages/viewpage.action?pageId=973049171" target="_blank" class="btn-doc">OFIA541)
📄 Importação de Serviços Scania (OFIA533)
</a>
<a href="https://tdn.totvs.com/pages/viewpage.action?pageId=10086976021020363440" target="_blank" class="btn-doc">
📄 Ponto de Entradaentrada OF533SEROF544PRE - Importação de Serviços API Scania (OFIA533)
</a>
<a href="https://tdn.totvs.com/pages/viewpage.action?pageId=10086998581020364912" target="_blank" class="btn-doc">
📄 Ponto de Entradaentrada OF533FIM - Importação de Serviços Scania (OFIA533) OF544POS API Scania
</a>
</div> |