Á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) - Veículos (SIGAVEI)

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).

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.


  • 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.

    • 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).

acao1,acao2,acao3
Totvs custom tabs box
tabsPasso a passo para utilização, Atualização de Dicionário/Menu
idspasso1,passo2
Totvs custom tabs box items
defaultyes
referenciapasso1
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
  • 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:
Função Protheus

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

C

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

Menu

Atualizações

Submenu

SCRM

Nome da Rotina

Integração SCRM

Programa

VEIA120

Módulo

Veículos (SIGAVEI)

Tipo

passo1
VEFSCRM Scania - Clientes

Chave

Nome

Modo

Único

PYME

VEF_FILIAL+VEF_CODIGO S
VEVSCRM SCANIA - VeiculosCVEV_FILIAL+VEV_CODIGOS

Campo

VEF
VCF_
FILIAL
SCRMED

VEF_CODIGO

VEF_TPEXEC

VEF_DTEXEC

VCF_SCRMSC
TipoCaractereCaractere
CaractereData
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 Cliente
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
Val. SistemaOpções
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

...

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

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


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çãoIntegração de Preço Garantia e Contrato (OFIA537)
  </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)   SCRM (VEIA120)
  </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