Árvore de páginas


01. DADOS GERAIS

Produto:

TOTVS DMS

Linha de Produto:

Linha Protheus

Segmento:

Varejo

Módulo:

Totvs Dms (Linha  Protheus) - Oficina (SIGAOFI)

Totvs Dms (Linha  Protheus) - Auto-Peças (SIGAPEC)

Função:Não se aplica
País:Todos Países 
Ticket:Não se aplica
Requisito/Story/Issue (informe o requisito relacionado) :DVARMIL-15473


02. SITUAÇÃO/REQUISITO

SIGAOFI / SIGAPEC
TÉCNICO

Atualmente, nas rotinas de Orçamento por Fases (OFIXA011), Painel de Orçamento (OFIXA018) e Peças da OS (OFIOM020), não é possível gerar solicitações de transferência entre filiais e sugestão de compra simultaneamente para um mesmo item. O usuário é obrigado a realizar uma operação de cada vez, o que gera retrabalho e atraso na composição do estoque.

A Dor do Usuário

Ao trabalhar com orçamentos que possuem itens com estoque insuficiente, o usuário precisa alternar entre fluxos distintos para gerar transferência e sugestão de compra separadamente, tornando o processo lento, suscetível a erros e sem visibilidade unificada das pendências de estoque.

[!] Impactos Identificados:

  • Impossibilidade de gerar transferência e compra no mesmo fluxo para um mesmo item/orçamento
  • Retrabalho operacional ao precisar acessar rotinas distintas para cada tipo de solicitação
  • Risco de inconsistência no estoque por falta de visão unificada das pendências
  • Atraso na composição de estoque impactando diretamente o atendimento das ordens de serviço
📋
Contexto Técnico:

As rotinas OFIXA011, OFIXA018 e OFIOM020 consultam o campo VS1_PRBEST para identificar orçamentos com problema de estoque. Um novo processo centralizado será criado para permitir a geração simultânea de transferência entre filiais e sugestão de compra. O funcionamento depende da habilitação dos parâmetros MV_MIL0220 = .T. e MV_MIL0181 = .T.. Os parâmetros MV_MIL0209 e MV_SUGCOS controlam a exibição das colunas de transferência e sugestão de compra respectivamente.

Tabela: VS1 Campo: VS1_PRBEST Rotina: OFIXA011 Rotina: OFIXA018 Rotina: OFIOM020 Param: MV_MIL0220 Param: MV_MIL0181 Param: MV_MIL0209 Param: MV_SUGCOS

[⚠] Comportamento Atual

  • O sistema permite apenas transferência OU sugestão de compra — nunca ambas simultaneamente
  • Itens com estoque parcial exigem dois fluxos separados para cobrir a quantidade total requisitada
  • Não há tela consolidada para distribuição das quantidades entre transferência e compra por item/orçamento

03. SOLUÇÃO

SIGAOFI / SIGAPEC

Solução Implementada

DOCUMENTAÇÃO TÉCNICA

✅ O que foi feito

Foi desenvolvido um novo processo de solicitações que permite ao usuário gerar, em uma única operação, tanto a transferência entre filiais quanto a sugestão de compra para itens com pendência de estoque. O processo está disponível nas rotinas Orçamento por Fases (OFIXA011), Painel de Orçamento (OFIXA018) e Peças da OS (OFIOM020).

Ao identificar itens com estoque insuficiente para compor a quantidade requisitada, o processo apresenta uma tela consolidada contendo todos os itens pendentes. Nessa tela, o usuário visualiza a situação de cada item e realiza a distribuição das quantidades entre as modalidades disponíveis — podendo informar quanto será atendido por transferência entre filiais e quanto será encaminhado para sugestão de compra, de forma independente e simultânea para cada item.

O processo pode ser acionado de duas formas: automaticamente, quando o sistema detecta itens sem estoque suficiente ao confirmar um orçamento ou peças da OS, exibindo uma mensagem de aviso e abrindo a tela de solicitações ao confirmar; ou manualmente, selecionando o orçamento com pendência de estoque e acionando a opção Pendências de Estoque. Ao concluir o preenchimento, as solicitações de transferência e sugestão de compra são geradas de forma simultânea, garantindo a composição do estoque necessário para atendimento do orçamento ou pedido.

Parâmetros envolvidos:
  • MV_MIL0220 = .T. — habilita o novo processo de solicitações
  • MV_MIL0181 = .T. — habilita reserva rastreavel
  • MV_MIL0209 = .T. — habilita a transferência entre filiais e exibe a coluna Qtd Aguard Trf
  • MV_SUGCOS = S — habilita a sugestão de compra e exibe a coluna Qtd Aguard Compra
⚠️
Aviso

Para o correto funcionamento dessa melhoria se faz nececessário a utilização dos parâmetros MV_MIL0181 e MV_MIL0220 habilitados simultaneamente

🚨
Atenção — Impacto da desativação dos parâmetros com MV_MIL0220 = .T.

Com o novo processo ativo, desabilitar um parâmetro não retorna ao comportamento anterior — ele bloqueia completamente aquela operação:

  • Com MV_SUGCOS = N, torna-se impossível gerar sugestão de compra — inclusive a geração manual que existia via Outras Ações nas rotinas deixa de funcionar
  • Com MV_MIL0209 = .F., torna-se impossível gerar transferência entre filiais — o campo não será apresentado no processo
  • Para utilizar apenas um dos processos, desabilite o parâmetro correspondente ao outro — o processo continuará funcionando para o que estiver ativo
  • Caso nenhum dos dois esteja ativo, recomenda-se retornar ao processo antigo desabilitando o MV_MIL0220 = .F.
⚠️
MV_FASEORC — Fase "T" e geração manual tornam-se obsoletas

Com o MV_MIL0220 = .T. ativo, a fase "T" do parâmetro MV_FASEORC e a geração manual de sugestão de compra via Outras Ações tornam-se obsoletas — o novo processo assume integralmente esse controle através dos parâmetros MV_MIL0209 e MV_SUGCOS. Ao retornar ao processo antigo (MV_MIL0220 = .F.), a fase "T" do MV_FASEORC e a geração manual via Outras Ações voltam a funcionar normalmente.

🔧 Regras de Consistência dos Parâmetros
MV_MIL0220 MV_SUGCOS MV_MIL0209 Comportamento
.T.S.T.✅ Processo completo — transferência e sugestão de compra simultâneas (Processo disponibilizado nesta documentação)
.T.S.F.⚠️ Somente sugestão de compra — transferência bloqueada
.T.N.T.⚠️ Somente transferência — sugestão de compra bloqueada
.T.N.F.❌ Nenhuma operação disponível — retornar ao processo antigo (MV_MIL0220 = .F.)
.F.↩️ Processo antigo — fase "T" do MV_FASEORC e geração manual via Outras Ações voltam a funcionar
Alterado: OFIXA011 Alterado: OFIXA018 Alterado: OFIOM020 Tabela: VS1 / Campo: VS1_PRBEST Param: MV_MIL0220 / MV_MIL0181 / MV_MIL0209 / MV_SUGCOS / MV_FASEORC
🔄

Atualização no Processo — Solicitações Simultâneas

Tema principal desta issue
OFIXA011 OFIXA018 OFIOM020
PROCESSO ANTERIOR
  • Somente era possível gerar transferência OU sugestão de compra — nunca simultaneamente
  • Para cobrir um item com estoque parcial era necessário acessar fluxos distintos para cada operação
  • Não havia tela consolidada para visualizar e distribuir as pendências de estoque por item
  • Processo suscetível a erros e sem rastreabilidade unificada das solicitações geradas
PROCESSO ATUAL
  • Transferência E sugestão de compra geradas simultaneamente em uma única operação
  • Tela consolidada exibe todos os itens pendentes com campos de distribuição entre transferência e compra
  • O sistema calcula automaticamente a quantidade pendente por item considerando reservas e solicitações em aberto
  • Fluxo unificado nas três rotinas: OFIXA011, OFIXA018 e OFIOM020
📦

Atualização no Processo — Entrega Futura

Atualização complementar para integridade das reservas
OFIXA011 OFIXA018
PROCESSO ANTERIOR
  • A Entrega Futura exige por regra uma TES que não movimenta estoque — comportamento correto
  • Por conta dessa TES, os itens não eram reservados após a geração das solicitações
  • O estoque que entrava ficava disponível para qualquer outro orçamento ou pedido consumir
  • Ao efetivar o orçamento original, o estoque podia ter sido consumido — gerando necessidade de novas solicitações e retrabalho contínuo
PROCESSO ATUAL
  • O processo passou a realizar a reserva dos itens independentemente de a TES movimentar estoque ou não no contexto de Entrega Futura
  • O estoque fica reservado para o orçamento ou pedido de origem
  • Outros orçamentos e pedidos não conseguem consumir o estoque reservado
  • A integridade dos itens é mantida do início ao fim, eliminando o ciclo de retrabalho
ℹ️

Esta atualização se aplica exclusivamente ao processo de Entrega Futura nas rotinas OFIXA011 e OFIXA018. O comportamento de reserva nos demais fluxos permanece inalterado.

Orçamento por Fases — OFIXA011

Selecione o orçamento com VS1_PRBEST = 1 e acesse via Outras Ações → Pendências de Estoque para abrir o processo de solicitações manualmente.


04. DEMAIS INFORMAÇÕES

Pacotes Gerados
12.1.2310: Clique Aqui
12.1.2410: Clique Aqui
12.1.2510: Clique Aqui

05. ASSUNTOS RELACIONADOS

  • Não há.