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 da Lista de Preços (OFIA539) |
|---|
| País: | Brasil |
|---|
| Ticket: | Não | há/Não se aplica | . |
|---|
| Requisito/ | StoryStory/Issue | (informe o requisito relacionado) : | DVARMIL- | 1094610944 |
|---|
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 de venda das peças //enviados fornecidas pela montadora Scania por meio de um arquivo XMLPRI9600.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 rotina Atualização da Lista de Preços (OFIA539), que realiza a leitura de arquivos XML lê arquivos PRI9600.TXT enviados pela montadora Scania e permite incluir ou atualizar registros atualiza os preços de venda 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 XMLPRI9600.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 PRI9600.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 da Lista de Preços (OFIA539)
- 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 o acesso à funcionalidade.
- É necessário possuir um arquivo XML válido com os serviços fornecidos pela montadoraDeve-se possuir um arquivo PRI9600.TXT válido, contendo as informações e preços de venda 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 |
|---|
| (OFIA533- Acesse o Módulo 14 (Oficina).
- Acesse o menuAtualizações
→ Cadastros Oficina →Importação de Serviços Scania- → Cadastros Peças → Atualização da Lista de Preços (OFIA539).
- Preencha os parâmetros
obrigatóriosMarcaArquivo XMLQuantidade MecânicosAção pós Processamento Arquivo XML- Diretório do Arquivo? 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.- PRI9600.TXT que será processado pela rotina.
- No parâmetro Grupos de Produto? 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 Destino Público?, ao clicar no ícone da lupa, será exibida uma listagem onde deve ser selecionado o preço de venda desejado.
- No parâmetro Destino Público 30d?, ao clicar no ícone da lupa, será exibida uma listagem onde deve ser selecionado o preço de venda desejado.
- No parâmetro Destino Balcão?, 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 Venda (B1_PRV1)
- Preco Venda2 (B5_PRV2)
- Preco Venda3 (B5_PRV3)
- Preco Venda4 (B5_PRV4)
- Preco Venda5 (B5_PRV5)
- Preco Venda6 (B5_PRV6)
- Preco Venda7 (B5_PRV7)
Sendo o campo Preco Venda (B1_PRV1) presente na aba Cadastrais, seção Descrição Genérica do Produto, e os outros campos de venda 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 PRI9600.TXT. Exemplo: Se no parâmetro Destino Público? for selecionado o preço "B1_PRV1", o campo Preco Venda da rotina Peças (MATA010) será atualizado com o valor da coluna "Publico" 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 Ação pós-processamento XML ou excluído , nem apagado após o processamento. Mover Arquivo: o parâmetro Mover Para? será habilitado e terá preenchimento obrigatório, 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 atualização 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 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 da Lista de Preços - Nenhuma Ação1.mp4 | | width | 1400 |
|---|
| autostart | true |
|---|
| height | 700 |
|---|
|
|
| Totvs custom tabs box items |
|---|
| Importação Arquivo XML Mover Arquivo| Atualização da Lista de Preços - Mover Arquivo1.mp4 | | width | 1400 |
|---|
| autostart | true |
|---|
| height | 700 |
|---|
|
|
| Totvs custom tabs box items |
|---|
| Importação Arquivo XML Apagar Arquivo| Atualização da Lista de Preços - 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 Peças |
|---|
Nome da Rotina | Atualização da Lista de Preços |
|---|
Programa | OFIA539 |
|---|
Módulo | Oficina (SIGAOFI) |
|---|
Tipo | Função Protheus |
|---|
Criação de Pergunte no arquivo SX1 – Pergunta:
OFIA533OFIA533OFIA533OFIA533| OFIA533 | VE105 | Marca ? | Arquivo XML ? | Quantidade Mecânicos ? | Ação pós Processamento ? | Mover Para | Diretório do Arquivo | Grupos de Produto | Destino Público | Destino Público 30d | ?N311990 | 0 | 0 | 0 | 0 |
|---|
| Var01 | MV_PAR01 | MV_PAR02 | MV_PAR03 | MV_PAR04 |
|---|
MV_PAR05 | @E 9 | Validação | ExistCpo("VE1",MV_PAR01) | OA533002K_ValidPerg() | !
|
|
|
| | Validação | OA539005M_PreValid(1) | !Vazio() .And. OA539005M_PreValid(2) | Vazio() .Or. OA539005M_PreValid(3) | Vazio() . |
|---|
AND. (MV_PAR03 >= 1 .And. MV_PAR03 <= 9)| Or. OA539005M_PreValid(3) | | Objeto | Get | Get | Get | Get |
|---|
| Consulta Padrão |
|
| VX5PRV | VX5PRV |
|---|
| Pré-Seleção (Combo) |
|
|
|
|
|---|
| Item 1 |
|
|
|
|
|---|
| Item 2 |
|
|
|
|
|---|
| Item 3 |
|
|
|
|
|---|
| Item 4 |
|
|
|
|
|---|
| Item 5 |
|
|
|
|
|---|
| Help |
|
|
|
|
|---|
Grupo | OFIA539 | OFIA539 | OFIA539 | OFIA539 |
|---|
Grupo de campo |
|
|
|
|
|---|
Ordem | 05 | 06 | 07 | 08 |
|---|
Pergunta | Destino Balcão | Atu. Quant. por Embalagem | Ação após Processamento | Mover Para |
|---|
Tipo | C | C | C | C |
|---|
| Tamanho | 40 | 1 | 1 | 99 |
|---|
| Decimal | 0 | 0 | 0 | 0 |
|---|
| Var01 | MV_PAR05 | MV_PAR06 | MV_PAR07 | MV_PAR08 |
|---|
| Formato |
|
|
|
|
|---|
| Validação | Vazio() .Or. OA539005M_PreValid(3) |
|
| If( MV_PAR07==2, OA539005M_PreValid(4) ,Vazio() |
|---|
NaoVazio() | OA533002K_ValidPerg(GetGet | VE1| VX5PRV |
|
|
| | 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=1017443499" target="_blank" class="btn-doc">
📄 Atualização da Lista de Preços (OFIA539)
</a>
<a href="https://tdn.totvs.com/pages/viewpage.action?pageId=1018563765" target="_blank" class="btn-doc">
📄 Ponto de Entrada OA539LIN - Atualização da Lista de Preços (OFIA539)
</a>
<a href="https://tdn.totvs.com/pages/viewpage.action?pageId=1018563840" target="_blank" class="btn-doc">
📄 Ponto de Entrada OA539FIM - Atualização da Lista de Preços (OFIA539)
</a>
<a href="https://tdn.totvs.com/pages/viewpage.action?pageId=1014657481" target="_blank" class="btn-doc">
📄 Importação Glass (OFIA538)
</a> </div> |