Rotinas: Pedido de Compra DMS Scania (OFIA540), Importação ESPPED Scania (OFIA542)


Opção de Menu: Oficina → Atualizações → Mov. Pedido Scania

Módulos: Oficina (SIGAOFI)

Objetivo:  Automatizar o ciclo completo de pedidos Scania no Protheus DMS: importar pedidos da fábrica (ESPPED) para gerar Pedido de Compra (SC7), vincular pedido Scania ao pedido interno (VEI → SC7), importar XML de NF para lançar a nota (SF1/SD1) e baixar automaticamente os itens entregues, e processar cancelamentos (CANCBO) para eliminar resíduos/cancelar itens, reduzindo intervenção manual e garantindo consistência entre pedido, entrega e cancelamento.




Scania Pedido Compra (OFIA540)
1. Identificação da Rotina


Nome da Rotina

Scania Pedido Compra
Programa OFIA540
Módulo ERPOficina (SIGAOFI)
Acesso à RotinaAtualizações/Mov. Pedido Scania/Scania Pedido Compra (OFIA540)
Data da Documentação (Ultima Atualização)

 



2. Descrição Funcional


A rotina Scania Pedido Compra (OFIA540) tem como principal objetivo disponibilizar uma rotina espelho do Pedido de Compras(SC7) no DMS, permitindo a gestão dos pedidos e a execução das ações específicas do processo Scania, como Vincular Pedido de Fábrica Exportar Pedido em .xlsx, além de centralizar as operações de Importar Pedido de Peças Protheus (ESPPED) e Eliminar Resíduos de Peças Canceladas (CANCBO) diretamente no browse.

Durante sua utilização, o usuário acessa o browse de pedidos (SC7) e pode executar as operações básicas (incluir/alterar/excluir/visualizar/pesquisar/legenda/imprimir). Ao selecionar um pedido e acionar Vincular Pedido de Fábrica, o sistema abre a pergunta MT297A e grava/atualiza o vínculo na tabela VEI, considerando o parâmetro MV_PEDANO quando aplicável. Ao acionar Exportar Pedido em Excel, o sistema gera um arquivo .xlsx com os itens do pedido para importação no LPC Net. Adicionalmente, a partir da própria OFIA540, o usuário pode executar Importar Pedido de Peças Protheus (ESPPED) e Eliminar Resíduos de Peças Canceladas (CANCBO), abrindo as respectivas telas de parâmetros (Perguntes) e processando os arquivos.

Após a execução, a rotina grava/atualiza o vínculo do pedido do Protheus com o Pedido da Scania na tabela VEI, garantindo que esse relacionamento seja utilizado em processos posteriores do épico, como a importação de XML (impxmlSC) para lançamento de NF e baixa automática dos itens entregues e o cancelamento (CANCBO) para eliminação de resíduos.

Dessa forma, a rotina garante padronização e consistência, assegurando o vínculo necessário de pedidos para usos posteriores no Protheus.



3. Pré-requisitos e Configurações

  1. É necessário incluir manualmente a rotina Scania Pedido Compra (OFIA540) no menu do Protheus (DMS), permitindo o acesso ao browse de pedidos (SC7) e às operações específicas.
  2. Deve estar parametrizado o MV_PEDANO, pois a rotina considera o número do pedido com o ano (ex.: 123456/24) para evitar conflito em casos de reutilização de número pela fábrica.



4. Fluxo de Utilização

Configuração Inicial – Scania Pedido Compra (OFIA540)

  1. Acesse o Módulo 14 (Oficina).
  2. Acesse o menu Atualizações → Mov. Pedido Scania → Scania Pedido Compra (OFIA540).
  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 Pedido → Vincular Pedido de Fábrica → Outras Opções → Vincular Pedido de Fábrica → Exportar Pedido em Excel.



5. Integrações e Dependências


Durante a execução da rotina Scania Pedido Compra (OFIA540), o sistema depende da SC7 para listar e manter os pedidos e da pergunta MT297A para capturar o Pedido de Fábrica, gravando o vínculo na VEI (considerando o MV_PEDANO). Para a exportação, depende do cadastro de produto (C7_PRODUTO → B1_CODITE) e de permissão de acesso a diretórios para gerar o .xlsx.

Importação ESPPED (OFIA542)
1.
Identificação da Rotina


Nome da Rotina

 Importação ESPPED
Programa OFIA542
Módulo ERPOficina (SIGAOFI)
Acesso à RotinaAtualizações/Mov. Pedido Scania/Importação ESPPED(OFIA542)
Data da Documentação (Ultima Atualização)

 



2. Descrição Funcional


A rotina  Importação ESPPED (OFIA542) 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).

Durante sua utilização, a rotina Importação ESPPED (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.

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 mesmo e assegurando o controle dos arquivos após o processamento conforme a ação definida no Pergunte.



3. Pré-requisitos e Configurações


  1. É necessário incluir manualmente a rotina Importação ESPPED (OFIA542) no menu do Protheus (DMS), permitindo o acesso ao pergunte e às operações específicas.



4. Fluxo de Utilização


Configuração Inicial – Scania Pedido Compra (OFIA540)

  1. Acesse o Módulo 14 (Oficina).
  2. Acesse o menu Atualizações → Mov. Pedido Scania → Importação ESPPED (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.



5. Integrações e Dependências


Durante a execução da rotina Importação ESPPED (OFIA542), o sistema realiza a leitura de arquivos ESPPED disponibilizados pela Fábrica em um diretório informado no Pergunte OFIA542 e depende da parametrização necessária para criação do Pedido de Compra via MSExecAuto (ExevAuto), utilizando os dados do arquivo e os parâmetros informados (fornecedor/loja, condição de pagamento, fórmula de preço e, opcionalmente, operação TES). A validação de existência e a identificação dos pedidos ocorre por meio da relação VEI → SC7, permitindo que o pedido seja criado automaticamente apenas quando não localizados na base. Como dependências, requer i grupo de Pergunte "OFIA542" cadastrado (via ATUSX 016125), permissões de leitura/escrita nos diretórios para processamento e ação pós-processamento (manter/mover/apagar), e disponibilidade das estruturas VEI e SC7 para amarração e registro dos pedidos.

Importação Arquivo XML (impxmlSC)
1.
Identificação da Rotina


Nome da Rotina

 Importação Arquivo XML
Programa impxmlSC
Módulo ERPOficina (SIGAOFI)
Acesso à RotinaAtualizações/Mov. Pedido Scania/ Importação Arquivo XML(impxmlSC)
Data da Documentação (Ultima Atualização)

 



2. Descrição Funcional


A rotina Importação Arquivo XML(impxmlSC) tem como principal objetivo lançar automaticamente Notas Fiscais de compra a partir de arquivos XML no Protheus DMS, utilizando os parâmetros informados no pergunte para registrar dados e permitir a baixa automática dos pedidos relacionados.

Durante sua utilização, a rotina Importação Arquivo XML(impxmlSC) lista todos os XML encontrados dentro do diretório. Para isso, o usuário informa no Pergunte o diretório dos arquivos XML e os parâmetros obrigatórios para criação do pedido (Arquivos, Marca, Mostra Detalhes, Espécie NF, Gerar Doc e Ação pós-processamento [manter, mover ou apagar] ). O sistema lista os XML encontrados(exibindo as colunas de Arquivo XML, Nota Fiscal, Série, Emissão, CNPJ Fornecedor, Fornecedor), permite selecionar quais serão lançados e exige os parâmetros obrigatórios por XML: tipo de criação (Pré-Nota MATA140 ou NF A103NFISCAL), Grupo da Peça, Espécie, Condição de Pagamento e Operação (quando for gerar NF). e após a confirmação caso a nota não exista ela é importada. 

Após a execução, a rotina processa os XML selecionados, cria a Pré-Nota ou a Nota Fiscal conforme a parametrização, grava cabeçalho e itens em SF1/SD1,identifica o pedido pelo <xPed> e pelo vínculo VEI → SC7 e realiza a baixa automática dos itens do pedido identificado aplicando ao final a ação definida para os arquivos.

Dessa forma, a rotina reduz atividades manuais e garante consistência entre NF, Pedido de Fábrica e Pedido Protheus e reduzindo retrabalho manual no processo de entrada de notas.



3. Pré-requisitos e Configurações


  1. É necessário incluir manualmente a rotina Importação Arquivo XML (impxmlSC) no menu do Protheus (DMS), permitindo o acesso ao pergunte e às operações específicas.



4. Fluxo de Utilização


Configuração Inicial – Importação Arquivo XML (impxmlSC)

  1. Acesse o Módulo 14 (Oficina).
  2. Acesse o menu Atualizações → Mov. Pedido Scania → Importação Arquivo XML (impxmlSC).
  3. Na tela Pergunte , preencher as seguintes informações:
    • Arquivos (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
    • Marca (obrigatório)
    • Mostra Detalhes (obrigatório)
    • Espécie NF (obrigatório)
    • Fórmula Preço de Reposição (obrigatório)
    • Gerar Doc (obrigatório)
    • 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 lista todos os arquivos XML encontrados no diretório informado 
    • O usuário seleciona quais XMLs deseja processar
    • Ao confirmar, o sistema interpreta o XML e grava cabeçalho e itens em SF1/SD1
    • 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 Importação Arquivo XML (impxmlSC), o sistema realiza leitura de arquivos XML em um diretório informado no Pergunte e depende das rotinas padrão de lançamento conforme o tipo escolhido: MATA140 para criação de Pré-Nota e A103NFISCAL para criação/classificação de Nota Fiscal. A gravação dos dados ocorre nas tabelas SF1(cabeçalho) e SD1(itens), e a identificação do pedido é feita pelo Pedido de Fábrica contido na tag <xPed> do XML, utilizando o vínculo VEI → SC7 para localizar o Pedido de Compra e executar a baixa automática dos itens. Como dependência de parametrização, a rotina exige que os cadastros informados existam: Grupo de Peça (SBM), Espécie (SX5 – tabela 42), Condição de Pagamento (SE4) e Operação (SFM, quando gerar NF), além de permissões de acesso aos diretórios para leitura e para a ação pós-processamento (manter/mover/apagar) dos arquivos.

Cancelamento de Pedido SCRM (OFIA601)
1.
Identificação da Rotina


Nome da Rotina

Cancelamento de Pedido SCRM
Programa OFIA601
Módulo ERPOficina (SIGAOFI)
Acesso à RotinaAtualizações/Mov. Pedido Scania/ Cancelamento de Pedido SCRM(OFIA601)
Data da Documentação (Ultima Atualização)

 



2. Descrição Funcional


A rotina Cancelamento de Pedido SCRM (OFIA601) tem como principal objetivo processar arquivos CANCBO de cancelamento de pedidos da Fábrica no Protheus DMS, eliminando resíduos e cancelando apenas os itens informados no arquivo, conforme os grupos definidos pelo usuário.

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 cancelados

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.

Dessa 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. É necessário incluir manualmente a rotina Cancelamento de Pedido SCRM (OFIA601) no menu do Protheus (DMS), permitindo o acesso ao pergunte e às operações específicas.



4. Fluxo de Utilização


Configuração Inicial – Cancelamento de Pedido SCRM (OFIA601)

  1. Acesse o Módulo 14 (Oficina).
  2. Acesse o menu Atualizações → Mov. Pedido Scania → Cancelamento de Pedido SCRM (OFIA601).
  3. Na tela Pergunte , preencher as seguintes informações:
    • Diretorio 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 Cancelamento de Pedido SCRM (OFIA601), o sistema processa arquivos CANCBO e depende do vínculo VEI → SC7 para localizar o pedido interno correspondente ao Pedido de Fábrica. O cancelamento é executado por meio da rotina padrão MATA235 (Eliminação de Resíduos) acionada via MSExecAuto, tendo como referência a função EICElimRes do fonte EIC.PRW, e registra o processamento através da classe DMS_LOGGER. A rotina também depende dos grupos informados no Pergunte existente na SBM para filtrar e cancelar apenas os itens permitidos, além de exigir permissões de leitura/escrita nos diretórios para leitura dos arquivos e tratamento pós-processamento.


6. Assuntos Relacionados

DT DMS SCANIA - Implementado campo Cod Grp Servico Montadora na rotina Grupo de Servicos (OFIOA020)

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.