Linha Microsiga Protheus

Árvore de páginas

Versões comparadas

Versão antiga 1

changes.mady.by.user Alisson Rafael de Lima

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Alisson Rafael de Lima

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Rotinas

...

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

...

Configurações Scania (

...

OFIA541)

Contratos Scania (OFIA600)

Opções de menu

Oficina → Atualizações → Configurações Scania

Oficina → Atualizações → Contratos Scania

Módulos
Oficina(SIGAOFI)
Objetivo

...

Implementação de novas configurações de integração com a Scania na tela Configurações Scania (OFIA541), aba Consulta Contrato ARMS.




Deck of Cards
id1,2,3,4,5



Card
id1
labelScania Pedido Compra (OFIA540)

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)

08/2025 


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 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/26) 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 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 de Peças Protheus (SPPED).

      • Acessar Outras Opções → Importar Pedido de Peças Protheus (ESPPED).

      • 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 de Peças Canceladas (CANCBO).

      • Acessar Outras Opções → Eliminar Resíduos de Peças Canceladas (CANCBO).

      • Preencher o Pergunte correspondente e confirmar para iniciar o processamento.

Multimedia
nameOFIA540.mp4
width1280
height720


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 Importação SPPED (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.

Card
id2
labelImportação ESPPED(OFIA542)

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.

Multimedia
nameIMPESPPED.mp4
width1280
height720


5. Integrações e Dependências


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

Card
id3
labelCancelamento de Pedido SCRM(OFIA601)

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:
    • 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
nameCANCBOVIDEOO.mp4
width1280
height720


5. Integrações e Dependências

Durante a execução da rotina Cancelamento de Pedido SCRM (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). 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.

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

Cadastros Oficina

Nome da Rotina

Scania Pedido Compra

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

Cadastros Oficina

Nome da Rotina

Cancelamento de Pedido SCRM 

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





...