Data de publicação: 12/05/2026
🎯 Objetivo
Orientar como realizar o reajuste de valores na Tabela de Preço pela rotina OMSA010 no Protheus, explicando os principais parâmetros da rotina e o comportamento do arredondamento aplicado ao novo preço. (TOTVS Developer Network)
🧩 Ambiente
Linha Microsiga Protheus – Faturamento (SIGAFAT), na rotina Tabelas de Preço (OMSA010). A página técnica consultada foi modificada em 31/01/2024. (TOTVS Developer Network)
🔎 Visão geral
A TOTVS descreve que a rotina de reajuste da OMSA010 permite aplicar um fator de multiplicação para reajustar os preços dos produtos nas tabelas selecionadas. O processo é usado para atualizar valores de tabela e pode também considerar itens como preço base e pedidos de venda em aberto, conforme a parametrização adotada. (TOTVS Developer Network)
Além disso, a documentação destaca que o comportamento do resultado depende diretamente do parâmetro Número de decimais, pois é ele que define como o sistema grava o novo valor e quando o arredondamento será aplicado. (TOTVS Developer Network)
⚙️ Como realizar o reajuste
1. Acessar a rotina de reajuste
Na rotina OMSA010, acesse a opção de reajuste da tabela de preço, visualize a mensagem do sistema e clique em Parâmetros. A partir daí, serão definidos os critérios do processamento. (TOTVS Developer Network)
2. Definir o intervalo de produtos, grupos, tipos e tabelas
A documentação orienta informar os filtros de processamento, como:
Produto Inicial e Produto Final
Grupo Inicial e Grupo Final
Tipo Inicial e Tipo Final
Tabela Inicial e Tabela Final
Esses campos determinam exatamente quais itens e quais tabelas terão os preços reajustados. (TOTVS Developer Network)
3. Informar o fator de reajuste
No campo Fator de Reajuste, deve ser informado o fator multiplicador que será aplicado ao preço atual. A TOTVS exemplifica que:
1,20 representa 20% de acréscimo
0,80 representa 20% de deságio (TOTVS Developer Network)
Na prática, o sistema multiplica o valor atual pelo fator informado para chegar ao novo preço. (TOTVS Developer Network)
4. Definir o número de decimais
No campo Número de decimais, deve ser informada a quantidade de casas decimais a considerar para gravar o novo preço. A documentação mostra que esse campo é muito importante, pois interfere diretamente no arredondamento do resultado final. (TOTVS Developer Network)
A própria TOTVS exemplifica que, se o novo valor calculado for 46,74 e o parâmetro estiver com 0 casas decimais, o valor gravado será 47,00. (TOTVS Developer Network)
5. Tratar pedidos em carteira
No campo Pedidos em Carteira, deve-se escolher entre:
Manter
Atualizar
Quando a opção Atualizar é utilizada, o sistema permite atualizar todos os pedidos de venda em aberto. (TOTVS Developer Network)
6. Definir o reaproveitamento do fator
No campo Reaplica Fator, a TOTVS informa que é possível definir entre Preço Base ou Preço Tabela. As fórmulas descritas são:
Preço base: preço base × fator de multiplicação × fator
Preço tabela: preço de venda × fator de multiplicação (TOTVS Developer Network)
7. Definir a atualização do preço base
No campo Atualiza Preço Base (produto)?, deve-se escolher entre Sim ou Não, conforme a necessidade do processo. (TOTVS Developer Network)
8. Confirmar o reajuste
Depois de conferir os parâmetros, basta confirmar o processamento. Segundo a TOTVS, o sistema reajusta as tabelas conforme a parametrização configurada. (TOTVS Developer Network)
📐 Como funciona o arredondamento
A documentação explica que o arredondamento depende da quantidade de casas decimais informadas no parâmetro Número de decimais. A regra apresentada é a usual: se o algarismo seguinte à casa decimal escolhida for maior ou igual a 5, o sistema aumenta 1 na casa decimal considerada; se for menor que 5, apenas elimina as casas excedentes. (TOTVS Developer Network)
Exemplo com arredondamento
A TOTVS usa o seguinte exemplo:
Produto: R$ 10,66
Reajuste: 56%
Fator aplicado: 1,56
Cálculo: 10,66 × 1,56 = 16,6296 (TOTVS Developer Network)
Com isso:
0 decimais → grava R$ 17
2 decimais → grava R$ 16,63
3 decimais → grava R$ 16,63 (TOTVS Developer Network)
Exemplo sem arredondamento prático nas dízimas
A mesma documentação mostra que, quando se trabalha com 4 casas decimais, pode não haver arredondamento da forma esperada para dízimas, porque não existe casa posterior suficiente para aplicar a regra. No mesmo cálculo 16,6296, o resultado é gravado como R$ 16,62 em alguns cenários demonstrados pela página. (TOTVS Developer Network)
Também são apresentados exemplos como:
1 decimal → grava R$ 16,60
4 decimais → grava R$ 16,62 (TOTVS Developer Network)
✅ Resultado esperado
Ao final do processo, o sistema reajusta os preços das tabelas conforme os filtros e parâmetros definidos, respeitando o fator informado e a lógica de arredondamento associada ao número de casas decimais configurado. (TOTVS Developer Network)
💡 Boas práticas
validar o intervalo de produtos e tabelas antes de confirmar o reajuste;
revisar o fator de reajuste para evitar aplicação incorreta de acréscimo ou deságio;
testar previamente o efeito do campo Número de decimais, principalmente quando houver exigência comercial de arredondamento específico;
avaliar com cuidado a opção Pedidos em Carteira, pois ela pode atualizar pedidos de venda em aberto;
revisar se o reajuste deve atuar sobre Preço Base ou Preço Tabela antes da confirmação. (TOTVS Developer Network)
❓ FAQ
1. A rotina OMSA010 permite reajustar preços automaticamente?
Sim. A TOTVS informa que a rotina aplica um fator de multiplicação para reajustar os preços dos produtos nas tabelas indicadas na parametrização. (TOTVS Developer Network)
2. Como informar 20% de acréscimo?
Deve-se informar o fator 1,20. (TOTVS Developer Network)
3. Como informar 20% de deságio?
Deve-se informar o fator 0,80. (TOTVS Developer Network)
4. O número de decimais interfere no valor final?
Sim. Ele define quantas casas decimais serão gravadas e controla o arredondamento aplicado ao valor reajustado. (TOTVS Developer Network)
5. É possível atualizar pedidos em aberto?
Sim. No campo Pedidos em Carteira, a opção Atualizar permite atualizar todos os pedidos de venda em aberto. (TOTVS Developer Network)
6. Posso reaplicar o fator sobre preço base ou preço tabela?
Sim. A documentação informa que o campo Reaplica Fator permite escolher entre Preço Base e Preço Tabela. (TOTVS Developer Network)
👤 Autor
Fabrizio Augusto Ventavolo
Consultor Especialista TOTVS — Mastersiga Consultoria
“Conectamos tecnologia, processos e pessoas para acelerar resultados com excelência em sistemas TOTVS.”