Á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

A rotina Importação GLASS (OFIA538) tem como objetivo simplificar a importação e atualização das peças enviadas pela Scania para o Protheus DMS, a partir do arquivo GLASS (Global Assortment) (.DAT) fornecido pela montadora. Esse arquivo reúne informações de peças, substituições e kits.

Ao iniciar a rotina, o usuário deve preencher os parâmetros obrigatórios e opcionais, que orientam o comportamento do processo e garantem a consistência dos dados antes da leitura do arquivo.

Após a validação dos parâmetros, o sistema interpreta o conteúdo do arquivo GLASS e realiza a inclusão ou atualização das peças conforme as informações oficiais da Scania.

Finalizado o processamento, o sistema executa as ações de pós-processamento definidas na configuração, como manter, mover ou excluir o arquivo, além de gerar logs com o detalhamento da operação.

Assim, a rotina Importação GLASS (OFIA538) contribui para a organização e manutenção do cadastro de peças da Scania no Protheus DMS, tornando o processo mais eficiente, parametrizável e alinhado às informações oficiais da montadora.

3. Pré-requisitos e Configurações

...

de execução é responsável por identificar, preparar e enviar os dados de clientes e veículos ao SCRM, respeitando integralmente todas as regras definidas 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 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

...

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


Para que a integração ocorra corretamente durante o processamento da rotina, é necessário 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

defaultyes
referenciaaba1

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

  • É necessário incluir manualmente a rotina Importação Glass (OFIA538) no menu do Protheus, permitindo assim o acesso à funcionalidade.
  • 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.

    Totvs custom tabs box items
    defaultno
    referenciaaba2


    testeOFIA541

    • 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

    2
    Totvs custom tabs box items
    defaultno
    referenciaaba3


    • 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

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

    • Tabela VE9 - Substituição de Itens

    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
    Tamanho2202
    Decimal000
    0
    Formato
    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
    @!@!@!
    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>

    ...