Controlar o flex dos vendedores no Mestre e enviar o saldo ao Apogeus
19 min
Criado por Felipe Mateus Hoffmann em 28/10/2026 15:53
Atualizado por Felipe Mateus Hoffmann em 28/10/2026 15:55
PEDIDOS · FLEX DOS VENDEDORES · APOGEUS
Controlar o flex dos vendedores no Mestre e enviar o saldo ao Apogeus

O flex é o saldo do vendedor que sobe com os acréscimos e desce com os descontos dados nos pedidos. No Mestre, esse saldo passa a ser contínuo: não zera no fim do mês, pode ficar negativo e fica registrado num extrato por vendedor. A cada envio, a Integração Apogeus leva ao aparelho do vendedor o saldo atual calculado pelo Mestre e a informação de bloqueio.

Resumo

Ligue o controle em Parâmetros > Pedidos 2 > Flex dos vendedores, informe a data de início e o tipo de cálculo. Na tela Pedidos - Flex dos vendedores (menu Vendas), lance o saldo inicial de cada vendedor: o Mestre recalcula o flex dele com todos os pedidos desde a data de início. Depois disso, cada pedido gravado ou alterado atualiza o saldo sozinho. Ajustes manuais, bloqueio e conferência ficam na mesma tela e no relatório Flex dos Vendedores - Extrato e Resumo.

Saldo inicial uma vez só, lançamentos sem edição

O saldo inicial é lançado uma única vez por vendedor e refaz o extrato dele a partir da data de início. Nenhum lançamento é editado ou excluído: um valor errado é corrigido com um ajuste contrário. Confira a data de início e o tipo de cálculo antes de lançar os saldos iniciais.

Visão rápida

  • O flex é calculado pelo Mestre, por pedido, e atualizado a cada item gravado ou alterado, inclusive nos pedidos que chegam do Apogeus.
  • O saldo é por vendedor e por empresa, e só os pedidos com data a partir do Início do controle entram na conta.
  • A ferramenta Integração Apogeus envia o saldo atual de cada vendedor, que substitui o saldo do aparelho no envio seguinte.
  • O botão Bloquear Flex bloqueia a utilização do flex do vendedor no Apogeus a partir do próximo envio.
EtapaQuem executaResultado esperado
Atualizar o Mestre e a ferramenta Integração ApogeusSuporte MestreGrupo "Flex dos vendedores" nos Parâmetros e tela "Pedidos - Flex dos vendedores" no menu Vendas
Configurar os parâmetrosSuporte com o administradorControle ligado, início do controle e cálculo do flex definidos
Lançar o saldo inicial de cada vendedorAdministrador do flexExtrato começando pelo saldo inicial, seguido dos pedidos desde a data de início
Conferir na tela e no relatórioAdministrador do flexSaldos iguais na tela e no relatório
Enviar ao ApogeusQuem opera a Integração ApogeusAparelhos com o saldo do Mestre e o bloqueio de cada vendedor

1. Entender o flex contínuo

O flex é um saldo do vendedor: o acréscimo dado num pedido aumenta o saldo e o desconto diminui. Nesse controle, o saldo não volta a zero na virada do mês. Cada linha do extrato traz o valor do movimento e o saldo do vendedor depois dele, e o saldo pode ficar negativo.

O extrato tem três origens de movimento:

  • Saldo inicial: o flex que o vendedor já tinha acumulado antes do início do controle.
  • Pedido: lançado automaticamente pelo Mestre, com a observação "Pedido" seguida do número.
  • Ajuste manual: valores positivos ou negativos lançados pelo administrador, sempre com motivo (por exemplo, verba de fim de ano ou mercadoria vencida).

2. Saber como o Mestre calcula o flex do pedido

O flex é apurado por pedido e lançado no vendedor do pedido. Só entram pedidos que atendem a todas as condições abaixo; nos demais, o flex do pedido é zero.

  • O controle está ligado na empresa do pedido.
  • É do tipo pedido (orçamentos e outros tipos não entram).
  • Não está cancelado nem perdido.
  • A data do pedido é igual ou posterior ao Início do controle.
  • O pedido tem vendedor.

Dentro do pedido, cada item conta assim (itens cancelados ficam de fora):

ItemFlex do item
VendaValor vendido − valor de tabela. O valor vendido já inclui a parte do desconto ou do acréscimo dado no total do pedido (rateio). O valor de tabela é a quantidade × o preço original do item.
Bonificação (brinde), remessa de amostra grátis e material promocionalTira do flex o valor de tabela inteiro do item.
Demais operações (devolução, troca, consignada etc.)Não entram no flex.

Nos itens de venda, o parâmetro Cálculo do flex define qual desconto conta:

Cálculo do flexComo contaExemplo (tabela 100,00, máximo de 10%)
Qualquer descontoTodo desconto tira do flex e todo acréscimo soma.Vendido a 95,00: −5,00. Vendido a 102,00: +2,00.
Somente desconto acima do máximoDesconto dentro do máximo é neutro (não mexe no flex). Só o que passar do máximo tira do flex. Acréscimo soma.Vendido a 95,00: 0,00. Vendido a 85,00: −5,00. Vendido a 103,00: +3,00.

No modo "Somente desconto acima do máximo", o desconto máximo de cada item é procurado nesta ordem, e vale o primeiro preenchido:

1Produto: "% Máximo de desconto" do cadastro do produto, quando o desconto do produto está ativo e dentro da vigência.
2Família: "% Desc. máximo" da família do produto.
3Parâmetros de Pedidos: "Desc. máximo permitido".

O flex do pedido é refeito sempre que um item é incluído, alterado ou excluído e sempre que mudam a situação, o vendedor ou a data do pedido. Isso vale para pedidos digitados no escritório, na Tela de Venda e para os pedidos que chegam do Apogeus. O Mestre lança só a diferença: se o último movimento do vendedor for do mesmo pedido, ele é atualizado; senão, entra uma linha nova. Pedido cancelado ou excluído é estornado, e trocar o vendedor tira o flex de um e lança no outro.

3. Ligar o controle nos parâmetros

Os parâmetros são por empresa. Acesse Parâmetros > guia Pedidos 2; o grupo Flex dos vendedores fica no fim da página.

1Marque Controlar o flex dos vendedores. Com ele marcado, o desconto e o acréscimo dados nos pedidos passam a formar o saldo de flex do vendedor. Enquanto estiver desmarcado, os dois campos abaixo ficam desabilitados.
2Informe o Início do controle: só os pedidos com data a partir desse dia alteram o flex do vendedor. Use a data a partir da qual o saldo inicial deixa de valer, para não contar o mesmo pedido duas vezes.
3Escolha o Cálculo do flex: "Qualquer desconto" ou "Somente desconto acima do máximo" (seção 2).
4Grave. Com o controle marcado, o Mestre exige a data e o cálculo: "Informe o início do controle do flex dos vendedores." ou "Informe o cálculo do flex dos vendedores.".
Desligar não apaga nada

Desmarcar o controle não apaga nem estorna os movimentos já lançados: os pedidos apenas deixam de alterar o flex. Ao religar, o pedido alterado é acertado pela diferença em relação ao que já estava lançado. Trocar o cálculo do flex também não refaz pedidos antigos; eles só mudam quando forem alterados de novo.

4. Acompanhar na tela Pedidos - Flex dos vendedores

Acesse o menu Vendas > Pedidos - Flex dos vendedores. A tela trabalha sempre com a empresa logada. Se o controle estiver desligado, ela abre com um aviso de que os pedidos não alteram o flex até que ele seja ligado.

  • Filtros (grupo recolhível): Situação do cadastro do vendedor, com marcação múltipla (nenhuma marcada = todas); Extrato de e Até, que já abrem do início do mês até hoje; e Ocultar vendedores não exportados para o Apogeus. Os filtros podem ser renomeados pelo botão Propriedades ou pelo clique direito.
  • Vendedores: código, vendedor, saldo, último movimento, situação (Bloqueado ou Liberado) e coluna Apogeus (Exportado ou Não exportado). Vendedor com código acima de 999 aparece como "Não exportado", porque não vai para o Apogeus. O duplo clique abre o cadastro do vendedor.
  • Extrato do vendedor: primeiro a linha Saldo anterior (saldo antes do período), depois cada movimento com data, origem, pedido, observação, valor e saldo. O duplo clique numa linha de pedido abre o pedido.
  • Pesquisar (ou F5) recarrega os saldos e o extrato.

5. Lançar o saldo inicial e os ajustes

O mesmo botão faz os dois lançamentos: ele mostra Saldo inicial enquanto o vendedor selecionado ainda não tem saldo inicial e passa a mostrar Novo ajuste depois disso.

1Selecione o vendedor e clique em Saldo inicial. Informe o Valor (negativo para débito; 0 é aceito para quem começa zerado) e o Motivo, que é obrigatório.
2Confirme a mensagem: o flex do vendedor será recalculado considerando o saldo inicial informado e todos os pedidos realizados a partir da data de início. O extrato anterior desse vendedor é refeito: passa a começar pelo saldo inicial, seguido de uma linha por pedido com flex.
3Para lançamentos posteriores, use Novo ajuste: valor positivo (crédito) ou negativo (débito), diferente de zero, com motivo obrigatório. Ajuste só é aceito depois do saldo inicial.
Como saber que ficou certo

O botão do vendedor passa a mostrar "Novo ajuste", o extrato começa pela linha "Saldo inicial" e o saldo da grade de vendedores é igual ao saldo da última linha do extrato. Um segundo saldo inicial para o mesmo vendedor é recusado com "O saldo inicial do vendedor já foi informado.".

6. Bloquear e desbloquear o flex do vendedor

Selecione o vendedor e clique em Bloquear Flex. Depois da confirmação, a situação dele passa a Bloqueado e o botão muda para Desbloquear Flex. O bloqueio não altera o saldo: ele bloqueia a utilização do flex no Apogeus e vale a partir do próximo envio da Integração Apogeus. O que o aparelho permite ou recusa com o flex bloqueado segue as regras do próprio Apogeus.

7. Enviar o saldo ao Apogeus

A cada envio, a ferramenta Integração Apogeus manda, por vendedor e filial, o saldo atual do Mestre, que substitui o saldo que está no aparelho, e a informação de bloqueio. O controle não é mais ligado na ferramenta: o antigo checkbox Controla flex saiu, e a ferramenta segue o parâmetro Controlar o flex dos vendedores de cada empresa. Vendedores com código acima de 999 não são exportados.

Nota para o suporte: onde está a ferramenta atualizada

Caminho interno da Mestre, de onde o suporte copia a versão da Integração Apogeus compatível com o flex contínuo:

\\servidor\Publico\9 0 SUPORTE\Ferramentas\Integração Apogeus\Jadel\9.0

8. Conferir no relatório

O relatório do usuário Flex dos Vendedores - Extrato e Resumo serve para conferência. Filtros: Data de, Data até, Filial e Somente resumo. O extrato agrupa por vendedor e filial, com o saldo anterior ao período, os movimentos e o saldo corrente; o resumo mostra o saldo atual e se o vendedor está bloqueado. Os saldos do resumo devem bater com a grade de vendedores da tela.

9. Implantar no cliente, passo a passo

1Atualize o Mestre e a ferramenta Integração Apogeus (seção 7).
2Configure os parâmetros da empresa: controle ligado, início do controle e cálculo do flex (seção 3).
3Lance o saldo inicial de cada vendedor, mesmo dos que começam com 0 (seção 5).
4Confira os saldos na tela e no relatório (seções 4 e 8) e bloqueie quem precisar (seção 6).
5Faça o envio pela Integração Apogeus e confira com os vendedores que o saldo do aparelho é o mesmo do Mestre.
Como o Mestre faz

O próprio banco de dados do Mestre recalcula o flex do pedido sempre que um item do pedido é gravado, alterado ou excluído e sempre que mudam a situação, o vendedor, a empresa, a data ou o tipo do pedido, seja qual for a tela ou a integração que gravou. O lançamento do saldo inicial apaga os movimentos anteriores do vendedor na empresa, grava o saldo inicial e recalcula, em ordem de data, cada pedido dele desde o início do controle. Com o controle desligado, nada é lançado nem estornado. A Integração Apogeus lê, para cada vendedor, o último saldo do extrato e o bloqueio; não há cálculo de flex na ferramenta.

Checklist de conferência

  • "Controlar o flex dos vendedores" marcado, com "Início do controle" e "Cálculo do flex" preenchidos na empresa certa.
  • Todos os vendedores exportados com saldo inicial lançado (o botão mostra "Novo ajuste").
  • Nenhum vendedor que usa o Palm com "Não exportado" na coluna Apogeus.
  • Saldos da tela iguais aos do resumo do relatório "Flex dos Vendedores - Extrato e Resumo".
  • Vendedores que devem ficar sem flex com a situação "Bloqueado".
  • Ferramenta Integração Apogeus atualizada e envio feito depois dos lançamentos.
Erros comuns e como evitar
  • Vendedor não aparece no Palm: o código dele é maior que 999 e não é exportado ao Apogeus. Confira a coluna Apogeus da tela.
  • "Informe o saldo inicial do vendedor antes de lançar ajustes.": lance primeiro o saldo inicial do vendedor.
  • Saldo inicial recusado por controle desligado ou data inválida: ligue o controle e informe o início do controle nos parâmetros da empresa logada.
  • Pedidos não mexem no flex: o controle está desligado, o pedido é de data anterior ao início, não é do tipo pedido, está cancelado ou perdido, ou não tem vendedor.
  • Saldo do aparelho diferente do Mestre: o aparelho só recebe o saldo novo no próximo envio da Integração Apogeus.
  • Lançamento errado: não há edição nem exclusão; lance um ajuste com o valor contrário e o motivo da correção.
  • Botões Saldo inicial, Novo ajuste ou Bloquear Flex desabilitados: o usuário não tem permissão de inclusão ou alteração na tela "Pedidos - Flex dos vendedores".

Fontes

  • Fonte da tela "Pedidos - Flex dos vendedores" e do grupo "Flex dos vendedores" da tela de Parâmetros (guia Pedidos 2).
  • Rotinas de banco do Mestre que lançam o flex do pedido, o saldo inicial, os ajustes e o bloqueio.
  • Fonte da exportação da ferramenta Integração Apogeus (saldo e bloqueio do vendedor).
  • Plano, especificação e roteiro de teste do flex contínuo (ticket 150441).
  • Orientação do Apogeus sobre o funcionamento do flex no aparelho.
Fluxo em uma linha

Ligar o controle nos Parâmetros → lançar o saldo inicial de cada vendedor → pedidos atualizam o flex sozinhos → ajustar e bloquear na tela → conferir no relatório → enviar ao Apogeus.

Revisão: 28/10/2026 — ticket 150441 (flex contínuo dos vendedores). Parâmetros, tela, cálculo do flex por pedido, saldo inicial, ajustes, bloqueio e exportação da Integração Apogeus conferidos no fonte. Comportamento do bloqueio no aparelho depende das regras do Apogeus.

Este artigo foi útil para você?
Últimos artigos visitados