Controle de Saldo de Bonificação
Este artigo tem como objetivo explicar o Controle de Saldo de Bonificação por vendedor do Demander.
Abaixo você encontrará informações sobre:
- Sobre o Controle de Saldo de Bonificação
- Como funciona
- Como configurar no Demander Web
- Consulta e validação no App Demander
- Comportamento de bloqueio
- Cenários de exemplo
- Dúvidas frequentes
Sobre o Controle de Saldo de Bonificação
Seção intitulada “Sobre o Controle de Saldo de Bonificação”O Controle de Saldo de Bonificação permite limitar o quanto cada vendedor pode utilizar em pedidos de bonificação, comparando o saldo enviado pelo ERP com o saldo já comprometido em pedidos existentes.
Com essa funcionalidade é possível definir quais tipos de pedido consomem saldo de bonificação e quais status de pedido abatem esse saldo, garantindo que o vendedor não ultrapasse o valor disponibilizado.
Os principais conceitos utilizados são:
- Saldo Bonificação do ERP: valor de bonificação liberado para o vendedor, recebido do ERP.
- Saldo reservado: somatório dos pedidos do vendedor que tenham um Tipo de Pedido que consome saldo de bonificação e um Status de Pedido que abate saldo de Bonificação.
- Saldo disponível: resultado do Saldo Bonificação do ERP menos o saldo reservado.
Como funciona
Seção intitulada “Como funciona”- O saldo oficial de bonificação de cada vendedor e, opcionalmente, um conteúdo HTML informativo para exibição no pedido, pode ser cadastrado no Demander Web ou recebido por integração.
- No cadastro de Tipo de Pedido é definido quais tipos de pedido consomem saldo.
- No cadastro de Status de Pedido, é possível definir quais status abatem saldo. Exemplo: quando o pedido entrar no status “Faturado”, ele passa a compor o cálculo do saldo de bonificação.
- Ao montar ou salvar um pedido, o App calcula o saldo reservado somando o Valor total do pedido de todos os pedidos do mesmo vendedor cujo tipo consome saldo e cujo status abate saldo — desconsiderando pedidos cancelados ou que mudaram de status.
- O saldo disponível é obtido subtraindo o saldo reservado do saldo oficial do ERP.
- O cálculo e a validação sempre consideram o vendedor selecionado no pedido(codVendedor).
O saldo reservado não é armazenado — ele é sempre calculado a partir dos pedidos do vendedor, segundo a fórmula:
saldoDisponivel = saldoBonificacaoERP - saldoReservado
Como configurar no Demander Web
Seção intitulada “Como configurar no Demander Web”-
- No cadastro de Tipo de Pedido, ative a opção Consome saldo de bonificação nos tipos que devem descontar o saldo do vendedor.
-
- No cadastro de Status, ative a opção Abate saldo de bonificação nos status que devem comprometer o saldo (compor o saldo reservado).
-
- O saldo oficial de bonificação de cada vendedor é integrado pelo ERP e disponibilizado no cadastro do vendedor.
-
- Opcionalmente, informe o conteúdo HTML informativo do vendedor, que será exibido na consulta de saldo dentro do pedido.
-
- Sincronize os dados para que as configurações e o saldo cheguem ao App Demander.

Consulta e validação no App Demander
Seção intitulada “Consulta e validação no App Demander”- Quando o tipo de pedido selecionado consome saldo de bonificação, é exibido um ícone no seletor de tipo de pedido que dá acesso ao resumo do saldo.
- O resumo do saldo de bonificação apresenta os pedidos que consumiram saldo, o saldo do ERP, o saldo reservado, o saldo disponível e o conteúdo HTML informativo do vendedor, quando existir.
- O ícone e a consulta ficam disponíveis apenas para tipos de pedido que consomem saldo de bonificação.
- A validação do saldo ocorre no momento de salvar o pedido.



Comportamento de bloqueio
Seção intitulada “Comportamento de bloqueio”- Quando o tipo de pedido consome saldo de bonificação e o valor do pedido ultrapassa o saldo disponível, o App bloqueia o salvamento.
- A mensagem de bloqueio informa ao usuário o saldo oficial do ERP, o saldo reservado e o saldo disponível no momento.
- Pedidos cujo tipo não consome saldo de bonificação seguem o fluxo normal, sem qualquer validação ou bloqueio.

Cenários de exemplo
Seção intitulada “Cenários de exemplo”- Cenário 1: Vendedor com saldo oficial de R$ 1.000,00 e saldo reservado de R$ 900,00 em pedidos existentes. O saldo disponível é de R$ 100,00 — um novo pedido de bonificação de até R$ 100,00 é permitido; acima disso, o salvamento é bloqueado.
- Cenário 2: Pedido cujo tipo não possui Consome saldo de bonificação ativo. O pedido não entra no cálculo do saldo reservado e não sofre validação de bloqueio.
- Cenário 3: Gerente ou Preposto montando pedido para um vendedor selecionado. O cálculo e a listagem de pedidos consideram o vendedor do pedido (codVendedor), e não o usuário logado.
Dúvidas frequentes
Seção intitulada “Dúvidas frequentes”Como o saldo reservado é calculado?
- Somando o valor total dos pedidos do vendedor cujo tipo consome saldo de bonificação e cujo status abate saldo, desconsiderando pedidos cancelados. Veja mais detalhes em Como funciona.
Qual vendedor é considerado em cenários de Gerente ou Preposto?
- Sempre o vendedor do pedido (o vendedor selecionado), independentemente de quem está montando o pedido.
O que acontece quando o valor do pedido ultrapassa o saldo disponível?
- O App bloqueia o salvamento e exibe uma mensagem com o saldo oficial do ERP, o saldo reservado e o saldo disponível no momento.