DSM Reprocessamento (OFIA020

)

1. Identificação da Rotina

2. Descrição Funcional

A rotina   Importar_Pedido Peças (OFIA542DSM Reprocessamento (OFIA020) tem como principal objetivo importar arquivos de pedidos SPPED da Fábrica e viabilizar a criação/atualização de pedidos no Protheus DMS, utilizando os parâmetros informados no pergunte OFIA542 e o vínculo VEI (Arquivo Pedido de Peça Complem) e SC7 (Ped.Compra / Aut.Entrega)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 Importar_Pedido Peças (OFIA542) realiza a importação de pedidos da Fábrica por meio do processamento de arquivos ESPPED localizados em um diretório informado pelo usuário. Para isso, o usuário informa no Pergunte OFIA542 o diretório dos arquivos ESPPED e os parâmetros obrigatórios para criação do pedido (fornecedor/loja Scania, condição de pagamento e fórmula de preço, além da TES opcional), define a ação pós-processamento (nenhuma, mover ou apagar) e confirma. Com base nessas informações e na relação VEI → SC7, a rotina identifica se o pedido já existe no Protheus e, quando não localizado, efetua a criação automática do Pedido de Compra (SC7), garantindo a padronização do cadastro e o controle do tratamento dos arquivos pós-processamento.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 gera o Pedido de Compra (SC7) automaticamente somente quando ele ainda não existe na base (validação pela relação VEI → SC7). Se o pedido já estiver cadastrado, nenhuma nova geração é realizada e o arquivo é apenas tratado conforme a ação pós-processamento definida (manter, mover ou apagar).

Dessa forma, a rotina automatiza a importação dos pedidos, reduzindo atividades manuais, garantindo a criação padronizada dos mesmos e assegurando o controle dos arquivos após o processamento conforme a ação definida no Pergunte.

3. Pré-requisitos e Configurações

1. É preciso incluir manualmente a rotina Importar_Pedido Peças (OFIA542) no menu do Protheus (DMS), permitindo o acesso ao pergunte e às operações específicas.
2. É necessário o preenchimento do parâmetro MV_MIL0005 com o código da concessionária por cada filial cadastrada.
3. É 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 – Scania Pedido Compra (OFIA542)

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

1. É preciso incluir manualmente a rotina DSM Reprocessamento (OFIA020) no meu do Protheus DMS.
2. É necessário que exista uma configuração válida do DSM Global cadastrada na rotina OFIA010
3. É necessário que existam execuções de levantamento previamente realizadas (carga inicial, manual ou schedule).
4. 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)

1. Acesse o Módulo 14 (Oficina).
2. Acesse o
3. Acesse o Módulo 14 (Oficina).
4. Acesse o menu Atualizações → Mov. Pedido Scania → Importar_Pedido Peças (OFIA542).
5. 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
     
6. 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 Reprocessamento (OFIA020), a funcionalidade de consulta e listagem de arquivos depende do diretório e das definições do DSM Global cadastradas na rotina OFIA010, pois a rotina considera a configuração gravada na VRN para identificar o diretório inicial de leitura de XMLs e o comportamento de salvamento conforme parametrizado. Para que as ações de Processa Carga Inicial, Processa Price Updates e Reprocessa execução selecionada funcionem corretamente, a rotina depende da rotina OFIA030, responsável por gerar a estrutura do XML e, quando selecionado, realizar a integração via Web Service com DSM Global, respeitando as TAGs e regras definidas na configuração. Dessa forma, a rotina garante que o acompanhamento e reprocessamento sejam executados com base na parametrização oficial do DSM Global por filial, mantendo a consistência entre as execuções, os XMLs gerados e o comportamento de integração.

DSM Global - Levantamentos (OFIA030

)

1. Identificação da Rotina

2. Descrição Funcional

A rotina Eliminar Resíduos BO (OFIA601DSM Global - Levantamentos (OFIA030) tem como principal objetivo processar arquivos CANCBO de cancelamento de pedidos da Fábrica realizar a análise dos movimentos da operação no Protheus DMS, eliminando resíduos e cancelando apenas os itens informados no arquivo, conforme os grupos definidos pelo usuário.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, o usuário acessa a rotina pelo menu e informa no Pergunte OFIA601 o diretório dos arquivos CANCBO e os grupos a serem atualizados (devem existir na SBM), além de definir a ação pós-processamento dos arquivos (manter, mover ou apagar), informando o diretório Mover Para apenas quando a opção Mover Arquivo for selecionada. Em seguida, o sistema lê todos os arquivos CANCBO dentro do diretório informado e identifica, em cada arquivo, o pedido de fábrica e os itens canceladosa 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 localiza o Pedido Protheus (SC7) correspondente através da relação VEI → SC7 e realiza o cancelamento somente dos itens presentes no arquivo e vinculados aos grupos configurados, executando a eliminação de resíduos via MSExecAuto da rotina MATA235 (referência EICElimRes – EIC.PRW). Ao final, registra logs de início, itens cancelados, erros do ExecAuto e término e aplica a ação pós-processamento definida para os arquivos.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 DMSDessa forma, a rotina automatiza o cancelamento de pedidos Scania via CANCBO, garantindo consistência no tratamento dos itens cancelados e reduzindo a intervenção manual no processo.

3. Pré-requisitos e Configurações

1. É 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.
2. É necessário o preenchimento do parâmetro MV_MIL0005 com o código da concessionária por cada filial cadastrada.
3. É 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)

1. Deve ser configurado o Embedded Audit Trail (CFGA710) para auditar alterações nas seguintes tabelas:
   • SB1 (B1_COD – Inclusão; B1_PRV1 – Inclusão e Alteração);
   • SB5 (B5_LOCALI2 – Alteração);
   • SBZ (BZ_PRIENT – Inclusão e Alteração) - opcional.

4. Fluxo de Utilização

Configuração Inicial – Eliminar Resíduos BO (OFIA601)

1. Acesse o Módulo 14 (Oficina).
2. Acesse o
3. Acesse o Módulo 14 (Oficina).
4. Acesse o menu Atualizações → Mov. Pedido Scania → Eliminar Resíduos BO (OFIA601).
5. 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
     
6. 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.

e Dependências

Durante a execução da rotina DSM Global - Levantamento (OFIA030), o processamento depende diretamente da configuração cadastrada na rotina OFIA010, pois a rotina lê os parâmetros gravados na tabela VRN (por filial via sxFilial('SD2'))para obter dados de comunicação com Web Service, filiais, grupos elegíveis, TAGs habilitadas, campos de pereço e a definição de geração de arquivo espelho. Para geração das transações, a rotina integra-se aos dados operacionais do Protheus DMS, utilizando as tabelas e movimentos da operação (cadastro de produtos e informações adicionais, requisições da oficina, movimentações de estoque e registros de venda perdida), além de utilizar o controle incrementar por filiar para não reprocessamento de vendas perdidas (VPJ/VBJ). Para atendimento do sequencial lógico do item requisitado na oficina (PartOrder), a rotina depende da existência e manutenção da tabela auxiliar à VQ3 quando o ponto de entradaPOA30SOF não estiver disponível no RPO, utilizando esse controle para preenchimento do atributo orderLineNumber no XML. Dessa forma, a rotina garante a geração e integração dos XMLs do DSM Global com base na parametrização oficial armazenada na VRN e nos dados da operação do DMS, mantendo rastreabilidade por filial e consistência no envio das transações ao DSM Global. 

DSM Global - Cadastro de Ajustes de Estoque (OFIA550)

1. Identificação da Rotina

2. Descrição Funcional

A rotina Cadastro de Ajustes de Estoque (OFIA550) tem como principal objetivo permitir o registro manual de ajustes de estoque para o DSM Global, quando o ajuste não foi gerado a partir de uma movimentação do Protheus (como movimentações internas, faturamento ou processos automáticos), mas o saldo precisa ser corrigido e refletido corretamente na plataforma do DSM Global.

Durante sua utilização, a rotina disponibiliza a inclusão e manutenção dos ajustes, padronizando as informações necessárias para que esses registros sejam considerados no processo de integração do DSM Global, garantindo consistência

3. Pré-requisitos e Configurações

1. É 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.
2. É necessário o preenchimento do parâmetro MV_MIL0005 com o código da concessionária por cada filial cadastrada.
3. É necessário que o parâmetro MV_MIL0006 esteja configurado com o código da concessionária.
4. Deve ser configurado o Embedded Audit Trail (CFGA710) para auditar alterações nas seguintes tabelas:
   • SB1 (B1_COD – Inclusão; B1_PRV1 – Inclusão e Alteração);
   • SB5 (B5_LOCALI2 – Alteração);
   • SBZ (BZ_PRIENT – Inclusão e Alteração) - opcional.

4. Fluxo de Utilização

Configuração Inicial – Eliminar Resíduos BO (OFIA601)

1. Acesse o Módulo 14 (Oficina).
2. Acesse o menu Atualizações → Mov. Pedido Scania → Eliminar Resíduos BO (OFIA601).
3. 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
     
4. 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 DSM Global - Levantamento (OFIA030), o processamento depende diretamente da configuração cadastrada na rotina OFIA010, pois a rotina lê os parâmetros gravados na tabela VRN (por filial via sxFilial('SD2'))para obter dados de comunicação com Web Service, filiais, grupos elegíveis, TAGs habilitadas, campos de pereço e a definição de geração de arquivo espelho. Para geração das transações, a rotina integra-se aos dados operacionais do Protheus DMS, utilizando as tabelas e movimentos da operação (cadastro de produtos e informações adicionais, requisições da oficina, movimentações de estoque e registros de venda perdida), além de utilizar o controle incrementar por filiar para não reprocessamento de vendas perdidas (VPJ/VBJ). Para atendimento do sequencial lógico do item requisitado na oficina (PartOrder), a rotina depende da existência e manutenção da tabela auxiliar à VQ3 quando o ponto de entradaPOA30SOF não estiver disponível no RPO, utilizando esse controle para preenchimento do atributo orderLineNumber no XML. Dessa forma, a rotina garante a geração e integração dos XMLs do DSM Global com base na parametrização oficial armazenada na VRN e nos dados da operação do DMS, mantendo rastreabilidade por filial e consistência no envio das transações ao DSM Global.