01. DADOS GERAIS
| Produto: | | Solucoes_totvs_parceirosexptotvs |
|---|
| SolucaoParcsExpsTOTVS | TOTVS DMS |
|---|
|
|
|---|
| Linha de Produto: | |
|---|
| Segmento: | |
|---|
| Módulo: | | 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/ | StoryStory/Issue | (informe o requisito relacionado) : | DVARMIL- | 1038110892 |
|---|
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 |
|---|
| 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 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óriosMarcaArquivo XMLQuantidade MecânicosAção pós Processamento 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 que será processado pela rotina.- 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
No parâmetro Ação pós- XML 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 XML inclusão ou cada serviço 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
processado de escolhida , ou manter
| 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 |
|---|
| Importação XML Nenhuma Ação| Atualização de Preço Garantia e Contrato - Nenhuma Ação1.mp4 | | width | 1400 |
|---|
| autostart | true |
|---|
| height | 700 |
|---|
|
|
| Totvs custom tabs box items |
|---|
| Importação Arquivo XML Mover Arquivo| Atualização de Preço Garantia e Contrato - Mover Arquivo1.mp4 | | width | 1400 |
|---|
| autostart | true |
|---|
| height | 700 |
|---|
|
|
| Totvs custom tabs box items |
|---|
| Importação Arquivo XML Apagar Arquivo| Atualização de Preço Garantia e Contrato - Apagar Arquivo1.mp4 | | width | 1400 |
|---|
| autostart | true |
|---|
| height | 700 |
|---|
|
|
|
|
| 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 | Cadastros OficinaPeças |
|---|
Nome da Rotina | Importação de Serviços ScaniaAtualização de Preço Garantia e Contrato |
|---|
Programa | OFIA533OFIA537 |
|---|
Módulo | Oficina (SIGAOFI) |
|---|
Tipo | Função Protheus |
|---|
Criação de Pergunte no arquivo SX1 – Pergunta:
OFIA533OFIA533OFIA533OFIA533OFIA533VE1Marca | Arquivo XML ? | Quantidade Mecânicos ? | Ação pós Processamento ? | Mover Para ?| Grupo a Considerar? | Dest. P.Dealer_Contrat | Dest. P.Dealer_Normal? | Dest. P.Balcão_Contrat | Tipo | C | C |
|---|
N31199| 10 | | Decimal | 0 | 0 | 0 | 0 | 0 |
|---|
| Var01 | MV_PAR01 | MV_PAR02 | MV_PAR03 | MV_PAR04 | MV_PAR05 |
|---|
| Formato |
|---|
@E 9 | Validação | ExistCpo("VE1",MV_PAR01) | OA533002K_ValidPerg() | !
|
|
|
|
| | Validação | OA537009M_VldFldOk(1) | !Vazio() .And. OA537VlGrp() | Vazio() .OR. OA537009M_VldFldOk(2) | Vazio() .OR. OA537009M_VldFldOk(2) | Vazio() . |
|---|
AND. (MV_PAR03 >= 1 .And. MV_PAR03 <= 9)NaoVazio() | OA533002K_ValidPerg() | | OR. OA537009M_VldFldOk(2) | | Objeto | Get | Get | Get | Get | Get |
|---|
| Consulta Padrão |
|
| VX5PRC | VX5PRC | VX5PRC |
|---|
| Pré-Seleção (Combo) |
|
|
|
|
|
|---|
| Item 1 |
|
|
|
|
|
|---|
| Item 2 |
|
|
|
|
|
|---|
| Item 3 |
|
|
|
|
|
|---|
| Item 4 |
|
|
|
|
|
|---|
| Item 5 |
|
|
|
|
|
|---|
| Help |
|
|
|
|
|
|---|
Grupo | OFIA537 | OFIA537 | OFIA537 | OFIA537 |
|---|
Grupo de campo |
|
|
|
|
|---|
Ordem | 06 | 07 | 08 | 09 |
|---|
Pergunta | Dest. P.Balcão_Normal? | Atualiza Qtd. por Embalagem? | Ação após Processamento? | Mover Para? |
|---|
Tipo | C | N | N | C |
|---|
| Tamanho | 10 | 1 | 1 | 80 |
|---|
| Decimal | 0 | 0 | 0 | 0 |
|---|
| Var01 | MV_PAR06 | MV_PAR07 | MV_PAR08 | MV_PAR09 |
|---|
| Formato |
|
|
|
|
|---|
| Validação | Vazio() .OR. OA537009M_VldFldOk(2) |
|
| If( MV_PAR08==2, OA537009M_VldFldOk(3) ,Vazio()) |
|---|
| Objeto | Get | Combo | Get |
|---|
Objeto | Get | Get | Get | ComboVE1| VX5PRC |
|
|
| | Pré-Seleção (Combo) |
| 2 | 1 |
|
|---|
| Item 1 |
| Sim | Nenhuma Ação |
|
|---|
| Item 2 |
| Não | Mover Arquivo |
|
|---|
| Item 3 |
|
| Apagar Arquivo |
|
|---|
| Item 4 |
|
|
|
|
|---|
| Item 5 |
|
|
|
|
|---|
| Help |
|
|
|
|
|---|
|
|
04. DEMAIS INFORMAÇÕES
| 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=9730468631017443440" target="_blank" class="btn-doc">
📄 NovoAtualização campode CodPreço GrpGarantia Servico Montadora - Grupos de Serviço (OFIOA020e Contrato (OFIA537)
</a>
<a href="https://tdn.totvs.com/pages/viewpage.action?pageId=9730491711017446392" target="_blank" class="btn-doc">
📄 Importação de Serviços Scania (OFIA533) Ponto de Entrada OFA537GR - Atualização de Preço Garantia e Contrato (OFIA537)
</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 Preço Garantia Serviçose ScaniaContrato (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> |
