Exibir origem

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 sofreram modificações. O cadastro deve ser realizado através da rotina Embedded Audit Trail (CFGA710), pelo Configurador (SIGACFG).
- É necessário incluir manualmente a rotina Atualização de Preço Garantia e Contrato (OFIA537) no menu do Protheus, permitindo assim o acesso à funcionalidade.
- Deve-se possuir um arquivo PRI RM.TXT válido contendo as informações e preços das peças enviados pela montadora Scania, que será utilizado como base para execução da rotina.
- Configurar corretamente o parâmetro "MV_ARQPROD" que é responsável por determinar se os dados dos indicadores de produto serão considerados pela tabela "Descrição Genérica do Produto" (SB1) ou pela tabela "Indicadores de Produtos" (SBZ).

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
VEF	SCRM Scania - Clientes	C	VEF_FILIAL+VEF_CODIGO	S
VEV	SCRM SCANIA - Veiculos	C	VEV_FILIAL+VEV_CODIGO	S

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

Tabela VEF - SCRM Scania - Clientes:

Campo	VEF_FILIAL	VEF_CODIGO	VEF_TPEXEC	VEF_DTEXEC
Tipo	Caractere	Caractere	Caractere	Data
Grupo de Campos	033
Ordem	01	02	03	04
Tamanho	2	8	1	8
Decimal	0	0	0	0
Formato	@!	@!	@!
Contexto	1 - Real	1 - Real	1 - Real	1 - Real
Propriedade	2 - Visualizar	2 - Visualizar	2 - Visualizar	2 - Visualizar
Título	Filial	Cod. Seq.	Tp.Execução	Dt.Execução
Descrição	Filial	Código Sequencial	Tipo Execução	Data 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ível	1	1	1	1
Usado	Não	Sim	Sim	Sim
Obrigatório	Não	Sim	Não	Não
Browse	Não	Sim	Sim	Sim
When
Pasta
Help	Có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
Tipo	Caractere	Caractere	Caractere
Grupo de Campos		001	002
Ordem	05	06	07
Tamanho	4	6	2
Decimal	0	0	0
Formato	@!	@!	@!
Contexto	1 - Real	1 - Real	1 - Real
Propriedade	2 - Visualizar	2 - Visualizar	2 - Visualizar
Título	Hr.Execução	Cód. Cliente	Loja Cliente
Descrição	Hora Execução	Código do Cliente	Loja do Cliente
Val. Sistema
Opções
Inic. Padrão
Inic. Browse
Cons. Padrão		SA1
Nível	1	1	1
Usado	Sim	Sim
Obrigatório	Não	Não
Browse	Sim	Sim	Sim
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
Tipo	Caractere	Caractere	Caractere
Grupo de Campos
Ordem	08	09	10
Tamanho	6	1	50
Decimal	0	0	0
Formato	@!	@!	@!
Contexto	1 - Real	1 - Real	1 - Real
Propriedade	2 - Visualizar	2 - Visualizar	2 - Visualizar
Título	Cod. Dealer	Status	Arquivo
Descrição	Código do Dealer	Status	Arquivo 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ível	1	1	1
Usado	Sim	Sim	Sim
Obrigatório	Não	Não	Não
Browse	Sim	Sim	Sim
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_FILIAL	VEV_CODIGO	VEV_CODVEF
Tipo	Caractere	Caractere	Caractere
Grupo de Campos	033
Ordem	01	02	03
Tamanho	2	8	8
Decimal	0	0	0
Formato	@!	@!	@!
Contexto	1 - Real	1 - Real	1 - Real
Propriedade	2 - Visualizar	2 - Visualizar	2 - Visualizar
Título	Filial	Cod. Seq.	Código VEF
Descrição	Filial	Código Sequencial	Código VEF
Val. Sistema
Opções
Inic. Padrão		GetSXENum("VEV","VEV_CODIGO")
Inic. Browse
Cons. Padrão
Nível	1	1	1
Usado	Não	Sim	Sim
Obrigatório	Não	Sim	Não
Browse	Não	Sim	Sim
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_CHASSI	VEV_ARQUIV
Tipo	Caractere	Caractere
Grupo de Campos
Ordem	04	05
Tamanho	25	50
Decimal	0	0
Formato	@!	@!
Contexto	1 - Real	1 - Real
Propriedade	2 - Visualizar	2 - Visualizar
Título	Chassi	Arquivo
Descrição	Número do Chassi	Arquivo Gerado
Val. Sistema
Opções
Inic. Padrão
Inic. Browse
Cons. Padrão
Nível	1	1
Usado	Sim	Sim
Obrigatório	Não	Não
Browse	Sim	Sim
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
Tipo	Caractere
Grupo de Campos
Ordem	A9
Tamanho	20
Decimal	0
Formato	@!
Contexto	1 - Real
Propriedade	1 - Alterar
Título	ID SCRMID
Descrição	ID SCRMID Scania
Val. Sistema
Opções
Inic. Padrão
Inic. Browse
Cons. Padrão
Nível	1
Usado	Sim
Obrigatório	Não
Browse	Sim
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

12.1.2210: https://r.totvs.io/p/1227898

12.1.2310: https://r.totvs.io/p/1227899

12.1.2410: https://r.totvs.io/p/1227900

12.1.2510: https://r.totvs.io/p/1227901

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>