1. Identificação da Rotina
Nome da Rotina | Importação de Serviços Scania |
|---|
| Programa | OFIA533 |
|---|
| Módulo ERP | Oficina (SIGAOFI) |
|---|
| Acesso à Rotina | Atualizações/Cadastros Oficina/Importação de Serviços Scania (OFIA533) |
|---|
| Data da Documentação (Ultima Atualização) | |
|---|
2. Descrição Funcional
Observação:
Neste tópico, é necessário descrever de forma clara e objetiva a funcionalidade da rotina, explicando qual é seu propósito, por que ela foi criada e qual a sua importância dentro do sistema.
A rotina Importação de Serviços Scania (OFIA533) tem como finalidade importar e atualizar automaticamente os serviços enviados pela montadora Scania para o sistema Protheus DMS, a partir de um arquivo XML fornecido pela própria montadora.
Durante a execução da rotina, é necessário preencher os parâmetros obrigatórios. Com base nessas informações e no mapeamento dos Grupos de Serviço previamente cadastrados, o sistema realiza as validações necessárias para identificar e incluir ou atualizar os serviços por meio do processamento do arquivo XML.
Após a importação, o sistema executa as ações de pós processamento configuradas — como mover, apagar ou manter o arquivo — e registra logs com o resultado da operação.
Dessa forma, a rotina garante a integração automática e segura dos serviços Scania com o Protheus, mantendo o cadastro sempre atualizado e reduzindo a necessidade de intervenções manuais.
3. Pré-requisitos e Configurações
Observação:
Neste tópico, devem ser informados todos os pré-requisitos e configurações necessárias para o correto funcionamento da rotina, como parametrizações, permissões, cadastros obrigatórios, tabelas envolvidas ou qualquer dependência técnica ou funcional.
Para o correto funcionamento da rotina Importação de Serviços Scania (OFIA533), é necessário garantir pré-condições que asseguram a leitura adequada do arquivo XML, o mapeamento dos grupos de serviço e a integração completa entre os dados da Scania e o Protheus DMS. São elas: - O campo “Cod. Grp Mont” deve estar adicionado na rotina Grupos de Serviço (OFIOA020), garantindo o vínculo correto entre os grupos de serviço da montadora Scania e os grupos cadastrados no Protheus.
- É necessário incluir manualmente a rotina Importação de Serviços Scania (OFIA533) no menu do Protheus, permitindo assim o acesso à funcionalidade.
- Deve-se possuir um arquivo XML válido contendo os serviços enviados pela montadora Scania, que será utilizado como base para o processo de importação.
|
Para que a importação de serviços ocorra corretamente durante o processamento do arquivo XML, é necessário que, 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. Essa configuração garante o correto mapeamento entre os grupos de serviço da Scania e os grupos cadastrados no Protheus, permitindo que o sistema identifique e vincule corretamente os serviços durante o processo de importação. |
Criação de Campo no arquivo SX3 – Campos:
- Tabela VOS - Grupos de Serviços
| Campo | VOS_GRPSER |
|---|
| Tipo | Caractere |
|---|
| Grupo de Campos |
|
|---|
| Ordem | 09 |
|---|
| Tamanho | 2 |
|---|
| Decimal | 0 |
|---|
| Formato | @! |
|---|
| Contexto | 1-Real |
|---|
| Propriedade | 1-Alterar |
|---|
| Título | Cod Grp Mont |
|---|
| Descrição | Cod Grp Servico Montadora |
|---|
| Val. Sistema | OA0200018_VldGrp() |
|---|
| Opções |
|
|---|
| Inic. Padrão |
|
|---|
| Inic. Browse |
|
|---|
| Cons. Padrão |
|
|---|
| Nível | 1 |
|---|
| Usado | Sim |
|---|
| Obrigatório | Não |
|---|
| Browse | Não |
|---|
| When |
|
|---|
| Pasta |
|
|---|
| Help | Grupo de servico da Montadora |
|---|
- 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 | OFIA533 | OFIA533 | OFIA533 | OFIA533 | OFIA533 |
|---|
Ordem | 01 | 02 | 03 | 04 | 05 |
|---|
Pergunta | Marca ? | Arquivo XML ? | Quantidade Mecânicos ? | Ação pós Processamento ? | Mover Para ? |
|---|
Tipo | C | C | N | C | C |
|---|
| Tamanho | 3 | 99 | 1 | 1 | 99 |
|---|
| 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() | !Vazio() .AND. (MV_PAR03 >= 1 .And. MV_PAR03 <= 9) | NaoVazio() | OA533002K_ValidPerg() |
|---|
| Objeto | Get | Get | Get | Combo | Get |
|---|
| Consulta Padrão | VE1 |
|
|
|
|
|---|
| Pré-Seleção (Combo) |
|
|
| 1 |
|
|---|
| Item 1 |
|
|
| Nenhuma Ação |
|
|---|
| Item 2 |
|
|
| Mover Arquivo |
|
|---|
| Item 3 |
|
|
| Apagar Arquivo |
|
|---|
| Item 4 |
|
|
|
|
|
|---|
| Item 5 |
|
|
|
|
|
|---|
| Help |
|
|
|
|
|
|---|
|
|
4. Fluxo de Utilização
Observação:
Neste tópico, deve ser descrito o passo a passo do fluxo de utilização da rotina, apresentando de forma sequencial e didática como o usuário deve operar a funcionalidade, desde a etapa inicial até a final, incluindo interações com outras rotinas, validações e resultados esperados.
Observação:
Prints e vídeos utilizados na documentação devem seguir o tema padrão do Protheus (Azul). O nome do usuário exibido deve ser apropriado e nunca deve ser utilizado o usuário "Admin".
Além disso, o passo a passo deve ser descrito de forma clara e objetiva, orientando o usuário pelo fluxo padrão da rotina, indicando visualmente onde clicar na tela e como utilizar as funcionalidades envolvidas.
- Acessar o Modulo 14 (Oficina)
- Acesse o menu Atualizações→ Cadastros Oficina → Importação de Serviços Scania (OFIA533)
|
|
5. Integrações e Dependências
Observação:
Neste tópico, devem ser detalhadas todas as integrações com outros sistemas ou rotinas, bem como as dependências existentes para o correto funcionamento da rotina. Especifique, de forma clara e objetiva, os sistemas integrados, os protocolos de comunicação, as interfaces utilizadas e quaisquer requisitos técnicos que influenciem a operação e a manutenção da funcionalidade, caso não houver integrações relevantes favor colocar "Não se aplica" neste tópico.
6. Assuntos Relacionados
DT DMS SCANIA - Implementado campo Cod Grp Servico Montadora na rotina Grupo de Servicos (OFIOA020)
PE OF533SER para que seja possível executar ações personalizadas após a inclusão ou atualização de serviços durante o processo de importação na rotina Importação de Serviços Scania (OFIA533)
PE OF533FIM para que seja possível executar ações personalizadas após a conclusão do processamento completo do arquivo XML na rotina Importação de Serviços Scania (OFIA533)
Observação:
Neste tópico, devem ser listados links ou referências para rotinas, documentos, parametrizações, tabelas ou funcionalidades que possuam relação direta com a rotina documentada. O objetivo é facilitar o entendimento do contexto e oferecer ao leitor acesso a conteúdos complementares que possam auxiliar no uso ou na configuração da funcionalidade, caso não houver assuntos relacionados relevantes favor colocar "Não se aplica" neste tópico.