Árvore de páginas

Versões comparadas

Chave

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


01. DADOS GERAIS

Story (informe o requisito relacionado) 10381
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) - Oficina (SIGAOFI)

Função:Atualização de Preço Garantia e Contrato (OFIA537)
País:Brasil
Ticket:Não há/Não se aplica.
Requisito/Story/Issue:DVARMIL-10892

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 //enviados fornecidas pela montadora Scania por meio de um arquivo XMLPRI RM.TXT, facilitando o recebimento e o cadastro 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 XML PRI RM.TXT enviados pela montadora Scania e permite incluir ou atualizar registros a atualização dos preços de peças no cadastro de serviços 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 XMLPRI RM.TXT, o mapeamento dos grupos de serviço 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)
    • O campo “Cod. Grp Mont” deve estar adicionado na rotina Grupos de Serviço (OFIOA020), garantindo o vínculo entre os grupos de serviço da montadora e os grupos cadastrados no Protheus.
    • Na rotina Grupos de Serviço (OFIOA020), existam registros cadastrados com o campo “Cod. Grp Mont” devidamente preenchido, conforme os códigos pré-definidos pela montadora Scania.
    • A rotina Importação de Serviços Scania (OFIA533) deve ser incluída manualmente no menu do Protheus, permitindo assim o acesso à funcionalidade.
    • É necessário Deve-se possuir um arquivo XML válido com os serviços fornecidos pela montadoraPRI RM.TXT válido contendo as informações e preços das peças enviados pela montadora Scania, que será utilizado como base para o processo de importaçãoexecuçã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
tabsPasso a passo para utilização, Atualização de Dicionário/Menu
idspasso1,passo2
Totvs custom tabs box items
defaultyes
referenciapasso1
  • Acesse o Módulo 14 (Oficina).
  • Acesse o menu Atualizações
→ Cadastros Oficina →Importação de Serviços Scania (OFIA533
  • → Cadastros Peças → Atualização de Preço Garantia e Contrato (OFIA537).
  • Preencha os parâmetros
obrigatórios
  • :
  • Marca
  • Arquivo XML
  • Quantidade Mecânicos
    •  
      • Ação pós Processamento
          • No parâmetro Arquivo
        XML
          • 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
        XML
          • PRI RM.TXT que será processado pela rotina.
          • No parâmetro
        Ação pós-
          • 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

        XML
          • PRI RM.TXT permanecerá no diretório original, sem ser movido

        ou excluído
          • , 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

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

        XML
          • PRI RM.TXT e, após a

        inclusão ou atualização
          • atualização de preço e da quantidade por embalagem de cada

        serviço
          • 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

        processado
          • concluído com sucesso, serão executadas ações personalizadas definidas através do ponto de entrada

        de
          • destinado à conclusão da rotina, e o sistema aplicará a ação de pós-processamento

        escolhida
          • selecionada (manter, mover

        ,
          • ou apagar

        ou manter
          • o arquivo).


        Totvs custom tabs box
        tabsPasso 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
        idsacao1,acao2,acao3
        Totvs custom tabs box items
        defaultyes
        referenciaacao1

        Multimedia
        name

        Importação XML Nenhuma Ação

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

        Totvs custom tabs box items
        defaultno
        referenciaacao2

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

        Totvs custom tabs box items
        defaultno
        referenciaacao3

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

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

      ?Cadastros Peças

      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





      04. DEMAIS INFORMAÇÕES

      1223354122335512233561223357
      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.
      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=9730468631017443440" target="_blank" class="btn-doc">     		
      	📄 NovoAtualização campode CodPreço GrpGarantia Servico Montadora - Grupos de Serviçoe Contrato (OFIOA020OFIA537)
        </a>
        <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=9730491711017446392" target="_blank" class="btn-doc">     		
      	📄 ImportaçãoPonto de Entrada OFA537GR - Atualização de Serviços ScaniaPreço Garantia e Contrato (OFIA533OFIA537)   
        </a>
        <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=10086976021018563130" target="_blank" class="btn-doc">     		
      	📄 Ponto de Entrada OF533SEROFA537FI - ImportaçãoAtualização de Serviços ScaniaPreço Garantia e Contrato (OFIA533OFIA537)   
        </a>
        <a href="https://tdn.totvs.com/pages/viewpage.action?pageId=10086998581014657481" target="_blank" class="btn-doc">     
      	📄 Ponto de Entrada OF533FIM - Importação deGlass Serviços Scania (OFIA533OFIA538)   
        </a>  
       </div>


      Templatedocumentos