Árvore de páginas

Versões comparadas

Chave

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

...

1. Identificação da Rotina


Nome da Rotina

Importação GlassConfigurações SCRM
ProgramaOFIA538OFIA541
Módulo ERPOficina (SIGAOFI)
Acesso à RotinaAtualizações/Cadastros Peças/Importação Glass (OFIA538Configurações Integrações Scania (OFIA541)
Data da Documentação (Última Atualização)

 

...

  • Restrições comerciais e cadastrais, assegurando que apenas clientes válidos participem da integração;

  • Regras relacionadas à frota, como marca, período mínimo de fabricação e status do veículo;

  • Parâmetros que controlam o volume e a forma de envio, prevenindo sobrecarga do serviço externo;

  • Ativação ou bloqueio da geração de arquivos, permitindo simulações ou controle operacional.

Caso a configuração esteja incompleta, inconsistente ou desativada, a integração não é executada, e o sistema registra a ocorrência para análise, garantindo segurança e previsibilidade no processo.


...

3. Pré-requisitos e Configurações

...

tabsPré-requisitos, Gatilhos, Atualização de Dicionário/Menu
idsaba1,aba2, aba3

...

...

Para o correto funcionamento da rotina Importação Glass (OFIA538), é 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.
Totvs custom tabs box items
defaultno
referenciaaba2

teste

...

defaultno
referenciaaba3

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

  • Tabela VE9 - Substituição de Itens

...

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.

Para utilizar a rotina Configurações SCRM, é necessário possuir cadastrados os dados de comunicação com o Web Service da Scania. Esses dados são utilizados pelo sistema para estabelecer a conexão e realizar a integração durante a execução do processo.

A correta parametrização dessas informações é obrigatória para que as rotinas de execução e de consulta do SCRM funcionem adequadamente. Sem o cadastro dos dados de comunicação, a integração não é realizada.

  • 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

...

Nome da Rotina

...

Programa

...

OFIA538

...

Módulo

...

Oficina (SIGAOFI)

...

Tipo

...

Função Protheus

Criação de Pergunte no arquivo SX1 – Pergunta

...

Grupo

...

Grupo de Campo

...

Ordem

...

Pergunta

...

Tipo

...

Grupo

...

Grupo de Campo

...

Ordem

...

Pergunta

...

Tipo

...

C

...


...

4. Fluxo de Utilização

Totvs custom tabs box
tabsExecução Manual, Schedule, Reprocessamento, Carga Inicial, Reenvio de clientes (avulso)Integração - SCRM, Gerais, Gatilhos para envio ao SCRM
idspasso1secao1,passo2,passo3,passo4,passo5secao2,secao3
Totvs custom tabs box items
defaultyes
referenciapasso1secao1

Ambiente
Define para qual ambiente estas configurações estão válidas. O uso das configurações está diretamente relacionado à definição do Tipo de Ambiente, conforme parametrização realizada na rotina CFGA750 (inserir link para a documentação original).

Integração Ativa
Quando configurado como Sim, indica que a integração com o SCRM está habilitada e torna obrigatório o preenchimento dos campos de comunicação com o Web Service. Quando configurado como Não, a integração permanece inativa, independentemente dos demais parâmetros.

Usuário WebService
Usuário utilizado para autenticação no Web Service do SCRM.

Senha WebService
Senha utilizada para autenticação no Web Service do SCRM.

URL Clientes WebService
Endereço do serviço responsável pelo recebimento dos dados de clientes.

URL Veículos WebService
Endereço do serviço responsável pelo recebimento dos dados de veículos.

Image Added

  • Acesse o Módulo 14 (Oficina).
  • Acesse o menu Atualizações → Cadastros Peças → Importação Glass (OFIA538).
  • 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
  • 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.
  • 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.
  • 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.

  • Image Removed

    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
    referenciapasso2
    Totvs custom tabs box items
    defaultno
    referenciapasso3
    secao2

    Última Execução / Hora da Última Execução
    Campo apenas informativo, que registra a data e hora da última execução automática ou manual concluída com sucesso na integração com o SCRM.

    Quantidade de Anos para Levantamento da Frota
    Define o intervalo de anos considerado para envio de veículos ao SCRM, com base no ano/modelo do veículo.
    Exemplo: se o parâmetro estiver configurado com valor 5 e o veículo for 2018/2018, o veículo não será considerado para envio, por estar fora do período configurado.

    Enviar Apenas Clientes Vinculados à Carteira de Vendedores de Veículos Novos
    Restringe o registro de eventos apenas a clientes vinculados à carteira de veículos novos.

    Gerar Arquivo Espelho do XML Integrado ao SCRM
    Controla a geração de arquivo XML para fins de auditoria e conferência.

    Salvar Arquivo na Pasta (do servidor)
    Define o diretório onde os arquivos XML gerados serão armazenados.

    Image Added

    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.

    Image Removed

    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).

    Image Removed

    Totvs custom tabs box items
    defaultno
    referenciapasso4
    Totvs custom tabs box items
    defaultno
    referenciapasso5
    secao3

    Cadastro do Cliente
    Define se operações realizadas no cadastro do cliente devem registrar eventos para envio futuro ao SCRM.

    Cadastro Complementar do Cliente
    Define se operações no cadastro complementar do cliente devem registrar eventos para envio futuro ao SCRM.

    Cadastro do Veículo
    Define se operações realizadas no cadastro do veículo devem registrar eventos para envio futuro ao SCRM.

    Ordem de Serviço
    Define se movimentações em ordens de serviço devem registrar eventos para envio futuro ao SCRM.

    Orçamento
    Define se operações em orçamentos devem registrar eventos para envio futuro ao SCRM.

    Emissão de Nota Fiscal
    Define se a emissão de nota fiscal deve registrar eventos para envio futuro ao SCRM.


    Image Added

    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).

    Image Removed


    ...

    5. Integrações e Dependências

    ...

    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).

    ...


    ...

    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>

    ...