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.
| Etapa | Quem executa | Resultado esperado |
|---|
| Atualizar o Mestre e a ferramenta Integração Apogeus | Suporte Mestre | Grupo "Flex dos vendedores" nos Parâmetros e tela "Pedidos - Flex dos vendedores" no menu Vendas | | Configurar os parâmetros | Suporte com o administrador | Controle ligado, início do controle e cálculo do flex definidos | | Lançar o saldo inicial de cada vendedor | Administrador do flex | Extrato começando pelo saldo inicial, seguido dos pedidos desde a data de início | | Conferir na tela e no relatório | Administrador do flex | Saldos iguais na tela e no relatório | | Enviar ao Apogeus | Quem opera a Integração Apogeus | Aparelhos com o saldo do Mestre e o bloqueio de cada vendedor |
1. Entender o flex contínuoO 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 pedidoO 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): | Item | Flex do item |
|---|
| Venda | Valor 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 promocional | Tira 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 flex | Como conta | Exemplo (tabela 100,00, máximo de 10%) |
|---|
| Qualquer desconto | Todo 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áximo | Desconto 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: | 1 | Produto: "% Máximo de desconto" do cadastro do produto, quando o desconto do produto está ativo e dentro da vigência. | | 2 | Família: "% Desc. máximo" da família do produto. | | 3 | Parâ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âmetrosOs parâmetros são por empresa. Acesse Parâmetros > guia Pedidos 2; o grupo Flex dos vendedores fica no fim da página. | 1 | Marque 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. | | 2 | Informe 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. | | 3 | Escolha o Cálculo do flex: "Qualquer desconto" ou "Somente desconto acima do máximo" (seção 2). | | 4 | Grave. 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 vendedoresAcesse 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 ajustesO 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. | 1 | Selecione 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. | | 2 | Confirme 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. | | 3 | Para 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 vendedorSelecione 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 ApogeusA 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órioO 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| 1 | Atualize o Mestre e a ferramenta Integração Apogeus (seção 7). | | 2 | Configure os parâmetros da empresa: controle ligado, início do controle e cálculo do flex (seção 3). | | 3 | Lance o saldo inicial de cada vendedor, mesmo dos que começam com 0 (seção 5). | | 4 | Confira os saldos na tela e no relatório (seções 4 e 8) e bloqueie quem precisar (seção 6). | | 5 | Faç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. |