Configuração DSM Scania (OFIA010)
|
Nome da Rotina | Configuração DSM Scania |
|---|---|
| Programa | OFIA010 |
| Módulo ERP | Oficina (SIGAOFI) |
| Acesso à Rotina | Atualizações/ |
| Data da Documentação (Última Atualização) |
|
2. Descrição Funcional
A rotina Configuração DSM Scania (OFIA010) tem como principal objetivo cadastrar e manter os parâmetros necessários para a integração do Protheus DMS com o DSM Global (Scania), definindo tanto os dados de comunicação com o Web Service quanto as regras do que será levantado e enviado pela rotina OFIA030.
Durante sua utilização, o usuário acessa a tela de configuração e preenche os parâmetros organizados em quatro folders (Filiais, Grupos, TAGs para envio e Configurações), informando os dados fornecidos pela Fábrica e as definições operacionais da integração (habilitação de TAGs, grupos elegíveis e comportamento de geração de arquivos). Ao confirmar, o sistema valida o preenchimento dos campos obrigatórios e prepara a configuração no formato JSON no padrão esperado.
Após a execução, a rotina grava ou atualiza a configuração exclusivamente no banco de dados, tabela VRN, associando o conteúdo à filia conforme sxFilial('SD2'), eliminando a gravação de arquivos JSON em disco. Além disso, ficam registrados as definições de geração de arquivo espelho do XML (com caminho de servidor, quando habilitado) e os campos de Preço de Venda (B1_PRV1) e Preço de Reposição, que serão utilizados pelas rotinas dependentes durante o levantamento e integração.
Dessa forma, a rotina garante padronização e consistência na parametrização do DSM Global por filial, centralizando as informações de configuração em uma única fonte (VRN) e assegurando que o processamento da OFIA030 utilize sempre os parâmetros mais recentes definidos pelo usuário.
3. Pré-requisitos e Configurações
- É preciso incluir manualmente a rotina DSM Configuração (OFIA010) no menu do Protheus DMS.
- É necessário realizar o cadastro para cada filial que participará da integração.
- É necessário definir os campos de Preço de Venda (B1_PRV1) e Preço de Reposição (vazio).
4. Fluxo de Utilização
Configuração Inicial – Scania Pedido Compra (OFIA540)
- Acesse o Módulo 14 (Oficina).
- Acesse o menu Atualizações → Mov. Pedido Scania → Scania Pedido Compra (OFIA540).
- Dentro de Scania Pedido Compra (OFIA540):
- Selecionar Pedido → Vincular Pedido de Fábrica → Outras Opções → Vincular Pedido de Fábrica → Vincular Pedido de Fábrica.
Selecionar um pedido no browse.
Acessar Outras Opções → Vincular Pedido de Fábrica.
Preencher a pergunta MT297A e confirmar.
- Selecionar Pedido → Vincular Pedido de Fábrica → Outras Opções → Vincular Pedido de Fábrica → Exportar Pedido em Excel.
Selecionar um pedido no browse.
Acessar Outras Opções → Exportar Pedido em Excel.
Selecionar o local de salvamento e confirmar a geração do .xlsx.
- Selecionar Pedido → Vincular Pedido de Fábrica → Outras Opções → Vincular Pedido de Fábrica → Importar_Pedido Peças (OFIA542).
Acessar Outras Opções → Importar_Pedido Peças (OFIA542).
Preencher o Pergunte correspondente e confirmar para iniciar o processamento.
- Selecionar Pedido → Vincular Pedido de Fábrica → Outras Opções → Vincular Pedido de Fábrica → Eliminar Resíduos BO (OFIA601).
Acessar Outras Opções → Eliminar Resíduos BO (OFIA601).
Preencher o Pergunte correspondente e confirmar para iniciar o processamento.
- Selecionar Pedido → Vincular Pedido de Fábrica → Outras Opções → Vincular Pedido de Fábrica → Vincular Pedido de Fábrica.
5. Integrações e Dependências
Durante a execução da rotina Scania Pedido Compra (OFIA540), o browse opera sobre os Pedidos de Compra gravados na SC7, portanto é necessário que esses pedidos já tenham sido criados no Protheus, seja pela própria rotina espelho (operação básica de incluir), pela rotina Pedido de Compras (MATA120) ou por rotinas de geração/importação do processo da Fábrica, como Importar_Pedido Peças (OFIA542), que cria pedidos automaticamente na SC7 a partir dos arquivos fornecidos . Para que as funcionalidades específicas do fluxo da Fábrica funcionem corretamente, a rotina depende da existência e manutenção do vínculo Pedido de Fábrica ↔ Pedido Protheus na tabela VEI, alimentado pela operação Vincular Pedido de Fábrica (pergunte MT297A), sempre considerando os parâmetros MV_MIL0005, MV_MIL0006 obrigatoriamente e o MV_PEDANO quando aplicável.
DSM Reprocessamento (OFIA020)
|
Nome da Rotina | DSM Reprocessamento |
|---|---|
| Programa | OFIA020 |
| Módulo ERP | Oficina (SIGAOFI) |
| Acesso à Rotina | Atualizações/ |
| Data da Documentação (Última Atualização) |
|
2. Descrição Funcional
A rotina DSM Reprocessamento (OFIA020) tem como principal objetivo disponibilizar uma tela para acompanhamento e reprocessamento das execuções de levantamento realizadas para envio ao DSM Global, permitindo ao usuário consultar execuções manuais, automatizadas (Schedule) e de carga inicial, além de visualizar as parametrizações utilizadas por filial e os arquivos XML gerados em cada processamento.
Durante sua utilização, a rotina realiza a leitura das execuções registradas, organiza as informações por tipo e período e carrega, para cada execução, as parametrizações consideradas no levantamento por filial. A rotina também identifica e lista os XMLs construídos durante o processamento, permitindo a abertura do conteúdo para conferência. Além disso, ao acionar os processamentos de Carga Inicial e Price Updates, a rotina controla o modo de execução conforme a escolha entre integrar via Web Service ou apenas gerar arquivo, acionando a geração de XMLs e o fluxo de integração quando aplicável.
Após a execução, a rotina finaliza o processamento conforme o modo selecionado ( integração via Web Service ou apenas geração de arquivo) e mantém disponíveis os XMLs resultantes na seção Arquivos Gerados, considerando como diretório inicial de leitura o caminho registrado na Configuração DSM Global (OFIA010). Quando a execução ocorrer com integração via Web Service, a rotina mantem o comportamento de salvamento de arquivo conforme a parametrização definida no OFIA010; quando ocorrer apenas geração, utiliza o diretório selecionado no momento do processamento. No reprocessamento, a rotina reconstrói a estrutura do XML utilizando exatamente os parâmetros da execução selecionada, garantindo consistência do levantamento.
Dessa forma, a rotina garante rastreabilidade e governança sobre as execuções do DSM Global, centralizando o histórico de processamentos, a visualização de parametrizações por filial e a capacidade de reprocessar levantamentos, reduzindo falhas operacionais e facilitando validações e suporte de integração.
3. Pré-requisitos e Configurações
- É preciso incluir manualmente a rotina DSM Reprocessamento (OFIA020) no meu do Protheus DMS.
- É necessário que exista uma configuração válida do DSM Global cadastrada na rotina OFIA010
- É necessário que existam execuções de levantamento previamente realizadas (carga inicial, manual ou schedule).
- Caso seja utilizada a opção de integração via Web Service, é necessário que os dados de comunicação estejam válidos na OFIA010.
4. Fluxo de Utilização
Configuração Inicial – Scania Pedido Compra (OFIA542)
- Acesse o Módulo 14 (Oficina).
- Acesse o menu Atualizações → Mov. Pedido Scania → Importar_Pedido Peças (OFIA542).
- Na tela Pergunte OFIA542, preencher as seguintes informações:
- Diretório dos arquivos ESPPED (obrigatório)
- Fornecedor Scania (obrigatório)
- Loja do Fornecedor (obrigatório)
- Condição de Pagamento (obrigatório)
- Fórmula Preço de Reposição (obrigatório)
- Operação TES (opcional)
- Ação Pós Processamento (obrigatório):
- Nenhuma Ação
- Mover Arquivo
- Apagar Arquivo
- Mover Para - Obrigatório somente se Ação pós-processamento = Mover arquivo
- Após preencher todos os parâmetros obrigatórios, clique no botão “Ok":
Ao clicar:- Campos obrigatórios são validados
- O sistema lê todos os arquivos ESPPED dentro do diretório
- Para cada arquivo, o sistema valida o pedido pela relação VEI → SC7:
Se não existir, cria o Pedido de Compra (SC7).
Se já existir, não gera novo pedido.
- O sistema aplica a ação definida:
- Mantem os arquivos na origem, ou
- Move para o diretório de destino, ou
- Apaga os arquivos processados.
5. Integrações e Dependências
Durante a execução da rotina Importar_Pedido Peças (OFIA542), o sistema opera sobre os arquivos SPPED disponibilizados pela fábrica e tem como resultado a geração de Pedidos de Compra na SC7 (mesmo padrão dos pedidos criados/armazenados pela rotina padrão de Pedido de Compras, como MATA120). Portanto, é necessário que a rotina esteja publicada no menu do DMS e que o Pergunte OFIA542 esteja disponível para o usuário informar o diretório dos arquivos, os parâmetros obrigatórios de criação (Fornecedor/Loja, Condição de Pagamento, Fórmula de Preço e TES opcional) e a ação pós-processamento (manter/mover/apagar, com permissão de acesso às pastas). Também é necessário que os parâmetros MV_MIL0005 e MV_MIL0006 estejam preenchidos corretamente e para evitar duplicidade e localizar os pedidos já existentes, a rotina depende da relação VEI → SC7 (vínculo do pedido da fábrica com o pedido interno) e, quando aplicável, da consideração do ano pedido (ex.: 123456/26) conforme a parametrização de MV_PEDANO.
DSM Global - Levantamentos (OFIA030)
|
Nome da Rotina | DSM Global - Levantamentos |
|---|---|
| Programa | OFIA030 |
| Módulo ERP | Oficina (SIGAOFI) |
| Acesso à Rotina | Atualizações/ |
| Data da Documentação (Última Atualização) |
|
2. Descrição Funcional
A rotina DSM Global - Levantamentos (OFIA030) tem como principal objetivo realizar a análise dos movimentos da operação no Protheus DMS e gerar os arquivos de integração com o DSM Global, construindo as transações no layout XML oficial e realizando o envio via Web Service conforme a parametrização definida.
Durante sua utilização, a rotina lê as configurações gravadas na VRN pela rotina OFIA010 (filiais, grupos e TAGs habilitadas, credenciais e parâmetros operacionais) e executa o levantamento dos eventos elegíveis para montar as transações no layout XML do DSM Global, contemplando transações como PartForSaleIntroduction, PartPriceUpdate, PartReception, PartOrder, PartDelivery, StockAdjustment, PartCorrection, SetStockBalance e LostSale, aplicando os controles necessários para sequenciamento e não reprocessamento quando aplicável.
Após a execução, a rotina finaliza o XML, controla o limite de transações por arquivo (quando aplicável), realiza o envio ao DSM Global via Web Service quando configurado, grava a informação de última execução na VRN e atualiza os controles incrementais por filial, como o intervalo processado de vendas perdidas (VBJ_SQVPJI/VBJ_SQVPJF). Quando habilitado na configuração, a rotina também gera o arquivo espelho do XML no diretório de servidor informado, mantendo a rastreabilidade do conteúdo integrado.
Dessa forma, a rotina garante a geração padronizada e consistente dos arquivos de integração do DSM Global, assegurando que apenas dados elegíveis e controlados sejam transmitidos, com rastreabilidade por filial, reduzindo riscos de reprocessamento e mantendo o DSM atualizado com os movimentos da operação no Protheus DMS.
3. Pré-requisitos e Configurações
- É preciso incluir manualmente a rotina Eliminar Resíduos BO (OFIA601) no menu do Protheus (DMS), permitindo o acesso ao pergunte e às operações específicas.
- É necessário o preenchimento do parâmetro MV_MIL0005 com o código da concessionária por cada filial cadastrada.
- É necessário que o parâmetro MV_MIL0006 esteja configurado com o código da concessionária.
4. Fluxo de Utilização
Configuração Inicial – Eliminar Resíduos BO (OFIA601)
- Acesse o Módulo 14 (Oficina).
- Acesse o menu Atualizações → Mov. Pedido Scania → Eliminar Resíduos BO (OFIA601).
- Na tela Pergunte , preencher as seguintes informações:
- Diretório CANCBO(obrigatório)
- Grupo de Produto(obrigatório)
- Ação Pós Processamento (obrigatório):
- Nenhuma Ação
- Mover Arquivo
- Apagar Arquivo
- Mover Para - Obrigatório somente se Ação pós-processamento = Mover arquivo
- Mover Para - Obrigatório somente se Ação pós-processamento = Mover arquivo
- Após preencher todos os parâmetros obrigatórios, clique no botão “Ok":
Ao clicar:- O sistema lê e processa todos os arquivos CANCBO encontrados no diretório informado
- Para cada arquivo, o sistema identifica o Pedido de Fábrica e localiza o pedido correspondente no Protheus via VEI → SC7
- O sistema cancela somente os itens presentes no arquivo e vinculados aos grupos configurados no Pergunte (eliminação de resíduos via MATA235).
- O sistema registra logs de início, itens cancelados/pedidos correspondentes, erros do ExecAuto e término.
- O sistema aplica a ação definida:
- Mantem os arquivos na origem, ou
- Move para o diretório de destino, ou
- Apaga os arquivos processados.
5. Integrações e Dependências
Durante a execução da rotina Eliminar Resíduos BO (OFIA601), o sistema opera sobre os arquivos CANCBO disponibilizados pela fábrica e tem como resultado o cancelamento (eliminação de resíduos) de itens de pedidos já existentes no Protheus DMS. Para funcionar corretamente, é necessário que a rotina esteja publicada no menu DMS e que o Pergunte OFIA601 esteja disponível para o usuário informar o diretório dos arquivos CANCBO, os grupos a serem atualizados (devem existir na SBM) e a ação pós-processamento (manter/mover/apagar, com permissão de acesso às pastas). Também é necessário que os parâmetros MV_MIL0005 e MV_MIL0006 estejam preenchidos corretamente. A rotina depende do vínculo VEI → SC7 para localizar o Pedido de Compra correspondente ao pedido da Fábrica e garante que apenas os itens presentes no arquivo e pertencentes aos grupos informados sejam processados para cancelamento.
|