Deck of Cards

id	1,2,3,4,5

Card

id	1
label	Scania Pedido Compra (OFIA540)

Scania Pedido Compra (OFIA540)

...

1. Identificação da Rotina

Nome da Rotina	Scania Pedido

...

Módulo ERP
Compra
Programa	OFIA540

...

Oficina (

...

SIGAOFI)
Acesso à Rotina	Atualizações/

...

Data da Documentação (
Mov. Pedido Scania/Scania Pedido Compra (OFIA540)

...

Última Atualização)	12/01/

...

2026

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/

...

tabs

Totvs custom tabs box

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

...

Passo a passo

ids

passo

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

Acesse o Módulo

2

14 (

Compras

Oficina).
Acesse o menu

Atualizações →

Pedidos

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

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

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

Multimedia

name

PEDIDODECOMPRA2

OFIA540.mp4
width	1280
height	720

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_MIL0006obrigatoriamente e o MV_PEDANO quando aplicável.

Card

id	2
label	Importar_Pedido Peças (OFIA542)

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)	12/01/2026

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.

Multimedia

name	OFIA542.mp4
width	1280
height	720

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.

Card

id	3
label	Eliminar Resíduos BO (OFIA601)

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)	12/01/2026

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.

Multimedia

name	OFIA601.mp4
width	1280
height	720

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.

Card

id	4
label	Atualização de Dicionário/Menu

Totvs custom tabs box items

default	no
referencia	passo2

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)

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.

Árvore de páginas

Versões comparadas

Versão antiga 6

Nova versão Atual

Chave

Scania Pedido Compra (OFIA540)

1. Identificação da Rotina

2. Descrição Funcional

3. Pré-requisitos e Configurações

4. Fluxo de Utilização

5. Integrações e Dependências

Importar_Pedido Peças (OFIA542)

1. Identificação da Rotina

2. Descrição Funcional

3. Pré-requisitos e Configurações

4. Fluxo de Utilização

5. Integrações e Dependências

Eliminar Resíduos BO (OFIA601)

1. Identificação da Rotina

2. Descrição Funcional

3. Pré-requisitos e Configurações

4. Fluxo de Utilização

5. Integrações e Dependências

6. Assuntos Relacionados

6. Assuntos Relacionados

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 6

Nova versão Atual

Chave

Scania Pedido Compra (OFIA540)

1. Identificação da Rotina

2. Descrição Funcional

3. Pré-requisitos e Configurações

4. Fluxo de Utilização

5. Integrações e Dependências

Importar_Pedido Peças (OFIA542)

1. Identificação da Rotina

2. Descrição Funcional

3. Pré-requisitos e Configurações

4. Fluxo de Utilização

5. Integrações e Dependências

Eliminar Resíduos BO (OFIA601)

1. Identificação da Rotina

2. Descrição Funcional

3. Pré-requisitos e Configurações

4. Fluxo de Utilização

5. Integrações e Dependências

6. Assuntos Relacionados

6. Assuntos Relacionados