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:
É necessário cadastrar previamente os gatilhos (triggers) para que a rotina identifique diariamente quais registros foram alterados. O cadastro dos gatilhos deve ser feito no Configurador (SIGACFG), por meio da rotina Embedded Audit Trail (CFGA710), acessando o caminho: SIGACFG > Ambiente > Embedded Audit Trail > Aplicador. - Na seção Grupo de Empresas, deve-se configurar a(s) empresa(s) em que os gatilhos serão aplicados.
- Na seção Tabela, é necessário configurar as seguintes tabelas:
- Tabela SA1 - Clientes
- Tabela SF2 - Cabeçalho das NF de Saída
- Tabela VCF - Dados Adicionais Clientes Cev
- Tabela VO1 - Ordem de Serviço
- Tabela VS1 - Orçamento
- Tabela VV1 - Cadastro de Veículos
- Na seção Campos, devem ser configurados os campos de cada tabela que acionarão os gatilhos quando alguma operação (como inclusão, alteração ou exclusão) for realizada.
Observação: Após a configuração dos gatilhos, é necessário executar as operações nos campos por meio das rotinas correspondentes às tabelas para que os gatilhos sejam efetivamente ativados. |

|
|
- Acesse o Módulo 11 (Veículos).
- Acesse o menu Atualizações → SCRM → Integração SCRM (VEIA120).
- Nas mensagens apresentadas durante a execução da rotina referentes aos pontos de entrada, clicar no botão Fechar.
- Será gerado arquivo de diário clientes e diário veículos
- 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 Configurador (SIGACFG).
- Acesse o menu Atualizações → SCRM → Integração SCRM (VEIA120).
- Será gerado arquivo de carga inicial clientes e carga inicial veículos
|
Caso na rotina Configurações Integrações Scania (OFIA541), na aba Integração SCRM, o campo Integração Ativa? esteja como Sim, e o campo Gerar Arquivo espelho do XML integrado ao SCRM? também esteja salvo como Sim, ao executar a rotina Integração SCRM (VEIA120) serão gerados arquivos de acordo com a opção utilizada (Carga Inicial ou Diário).
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v1="http://xmlns.scania.com/account/schema/scrmmsgs/v1" xmlns:v11="http://xmlns.scania.com/account/schema/account/v1">
<soapenv:Header>
<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
<wsse:UsernameToken wsu:Id="UsernameToken-1">
<wsse:Username>USUARIO</wsse:Username>
<wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">SENHA</wsse:Password>
</wsse:UsernameToken>
</wsse:Security>
</soapenv:Header>
<soapenv:Body>
<v1:UpdateAccountRequest>
<v1:Account>
<v11:accountnumber>01020304056</v11:accountnumber>
<v11:name>TESTE NOME DO TESTE</v11:name>
<v11:global_tradename>TESTE NOME</v11:global_tradename>
<v11:global_vatnumber>ISENTO</v11:global_vatnumber>
<v11:emailaddress1>[email protected]</v11:emailaddress1>
<v11:address1_line1>RUA TESTES, 123</v11:address1_line1>
<v11:global_address1countryid>01058</v11:global_address1countryid>
<v11:global_address1countyid>SP</v11:global_address1countyid>
<v11:address1_postalcode>15000123</v11:address1_postalcode>
<v11:address1_city>CIDADE</v11:address1_city>
<v11:address1_county>ESTADO</v11:address1_county>
<v11:address1_country>PAIS</v11:address1_country>
<v11:address2_line1>RUA TESTES, 123</v11:address2_line1>
<v11:global_address2countyid>SP</v11:global_address2countyid>
<v11:address2_postalcode>15000123</v11:address2_postalcode>
<v11:address2_city>CIDADE</v11:address2_city>
<v11:address2_county>ESTADO</v11:address2_county>
<v11:address2_country>PAIS</v11:address2_country>
<v11:creditonhold>1 - Liberado ate o Limite</v11:creditonhold>
<v11:global_latestpurchasedateparts>2025-05-14</v11:global_latestpurchasedateparts>
<v11:global_latestpurchasedateworkshop>2025-07-11</v11:global_latestpurchasedateworkshop>
<v11:global_countrycode>BR</v11:global_countrycode>
<v11:global_accounttype>1</v11:global_accounttype>
<v11:global_sourcestatus>Ativo</v11:global_sourcestatus>
<v11:dealer/>
<v11:persontype>1</v11:persontype>
<v11:relationtype>3</v11:relationtype>
<v11:originsystem>Protheus</v11:originsystem>
<v11:cws>Nao</v11:cws>
</v1:Account>
</v1:UpdateAccountRequest>
</soapenv:Body>
</soapenv:Envelope>
|
- 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

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/display/public/framework/Embedded+Audit+Trail+-+Aplicador" target="_blank" class="btn-doc">
📄 Embedded Audit Trail - Aplicador
</a>
<a href="https://tdn.totvs.com/display/public/framework/Configurar+Embedded+Audit+Trail" target="_blank" class="btn-doc">
📄 Configurar Embedded Audit Trail
</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> |
