Scania Pedido Compra (OFIA540)
1. Identificação da Rotina
Nome da Rotina |
Scania Pedido Compra |
|---|---|
| Programa | OFIA540 |
| Módulo ERP | Oficina (SIGAOFI) |
| Acesso à Rotina | Atualizações/Mov. Pedido Scania/Scania Pedido Compra (OFIA540) |
| Data da Documentação (Última 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 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, 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
- É preciso 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.
- Deve estar parametrizado o MV_PEDANO, pois a rotina considera o número do pedido com o ano (ex.: 123456/26) para evitar conflito em casos de reutilização de número pela fábrica.
- É necessário o preenchimento do parâmetro MV_MIL0005 com o código da concessionária por cada filial cadastrada.
- É 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 (OFIA540)
- Acesse o Módulo 14 (Oficina).
- Acesse o menu Atualizações → Mov. Pedido Scania → Scania Pedido Compra (OFIA540).
- 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.
- Selecionar Pedido → Vincular Pedido de Fábrica → Outras Opções → Vincular Pedido de Fábrica → Vincular Pedido de Fábrica.
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 funcionalidades 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, alimentado pela operação Vincular Pedido de Fábrica (pergunte MT297A), sempre considerando os parâmetros MV_MIL0005, MV_MIL0006 obrigatoriamente e o MV_PEDANO quando aplicável.
Importar_Pedido Peças (OFIA542)
1. Identificação da Rotina
Nome da Rotina |
Importar_Pedido Peças |
|---|---|
| Programa | OFIA542 |
| Módulo ERP | Oficina (SIGAOFI) |
| Acesso à Rotina | Atualizações/Mov. Pedido Scania/Importar_Pedido Peças (OFIA542)(OFIA542) |
| Data da Documentação (Última Atualização) |
|
2. Descrição Funcional
A rotina 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 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 mesmos e assegurando o controle dos arquivos após o processamento conforme a ação definida no Pergunte.
3. Pré-requisitos e Configurações
- É 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.
- É necessário o preenchimento do parâmetro MV_MIL0005 com o código da concessionária por cada filial cadastrada.
- É 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)
- Acesse o Módulo 14 (Oficina).
- Acesse o menu Atualizações → Mov. Pedido Scania → Importar_Pedido Peças (OFIA542).
- 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
- 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.
Eliminar Resíduos BO (OFIA601)
1. Identificação da Rotina
Nome da Rotina |
Eliminar Resíduos BO |
|---|---|
| Programa | OFIA601 |
| Módulo ERP | Oficina (SIGAOFI) |
| Acesso à Rotina | Atualizações/Mov. Pedido Scania/Eliminar Resíduos BO (OFIA601) |
| Data da Documentação (Última Atualização) |
|
2. Descrição Funcional
A rotina Eliminar Resíduos BO (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
- É 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.
- É necessário o preenchimento do parâmetro MV_MIL0005 com o código da concessionária por cada filial cadastrada.
- É 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)
- Acesse o Módulo 14 (Oficina).
- Acesse o menu Atualizações → Mov. Pedido Scania → Eliminar Resíduos BO (OFIA601).
- 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
- 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.
- 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 |
OFIA542 | OFIA542 | OFIA542 | OFIA542 |
|---|---|---|---|---|
Grupo de campo |
SC7 | SC7 | SC7 | SC7 |
Ordem |
01 | 02 | 03 | 04 |
Pergunta |
Diretório Arquivos ESPPED | Fornecedor Scania | Loja do Fornecedor | Condição de Pagamento |
Tipo |
C | C | C | C |
| Tamanho | 99 | 6 | 2 | 3 |
| Decimal | 0 | 0 | 0 | 0 |
| Var01 | MV_PAR01 | MV_PAR02 | MV_PAR03 | MV_PAR04 |
| Formato | ||||
| Validação | OC542002N_ValidPerg() | ExistCpo('SA2',MV_PAR02) .and. NaoVazio() | ExistCpo("SA2",MV_PAR02+MV_PAR03) .and. NaoVazio() | ExistCpo('SE4',MV_PAR04) .and. NaoVazio() |
| Objeto | Get | Get | Get | Get |
| Consulta Padrão | VE1 | |||
| Pré-Seleção (Combo) | ||||
| Item 1 | ||||
| Item 2 | ||||
| Item 3 | ||||
| Item 4 | ||||
| Item 5 | ||||
| Help |
Grupo |
OFIA542 | OFIA542 | OFIA542 | OFIA542 |
|---|---|---|---|---|
Grupo de campo |
SC7 | SC7 | SC7 | SC7 |
Ordem |
05 | 06 | 07 | 08 |
Pergunta |
Formula Preço de Reposição | Operação TES | Ação pós-processamento | Mover Para |
Tipo |
C | C | N | C |
| Tamanho | 6 | 2 | 1 | 9 |
| Decimal | 0 | 0 | 0 | 0 |
| Var01 | MV_PAR05 | MV_PAR06 | MV_PAR07 | MV_PAR08 |
| Formato | ||||
| Validação | FG_SEEK('VEG','MV_PAR05',1,.F.).and.(VEG->VEG_GRUFOR=='04') .and. NaoVazio() | Vazio() .or. ExistCpo('SX5','DJ'+MV_PAR06) | OC542002N_ValidPerg() | OC542002N_ValidPerg() |
| Objeto | Get | Get | Combo | Get |
| 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 |
OFIA601 | OFIA601 | OFIA601 | OFIA601 |
|---|---|---|---|---|
Grupo de campo |
SC7 | SC7 | SC7 | SC7 |
Ordem |
01 | 02 | 03 | 04 |
Pergunta |
Diretório CANCBO | Grupo de Produto | Ação pós-processamento | Mover Para |
Tipo |
C | C | C | C |
| Tamanho | 99 | 4 | 1 | 99 |
| Decimal | 0 | 0 | 0 | 0 |
| Var01 | MV_PAR01 | MV_PAR02 | MV_PAR03 | MV_PAR04 |
| Formato | ||||
| Validação | OA601003F_Valid() | OA601003F_Valid() | OA601003F_Valid() | OA601003F_Valid() |
| Objeto | Get | Get | Combo | Get |
| 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 |
6. Assuntos Relacionados
DVARMIL-11121 DT DMS SCANIA - Scania Pedido Compra (OFIA540)