Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Deck of Cards
id1,2,3,4,5
Card
id1
label Configuração DSM Scania (OFIA010)

Configuração DSM Scania (OFIA010)


1. Identificação da Rotina


Nome da Rotina

Configuração DSM Scania
Programa OFIA010
Módulo ERPOficina (SIGAOFI)
Acesso à RotinaAtualizaçõ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

  1. É preciso incluir manualmente a rotina DSM Configuração (OFIA010) no menu do Protheus DMS.
  2. É necessário realizar o cadastro para cada filial que participará da integração.
  3. É 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 – Configuração DSM Scania Pedido Compra (OFIA540OFIA010)

  1. Acesse o   Módulo 14 (Oficina).
  2. Acesse o menu Atualizações → Mov. Pedido Scania → Scania Pedido Compra (OFIA540A DEFINIR → Configuração DSM Scania (OFIA010).
  3. 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.

Multimedia
nameOFIA540.mp4
width1280
height720

5. Integrações e Dependências

Durante sua execução a rotina DSM Configuração (OFIA010) grava e mantém a configuração do DSM Global em formato JSON na tabela VRN, por filial (sxFilial('SD2')), e essa configuração é a base utilizada pela rotina. A OFIA030 depende diretamente dos parâmetros definidos na OFIA010 (dados do Web Service, filiais, grupos, TAGs habilitadas e campos de preço de venda/reposição) para realizar o levantamento, montar o XML e integrar com o DSM Global. A OFIA020 utiliza as definições da OFIA010 relacionadas ao diretório e ao comportamento de salvamento/geração de XML (arquivo espelho), para listar e consultar os arquivos gerados nas execuções.

  1. da aba Filiais preencha os parâmetros obrigatórios:
    • Código Filial (Código da filial desejada)
    • Warehouse ID (Fornecida pela Fábrica)
  2. Dentro da aba Grupos preencha os parâmetros obrigatórios:
    • Código Grupo (Código do grupo de produto desejado)
  3. Dentro da aba TAGS para envio preencha os parâmetros obrigatórios:
    • PartForSaleIntroduction (Sim ou Não)
    • PartPriceUpdate (Sim ou Não)
    • PartReception (Sim ou Não)
    • PartOrder (Sim ou Não)
    • PartDelivery (Sim ou Não)
    • PartOrderDelivery (Sim ou Não)
    • StockAdjustment (Sim ou Não)
    • LostSale (Sim ou Não)
    • RemovePartInStock (Sim ou Não)
    • PartCorrection (Sim ou Não)
    • SetStockBalance (Sim ou Não)
  4. Dentro da aba Configurações preencha os parâmetros obrigatórios:
    • Operator ID (Fornecida pela Fábrica)
    • Owner ID (Fornecida pela Fábrica)
    • Global Region ID (Fornecida pela Fábrica)
    • Código Moeda (Código da moeda desejado)
    • Grupo Principal (Grupo desejado)
    • URL WebService (Fornecida pela Fábrica)
    • Usuário WebService (Fornecida pela Fábrica)
    • Senha WebService (Fornecida pela Fábrica)
    • Agrega Qtde.Reservada/Bloqueada (Sim ou Não)
    • Agrega Qtde.Estoque em Trânsito (Sim ou Não)
    • Salvar XML na pasta (Sim ou Não)
      • Sim - Inserir local do servidor
      • Não - Campo bloqueado
    • Fórmula Preço de Venda (Grupo de fórmula desejado)
    • Fórmula Preço Reposição (Grupo de fórmula desejado)
  5. Após preencher todos os parâmetros obrigatórios, clique no botão “Confirmar”:
    Ao confirmar:
    • Todos os valores são salvos na tabela VRN (JSON)

Multimedia
nameOFIA540.mp4
width1280
height720



5. Integrações e Dependências


Durante sua execução a rotina DSM Configuração (OFIA010) grava e mantém a configuração do DSM Global em formato JSON na tabela VRN, por filial (sxFilial('SD2')), e essa configuração é a base utilizada pela rotina. A OFIA030 depende diretamente dos parâmetros definidos na OFIA010 (Filiais, Grupos, TAGS para envio e Configurações) para realizar o levantamento, montar o XML e integrar com o DSM Global. A OFIA020 utiliza as definições da OFIA010 relacionadas ao diretório e ao comportamento de salvamento/geração de XML (arquivo espelho), para listar e consultar os arquivos gerados nas execuções.

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

  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 menu Atualizações → Mov. Pedido Scania → Importar_Pedido Peças (OFIA542).
  3. 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
  4. 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.

Card
id2
labelDSM Reprocessamento (OFIA020)

DSM Reprocessamento (OFIA020)


1.
Identificação da Rotina


Nome da Rotina

DSM Reprocessamento

Programa OFIA020
Módulo ERPOficina (SIGAOFI)
Acesso à RotinaAtualizaçõ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


  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 menu Atualizações → Mov. Pedido Scania → Importar_Pedido Peças (OFIA542).
  3. 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
  4. 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.

Multimedia
nameOFIA542.mp4
width1280
height720



5. Integrações e Dependências


Durante a execução da rotina 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

Card
id2
labelDSM Reprocessamento (OFIA020)

DSM Reprocessamento (OFIA020)

1. Identificação da Rotina

Nome da Rotina

DSM Reprocessamento

Programa OFIA020
Módulo ERPOficina (SIGAOFI)
Acesso à RotinaAtualizações/
Data da Documentação (Última Atualização)

 

Multimedia
nameOFIA542.mp4
width1280
height720

5. Integrações e Dependências

Durante a execução da rotina 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.

Card
id3
labelDSM Global - Levantamentos (OFIA030)

DSM Global - Levantamentos (OFIA030)


1.
Identificação da Rotina


Nome da Rotina

DSM Global - Levantamentos
Programa OFIA030
Módulo ERPOficina (SIGAOFI)
Acesso à RotinaAtualizaçõ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

  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. 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.

Multimedia
nameOFIA601.mp4
width1280
height720

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'))

reprocessamento e mantendo o DSM atualizado com os movimentos da operação no Protheus DMS.



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.

Multimedia
nameOFIA601.mp4
width1280
height720



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. 


Card
id4
labelCadastro de Ajustes de Estoque (OFIA550)

DSM Global - Cadastro de Ajustes de Estoque (OFIA550)


1.
Identificação da Rotina


Nome da Rotina

DSM Global Cadastro de Ajustes de Estoque
ProgramaOFIA550
Módulo ERPOficina (SIGAOFI)
Acesso à RotinaAtualizações/
Data da Documentação (Última Atualização)

 



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.

Multimedia
nameOFIA601.mp4
width1280
height720



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. 



Card
id5
Card
id4
labelAtualização de Dicionário/Menu
Totvs custom tabs box items
defaultno
referenciapasso2
  • 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

Mov. Pedido Scania

Nome da Rotina

 Importar_Pedido Peças

Programa

OFIA542

Módulo

Oficina (SIGAOFI)

Tipo

Função Protheus


Criação de Pergunte no arquivo SX1 – Pergunta


Grupo

OFIA542OFIA542OFIA542OFIA542

Grupo de campo

SC7SC7SC7SC7

Ordem

01020304

Pergunta

Diretório Arquivos ESPPEDFornecedor ScaniaLoja do FornecedorCondição de Pagamento

Tipo

CCCC
Tamanho99623
Decimal0000
Var01MV_PAR01MV_PAR02MV_PAR03MV_PAR04
Formato



ValidaçãoOC542002N_ValidPerg()ExistCpo('SA2',MV_PAR02) .and. NaoVazio()ExistCpo("SA2",MV_PAR02+MV_PAR03) .and. NaoVazio()ExistCpo('SE4',MV_PAR04) .and. NaoVazio()
ObjetoGetGetGetGet
Consulta PadrãoVE1


Pré-Seleção (Combo)



Item 1



Item 2



Item 3



Item 4



Item 5



Help





Grupo

OFIA542OFIA542OFIA542OFIA542

Grupo de campo

SC7SC7SC7SC7

Ordem

05060708

Pergunta

Formula Preço de ReposiçãoOperação TESAção pós-processamentoMover Para

Tipo

CCNC
Tamanho6219
Decimal0000
Var01MV_PAR05MV_PAR06MV_PAR07MV_PAR08
Formato



ValidaçãoFG_SEEK('VEG','MV_PAR05',1,.F.).and.(VEG->VEG_GRUFOR=='04') .and. NaoVazio()Vazio() .or. ExistCpo('SX5','DJ'+MV_PAR06)OC542002N_ValidPerg()OC542002N_ValidPerg()
ObjetoGetGetComboGet
Consulta Padrão



Pré-Seleção (Combo)


1
Item 1


Nenhuma Ação
Item 2


Mover Arquivo
Item 3


Apagar Arquivo
Item 4



Item 5



Help




  • 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

Mov. Pedido Scania

Nome da Rotina

Eliminar Resíduos BO  

Programa

OFIA601

Módulo

Oficina (SIGAOFI)

Tipo

Função Protheus


Criação de Pergunte no arquivo SX1 – Pergunta


Grupo

OFIA601OFIA601OFIA601OFIA601

Grupo de campo

SC7SC7SC7SC7

Ordem

01020304

Pergunta

Diretório CANCBOGrupo de ProdutoAção pós-processamentoMover Para

Tipo

CCCC
Tamanho994199
Decimal0000
Var01MV_PAR01MV_PAR02MV_PAR03MV_PAR04
Formato



ValidaçãoOA601003F_Valid()OA601003F_Valid()OA601003F_Valid()OA601003F_Valid()
ObjetoGetGetComboGet
Consulta Padrão



Pré-Seleção (Combo)


1
Item 1


Nenhuma Ação
Item 2


Mover Arquivo
Item 3


Apagar Arquivo
Item 4



Item 5



Help



...