Linha Microsiga Protheus

Árvore de páginas

  • Criado por Usuário desconhecido (diulie.freitas), última alteração em 21 nov, 2025


01. DADOS GERAIS

Produto:

TOTVS DMS

Linha de Produto:

Linha Protheus

Segmento:

Varejo

Módulo:

Totvs DMS (Linha Protheus) - Oficina (SIGAOFI)

Função:Importação de Serviços Scania (OFIA533)
País:Brasil
Ticket:Não há/Não se aplica.
Requisito/Story/Issue (informe o requisito relacionado) :

DVARMIL-10381


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 importação de serviços enviados pela montadora Scania por meio de um arquivo XML, facilitando o recebimento e o cadastro dessas informações dentro do sistema Protheus DMS.

03. SOLUÇÃO

A solução implementada consistiu na criação da rotina Importação de Serviços Scania (OFIA533), que realiza a leitura de arquivos XML enviados pela montadora Scania e permite incluir ou atualizar registros no cadastro de serviços do sistema Protheus DMS.

Para que a rotina funcione corretamente, é necessário garantir algumas condições que asseguram a leitura adequada do arquivo XML, o mapeamento dos grupos de serviço e o correto tratamento dos dados no sistema. São elas:

    • 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 montadora, que será utilizado como base para o processo de importação.


  1. Acesse o Módulo 14 (Oficina).
  2. Acesse o menu Atualizações → Cadastros Oficina → Importação de Serviços Scania (OFIA533).
  3. Preencha os parâmetros obrigatórios:
    • Marca
    • Arquivo XML
    • Quantidade Mecânicos 
    • Ação pós Processamento
  4. 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.

  5. No parâmetro Ação pós-processamento, selecione uma das opções abaixo:

    • Nenhuma Ação: o arquivo XML permanecerá no diretório original, sem ser movido ou excluído 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 será excluído do diretório original.

  6. 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 sistema aplicará a ação de pós-processamento escolhida (mover, apagar ou manter o arquivo).



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

Nome da Rotina

Importação de Serviços Scania

Programa

OFIA533

Módulo

Oficina (SIGAOFI)

Tipo

Função Protheus



Criação de Pergunte no arquivo SX1 – Pergunta: 


Grupo

OFIA533OFIA533OFIA533OFIA533OFIA533

Grupo de campo

VE1



Ordem

0102030405

Pergunta

Marca ?Arquivo XML ?Quantidade Mecânicos ?Ação pós Processamento ?Mover Para ?

Tipo

CCNCC
Tamanho3991199
Decimal00000
Var01MV_PAR01MV_PAR02MV_PAR03MV_PAR04MV_PAR05
Formato

@E 9

ValidaçãoExistCpo("VE1",MV_PAR01)OA533002K_ValidPerg()!Vazio() .AND. (MV_PAR03 >= 1 .And. MV_PAR03 <= 9)NaoVazio()OA533002K_ValidPerg()
ObjetoGetGetGetComboGet
Consulta PadrãoVE1



Pré-Seleção (Combo)


1
Item 1


Nenhuma Ação
Item 2


Mover Arquivo
Item 3


Apagar Arquivo
Item 4




Item 5




Help






04. DEMAIS INFORMAÇÕES

Pacote gerados

12.1.2210: https://r.totvs.io/p/1223354

12.1.2310: https://r.totvs.io/p/1223355

12.1.2410: https://r.totvs.io/p/1223356

12.1.2510: https://r.totvs.io/p/1223357


IMPORTANTE!

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


05. ASSUNTOS RELACIONADOS


 
    📄 Novo campo Cod Grp Servico Montadora - Grupos de Serviço (OFIOA020)     📄 Importação de Serviços Scania (OFIA533)     📄 Ponto de Entrada OF533SER - Importação de Serviços Scania (OFIA533)       📄 Ponto de Entrada OF533FIM - Importação de Serviços Scania (OFIA533)