Árvore de páginas

Versões comparadas

Chave

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


01. DADOS GERAIS

Produto:

Solucoes_totvs

Solucoes_totvs_cross
SolucaoCross

Solucoes_totvs_parceiros
SolucaoParceiros

Solucoes_totvs_parceirosexptotvs
SolucaoParcsExpsTOTVSTOTVS DMS

Linha de Produto:

Linhas_totvs
LinhaLinha Protheus

Segmento:

Segmentos_totvs
Segmento Varejo

Módulo:

Modulos_cross_segmentos

Modulos_framework

Modulos_totvs_construcao

Modulos_totvs_juridico

Modulos_totvs_logistica

Modulos_totvs_manufatura

Modulos_totvs_rh

Modulos_totvs_saude

Modulos_totvs_prestadores_de_servicos

Totvs DMS (Linha Protheus) - Oficina Veículos (SIGAOFISIGAVEI)

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

02. SITUAÇÃO/REQUISITO

Após levantamentos realizados sobre estudos baseando-se com base nos processos e regras de negócio da montadora Scania, foi identificada identificou-se a necessidade de criar uma rotina que permita realizar a atualização de preço das peças fornecidas pela montadora Scania por meio de um arquivo PRI RM.TXT, facilitando o recebimento e a atualização dessas informações dentro do sistema Protheus DMSenvie 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 Atualização de Preço Garantia e Contrato (OFIA537), que realiza a leitura de arquivos PRI RM.TXT enviados pela montadora Scania e permite a atualização dos preços de peças no cadastro de Peças do sistema Protheus DMS.

Para que a rotina funcione corretamente, é necessário garantir algumas condições que asseguram a leitura adequada do arquivo PRI RM.TXT, o mapeamento das peças previamente cadastradas e o correto tratamento dos dados no sistema. São elas:

    • As peças existentes no arquivo PRI RM.TXT devem ter sido previamente cadastradas na rotina de Peças (MATA010) ou pela rotina Importação Glass (OFIA538).
    • É 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).

...

tabsPasso a passo para utilização, Atualização de Dicionário/Menu
idspasso1,passo2

...

defaultyes
referenciapasso1
  • Acesse o Módulo 14 (Oficina).
  • Acesse o menu Atualizações → Cadastros Peças → Atualização de Preço Garantia e Contrato (OFIA537).
  • Preencha os parâmetros: 
    • No parâmetro Arquivo para Importação? que possui preenchimento obrigatório, ao sair do campo, será exibida uma tela mostrando o servidor (pasta protheus_data) e seus diretórios. Selecione o arquivo PRI RM.TXT que será processado pela rotina.
    • No parâmetro Grupo a considerar? que possui preenchimento obrigatório, será necessário preencher o(s) grupo(s) vinculado(s) às peças já cadastradas no Protheus e existentes na rotina Grupos de Peças (MATA035).
    • No parâmetro Dest. P.Dealer_Contrat?, ao clicar no ícone da lupa, será exibida uma listagem onde deve ser selecionado o preço de venda desejado.
    • No parâmetro Dest. P.Dealer_Normal?, ao clicar no ícone da lupa, será exibida uma listagem onde deve ser selecionado o preço de venda desejado.
    • No parâmetro Dest. P.Balcão_Contrat?,  ao clicar no ícone da lupa, será exibida uma listagem onde deve ser selecionado o preço de venda desejado.
    • No parâmetro Dest. P.Balcão_Normal?,  ao clicar no ícone da lupa, será exibida uma listagem onde deve ser selecionado o preço de venda desejado.

Atualização dos preços: A listagem apresentada nos parâmetros acima consiste nos seguintes campos:

      • Preco Venda2 (B5_PRV2)
      • Preco Venda3 (B5_PRV3)
      • Preco Venda4 (B5_PRV4)
      • Preco Venda5 (B5_PRV5)
      • Preco Venda6 (B5_PRV6)
      • Preco Venda7 (B5_PRV7)

Esses campos estão presentes na aba Vendas, seção Dados Adicionais do Produto, rotina Peças (MATA010).

A atualização ocorrerá da seguinte forma: o campo referente ao preço selecionado no parâmetro será atualizado com o valor correspondente existente no arquivo PRI RM.TXT.

Exemplo: Se no parâmetro Dest. P.Dealer_Contrat? for selecionado o preço "B5_PRV4", o campo Preco Venda4 da rotina Peças (MATA010) será atualizado com o valor da coluna "P.Dealer_Contrato" do arquivo.

Observação: Não é permitido utilizar o mesmo preço de venda em parâmetros diferentes, ou seja, caso um preço de venda já tenha sido selecionado em um parâmetro, se selecionado o mesmo preço em um segundo parâmetro ao clicar no botão OK para execução da rotina ocorrerá a validação dos parâmetros e será exibida uma mensagem em tela abortando a operação.

...

  • No parâmetro Atualiza Qtd. por Embalagem? que possui preenchimento obrigatório, caso seja selecionada a opção 1 - Sim, a quantidade de peças por embalagem será atualizada de acordo com a configuração realizada anteriormente para o parâmetro "MV_ARQPROD". Caso seja selecionada a opção 2 - Não, não haverá atualização da quantidade de peças por embalagem.  

...

No parâmetro Ação após processamento, selecione uma das opções abaixo:

  • Nenhuma Ação: o arquivo PRI RM.TXT permanecerá no diretório original, sem ser movido, nem apagado após o processamento.

  • Mover Arquivo: o parâmetro Mover Para? será habilitado, permitindo selecionar o diretório de destino dentro do servidor. Ao final do processamento, o arquivo será movido automaticamente do diretório original para o diretório informado.

  • Apagar Arquivo: ao término do processamento, o arquivo PRI RM.TXT será excluído do diretório original.

Após preencher todos os parâmetros obrigatórios, clique no botão “OK”.

...

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.

...

Realizada a criação do dicionário de dados Envia SCRM (VCF_SCRMED) e SCRM St.Cred (VCF_SCRMSC) na tabela Dados Adicionais Clientes Cev (VCF) para atender à regra de negócio da Integração SCRM.


acao1,acao2,acao3
Totvs custom tabs box
tabs
Passo a passo: Ação pós Processamento - Nenhuma Ação, Passo a passo: Ação pós Processamento - Mover Arquivo, Passo a passo: Ação pós Processamento - Apagar Arquivoids
Atualização de Dicionário/Menu
idspasso1

Criação de Tabela no arquivo SX2 – Tabelas:

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


  • Tabela VEF - SCRM Scania - ClientesVCF - Dados Adicionais Clientes Cev:


Totvs custom tabs box items
defaultyes
referencia
acao1

Multimedia
nameAtualização de Preço Garantia e Contrato - Nenhuma Ação1.mp4
width1400
autostarttrue
height700

Totvs custom tabs box items
defaultno
referenciaacao2
Totvs custom tabs box items
defaultno
referenciaacao3
Totvs custom tabs box items
defaultno
referenciapasso2
passo1

Criação de C

  • 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

Chave

Nome

Modo

Único

PYME

VEFSCRM Scania - ClientesCVEF_FILIAL+VEF_CODIGO S
VEVSCRM SCANIA - VeiculosCVEV_FILIAL+VEV_CODIGOS

Campo

VEF
VCF_
FILIAL
SCRMED
VEF
VCF_
CODIGO

VEF_TPEXEC

VEF_DTEXEC

SCRMSC
Tipo
TipoCaractere
CaractereCaractere
Data
Grupo de Campos
033


Ordem
01020304
A9B0
Tamanho
2
1
8
1
8
Decimal
00
00
Formato
@!
@!@!
Contexto1 - Real1 - Real
Propriedade1 -
Real
Alterar1 -
RealPropriedade2 - Visualizar2 - Visualizar2 - Visualizar2 - VisualizarTítuloFilialCod. Seq.Tp.ExecuçãoDt.ExecuçãoDescriçãoFilialCódigo SequencialTipo ExecuçãoData ExecuçãoVal. SistemaPertence("12 ")Opções1=Carga Inicial;2=DiarioInic. PadrãoGetSXENum("VEF","VEF_CODIGO",,1)"1"dDataBaseInic. BrowseCons. PadrãoNível1111UsadoNãoSimSimSimObrigatórioNãoSimNãoNãoBrowseNãoSimSimSimWhenPastaHelpCó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

TipoCaractereCaractereCaractereGrupo de Campos001002Ordem050607Tamanho462Decimal000Formato@!@!@!Contexto1 - Real1 - Real1 - RealPropriedade2 - Visualizar2 - Visualizar2 - VisualizarTítuloHr.ExecuçãoCód. ClienteLoja ClienteDescriçãoHora ExecuçãoCódigo do ClienteLoja do ClienteVal. SistemaOpções
Alterar
TítuloEnvia SCRMSCRM St.Cred
DescriçãoEnvia Dados SCRMSCRM-Status de Crédito
Val. SistemaVAZIO() .or. Pertence('12 ')VAZIO() .or. Pertence('01234 ')
Opções1=Sim;2=Nao0=Sem Credito Estabelecido;1=Liberado ate o Limite;2=Credito Bloqueado;3=Credito Irrestrito;4=Sob Consulta
Inic. Padrão

Inic. Browse

Cons. Padrão
SA1


Nível
1
11
UsadoSimSim
ObrigatórioNãoNão
Browse
Sim
Não
Sim
Não
SimWhenPastaHelp

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

TipoCaractereCaractereCaractereGrupo de CamposOrdem080910Tamanho6150Decimal000Formato@!@!@!Contexto1 - Real1 - Real1 - RealPropriedade2 - Visualizar2 - Visualizar2 - VisualizarTítuloCod. DealerStatusArquivoDescriçãoCódigo do DealerStatusArquivo GeradoVal. SistemaPertence("12 ")Opções1=Gerado apenas Clientes;2=Gerado Clientes e VeiculosInic. Padrão"1"Inic. BrowseCons. PadrãoNível111UsadoSimSimSimObrigatórioNãoNãoNãoBrowseSimSimSimWhenPastaHelp

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_CODVEFTipoCaractereCaractereCaractereGrupo de Campos033Ordem010203Tamanho288Decimal000Formato@!@!@!Contexto1 - Real1 - Real1 - RealPropriedade2 - Visualizar2 - Visualizar2 - VisualizarTítuloFilialCod. Seq.Código VEFDescriçãoFilialCódigo SequencialCódigo VEFVal. SistemaOpçõesInic. PadrãoGetSXENum("VEV","VEV_CODIGO")Inic. BrowseCons. PadrãoNível111UsadoNãoSimSimObrigatórioNãoSimNãoBrowseNãoSimSimWhenPastaHelp

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_ARQUIVTipoCaractereCaractereGrupo de CamposOrdem0405Tamanho2550Decimal00Formato@!@!Contexto1 - Real1 - RealPropriedade2 - Visualizar2 - VisualizarTítuloChassiArquivoDescriçãoNúmero do ChassiArquivo GeradoVal. SistemaOpçõesInic. PadrãoInic. BrowseCons. PadrãoNível11UsadoSimSimObrigatórioNãoNãoBrowseSimSimWhenPastaHelp

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.

04. DEMAIS INFORMAÇÕES

...

When
M->VCF_SCRMED=="1"
Pasta

Help

Identificar se os dados em questão podem ou não ser enviados para a plataforma SCRM.

Permitirá armazenar de forma dinâmica a informação referente ao status de crédito a ser enviada à Scania.

0 - Sem Crédito Estabelecido

1 - Liberado até o Limite

2 - Crédito Bloqueado

3 - Crédito Irrestrito

4 - Sob Consulta

04. DEMAIS INFORMAÇÕES

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

...


Card documentos
Informacao Esta atualização de dicionário estará disponível na release 12.01.2610.
TituloIMPORTANTE!

05. 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=10174434401031526686" target="_blank" class="btn-doc">     
	📄 Atualização de Preço Garantia e ContratoIntegração SCRM (OFIA537VEIA120)
  </a>
  <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=1017446392" target="_blank" class="btn-doc">     		
	📄 Ponto de Entrada OFA537GR - Atualização de Preço Garantia e Contrato (OFIA537)   
  </a>
  <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=1018563130" target="_blank" class="btn-doc">     
	📄 Ponto de Entrada OFA537FI - Atualização de Preço Garantia e Contrato (OFIA537)   
  </a>
  <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=1014657481" target="_blank" class="btn-doc">     
	📄 Importação Glass (OFIA538)   
  </a>   </div>


Templatedocumentos