Fórmulas dos Validadores
Esta página cobre o Validador de dados diário e o Validador NF.
Validador de dados: valores originais
Para cada data, loja e vendedor, o GV consolida somente vendas contabilizadas:
| Campo | Fórmula original |
|---|---|
| Vendas total | Soma dos valores das movimentações. |
| Qtd. peças | Soma das peças. |
| Qtd. vendas | Contagem das movimentações de venda do agrupamento. |
Quando existe edição, o valor ajustado substitui o original nos indicadores. O original permanece armazenado para comparação e auditoria.
Status diário
| Status | Regra |
|---|---|
| Aguardando validação | Existe pelo menos uma linha ainda pendente. |
| Validado | Todas as linhas foram validadas sem diferença manual. |
| Validado com edição manual | Alguma linha difere do original ou possui ajuste manual registrado. Tem precedência sobre os demais. |
Os big numbers da página são:
Validados = total de dias/lojas - aguardando
Aguardando = quantidade de dias/lojas pendentes
Com alterações = quantidade de dias/lojas com edição manual
Percentual do card = quantidade do status / total de dias/lojas
Totais da modal diária
Total loja = soma das linhas de vendedores e de Outras vendas
- Meta 1: soma da Meta 1 diária de todos os vendedores da loja.
- Meta 1 por vendedor: valor individual quando todos são iguais; caso sejam diferentes, mostra a média
soma das metas diárias / vendedores com meta. - Peso do dia: na contingência sem meta diária,
1 / quantidade de dias da semana em que a loja abre no mês.
O bloqueio de atualização automática é uma escolha explícita na modal. Quando Bloquear atualizações automáticas está marcado, novas cargas não sobrescrevem os valores manuais daquele agrupamento. Ao desmarcar e salvar, o bloqueio fica inativo; a próxima carga do Protheus substitui os ajustes pelos valores recebidos da origem e devolve a linha ao estado aguardando validação.
Validador NF: geração da divergência
O documento é comparado com a versão já conhecida. Podem ser sinalizados vendedor ausente, valor, quantidade, vendedor, data ou loja alterados.
O big number Sem vendedor soma o valor líquido das vendas Protheus com
sellerId vazio e includedInMetrics=true. O total respeita o escopo do usuário
e os filtros de período, operação e loja. A quantidade de NFs aparece ao lado do
rótulo.
| Campo editável | Efeito |
|---|---|
| Data | Atualiza a data efetiva da venda. |
| Valor | Atualiza Vendas; valor negativo define a movimentação como devolução. |
| Peças | Atualiza a quantidade de peças. |
| Vendedor | Refaz o vínculo com um vendedor da mesma loja. |
| Contabilizar | Inclui ou exclui a NF dos indicadores executivos. |
As alterações feitas na modal ficam apenas sinalizadas na tela. A NF continua na lista e pode ser corrigida novamente até o usuário acionar Salvar alterações e confirmar o lote. O botão permanece desabilitado sem sinalizações e fica verde quando há itens prontos para salvar. Somente nessa confirmação as sinalizações são persistidas e as NFs concluídas deixam a fila pendente.
Antes da confirmação do lote, a opção Sem vendedor / vendedor padrão remove o vínculo sinalizado por engano. Nesse caso, a NF volta ao estado original sem vendedor, permanece pendente no validador e não entra nos indicadores.
Ao reconstruir o item da NF:
Preço unitário = Valor / Peças
Se Peças for zero, o preço unitário recebe o próprio Valor para evitar divisão por zero.
Status da divergência NF
- Aguardando validação: divergência aberta.
- Validada: aceita sem mudança em relação ao payload recebido e sem troca da flag de contabilização.
- Validada com edição: algum campo ou a flag foi alterado.
- Substituída: uma ocorrência mais nova tornou a anterior obsoleta.
Enquanto aguarda vínculo, a NF não compõe Dashboard, Raio-X, comparativos,
campanhas, rankings ou indicadores individuais. Seu valor aparece separadamente
como Vendas não identificadas no card de Vendas do Dashboard. Ao selecionar
um vendedor válido, ela passa automaticamente a participar dos indicadores; a
alternativa é excluí-la do fluxo pela flag Contabilizar. A ação Sincronizar
novos vendedores tenta CPF e depois Loja + Código PDV, sem alterar os
cadastros de vendedores.