Histórico da Página

01. DADOS GERAIS

Produto:

Solucoes_totvs

Solucoes_totvs_cross

SolucaoCross

Solucoes_totvs_parceiros

SolucaoParceiros

Solucoes_totvs_parceirosexptotvs

SolucaoParcsExpsTOTVS	TOTVS DMS

Linha de Produto:

Linhas_totvs

Linha	Linha 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 (SIGAOFI)

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:

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

Totvs custom tabs box

tabs	Passo a passo para utilização, Atualização de Dicionário/Menu
ids	passo1,passo2

Totvs custom tabs box items

default	yes
referencia	passo1

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

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 Arquivo
ids	acao1,acao2,acao3

Totvs custom tabs box items

default	yes
referencia	acao1

Multimedia

name	Atualização de Preço Garantia e Contrato - Nenhuma Ação1.mp4
width	1400
autostart	true
height	700

Totvs custom tabs box items

default	no
referencia	acao2

Totvs custom tabs box items

default	no
referencia	acao3

Totvs custom tabs box items

default	no
referencia	passo2

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.

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

Card documentos

Informacao	Esta atualização de dicionário estará disponível na release 12.01.2610.
Titulo	IMPORTANTE!

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

Templatedocumentos

Árvore de páginas

Versões comparadas

Versão antiga 13

Nova versão 14

Chave

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

03. SOLUÇÃO

04. DEMAIS INFORMAÇÕES

05. ASSUNTOS RELACIONADOS