Contratos Scania (OFIA600)

1. Identificação da Rotina

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 e Exportar Pedido em .xlsx, além de centralizar as operações de Importar_Pedido Peças (OFIA542) e Eliminar Resíduos BO (OFIA601) 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 Peças (OFIA542) e  Eliminar Resíduos BO (OFIA601), 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 (OFIA601) 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

Para o correto funcionamento da rotina Contratos Scania (OFIA600), é necessário garantir algumas condições que asseguram a integração com a API ARMS:

• • A rotina Configurações Scania (OFIA541), aba Integração Arms deve ser preenchida com as credenciais válidas para a integração correta com a API ARMS.

4. Fluxo de Utilização

Configuração Inicial – Contratos Scania (OFIA600)

1. Acesse o Módulo 14 (Oficina).
2. Acesse o menu Atualizações → Contratos Scania (OFIA600).
3. No botão Consultar Contrato Chassi, preencha o campo com o número do chassi e clique no botão Ok.
4. No botão Alterar, altere os campos Cliente e Loja se necessário e clique no botão Confirmar.
5. No botão Visualizar. a tela com os dados gerais do Contrato e as abas: Desconto, E-mail Gestores e Local Dealers são exibidas.
6. No menu Outras Ações, para excluir um registro, clique na opção Excluir e em seguida no botão Confirmar. 

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 funcionalidade 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, alimentando pela operação Vincular Pedido de Fábrica (pergunte MT297A) e considerando o parâmetro MV_PEDANO quando aplicável.

Configurações Scania (OFIA541)

1. Identificação da Rotina

2. Descrição Funcional

A rotina  Importar_Pedido Peças (OFIA542Configurações Scania(OFIA600) 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 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 e assegurando o controle dos arquivos após o processamento conforme a ação definida no Pergunte.. Protheus DMS,

3. Pré-requisitos e Configurações

1. É necessário 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.

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