Manual do usuário
Central de ajuda/Manual do usuário/Valores de KPI em tempo real

Valores de KPI em tempo real

Última atualização 2026-10-16

Como os números dos cartões de KPI são calculados ao vivo: o motor em tempo real, o cache de 15 minutos, quais 25 KPIs têm valores reais (e suas fórmulas) e por que 25 mostram "ainda indisponível".

Os números dos cartões de KPI são calculados ao vivo pelo motor de KPI em tempo real — são seus dados reais, não dados demo. Cada valor traz sua fórmula (note): o que foi contado, em qual período e de qual módulo. Se um KPI não puder ser calculado com honestidade, mostra "indisponível" em vez de um número inventado.

Como os valores em tempo real são calculados#

O motor mapeia cada código de KPI para suas tabelas reais (posições, pedidos, embarques, faturas…), calcula apenas para sua organização e guarda o resultado por 15 minutos. KPIs de janela olham os últimos 30 dias por padrão; os pontuais (utilização de capacidade, recebíveis vencidos) são fotos do momento. A comparação ano a ano aparece quando existe: KPIs de janela também retornam o período anterior de igual duração (prev_value).

«Indisponível» é um recurso, não um erro. Se os dados base nunca foram registrados (p. ex., nunca se informou uma data de entrega prometida), o motor retorna vazio com o motivo — nunca inventa um número plausível nem faz dados demo passarem por reais.

25 KPIs com valores em tempo real#

  • Utilização de capacidade: posições com estoque ÷ posições ativas.
  • Tempo doca-estoque: conclusão do recebimento − chegada, em horas (proxy: timestamps).
  • Taxa de atendimento: atendidos ÷ (total − cancelados).
  • Ciclo do pedido: pedido → evento de entrega, em horas.
  • Taxa de entrega parcial: expedidos com linhas em falta ÷ expedidos.
  • Taxa de cancelamento: cancelados ÷ pedidos totais.
  • Ticket médio: valor total ÷ n.º de pedidos.
  • Entregas no prazo: POD no prazo ÷ entregas com data prometida.
  • Custo por embarque: custo total ÷ n.º de embarques.
  • Tempo de portaria: saída − entrada, em minutos.
  • Permanência no pátio: saída − entrada, em horas.
  • Taxa de devolução: devoluções ÷ expedições.
  • Principal motivo: motivo n.º 1 ÷ devoluções com motivo.
  • Recondicionados: linhas para restock ÷ linhas de devolução.
  • Ciclo de devolução: criação RMA → disposição, em dias (proxy: timestamp).
  • Densidade de paradas: paradas ÷ rotas.
  • Ciclo de compra: data PO → recebimento, em dias.
  • OTIF de fornecedor: POs no prazo e completas ÷ POs recebidas.
  • DSO: recebíveis ÷ faturamento diário médio × dias.
  • DPO: a pagar ÷ contas diárias médias × dias.
  • % vencido: recebíveis vencidos ÷ recebíveis totais.
  • Ticket médio: valor total ÷ n.º de oportunidades.
  • Eficiência: milhas (odômetro) ÷ galões.
  • Taxa de sucesso: bem-sucedidas ÷ totais.
  • Cumprimento de SLA: dentro do SLA ÷ resolvidos.

25 KPIs ainda sem valores em tempo real#

Não são erros do motor — os dados base nunca foram registrados ou o campo está vazio. Serão ativados sozinhos quando os dados existirem, sem mudar código.

  • Giro de estoque: sem dados de custo.
  • Acurácia de separação: erros nunca registrados.
  • Embarques no prazo: sem data prometida.
  • Eficiência de recebimento: sem horas-homem válidas.
  • Acurácia de pedidos: sem registros de erro.
  • Pedidos perfeitos: avaria/documentos sem dados.
  • OTIF: sem dados de entrega completa.
  • Entrega na primeira tentativa: sem registros.
  • Custo por milha: sem dados de milhas.
  • % milhas vazias: sem dados.
  • Utilização de docas: sem registros.
  • Sobrestadia: sem dados.
  • Tempo no porto: tempos vazios.
  • Custo por parada: rotas sem custo.
  • POD no prazo: sem data prometida.
  • Variação de custo: sem preço padrão.
  • Scorecard: qualidade sem dados.
  • Ciclo de caixa: precisa de COGS.
  • Margem por cliente: sem custo direto.
  • Conversão de leads: sem registros.
  • Taxa de vitória: sem negócios fechados.
  • Ciclo de vendas: sem ganhos.
  • Produtividade: sem horas válidas.
  • % horas extras: sem campo.
  • Utilização da frota: registro vazio.

Como ler a comparação#

KPIs de janela retornam prev_value — a mesma métrica do período anterior de igual duração (p. ex., os 30 dias anteriores). Os pontuais (utilização, DSO, DPO, vencidos) não têm período anterior e o omitem. Amostras pequenas aparecem: sample_size diz em quantos registros o número se baseia.