Árvore de páginas

Versões comparadas

Chave

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

...

Totvs custom tabs box
tabsPré-requisitos, Configurações, Atualização de Dicionário/Menu
idsaba1,aba2,aba3
Totvs custom tabs box items
defaultyes
referenciaaba1

Para o correto funcionamento da rotina Atualização de Preço Garantia e Contrato (OFIA537), é necessário garantir pré-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 entre a Scania e o Protheus DMS. São elas:

  1. As peças existentes no arquivo PRI RM.TXT devem ter sido previamente cadastradas na rotina de Peças (MATA010).
  2. É necessário incluir manualmente a rotina Atualização de Preço Garantia e Contrato (OFIA537) no menu do Protheus, permitindo assim o acesso à funcionalidade.
  3. Deve-se possuir um arquivo PRI RM.TXT válido contendo as informações e os preços das peças enviados pela montadora Scania, que será utilizado como base para a execução da rotina.


Bloco de código
languagexml
themeRDark
titleEstrutura do arquivo PRI RM.TXT
Cod.Item   Descrição_Item       Status Qt.Peça_Emb. PRG   Descr.PRG     Preço_Harm. %Desc.PRG Grupo Descr.Grupo     Vig.Inicial  %IPI  %PIS %COFINS P.Dealer_Contrato P.Dealer_Normal MC_Contrato P.Balcao_Contrato P.Balcao_Normal Clas.Fiscal
---------- -------------------- ------ ------------ ----- ------------- ----------- --------- ----- --------------- ----------- ----- ----- ------- ----------------- --------------- ----------- ----------------- --------------- -----------
0000000    PECA DE TESTES A     A      1            444   Test Part     S           1.1       1     GRUPO TESTE      01/02/2025  1.11   3.3    22.2            999.99          888.88          11           6666.66         1111.11    00000000
1111111    PECA DE TESTES B     I      2            333   Test Part     S           2.2       2     GRUPO TESTE      01/01/2025  2.22   4.4    33.3             88.88           77.77          22             55.55           22.22    11111111
2222222    PECA DE TESTES C     A      3            222   Test Part     S           3.3       3     GRUPO TESTE      01/03/2025   1.1  1.11     4.4              7.77            6.66          33              4.44            3.33    22222222
3333333    PECA DE TESTES D     I      4            111   Test Part     S           4.4       4     GRUPO TESTE      01/04/2025   2.2  2.22     1.1                 6            5.55          44              3.33           44.44    33333333
0000000    PECA DE TESTES A     A      1            444   Test Part     S           1.1       1     GRUPO TESTE      01/02/2025  1.11   3.3    22.2            999.99          888.88          11           6666.66         1111.11    00000000
1111111    PECA DE TESTES B     I      2            333   Test Part     S           2.2       2     GRUPO TESTE      01/01/2025  2.22   4.4    33.3             88.88           77.77          22             55.55           22.22    11111111
2222222    PECA DE TESTES C     A      3            222   Test Part     S           3.3       3     GRUPO TESTE      01/03/2025   1.1  1.11     4.4              7.77            6.66          33              4.44            3.33    22222222
3333333    PECA DE TESTES D     I      4            111   Test Part     S           4.4       4     GRUPO TESTE      01/04/2025   2.2  2.22     1.1                 6            5.55          44              3.33           44.44    33333333
0000000    PECA DE TESTES A     A      1            444   Test Part     S           1.1       1     GRUPO TESTE      01/02/2025  1.11   3.3    22.2            999.99          888.88          11           6666.66         1111.11    00000000
    
Nota
titleInformativo
  • Tamanho do arquivo PRI RM.txt: Aproximadamente xx MB.
  • Quantidade de peças contidas existentes no arquivo: Cerca de xx peças.
  • Tempo de processamento do arquivo pela rotina: Aproximadamente xx minutos.
Totvs custom tabs box items
defaultno
referenciaaba2


Para que a atualização de preços e de quantidade por embalagem ocorra corretamente durante o processamento do arquivo PRI RM.TXT, é necessário que o parâmetro "MV_ARQPROD" esteja configurado corretamente. Esse parâmetro é responsável por configurar se os dados de indicadores de produto serão considerados pela tabela "SB1" (Descrição Genérica do Produto) ou se serão considerados pela tabela "SBZ" (Indicadores de Produtos).

Caso seja configurado como SB1 (B1_QE Qtd.Embalag.) ou SBZ (BZ_QE Qtd.Embalag.)

Essa configuração garante o correto mapeamento dos registros, permitindo que o sistema identifique e atualize os preços das peças e suas quantidades de forma correta.


Totvs custom tabs box items
defaultno
referenciaaba3
  • 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

?

Nome da Rotina

Atualização de Preço Garantia e Contrato

Programa

OFIA537

Módulo

Oficina (SIGAOFI)

Tipo

Função Protheus


Criação de Pergunte no arquivo SX1 – Pergunta


Grupo

OFIA537OFIA537OFIA537OFIA537OFIA537

Grupo de campo






Ordem

0102030405

Pergunta

Arquivo para Importação?Grupo a Considerar?Dest. P.Dealer_ContratDest. P.Dealer_Normal?Dest. P.Balcão_Contrat

Tipo

CCCCC
Tamanho8099101010
Decimal00000
Var01MV_PAR01MV_PAR02MV_PAR03MV_PAR04MV_PAR05
Formato




ValidaçãoOA537009M_VldFldOk(1)!Vazio() .And. OA537VlGrp()Vazio() .OR. OA537009M_VldFldOk(2)Vazio() .OR. OA537009M_VldFldOk(2)Vazio() .OR. OA537009M_VldFldOk(2)
ObjetoGetGetGetGetGet
Consulta Padrão

VX5PRCVX5PRCVX5PRC
Pré-Seleção (Combo)




Item 1




Item 2




Item 3




Item 4




Item 5




Help






Grupo

OFIA537OFIA537OFIA537OFIA537

Grupo de campo





Ordem

06070809

Pergunta

Dest. P.Balcão_Normal?Atualiza Qtd. por Embalagem?Ação após Processamento?Mover Para?

Tipo

CNNC
Tamanho101180
Decimal0000
Var01MV_PAR06MV_PAR07MV_PAR08MV_PAR09
Formato



ValidaçãoVazio() .OR. OA537009M_VldFldOk(2)

If( MV_PAR08==2, OA537009M_VldFldOk(3) ,Vazio())
ObjetoGetComboGetGet
Consulta PadrãoVX5PRC


Pré-Seleção (Combo)
21
Item 1
SimNenhuma Ação
Item 2
NãoMover Arquivo
Item 3

Apagar Arquivo
Item 4



Item 5



Help





...

Totvs custom tabs box
tabsPasso a passo: Ação após Processamento - Nenhuma Ação, Passo a passo: Ação após Processamento - Mover Arquivo, Passo a passo: Ação após Processamento - Apagar Arquivo, Gravação de Logs
idspasso1,passo2,passo3,passo4
Totvs custom tabs box items
defaultyes
referenciapasso1


  • Acesse o Módulo 14 (Oficina).
  • Acesse o menu Atualizações → ? → 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.

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 a opção Nenhuma Ação. Com isso, o arquivo PRI RM.TXT permanecerá no diretório original, sem ser movido nem apagado após o processamento.
  • 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 quantidade por embalagem de cada peça, serão executadas ações personalizadas definidas através do ponto de entrada.
  • Ao final do processamento, quando o arquivo for processado com sucesso, serão executadas ações personalizadas definidas através do ponto de entrada de conclusão da rotina.


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

Totvs custom tabs box items
defaultno
referenciapasso2


  • Acesse o Módulo 14 (Oficina).
  • Acesse o menu Atualizações → ? → 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
    • considerar?
    (
    • que possui preenchimento obrigatório
    )
  • Dest. P.Dealer_Contrat? 
    • , 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_
    Normal?
    • 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
    • Dealer_
    Contrat?
    • 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_
    Normal?
  • Atualiza Qtd. por Embalagem? (preenchimento obrigatório)
  • Ação após Processamento?
  • Mover Para?
  • No parâmetro Arquivo XML
    • Contrat?,  ao clicar no ícone da lupa, será exibida uma
    tela mostrando o servidor (pasta protheus_data) e seus diretórios. Selecione o arquivo XML que será processado pela rotina.
  • No parâmetro Ação após Processamento:
  • Selecione a opção Mover Arquivo. Com isso, o parâmetro Mover Para será habilitado, permitindo que seja selecionado o diretório de destino dentro do servidor. Ao final do processamento, o arquivo será movido do diretório de origem para o diretório selecionado.
  • Após preencher todos os parâmetros obrigatórios, clique no botão “OK”.
  • A rotina processará o arquivo XML e após a inclusão ou atualização de cada serviço serão executadas ações personalizadas definidas através do ponto de entrada.
  • Ao final do processamento, quando o arquivo for processado com sucesso, serão executadas ações personalizadas definidas através do ponto de entrada de conclusão da rotina, e o arquivo será movido do diretório original para o diretório destino indicado no parâmetro Mover Para.

Multimedia
nameAtualização de Preço Garantia e Contrato - Mover Arquivo.mp4
width1400
autostarttrue
height700

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

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 ProcessamentoSelecione a opção Mover Arquivo. Com isso, 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 do diretório de origem para o diretório selecionado.
  • 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 quantidade por embalagem de cada peça, serão executadas ações personalizadas definidas através do ponto de entrada.
  • Ao final do processamento, quando o arquivo for processado com sucesso, serão executadas ações personalizadas definidas através do ponto de entrada de conclusão da rotina, e o arquivo será movido do diretório original para o diretório destino indicado no parâmetro Mover Para.


Multimedia
nameAtualização de Preço Garantia e Contrato - Mover Arquivo.mp4
width1400
autostarttrue
height700

Totvs custom tabs box items
defaultno
referenciapasso3
Totvs custom tabs box items
defaultno
referenciapasso3


  • Acesse o Módulo 14 (Oficina).
  • Acesse o menu Atualizações → ? → 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.

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.

  • Acesse o Módulo 14 (Oficina).
  • Acesse o menu Atualizações → ? → Atualização de Preço Garantia e Contrato (OFIA537).
  • Preencha os parâmetros: 
  • Arquivo para Importação? (preenchimento obrigatório)
  • Grupo a Considerar? (preenchimento obrigatório)
  • Dest. P.Dealer_Contrat? 
  • Dest. P.Dealer_Normal?
  • Dest. P.Balcão_Contrat?
  • Dest. P.Balcão_Normal?
  • Atualiza Qtd. por Embalagem? (preenchimento obrigatório)
  • Ação após Processamento?
  • Mover Para?
  • No parâmetro Arquivo XML, será exibida uma tela mostrando o servidor (pasta protheus_data) e seus diretórios. Selecione o arquivo XML que será processado pela rotina.
  • No parâmetro Ação após Processamento:
    • 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 a opção Apagar Arquivo. Com isso, ao término do processamento do arquivo, ele será apagado do diretório de onde foi selecionado.
  • Após preencher todos os parâmetros obrigatórios, clique no botão “OK”.
  • A rotina processará o arquivo XML PRI RM.TXT e, após a inclusão ou atualização de cada serviço preço e quantidade por embalagem de cada peça, serão executadas ações personalizadas definidas através do ponto de entrada.
  • Ao final do processamento, quando o arquivo for processado com sucesso, serão executadas ações personalizadas definidas através do ponto de entrada de conclusão da rotina, e o arquivo será apagado do diretório original onde foi selecionado.


Multimedia
nameAtualização de Preço Garantia e Contrato - Apagar Arquivo.mp4
width1400
autostarttrue
height700

Totvs custom tabs box items
defaultno
referenciapasso4

Após a execução da rotina, será possível visualizar na tabela VQL (Informações genéricas) os registros de log do processamento, conforme o exemplo apresentado na imagem abaixo.

  • Na coluna VQL_AGROUP (Agrupador), será registrado o nome do fonte da rotina;
  • Na coluna VQL_MSGLOG (Mensagens de Log), será registrada a mensagem de log contendo informações como mensagem (Processamento ou Erro), empresa, filial, usuário, modo de execução (manual ou schedule) e os valores informados nos parâmetros da rotina.


...