Importar_Pedido Peças (OFIA542)

1. Identificação da Rotina

2. Descrição Funcional

A rotina  Importação ESPPED Importar_Pedido Peças (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 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.

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 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. É necessário preciso incluir manualmente a rotina Importação ESPPED Importar_Pedido Peças (OFIA542) no menu do Protheus (DMS), permitindo o acesso ao pergunte e às operações específicas.

4. Fluxo de Utilização

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

5. Integrações e Dependências

Durante a execução da rotina Importação ESPPED 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). Para 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/2426) conforme a parametrização de MV_PEDANO.

Eliminar Resíduos BO (OFIA601

)

1. Identificação da Rotina

2. Descrição Funcional

A rotina Importação Arquivo XML(impxmlSCEliminar Resíduos BO (OFIA601) tem como principal objetivo lançar automaticamente Notas Fiscais de compra a partir de arquivos XML processar arquivos CANCBO de cancelamento de pedidos da Fábrica no Protheus DMS, utilizando os parâmetros informados no pergunte para registrar dados e permitir a baixa automática dos pedidos relacionadoseliminando resíduos e cancelando apenas os itens informados no arquivo, conforme os grupos definidos pelo usuário.

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 [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] ). 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. ), 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 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 notasautomatiza 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 preciso incluir manualmente a rotina Importação Arquivo XML (impxmlSC Eliminar Resíduos BO (OFIA601) no menu do Protheus (DMS), permitindo o acesso ao pergunte e às operações específicas.

4. Fluxo de Utilização

1. É necessário o preenchimento do parâmetro MV_MIL0005 com o código da concessionária por cada filial cadastrada.
2. É 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 (OFIA601Configuraçã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 (impxmlSCEliminar Resíduos BO (OFIA601).
3. Na tela Pergunte , preencher as seguintes informações:
   • Diretório CANCBO(obrigatório)
   • Grupo de ProdutoArquivos (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 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 lê e processa todos os arquivos XMLCANCBO encontrados no diretório informado 
   • O usuário seleciona quais XMLs deseja processar
   • informado
   • Para cada arquivoAo confirmar, o sistema interpreta identifica o XML e grava cabeçalho e itens em SF1/SD1Pedido 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 Importação Arquivo XML (impxmlSCEliminar Resíduos BO (OFIA601), o sistema opera sobre arquivos XML de Nota Fiscal disponíveis em um diretório informado no Pergunte os arquivos CANCBO disponibilizados pela fábrica e tem como resultado o lançamento da entrada de NF no Protheus, registrando cabeçalho e itens (SF1/SD1) conforme a ação escolhida (Criar Pré-Nota – MATA140 ou Criar Nota Fiscal/Classificar – A103NFISCAL). Para funcionar corretamente, é 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 do DMS e que o Pergunte OFIA601 esteja disponível para o usuário consiga informar no Pergunte o diretório dos SMLs 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). Além disso, para cada XML selecionado, é obrigatório ter os parâmetros e cadastros válidos no Protheus (Grupo da Peça, Espécie, Condição de Pagamento e Operação quando for gerar NF). Quando houver baixa automática, a rotina depende do Pedido de Fábrica no XML (<xPed>) e do vínculo VEI → SC7 para localizar o Pedido de Compra e efetuar a baixa dos itens entreguesTambé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.