01. DADOS GERAIS

Produto:

Linha de Produto:

Segmento:

Módulo:

Totvs DMS (Linha Protheus) - Veículos (SIGAVEI)

Função:Integração SCRM (VEIA120)
País:Brasil
Ticket:Não há/Não se aplica.
Requisito/Story/Issue:DVARMIL-10421

02. SITUAÇÃO/REQUISITO

Após levantamentos realizados com base nos processos e regras de negócio da montadora Scania, identificou-se a necessidade de criar uma rotina que envie informações de clientes e veículos para integração com o SCRM da própria montadora, facilitando a integração e atualização dos dados entre o sistema Protheus DMS e o SCRM.

03. SOLUÇÃO

A solução implementada consistiu na criação da rotina Integração SCRM (VEIA120), que identifica, prepara e envia os dados de clientes e veículos do Protheus DMS ao SCRM, respeitando as regras definidas na configuração.

Para que a rotina funcione corretamente, é necessário garantir algumas configurações que asseguram a integração com o SCRM. São elas:

Cadastrar previamente os gatilhos (triggers) que permitem que a rotina identifique diariamente os registros que foram modificados.

O cadastro dos gatilhos deve ser realizado pelo Configurador (SIGACFG), na rotina Embedded Audit Trail (CFGA710), no caminho SIGACFG > Ambiente > Embedded Audit Trail > Aplicador.


Na seção Grupo de empresas:

OBS: Na coluna Grupo de empresas, informar a empresa em que os gatilhos deverão ser aplicados.


Na seção Tabela:


Na seção Campos:

  • Tabela SA1:


  • Tabela VCF:


  • Tabela VV1:













  • Acesse o Módulo 11 (Veículos).
  • Acesse o menu Atualizações → SCRM → Integração SCRM (VEIA120).
  • A rotina processará o arquivo PRI RM.TXT e, após a atualização de preço e da quantidade por embalagem de cada peça, serão executadas ações personalizadas definidas através do ponto de entrada criado para execução após o processamento de cada item.
  • Ao final do processamento, quando o arquivo for concluído com sucesso, serão executadas ações personalizadas definidas através do ponto de entrada destinado à conclusão da rotina, e o sistema aplicará a ação de pós-processamento selecionada (manter, mover ou apagar o arquivo).


  • Acesse o Módulo 11 (Veículos).
  • Acesse o menu Atualizações → SCRM → Integração SCRM (VEIA120).
  • 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

TipoCaractere
Grupo de Campos
OrdemA9
Tamanho20
Decimal0
Formato@!
Contexto1 - Real
Propriedade1 - Alterar
TítuloID SCRMID
DescriçãoID SCRMID Scania
Val. Sistema
Opções
Inic. Padrão
Inic. Browse
Cons. Padrão
Nível1
UsadoSim
ObrigatórioNão
BrowseSim
When
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.

04. DEMAIS INFORMAÇÕES

Pacote gerados



05. ASSUNTOS RELACIONADOS


<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=1031526686" target="_blank" class="btn-doc">     
	📄 Integração SCRM (VEIA120)
  </a>
  <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=1032140741" target="_blank" class="btn-doc">     		
	📄 Ponto de Entrada VA120FCP - Integração SCRM (VEIA120)   
  </a>
  <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=1032141116" target="_blank" class="btn-doc">     
	📄 Ponto de Entrada VA120FVT - Integração SCRM (VEIA120)   
  </a>
  <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=1032141162" target="_blank" class="btn-doc">     
	📄 Ponto de Entrada VA120QRY - Integração SCRM (VEIA120)   
  </a>
  <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=1032143032" target="_blank" class="btn-doc">     
	📄 Ponto de Entrada VA120PET - Integração SCRM (VEIA120)   
  </a> </div>