01. DADOS GERAIS
| Produto: |
TOTVS DMS |
|---|---|
| Linha de Produto: | Linha Protheus |
| Segmento: | Varejo |
| 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 configuradas 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).
- 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 Módulo 11 (Veículos).
- Acesse o menu Atualizações → SCRM → Integração SCRM (VEIA120).
- Será gerado arquivo de carga inicial clientes e carga inicial veículos
- 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/1234398 12.1.2310:https://r.totvs.io/p/1234399 12.1.2410:https://r.totvs.io/p/1234400 12.1.2510:https://r.totvs.io/p/1234401 |
|---|
Esta atualização de dicionário estará disponível na release 12.01.2610.
IMPORTANTE!
05. ASSUNTOS RELACIONADOS
📄 Integração SCRM (VEIA120)
📄 Embedded Audit Trail - Aplicador
📄 Configurar Embedded Audit Trail
📄 Ponto de Entrada VA120FCP - Integração SCRM (VEIA120)
📄 Ponto de Entrada VA120FVT - Integração SCRM (VEIA120)
📄 Ponto de Entrada VA120QRY - Integração SCRM (VEIA120)
📄 Ponto de Entrada VA120PET - Integração SCRM (VEIA120)
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas