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 sobre estudos baseando-se nos processos e regras de negócio da montadora Scania, foi identificada 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 DMS.

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:


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






  • 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

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


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


  • Tabela VEF - SCRM Scania - Clientes:


Campo

VEF_FILIAL

VEF_CODIGO

VEF_TPEXEC

VEF_DTEXEC

TipoCaractereCaractereCaractereData
Grupo de Campos033


Ordem01020304
Tamanho2818
Decimal0000
Formato@!@!@!
Contexto1 - Real1 - Real1 - Real1 - Real
Propriedade2 - Visualizar2 - Visualizar2 - Visualizar2 - Visualizar
TítuloFilialCod. Seq.Tp.ExecuçãoDt.Execução
DescriçãoFilialCódigo SequencialTipo ExecuçãoData 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ível1111
UsadoNãoSimSimSim
ObrigatórioNãoSimNãoNão
BrowseNãoSimSimSim
When



Pasta



HelpCó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

TipoCaractereCaractereCaractere
Grupo de Campos
001002
Ordem050607
Tamanho462
Decimal000
Formato@!@!@!
Contexto1 - Real1 - Real1 - Real
Propriedade2 - Visualizar2 - Visualizar2 - Visualizar
TítuloHr.ExecuçãoCód. ClienteLoja Cliente
DescriçãoHora ExecuçãoCódigo do ClienteLoja do Cliente
Val. Sistema


Opções


Inic. Padrão


Inic. Browse


Cons. Padrão
SA1
Nível111
UsadoSimSim
ObrigatórioNãoNão
BrowseSimSimSim
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

TipoCaractereCaractereCaractere
Grupo de Campos


Ordem080910
Tamanho6150
Decimal000
Formato@!@!@!
Contexto1 - Real1 - Real1 - Real
Propriedade2 - Visualizar2 - Visualizar2 - Visualizar
TítuloCod. DealerStatusArquivo
DescriçãoCódigo do DealerStatusArquivo 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ível111
UsadoSimSimSim
ObrigatórioNãoNãoNão
BrowseSimSimSim
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_FILIALVEV_CODIGOVEV_CODVEF
TipoCaractereCaractereCaractere
Grupo de Campos033

Ordem010203
Tamanho288
Decimal000
Formato@!@!@!
Contexto1 - Real1 - Real1 - Real
Propriedade2 - Visualizar2 - Visualizar2 - Visualizar
TítuloFilialCod. Seq.Código VEF
DescriçãoFilialCódigo SequencialCódigo VEF
Val. Sistema


Opções


Inic. Padrão
GetSXENum("VEV","VEV_CODIGO")
Inic. Browse


Cons. Padrão


Nível111
UsadoNãoSimSim
ObrigatórioNãoSimNão
BrowseNãoSimSim
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_CHASSIVEV_ARQUIV
TipoCaractereCaractere
Grupo de Campos

Ordem0405
Tamanho2550
Decimal00
Formato@!@!
Contexto1 - Real1 - Real
Propriedade2 - Visualizar2 - Visualizar
TítuloChassiArquivo
DescriçãoNúmero do ChassiArquivo Gerado
Val. Sistema

Opções

Inic. Padrão

Inic. Browse

Cons. Padrão

Nível11
UsadoSimSim
ObrigatórioNãoNão
BrowseSimSim
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

TipoCaractere
Grupo de Campos
OrdemA9
Tamanho20
Decimal0
Formato@!
Contexto1 - Real
Propriedade1 - Alterar
TítuloID SCRMID
DescriçãoID SCRMID Scania
Val. Sistema
Opções
Inic. Padrão
Inic. Browse
Cons. Padrão
Nível1
UsadoSim
ObrigatórioNão
BrowseSim
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=1017443440" target="_blank" class="btn-doc">     
	📄 Atualizaçã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)   
  </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>