Árvore de páginas

Versões comparadas

Chave

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

...

Índice
minLevel0
include[Identificação da Rotina]
indent10px


...

1. Identificação da Rotina


Nome da Rotina

Importação GlassIntegração SCRM
ProgramaOFIA538VEIA120
Módulo ERPOficina Veículos (SIGAOFISIGAVEI)
Acesso à RotinaAtualizações/Cadastros Peças/Importação Glass (OFIA538SCRM/Integração SCRM (VEIA120)
Data da Documentação (Última Atualização)

05122025 


...

2. Descrição Funcional

Executar o processo de envio das informações A rotina de execução é responsável por identificar, preparar e enviar os dados de clientes e veículos ao SCRM, respeitando integralmente todas as regras de elegibilidade, controle de alterações e consistência de dados.

Funcionamento Geral

A execução pode ocorrer de forma manual ou automática, dependendo do contexto operacionaldefinidas na configuração. Essa execução pode ocorrer de forma manual ou automática, sempre considerando apenas informações que sofreram alteração desde a última execução válida.

Durante a execução, o sistema identifica quais registros precisam ser enviados com base em alterações ocorridas nos dados.

O processo não envia dados repetidos ou inalterados, priorizando apenas informações que sofreram mudanças relevantes desde a última execução.

Execução de Clientes

Durante a execução, um cliente será considerado para envio quando:

  • Possuir alterações relevantes desde a última comunicação.

  • Estiver ativo e com informações mínimas preenchidas.

  • Estiver vinculado a um dealer válido.

  • Atender às regras definidas na configuração.

O envio do cliente pode ocorrer isoladamente ou como parte de um processo que também envolva seus veículos.

Execução de Veículos

O envio de veículos depende diretamente da elegibilidade do cliente.
Além disso, o sistema avalia:

  • Se o cliente possui frota válida para envio.

  • Se os veículos atendem aos critérios mínimos configurados (como marca e ano).

  • Se os veículos não estão bloqueados ou excluídos.

Caso o cliente não possua veículos elegíveis, apenas os dados do cliente são enviados.

Controle de Execução

Cada execução gera um controle que registra:

  • Data e hora da execução.

  • Tipo de execução realizada.

  • Situação do envio (somente cliente ou cliente com veículos).

  • Resultado final da comunicação com o SCRM.

Esse controle evita duplicidade de envios e permite acompanhamento posterior.

Comunicação com o SCRM

Após a montagem das informações, o sistema realiza o envio por meio de serviço externo seguro.

O retorno do serviço é avaliado imediatamente:

  • Em caso de sucesso, o envio é considerado concluído.

  • Em caso de erro, o processo registra o ocorrido e mantém o controle para análise ou reprocessamento.

3. Pré-requisitos e Configurações

realiza uma análise criteriosa dos dados, verificando se os clientes atendem aos requisitos funcionais antes de qualquer envio. Somente clientes considerados elegíveis são processados, evitando integrações desnecessárias ou incorretas. Quando aplicável, o sistema também avalia a existência de frota válida associada ao cliente, garantindo coerência entre os dados enviados.

O processo organiza os registros em lotes controlados, permitindo:

  • Divisão do envio em múltiplos arquivos, quando o volume de dados ultrapassa os limites definidos;

  • Rastreabilidade completa de cada envio, associando cliente, veículo e execução;

  • Tratamento de erros por lote, sem comprometer toda a execução.

Cada envio é submetido a uma validação do retorno do serviço externo. Apenas respostas positivas são consideradas como execução bem-sucedida. Em caso de falha, o processo registra o erro e segue a regra definida para interrupção ou continuidade, sempre preservando a integridade das informações.

Ao final da execução, o sistema atualiza os controles internos, garantindo que execuções futuras considerem corretamente o histórico já processado, evitando reenvios indevidos e mantendo a consistência da integração.


...

3. Pré-requisitos e Configurações

Configurações SCRM

Totvs custom tabs box
tabsGatilhos (Triggers), Configurações SCRM, Atualização de Dicionário/Menu
idsaba1,aba2,aba3
totvs-custom-tabs-box-
Totvs custom tabs box
tabsPré-requisitos, Gatilhos, Atualização de Dicionário/Menu
idsaba1,aba2, aba3
totvs-custom-tabs-box-items
defaultyes
referenciaaba1


Para o correto funcionamento da rotina Importação Glass (OFIA538)que a integração ocorra corretamente durante o processamento da rotina, é necessário garantir pré-condições que asseguram a leitura adequada do arquivo .DAT:

  1. É necessário incluir manualmente a rotina Importação Glass (OFIA538) no menu do Protheus, permitindo assim o acesso à funcionalidade.
  2. Deve-se possuir um arquivo com a extensão .DAT contendo as peças enviadas pela montadora Scania, que será utilizado como base para o processo de importação.

que os gatilhos estejam configurados corretamente na base de dados.

SIGACFG > Ambiente > Embedded Audit Trail > Aplicador - Aplicador de Triggers para auditoria - Embedded Audit Trail (CFGA710)


Na seção Grupo de empresas:

Image Added


Na seção Tabela:

Image Added


Na seção Campos:

  • Tabela SA1:

Image Added


  • Tabela VCF:

Image Added


  • Tabela VV1:

Image Added

Totvs custom tabs box items
default
Totvs custom tabs box items
defaultno
referenciaaba2


testeOFIA541

Criação de Campo no arquivo VE9 – Campos:

  • Tabela VE9 - Substituição de Itens

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

Criação de Pergunte no arquivo SX1 – Pergunta

Totvs custom tabs box items
defaultno
referenciaaba3
CampoVE9_SEGMENVE9_STAGLAVE9_APLICAVE9_STATUS
TipoCaractereCaractereCaractereCaractere
Grupo de Campos
Ordem16171819
Tamanho230352
Decimal0000
Formato@!@!@!@!
Contexto1-Real  1-Real  1-Real  1-Real  
Propriedade1-Alterar1-Alterar1-Alterar1-Alterar
TítuloSegmento RegStatus GlassAplica ItemStatus
DescriçãoSegmento do registroDescrição Status GlassAplicação do ItemStatus
Val. SistemaPertence("01/02/03/04/05/06")OpçõesInic. PadrãoInic. BrowseCons. PadrãoNível
UsadoSimSimSimSim
ObrigatórioNãoNãoNãoNão
BrowseWhenPasta
Help

Campo utilizado para indicar o tipo de informação vinculada ao item, permitindo ao sistema classificar e tratar corretamente o registro.

Opções:

01 Informação Básica do Item

02 Informação Utilização do Item

03 Observação do Item

04 Informação Substituição do Item

05 Observação da Substituição do Item

06 Informação Composição do Kit

Indica a descrição do status do item importado do arquivo Glass, exclusivo da montadora Scania.

Informa os dados de utilização do item, exclusivos da montadora Scania.

Indica o status do item importado do arquivo Glass, exclusivo da montadora Scania.

Menu

Atualizações

Submenu

Cadastros Peças

Nome da Rotina

Importação Glass

Programa

OFIA538

Módulo

Oficina (SIGAOFI)

Tipo

Função Protheus

Grupo

OFIA538OFIA538OFIA538OFIA538

Grupo de Campo

162003004024

Ordem

01020304

Pergunta

Grupo Padrão Da PeçaConta Contábil Padrão PeçaCentro De Custo Padrão PeçaArmazém Padrão da Peça

Tipo

CCNC
Tamanho22022
Decimal0000
Var01MV_PAR01MV_PAR02MV_PAR03MV_PAR04
Formato
ValidaçãoOA538016J()OA538017J()OA538018J()OA538019J()
ObjetoGetGetGetGet
Consulta PadrãoSBMCT1CTTNNR
Pré-Seleção (Combo)000
Item 1Item 2Item 3Item 4Item 5Help

Grupo

OFIA538OFIA538OFIA538

Grupo de Campo

Ordem

050607

Pergunta

Arquivo .DATAção Após o ProcessamentoMover Para

Tipo

CC

C

Tamanho99150
Decimal000
Var01MV_PAR05MV_PAR06MV_PAR07
FormatoValidaçãoOA538022J_ValidPerg()
ObjetoFileComboGet
Consulta Padrão
Pré-Seleção (Combo)000
Item 1Nenhuma AçãoItem 2Mover ArquivoItem 3Apagar ArquivoItem 4Item 5Help


  • 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

SCRM

Nome da Rotina

Integração SCRM

Programa

VEIA120

Módulo

Veículos (SIGAVEI)

Tipo

Função Protheus


Criação de Tabela no arquivo SX2 – Tabelas:


Chave

Nome

Modo

Único

PYME

VEFSCRM Scania - ClientesCVEF_FILIAL+VEF_CODIGO S
VEVSCRM SCANIA - VeiculosCVEV_FILIAL+VEV_CODIGOS


Criação de Campo no arquivo SX3 – Campos:


  • Tabela VEF - SCRM Scania - Clientes:


Campo

VEF_FILIAL

VEF_CODIGO

VEF_TPEXEC

VEF_DTEXEC

TipoCaractereCaractereCaractereData
Grupo de Campos033


Ordem01020304
Tamanho2818
Decimal0000
Formato@!@!@!
Contexto1 - Real1 - Real1 - Real1 - Real
Propriedade2 - Visualizar2 - Visualizar2 - Visualizar2 - Visualizar
TítuloFilialCod. Seq.Tp.ExecuçãoDt.Execução
DescriçãoFilialCódigo SequencialTipo ExecuçãoData Execução
Val. Sistema

Pertence("12 ")
Opções

1=Carga Inicial;2=Diario
Inic. Padrão
GetSXENum("VEF","VEF_CODIGO",,1)"1"dDataBase
Inic. Browse



Cons. Padrão



Nível1111
UsadoNãoSimSimSim
ObrigatórioNãoSimNãoNão
BrowseNãoSimSimSim
When



Pasta



HelpCódigo que identifica a filial da empresa usuária do sistema.Identificador numérico gerado automaticamente pelo sistema.

Campo no qual apresenta o Tipo de Execução, onde:

1 - Carga Inicial

2 - Diário

Campo de exibição que apresenta a data em que o processo foi realizado, permitindo rastreabilidade e conferência das informações.

Campo

VEF_HREXEC

VEF_CODCLI

VEF_LOJCLI

TipoCaractereCaractereCaractere
Grupo de Campos
001002
Ordem050607
Tamanho462
Decimal000
Formato@!@!@!
Contexto1 - Real1 - Real1 - Real
Propriedade2 - Visualizar2 - Visualizar2 - Visualizar
TítuloHr.ExecuçãoCód. ClienteLoja Cliente
DescriçãoHora ExecuçãoCódigo do ClienteLoja do Cliente
Val. Sistema


Opções


Inic. Padrão


Inic. Browse


Cons. Padrão
SA1
Nível111
UsadoSimSim
ObrigatórioNãoNão
BrowseSimSimSim
When


Pasta


Help

Campo de exibição que apresenta a hora em que o processo foi realizado, permitindo rastreabilidade e conferência das informações.

Número único que diferencia cada cliente dentro da empresa. A identificação completa é composta pelo código do cliente e o código da loja.

Número que diferencia cada loja do cliente, utilizado para organizar e controlar as operações.

Campo

VEF_DEALER

VEF_STATUS

VEF_ARQUIV

TipoCaractereCaractereCaractere
Grupo de Campos


Ordem080910
Tamanho6150
Decimal000
Formato@!@!@!
Contexto1 - Real1 - Real1 - Real
Propriedade2 - Visualizar2 - Visualizar2 - Visualizar
TítuloCod. DealerStatusArquivo
DescriçãoCódigo do DealerStatusArquivo Gerado
Val. Sistema
Pertence("12 ")
Opções
1=Gerado apenas Clientes;2=Gerado Clientes e Veiculos
Inic. Padrão
"1"
Inic. Browse


Cons. Padrão


Nível111
UsadoSimSimSim
ObrigatórioNãoNãoNão
BrowseSimSimSim
When


Pasta


Help

Identifica a concessionária ou revendedor autorizado responsável pela operação.

Campo no qual apresenta o Status da operação, onde:

1 = Gerado apenas Clientes

2 = Gerado Clientes e Veículos

Exibe o nome do arquivo que foi produzido ao final da execução do processo, permitindo identificar o resultado da operação e servir como referência para conferência, auditoria e acompanhamento das etapas realizadas.


Criação de Campo no arquivo SX3 – Campos:


  • Tabela VEV - SCRM SCANIA - Veiculos:


Campo

VEV_FILIALVEV_CODIGOVEV_CODVEF
TipoCaractereCaractereCaractere
Grupo de Campos033

Ordem010203
Tamanho288
Decimal000
Formato@!@!@!
Contexto1 - Real1 - Real1 - Real
Propriedade2 - Visualizar2 - Visualizar2 - Visualizar
TítuloFilialCod. Seq.Código VEF
DescriçãoFilialCódigo SequencialCódigo VEF
Val. Sistema


Opções


Inic. Padrão
GetSXENum("VEV","VEV_CODIGO")
Inic. Browse


Cons. Padrão


Nível111
UsadoNãoSimSim
ObrigatórioNãoSimNão
BrowseNãoSimSim
When


Pasta


Help

Código que identifica a filial da empresa usuária do sistema.

Identificador numérico gerado automaticamente pelo sistema.

Número único que individualiza o registro VEF, utilizado para rastreabilidade e conferência das informações.

Campo

VEV_CHASSIVEV_ARQUIV
TipoCaractereCaractere
Grupo de Campos

Ordem0405
Tamanho2550
Decimal00
Formato@!@!
Contexto1 - Real1 - Real
Propriedade2 - Visualizar2 - Visualizar
TítuloChassiArquivo
DescriçãoNúmero do ChassiArquivo Gerado
Val. Sistema

Opções

Inic. Padrão

Inic. Browse

Cons. Padrão

Nível11
UsadoSimSim
ObrigatórioNãoNão
BrowseSimSim
When

Pasta

Help

Número de identificação do veículo, utilizado para rastreabilidade e conferência das informações.

Exibe o nome do arquivo que foi produzido ao final da execução do processo, permitindo identificar o resultado da operação e servir como referência para conferência, auditoria e acompanhamento das etapas realizadas.


Criação de Campo no arquivo SX3 – Campos:


  • Tabela VCF - Dados Adicionais Clientes Cev:


Campo

VCF_SCRMID

VCF_SCRMEDVCF_SCRMSC
TipoCaractereCaractereCaractere
Grupo de Campos


OrdemA9A9B0
Tamanho2011
Decimal000
Formato@!@!@!
Contexto1 - Real1 - Real1 - Real
Propriedade1 - Alterar1 - Alterar1 - Alterar
TítuloID SCRMIDEnvia SCRMSCRM St.Cred
DescriçãoID SCRMID ScaniaEnvia Dados SCRMSCRM-Status de Crédito
Val. Sistema
VAZIO() .or. Pertence('12 ')VAZIO() .or. Pertence('01234 ')
Opções
1=Sim;2=Nao0=Sem Credito Estabelecido;1=Liberado ate o Limite;2=Credito Bloqueado;3=Credito Irrestrito;4=Sob Consulta
Inic. Padrão


Inic. Browse


Cons. Padrão


Nível111
UsadoSimSimSim
ObrigatórioNãoNãoNão
BrowseSimNãoNão
When

M->VCF_SCRMED=="1"
Pasta


Help

Informe o código único do registro SCRMID da Scania. Esse valor é utilizado para associar corretamente o registro no sistema, garantindo controle, auditoria e acompanhamento das operações.

Identificar se os dados em questão podem ou não ser enviados para a plataforma SCRM.

Permitirá armazenar de forma dinâmica a informação referente ao status de crédito a ser enviada à Scania.

0 - Sem Crédito Estabelecido

1 - Liberado até o Limite

2 - Crédito Bloqueado

3 - Crédito Irrestrito

4 - Sob Consulta


...

4. Fluxo de Utilização


Totvs custom tabs box
tabsExecução Manual, Schedule, Reprocessamento, Carga Inicial, Reenvio de clientes (avulso), Gravação de Logs
idspasso1,passo2,passo3,passo4,passo5,passo6
Totvs custom tabs box items
defaultyes
referenciapasso1


  1. Acesse o Módulo 14 (Oficina).
  2. Acesse o menu Atualizações → Cadastros Peças → Importação Glass (OFIA538).
  3. Preencha os parâmetros obrigatórios:
    • Grupo Padrão da Peça
    • Armazém Padrão da Peça
    • Arquivo .DAT 
    • Ação Após o Processamento
  4. No parâmetro Arquivo .DAT, será exibida uma tela mostrando o servidor (pasta protheus_data) e seus diretórios. Selecione o arquivo .DAT que será processado pela rotina.
  5. No parâmetro Ação Após o Processamento:
    • Selecione a opção Nenhuma Ação. Com isso, o arquivo .DAT permanecerá no diretório originalsem ser movido ou apagado após o processamento.
  6. Após preencher todos os parâmetros obrigatórios, clique no botão “OK”.

    • A rotina processará o arquivo .DAT e após a inclusão ou atualização das peças serão executadas ações personalizadas definidas através do ponto de entrada.

    • Ao final do processamento, serão executadas ações personalizadas definidas através dos pontos de entrada de conclusão da rotina.

Totvs custom tabs box items
defaultno
referenciapasso2


  1. Acesse o Módulo 14 (Oficina).
  2. Acesse o menu Atualizações → Cadastros Peças → Importação Glass (OFIA538).
  3. Preencha os parâmetros obrigatórios:
    • Grupo Padrão da Peça
    • Armazém Padrão da Peça 
    • Arquivo .DAT
    • Ação Após o Processamento
  4. No parâmetro Arquivo .DAT, será exibida uma tela mostrando o servidor (pasta protheus_data) e seus diretórios. Selecione o arquivo .DAT que será processado pela rotina.
  5. No parâmetro Ação Após o Processamento:
    • Selecione a opção Mover Arquivo. Com isso, o parâmetro Mover Para será habilitado, permitindo que seja selecionado o diretório destino no 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 .DAT e após a inclusão ou atualização das peças serão executadas ações personalizadas definidas através do ponto de entrada.

    • Ao final do processamento, 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.

Image Removed



Totvs custom tabs box items
defaultno
referenciapasso3


  1. Acesse o Módulo 14 (Oficina).
  2. Acesse o menu Atualizações → Cadastros Peças → Importação Glass (OFIA538).
  3. Preencha os parâmetros obrigatórios:
    • Grupo Padrão da Peça
    • Armazém Padrão da Peça
    • Arquivo .DAT 
    • Ação Após o Processamento
  4. No parâmetro Arquivo .DAT, será exibida uma tela mostrando o servidor (pasta protheus_data) e seus diretórios. Selecione o arquivo .DAT que será processado pela rotina.
  5. No parâmetro Ação pós Processamento:
    • Selecione a opção Apagar Arquivo. Com isso, ao término do processamento, o arquivo será apagado do diretório onde foi selecionado.
  6. Após preencher todos os parâmetros obrigatórios, clique no botão “OK”.

    • A rotina processará o arquivo .DAT e após a inclusão ou atualização das peças, serão executadas ações personalizadas definidas através do ponto de entrada.

    • Ao final do processamento, 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.


Totvs custom tabs box items
defaultno
referenciapasso4


Após a execução da rotina, será possível visualizar na tabela VQL os registros de logs gerados pelo processamento, conforme o exemplo na imagem abaixo.

  • Na coluna VQL_AGROUP (Agrupador), será registrado o nome do fonte da rotina;
  • Na coluna VQL_TIPO (Tipo), será registrado o status da ação após o processamento, se houve sucesso, erro e também o início da ação.
  • 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).


Totvs custom tabs box items
defaultno
referenciapasso5


Após a execução da rotina, será possível visualizar na tabela VQL os registros de logs gerados pelo processamento, conforme o exemplo na imagem abaixo.

  • Na coluna VQL_AGROUP (Agrupador), será registrado o nome do fonte da rotina;
  • Na coluna VQL_TIPO (Tipo), será registrado o status da ação após o processamento, se houve sucesso, erro e também o início da ação.
  • 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).


Totvs custom tabs box items
defaultno
referenciapasso6


Logs VRN (Configuração na OFIA541) e VQL


...

5. Integrações e Dependências


Integrações

Ao final da execução, as peças importadas pela rotina Importação Glass (OFIA538) estarão disponíveis nas rotinas de Cadastro de Peças (MATA010), Peças Substituídas (OFIPA910) e Kits (OFIPA920).

...

Principais campos importados após o processamento do arquivo DAT
Cadastro de PeçasSubstituição de ItensCadastro de Kits
Tabela SB1(Segmento 01)Tabela SB5Tabela SBZTabela VE9Tabela VEH(Cabeçalho)Tabela VE8(Itens do Kit)
B1_DATCADB5_CODBZ_CODTodos SegmentosSegmento 01Segmento 02Segmento 04Segmento 06Segmento 06
B1_CODB5_CEMEBZ_LOCPADVE9_FILIALVE9_STAGLAVE9_APLICAVE9_ITENOVVE9_ITENOVVEH_FILIALVE8_FILIAL
B1_GRUPOB5_UMIND
VE9_SEGMENVE9_ITENOVVE9_ITENOVVE9_QTDADEVE9_QTDADEVEH_TIPO  VE8_TIPO  
B1_CODITE

VE9_NROSEQ

VE9_DATSUB
VEH_GRUKITVE8_GRUKIT
B1_FABRIC

VE9_NROSUB

VE9_QTDSUB
VEH_CODKITVE8_CODKIT
B1_DESC

VE9_GRUITE

VE9_STATUS
VEH_DESKITVE8_GRUITE
B1_UM

VE9_GRUNOV



VEH_VALKITVE8_CODITE
B1_SEGUM

VE9_ITEANT




VE8_QTDADE
B1_TIPO








B1_LOCPAD








B1_CONTA








B1_CC









...

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=1014654380" target="_blank" class="btn-doc">     		
	📄 Ponto de Entrada OF538PRO - Importação Glass (OFIA538)   
  </a>
  <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=1014655032" target="_blank" class="btn-doc">     
	📄 Ponto de Entrada OF538FIM - Importação Glass (OFIA538)   
  </a>
</div>

...