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-11610

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 Campo no arquivo SX3 – Campos:


  • Tabela VCF - Dados Adicionais Clientes Cev:


Campo

VCF_SCRMEDVCF_SCRMSC
TipoCaractereCaractere
Grupo de Campos

OrdemA9B0
Tamanho11
Decimal00
Formato@!@!
Contexto1 - Real1 - Real
Propriedade1 - Alterar1 - 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

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

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>