Manual do Usuário

Guia de uso do Sistema de KPIs Petiskeira. Não é preciso instalar nada — o sistema funciona pelo navegador, no computador ou no celular.

Endereço: https://kpi.petiskeira.com.br

Voltar ao README · Dúvidas de cálculo: Regras de Negócio

Sumário#

• Primeiros passos
• O que cada perfil enxerga
• Dashboard
• Lançar Metas
• Lançar Resultados
• Metas + Resultados (admin)
• Meus Resultados
• O botão de ajuda
• Valores ocultos na tela
• Minha Unidade
• Sincronização RH
• Indicadores
• Por colaborador
• Usuários (admin)
• Relatórios
• Fechamento de Folha
• Valoriza
• Auditoria (admin)
• Perguntas frequentes

Primeiros passos#

Entrar#

Acesse https://kpi.petiskeira.com.br. A tela oferece até dois caminhos:

Entrar com Petiskeira (recomendado) — leva ao Gestor de Autenticação da empresa, que confirma quem você é pelo reconhecimento facial. Não é preciso digitar senha, e quem já entrou em outro sistema da Petiskeira no mesmo dia costuma nem precisar se identificar de novo.

E-mail ou CPF + senha — o login tradicional, que segue disponível. Na primeira vez o sistema pede a troca de senha, com no mínimo 10 caracteres.

Se aparecer "Você não tem acesso a este sistema", significa que o gestor confirmou sua identidade, mas você ainda não está cadastrado no KPI. Fale com o administrador.

Ajustes de tela#

No topo da barra lateral você pode:

• alternar entre tema claro e escuro (ícone de sol/lua);
• aumentar ou diminuir o tamanho da fonte (− e +).

Sair#

Clique no ícone ↩ ao lado do seu nome. Por segurança, a sessão expira sozinha após 12 horas — quando isso acontece, o sistema leva você de volta ao login avisando que a sessão expirou. É só entrar de novo; nada do que foi salvo se perde.

O que cada perfil enxerga#

O administrador pode ajustar as permissões por usuário — então o seu menu pode ter mais ou menos itens que o descrito acima.

Responsável de unidade não é um perfil à parte: é quem foi marcado como responsável no cadastro de uma loja. Quem está marcado ganha a tela Minha Unidade, com a apuração de cada colaborador daquela loja. Uma loja pode ter vários responsáveis, e a mesma pessoa pode responder por mais de uma.

Dashboard#

Visão geral do mês: número de indicadores, atingimento médio e gráficos por loja. Serve para enxergar rapidamente onde estão os pontos de atenção.

Lançar Metas#

🗓️ Prazo: as metas do mês ficam abertas até o dia 5 do próprio mês.

1. Escolha a loja e confira o mês/ano.
2. Preencha a coluna Meta do mês para cada indicador.
3. Clique em Salvar.

A barra no topo mostra quantos indicadores já foram preenchidos. Os indicadores aparecem agrupados por gestor — clique no título do grupo para recolher ou expandir.

Zero é um valor válido. Se a meta é não ter nenhuma ocorrência, digite 0 — o sistema entende e calcula corretamente.

Passado o prazo, a tela fica bloqueada. Supervisores e administradores veem um botão Reabrir para edição para correções pontuais.

Lançar Resultados#

🗓️ Prazo: os resultados de um mês abrem no mês seguinte e vão até o dia 5. Exemplo: os resultados de julho são lançados em agosto, até 05/08.

1. Escolha a loja e o período apurado.
2. Preencha a coluna Realizado.
3. Clique em Salvar.

A coluna Ating. calcula na hora e usa cores:

Forçar um lançamento#

Quando for necessário registrar um valor fora do fluxo normal, marque Forçar e escreva o motivo — o sistema não salva sem justificativa. Lançamentos forçados ficam destacados na tela e registrados na auditoria.

Um resultado forçado paga como 100%: o indicador é tratado como atingido exatamente — sem consolação, sem superação — e o atingimento mostra 100% com a marca forçado. O valor que você digitou continua registrado e visível; o que explica o pagamento é o seu motivo.

Metas + Resultados (admin)#

Aba que mostra meta e resultado lado a lado, ambos editáveis e sem trava de prazo. Foi feita para correções e carga de dados de meses anteriores.

Tem um campo Forçar meta independente do "Forçar" do resultado, cada um com sua justificativa. Tudo continua sendo registrado na auditoria.

Meus Resultados#

Tela do colaborador. Mostra, para o mês escolhido:

• Composição salarial, incluindo a Possibilidade (o quanto pode receber de variável);
• Indicadores atingidos — quantos bateram a meta, ex.: 3 de 5;
• Remuneração variável conquistada;
• a tabela de competências, indicador a indicador, com meta, realizado, atingimento e peso

— marcando quando houve consolação ou superação;

• o Anual Acumulado: como foi cada mês do ano até o mês escolhido.

A tabela de competências não traz valores em R$ linha a linha. Dinheiro por indicador desvia a atenção do que dá para fazer; o que interessa ali é meta contra realizado. O total da remuneração continua nos cards de resumo e na barra logo abaixo da tabela.

Anual Acumulado#

Substitui a antiga janela de 6 meses. Mostra cada mês do ano até o mês escolhido, com:

• quantos meses já foram lançados, o atingimento médio e quantos meses fecharam em 100% ou

mais;

• um quadradinho por mês — clique para abrir aquele mês;
• um gráfico com o atingimento e duas barras: Possibilidade (o teto do mês) e

Recebido. A diferença entre as duas é o que ficou na mesa;

• o acumulado do ano: quanto recebeu de quanto era possível.

Mês sem lançamento aparece como — / sem lançamento e vira uma lacuna no gráfico — não entra na média nem no total possível.

Conferir a apuração antes do pagamento#

Quando a folha da sua loja é fechada, aparece um aviso no topo com o valor apurado e dois botões:

• ✓ Estou de acordo — registra que você conferiu;
• ⚠ Contestar — você aponta qual indicador está errado e explica o motivo.

A resposta fica registrada com data e hora, e pode ser alterada enquanto a folha não for paga. Contestar não atrasa o pagamento — a gestão é avisada e responde.

Toda contestação recebe uma resposta da gestão: deferida (a alegação procede) ou indeferida, sempre com o motivo. Alegação, decisão e justificativa saem no espelho da operação, o documento que acompanha o pagamento.

Se o responsável da sua loja contestar por você, aparece um aviso aqui com o que ele apontou — mesmo que você já tenha registrado que estava de acordo.

O botão de ajuda#

O ? no alto da barra esquerda abre a ajuda da tela em que você está — o que fazer ali, os prazos e os erros comuns daquela tela. Dentro dele, Manual completo abre esta documentação inteira numa aba nova.

Valores ocultos na tela#

Os valores de pagamento — possibilidade, a receber, superação, ajustes e totais — aparecem como R$ •••• assim que você entra. É proposital: o sistema costuma ser aberto no balcão da loja, e remuneração de colega não é assunto para quem está atrás de você.

Para ver, desmarque Ocultar valores na tela, na barra da esquerda, logo abaixo do controle de fonte. Marque de novo quando terminar — e, de qualquer forma, no próximo acesso volta a ficar oculto, mesmo que você tenha deixado desmarcado.

Isso é só a tela: os PDFs, o CSV e o arquivo do banco saem sempre com os valores, porque são documentos que você decidiu gerar.

Minha Unidade#

Tela de quem responde por uma loja. Ela só aparece para quem está marcado como responsável no cadastro da loja — não há permissão separada a marcar: o vínculo é a permissão.

Para o administrador: o vínculo é feito em Por loja → editar a loja → Responsáveis pela unidade, marcando os usuários. Colaboradores não aparecem na lista: a permissão é de quem responde pela loja, não de quem é medido por ela.

Escolha a loja (se você responde por mais de uma), o mês e o ano, e clique em Buscar. A tela tem duas abas.

Painel da loja#

É o acompanhamento do gerente, sem dinheiro por indicador — o assunto aqui é meta:

• cartões: atingimento médio da loja, indicadores atingidos (de quantos lançados), em

consolação, não atingidos (e quantos ainda sem lançamento), colaboradores em 100% e abaixo de 70%;

• atingimento por colaborador: barras com o ponderado de cada um, na cor do farol;
• evolução da loja: 12 meses de atingimento médio e % de indicadores atingidos — mês sem

lançamento fica em branco;

• indicadores da loja: cada indicador com gestor, meta, realizado, atingimento e quantos

colaboradores dependem dele, ordenado do pior para o melhor — o que precisa de atenção vem primeiro. Resultado forçado aparece marcado.

• ⬇ PDF do painel: o mesmo conteúdo em PDF, para levar à reunião da loja.

PDF para a conversa com o colaborador#

Na aba Colaboradores, cada linha (e o detalhe em Ver) tem ⬇ PDF: uma página com os cartões da pessoa, as metas do mês indicador a indicador, a evolução dela em 12 meses, a conferência registrada (se houver) e um bloco em branco "Combinados desta conversa" com linhas para anotar à mão e espaço para as duas assinaturas. É o roteiro para sentar e conversar sobre o progresso.

Colaboradores#

Para cada colaborador da unidade:

• indicadores atingidos (ex.: 3 de 5) e o atingimento ponderado;
• possibilidade e quanto vai receber;
• a conferência: o que o colaborador respondeu e o que você registrou.

Não precisa esperar a folha fechar: com o mês em aberto, ⚠ Contestar já funciona e registra uma contestação prévia, que quem fecha a folha vê antes de congelar os valores e que segue para a folha quando ela for fechada.

Ver abre o detalhamento indicador a indicador — meta, realizado, atingimento e peso —, a mesma visão que o colaborador tem de si mesmo, também sem valores por indicador. O que ele vai receber aparece no topo do detalhe e na lista.

Contestar por um colaborador#

Com a folha fechada e ainda não paga, aparece o botão ⚠ Contestar em cada linha. Aponte o indicador (opcional) e descreva o que está errado.

Sua contestação entra como registro separado, identificado com o seu nome. Ela não apaga a resposta do colaborador: se ele já tinha registrado algo, as duas ficam lado a lado na folha e no espelho da operação. O colaborador é avisado em Meus Resultados.

Depois de registrada, o botão vira ⚠ Rever — você pode ajustar enquanto a folha não for paga. A gestão responde à sua contestação do mesmo jeito que responde à do colaborador: deferindo ou indeferindo, com motivo.

Sincronização RH#

Traz do RH — pelo hub Gorjetas, que espelha o Senior — quem entrou, quem saiu e o que mudou. Aparece para quem tem a seção Por colaborador. Roda sozinha todo dia; ⟳ Sincronizar agora roda na hora.

O KPI só tem a gestão, então ninguém entra sozinho: a tela mostra o que o RH tem e você decide.

O que a tela mostra, de cima para baixo:

• Última rodada — quando, por quem, e quando o hub foi atualizado pelo Senior. Se essa data

passar de 2 dias, o aviso em vermelho quer dizer que o conector do Senior pode ter parado.

• Desligados no RH ainda ativos no KPI — clique Inativar e informe o motivo. Até lá a

pessoa continua na apuração; se saiu num mês com folha aberta, a decisão de pagar aparece no fechamento.

• Vinculados que não vieram do RH — sumir do lote não desliga ninguém (pode ser a view

do Senior). Confira antes de inativar.

• Lojas sem colaborador ativo — sugestão de Inativar loja. Loja inativa some do

lançamento e do cadastro, mas folhas e relatórios dela continuam acessíveis, marcadas (inativa). Reabre sozinha se alguém ativo chegar do RH.

• Sem de-para — afeta quem já está no KPI — loja ou cargo de alguém vinculado que o KPI

não reconhece. Isso é problema de verdade: aponte o correspondente e sincronize de novo.

• Cargos do RH sem correspondência no KPI — lista recolhida com os cargos operacionais e

quantas pessoas têm cada um. Não é pendência: operacional não entra no KPI. Só abra se um cargo da gestão estiver escrito diferente no RH (ex.: COORDENADOR GERAL DE PRODUÇÃO) e aponte para o cargo do KPI.

• Divergências — o que está diferente entre o KPI e o RH (conta, endereço, nome). A

sincronização não sobrescreve o que já está preenchido: corrija à mão em Por colaborador se o RH estiver certo.

• Pessoas no RH que não estão no KPI — só quem tem cargo da gestão (um cargo do KPI,

direto ou por de-para). Filtre e clique + Adicionar. A pessoa entra sem competências e sem possibilidade: configure em Por colaborador antes do fechamento.

• De-para em vigor — o que já está apontado; ✕ remove.

Em Por colaborador, quem está vinculado ao RH aparece com a etiqueta RH e a matrícula; quem foi desligado no RH aparece com desligado dd/mm/aaaa.

Indicadores#

Cadastro do que é medido.

Criar: clique em + Novo indicador e informe nome, gestor, loja, unidade, periodicidade e o sentido (maior é melhor ou menor é melhor).

Faixas de consolação e superação#

É aqui que se define quanto pagar quando a meta não foi batida (ou foi superada).

Cada faixa de consolação responde "a partir de X, paga Y", e o X pode ser:

• % atingido — a partir de 80% → paga 70% do valor;
• quantidade — a partir de 5 → paga 85% do valor.

A opção por quantidade serve quando a proporção matemática não reflete a regra da empresa.

Cada faixa de superação pode ainda valer só para determinados cargos. O botão ao lado da faixa começa em todos os cargos; clicando nele você marca quantos cargos quiser, e a faixa passa a valer apenas para quem tem algum deles — e a mais: as faixas gerais continuam valendo para essas pessoas, e sempre paga a melhor. Ou seja, restringir por cargo nunca faz alguém receber menos.

O botão resume o que está marcado: todos os cargos, o nome quando é um só, ou 3 cargos quando são vários (passe o mouse para ver quais). Limpar (todos) volta a faixa a valer para todo mundo.

Os cargos vêm de uma lista. No cadastro do colaborador o cargo é escolhido, não digitado, e o botão ＋ ao lado cria um cargo novo na hora. Não existe renomear cargo: o vínculo é pelo nome, então para trocar crie o novo e reatribua as pessoas. Exemplo: meta de 6; matematicamente 5 daria 83%, mas a empresa considera que vale 85% — basta criar a faixa por quantidade.

As faixas de superação funcionam igual, medindo quanto passou de 100%.

Ações em lote#

Selecione vários indicadores com as caixas à esquerda para excluir em massa, clonar para outra loja (com sufixo no nome) ou atribuir a um gestor.

Por colaborador#

Cadastro das pessoas e do vínculo com os indicadores.

Campos principais:

• Dados pessoais: nome, CPF, cargo e loja;
• Possibilidade: valor máximo de remuneração variável;
• Composição salarial: CTPS, antecipação e bônus formação;
• Grupo de disputa: define com quem a pessoa concorre no Valoriza. Quem

ficar sem grupo não entra no ranking;

• Competências: quais indicadores contam para essa pessoa e o peso de cada um.

Os pesos precisam somar exatamente 100% — o sistema avisa se estiver diferente.

Dados para pagamento#

Para o colaborador entrar no arquivo enviado ao banco, a ficha precisa de CPF, banco, agência, conta e endereço completo (endereço, bairro, cidade, CEP e UF). Enquanto faltar algo, a própria ficha avisa o que está pendente; quem está completo ganha o selo 🏦 na lista.

Importar de uma vez: em vez de digitar pessoa por pessoa, clique em 🏦 Importar dados de pagamento e envie o arquivo de remessa (.txt) já usado no banco. O sistema lê agência, conta e endereço de cada favorecido e casa com o cadastro pelo CPF.

Antes de gravar, aparece uma prévia com tudo o que vai acontecer:

Nada é gravado até você clicar em Importar.

Usuários (admin)#

Cadastro de quem acessa o sistema.

Criar: informe nome, e-mail, perfil e loja. O usuário nasce com senha padrão e é obrigado a trocá-la no primeiro acesso — a lista mostra a marca "senha padrão" enquanto isso não acontece.

Permissões: marque exatamente quais seções o usuário pode abrir. O botão "Aplicar padrão do perfil" preenche a sugestão para aquele perfil.

Redefinir senha: clique no botão 🔑 na linha do usuário, defina uma senha temporária (mínimo 8 caracteres) e informe a pessoa. Ela será obrigada a criar uma nova senha no próximo login. A ação fica registrada na auditoria.

Desativar: o botão de olho ativa/desativa o acesso. Prefira desativar a excluir — preserva o histórico.

Acesso pelo Gestor de Autenticação#

O Gestor confirma quem é a pessoa; quem decide o que ela pode fazer continua sendo o KPI. Por isso, estar cadastrado no Gestor não basta — é preciso existir aqui também.

Para liberar alguém:

1. Usuários → + Novo usuário
2. Preencha nome, CPF (é a chave do vínculo), e-mail, perfil e loja
3. Marque as permissões de acesso
4. Salve

Na primeira vez que a pessoa entrar por "Entrar com Petiskeira", o sistema reconhece o CPF e amarra os dois cadastros sozinho. A partir daí a ficha mostra "✓ Já entrou pelo Gestor de Autenticação", e a lista exibe o selo 🔑 ao lado do e-mail.

A ficha avisa quando falta o que é preciso: sem CPF nem e-mail, a pessoa não consegue entrar pelo Gestor, porque não há como ligá-la ao cadastro do KPI.

Para alguém que já usava o sistema: basta preencher o CPF na ficha. Nada mais muda — o vínculo acontece no próximo acesso pelo Gestor, e o histórico é preservado.

Se aparecer "Você não tem acesso a este sistema": o Gestor confirmou a identidade, mas não há usuário correspondente no KPI. Cadastre pelo passo a passo acima, conferindo o CPF.

Relatórios#

Folha de Remuneração Variável#

Escolha o período e a loja e clique em Gerar. Mostra, por loja, cada colaborador com a possibilidade, o valor a receber, a superação, os ajustes (lançamentos avulsos) e o total, com subtotais e total geral. ⬇ PDF baixa o mesmo relatório em PDF, no padrão do espelho.

O botão Detalhar abre a visão indicador a indicador daquela pessoa — útil para explicar a alguém exatamente como o valor foi formado.

Status de lançamentos#

Mostra o que já foi lançado e o que está faltando no período. Também sai em ⬇ PDF.

Fechamento de Folha#

Congela os valores da folha para pagamento. Enquanto a folha não é fechada, ela muda sempre que um lançamento do período é corrigido — depois de fechada, fica estável.

Como fechar:

1. Escolha mês, ano e loja e clique em Conferir.
2. O sistema mostra a apuração de cada colaborador e o total. Se alguém estiver **sem

lançamento** no período, aparece um aviso — vale checar antes de prosseguir.

1. Confira os valores e clique em 🔒 Fechar folha. Você pode registrar uma observação

(ex.: quem conferiu).

Desligados no período#

Se alguém da loja foi desligado dentro do mês, aparece um quadro amarelo acima da tabela: nome, data e valor apurado, com ✓ Pagar ou ✕ Não pagar e um campo de motivo. O botão Fechar folha só libera depois de todos decididos — e o servidor confere de novo.

Por acordo, quem sai no meio do mês às vezes recebe, às vezes não. O sistema não decide por você: registra o que você decidir, com o motivo, e leva para o espelho — inclusive quando não foi pago.

Depois de fechada você pode:

• ⬇ CSV — baixa a planilha para enviar ao financeiro (abre direto no Excel);
• ✓ Marcar como paga — confirma que o pagamento foi feito;
• 🔓 Reabrir — descarta os valores congelados e volta a calcular ao vivo, **exigindo o

motivo**.

⚠️ Reabrir só é possível antes de marcar como paga. Depois de paga, a folha é definitiva.

Responder às contestações#

Na folha fechada, o quadro Conferência dos colaboradores mostra quantos concordaram, quantos contestaram e quantos não responderam. Cada contestação traz o que o colaborador alegou e dois botões:

• ✓ Deferir — a alegação procede;
• ✕ Indeferir — a alegação não procede.

Nos dois casos o motivo é obrigatório: é ele que o colaborador tem direito de saber, e é ele que sai no espelho da operação. Depois de registrada, a decisão aparece no quadro com o nome de quem decidiu e a data — e pode ser revista pelo botão Revisar.

Deferir não muda o valor. Para corrigir, reabra a folha, ajuste o lançamento e feche de novo.

Gerar o arquivo para o banco#

Com a folha fechada, o botão Gerar arquivo monta a remessa no padrão CNAB 240 do Santander, pronta para envio pelo Santander Empresas.

1. Escolha se o arquivo vai levar todas as lojas fechadas do período ou apenas uma.
2. Informe a data do pagamento.
3. Clique em ⬇ Gerar e baixar.

Se algum colaborador estiver sem CPF, agência, conta ou endereço, o sistema não gera e mostra a lista de quem falta — complete em Por colaborador e tente de novo. É uma trava proposital: conta incorreta significa pagamento na conta de outra pessoa.

⚠️ No primeiro envio, compare o arquivo com um antigo e confirme com o gerente do banco: arquivo de origem nova costuma passar por homologação.

Junto com o .txt baixa também um espelho em PDF — o extrato detalhado da mesma operação. O arquivo do banco é ilegível para conferência humana; o espelho é o documento para arquivar, aprovar e auditar. Ele traz:

• a identificação da remessa (empresa, conta, período, data do pagamento e quem gerou);
• as folhas fechadas que entraram no arquivo;
• a relação de pagamentos, com CPF mascarado, agência/conta e valor;
• o detalhamento de cada colaborador — indicador a indicador, com meta, realizado,

atingimento, peso e quanto rendeu, mais a composição do total;

• a conferência: quem concordou, quem contestou, e **cada contestação com a decisão e o

motivo**.

Contestações ainda sem decisão aparecem como pendente de decisão — vale responder antes de gerar o arquivo.

No fim da tela fica a lista de todos os fechamentos do ano, com situação e total — clique em Abrir para ver qualquer um.

Tudo (fechar, pagar e reabrir) fica registrado na Auditoria.

Valoriza#

Programa de reconhecimento. A tela mostra dois rankings ao mesmo tempo:

• 🗓️ Mês — classificação pelo atingimento ponderado (ex.: 92%);
• 🏆 Acumulado do ano — quantos indicadores bateram a meta somando os meses lançados

(ex.: 52 de 60), pensado para o evento de fechamento do ano.

Quem concorre com quem vem do Grupo de disputa cadastrado na ficha do colaborador.

Empate mantém empate: três pessoas com o mesmo resultado ficam todas em 1º, e a próxima é a 2ª colocada.

Gerar a arte para publicar#

Cada grupo tem os botões 🖼️ Vertical e 🖼️ Horizontal:

• Vertical — formato para stories e WhatsApp;
• Horizontal — formato para TV e apresentação.

Abre uma prévia na tela, onde você pode:

• alternar entre vertical e horizontal;
• escolher uma imagem de fundo (ou removê-la com Sem fundo);
• ⬇ Baixar PNG quando estiver do jeito desejado.

A imagem de fundo fica salva no navegador que você está usando — se abrir de outro computador, será preciso escolhê-la de novo.

Auditoria (admin)#

Registro de tudo o que acontece no sistema, exigido para conformidade (LGPD) por envolver dados de remuneração.

Filtre por ação, tabela e período e clique em Buscar. Cada linha conta o que houve em linguagem direta:

Adriano alterou o indicador "Ticket Médio": unidade de "Qtd" para "R$"

Clique na linha para ver todos os campos alterados, com o valor antes e depois.

O registro é somente leitura — ninguém, nem o administrador, pode editar ou apagar o histórico pelo sistema. Senhas nunca são gravadas no log.

Perguntas frequentes#

Esqueci minha senha. Peça a um administrador para redefinir (botão 🔑 na tela de Usuários). Você receberá uma senha temporária e criará uma nova no primeiro acesso.

O sistema disse que minha sessão expirou. Normal: a sessão dura 12 horas por segurança. Basta entrar de novo.

Não consigo digitar no campo de meta ou resultado. O prazo do período provavelmente fechou. Peça a um supervisor ou administrador para reabrir.

Posso lançar zero? Sim. Zero é um valor válido e é calculado corretamente — inclusive nos indicadores em que "menor é melhor", onde zero é o melhor resultado possível.

Bati a meta mas não recebi superação. A superação só é paga a partir da faixa configurada no indicador. Se a faixa começa em +10% e você fez 105%, bateu a meta (recebe o valor integral), mas não alcançou a superação.

Um colaborador não aparece no Valoriza. Falta preencher o Grupo de disputa na ficha dele, ou ele não tem competências vinculadas.

Meu nome não aparece nos relatórios. Relatórios consideram apenas colaboradores ativos e com competências cadastradas.

Manual do Gestor

Guia de quem conduz o ciclo da remuneração variável: definir metas, apurar resultados, fechar a folha, responder às contestações e mandar pagar.

O Manual do Usuário descreve cada tela em detalhe. Este documento descreve a ordem das coisas e as decisões que só o gestor toma.

Sumário#

• Papéis
• O ciclo do mês
• 1. Antes do mês começar: metas
• 2. Durante o mês: acompanhar
• 3. Virou o mês: resultados
• 4. Conferir e fechar a folha
• 5. A janela de conferência
• 6. Responder às contestações
• 7. Pagar
• 7.1 Corrigir uma folha já paga
• 8. Reconhecer: Valoriza
• Erros que custam caro
• Perguntas que a equipe faz

Papéis#

Responsável de unidade não é um perfil. É quem foi marcado no cadastro da loja, em Por loja → editar → Responsáveis pela unidade. Uma loja pode ter vários; a mesma pessoa pode responder por mais de uma. Quem sai da lista perde o acesso na hora.

Fechar folha, pagar e decidir contestação exigem a seção Fechamento de Folha liberada — e são conferidas no servidor, não só na tela.

O ciclo do mês#

flowchart TD
    A[Metas do mês] --> B[Resultados]
    B --> C[Conferir apuração]
    C --> D[Fechar folha]
    D --> E[Conferência: colaborador e responsável]
    E --> F{Contestou?}
    F -- não --> J[Gerar arquivo + espelho]
    F -- sim --> G[Deferir ou indeferir]
    G --> H{Muda o valor?}
    H -- sim --> I[Reabrir, corrigir e fechar de novo]
    I --> E
    H -- não --> J
    J --> K[Marcar como paga]

O ponto sem volta é marcar como paga: depois disso nada mais muda.

1. Antes do mês começar: metas#

Em Lançar Metas, escolha mês, ano e loja. Cada indicador recebe a meta do período.

• Meta em branco faz o indicador ser tratado como sem dados — ele não conta na apuração e

o colaborador não tem como atingir nada ali.

• Meta zero é meta válida, não vazio. Em "menor é melhor", zero é o alvo.
• Se precisar de uma meta fora do padrão, marque Forçar meta e escreva o motivo. Sem

motivo, o campo fica marcado em vermelho e a linha não deveria ser salva assim — o motivo é o que explica a exceção seis meses depois.

O prazo de lançamento fecha automaticamente. Passado o prazo, supervisor e admin conseguem reabrir para edição — a reabertura fica registrada.

2. Durante o mês: acompanhar#

Relatórios → Status de lançamentos mostra, por loja, quantos indicadores já têm resultado e quais faltam. É o jeito mais rápido de descobrir que uma loja inteira está sem lançamento antes de a folha fechar.

Quem responde por uma loja acompanha em Minha Unidade a apuração ao vivo, colaborador a colaborador, mesmo antes de a folha fechar.

3. Virou o mês: resultados#

Em Lançar Resultados, informe o realizado de cada indicador. O atingimento aparece na hora, com a cor da situação:

Zero é resultado, não ausência de resultado. Deixar em branco e escrever zero são coisas diferentes: em branco o indicador não entra na conta; zero entra e pode até atingir a meta, quando o indicador é "menor é melhor".

Para lançar meta e resultado lado a lado, use a aba Metas + Resultados (admin), que não tem trava de prazo.

Forçar um resultado é dizer "por acordo, este indicador conta como atingido": paga 100% do valor do indicador — nem menos, nem superação — e o realizado fica só como registro. Use quando o resultado ruim não é responsabilidade da pessoa (obra, sistema fora, meta impossível descoberta tarde) e escreva o motivo pensando em quem vai ler o espelho.

4. Conferir e fechar a folha#

Fechamento de Folha → mês, ano, loja → Conferir.

A tela mostra a apuração de cada colaborador e o total. Antes de fechar, olhe:

• o aviso de colaborador sem lançamento — quase sempre é indicador esquecido, não

desempenho ruim;

• valores zerados em quem deveria receber;
• valores acima do esperado, que costumam indicar meta lançada errada.

• as contestações registradas antes do fechamento pelos responsáveis das unidades — o

bloco laranja lista cada uma; corrija o que procede e só então feche. Depois de fechada, elas aparecem para deferir ou indeferir.

Fechar congela os valores. A partir daí, corrigir um lançamento antigo não muda mais essa folha. É proposital: o que foi pago fica registrado como foi pago.

Registre na observação quem conferiu. Vale ouro quando alguém perguntar depois.

5. A janela de conferência#

Entre fechar e pagar existe a janela em que a equipe confere. Nela:

• o colaborador vê o valor apurado em Meus Resultados e registra de acordo ou

contesta, apontando o indicador;

• o responsável da unidade vê todo mundo da loja em Minha Unidade e pode **contestar pelo

colaborador**.

As duas respostas são registros separados. A do responsável não apaga a do colaborador, e o colaborador é avisado quando alguém contesta por ele — inclusive se já tinha concordado.

Responder é opcional e não trava o pagamento. O quadro Conferência dos colaboradores, na folha fechada, mostra quantos concordaram, quantos contestaram e quantos não responderam.

Depois de paga, a folha não aceita mais resposta.

Quem saiu no meio do mês#

Desligado com data dentro do mês aparece no fechamento com o valor apurado e a pergunta: Pagar ou Não pagar? Por acordo, às vezes sim, às vezes não — a decisão é sua, com motivo obrigatório. A folha não fecha enquanto houver desligado sem decisão.

O que você decidir sai no espelho da operação, mesmo quando foi não pagar. Se um dia alguém perguntar por que o colega recebeu e ele não, a resposta está escrita.

6. Responder às contestações#

Cada contestação tem dois botões: ✓ Deferir e ✕ Indeferir. Nos dois casos o motivo é obrigatório.

Deferir não muda o valor. Deferir é reconhecer que a alegação procede. Para o valor mudar você precisa reabrir a folha, corrigir o lançamento e fechar de novo — ou, se a folha já está paga, fazer um lançamento avulso na próxima (seção 7.1).

Escreva o motivo pensando em quem vai ler: o colaborador, e eventualmente alguém de fora da empresa. "Não procede" não é motivo. "O ticket apurado confere com o fechamento do PDV do dia 12; não há divergência" é.

A decisão pode ser revista enquanto a folha permitir, e toda alteração fica na auditoria.

Contestação sem decisão sai marcada como pendente no espelho da operação. Responda antes de gerar o arquivo do banco.

7. Pagar#

Com a folha fechada, Gerar arquivo monta a remessa no padrão CNAB 240 do Santander.

1. Escolha se o arquivo leva todas as lojas fechadas do período ou apenas uma.
2. Informe a data do pagamento.
3. ⬇ Gerar e baixar.

Se faltar CPF, agência, conta ou endereço de alguém, o sistema não gera e lista quem falta. É trava proposital: conta errada é pagamento na conta de outra pessoa.

Baixam dois arquivos:

O espelho é o extrato legível da mesma operação: identificação da remessa, folhas fechadas, relação de pagamentos, o detalhamento de cada colaborador indicador a indicador e cada contestação com sua decisão e o motivo. É o documento que sustenta a operação se alguém questionar depois — o .txt não serve para isso, ninguém lê um CNAB.

Envio ao banco e conferência do retorno são manuais, por decisão. Depois de confirmado o pagamento, volte e clique em ✓ Marcar como paga.

No primeiro envio de um período novo, compare o arquivo com um antigo e confirme com o gerente do banco: arquivo de origem nova costuma passar por homologação.

7.1 Corrigir uma folha já paga#

Folha paga não se mexe. Se alguém recebeu a menos (ou a mais) em julho, a correção entra na folha de agora, como lançamento avulso, dizendo que se refere a julho.

Fechamento de Folha → ＋ Lançamento avulso.

1. Loja e colaborador (quem já saiu também aparece, marcado inativo).
2. Crédito (pagar a mais) ou estorno (descontar) e o valor.
3. Período de referência — o mês a que o valor se refere. Pode ser a folha passada que

está sendo corrigida ou o próprio mês (um extra ou desconto do período). A tela lista as folhas fechadas da loja para você não errar o mês.

1. Entra na folha de — normalmente o mês em aberto. Se essa folha já estiver fechada, o

sistema recusa: lance na seguinte.

1. Atalhos — os avulsos que se repetem (ex.: Superação diferença de inventário · R$ 100,

QLP completo · R$ 200): um clique preenche tipo, valor e motivo. Parcelas (1, 2 ou 3) aparecem só para estorno; a prévia mostra quanto cai em cada mês.

1. Motivo — obrigatório. Sai no espelho e na tela do colaborador; escreva para quem vai ler.

O lançamento fica pendente até você fechar a folha daquela competência. Na prévia do fechamento ele aparece num bloco próprio, e o total do colaborador já sai líquido. Para desfazer antes de fechar: Cancelar, com motivo. Depois de fechar, só reabrindo a folha (o lançamento volta a pendente).

Estorno maior que o valor do mês. O banco não recebe valor negativo, então a folha não fecha enquanto alguém ficar abaixo de zero. Ao lado do lançamento aparecem os botões 2x e 3x: o sistema cancela o original e cria as parcelas, cada uma já apontada para o mês seguinte. Elas entram sozinhas nos próximos fechamentos.

Quem saiu. Se o colaborador tem desligamento dentro do mês, a decisão Pagar / Não pagar vale também para as parcelas dele: pagar soma tudo, não pagar cancela tudo. Se ele já saiu antes e não está mais na folha, o lançamento não entra sozinho — fica na lista Lançamentos avulsos pendentes (fim da tela, todas as lojas). Olhe essa lista antes de fechar uma rescisão: é ali que se vê se sobrou desconto ou crédito de alguém que foi embora.

8. Reconhecer: Valoriza#

A aba Valoriza classifica por atingimento do mês e por acumulado do ano, dentro dos grupos que você define no cadastro do colaborador (campo Grupo do ranking).

Empate fica empatado: três pessoas com 100% ficam todas em 1º, e a próxima vai para 2º. Não há critério de desempate, e é de propósito.

Dá para gerar a arte vertical e horizontal para publicar, com imagem de fundo própria. Valores em R$ não aparecem na arte.

Erros que custam caro#

Perguntas que a equipe faz#

"Contestei, e agora?" A gestão responde deferindo ou indeferindo, sempre com motivo. Contestar não atrasa o pagamento.

"Deferiram minha contestação, por que o valor não mudou?" Deferir reconhece a alegação. Se o valor precisa mudar, a folha é reaberta, o lançamento é corrigido e ela é fechada de novo — pode cair no mês seguinte, dependendo de quando aconteceu.

"Por que não vejo quanto cada indicador vale?" A tabela de competências mostra meta, realizado, atingimento e peso — sem R$ por linha, de propósito, para o foco ficar na meta. O total continua nos cards e na barra.

"Meu mês aparece sem lançamento." O resultado daquele mês não foi lançado. Fale com quem lança os indicadores da sua loja.

"O responsável contestou por mim sem me avisar." O sistema avisa: aparece um aviso em Meus Resultados com o que ele apontou. A sua resposta continua registrada do lado.

Petiskeira Alimentos Ltda. — uso interno.

Roteiro de Treinamento

Guia para conduzir a reunião de apresentação do sistema à equipe que vai acessar e alimentar — gerentes de loja, coordenadores e quem lança metas e resultados.

Duração: 90 minutos. Formato: projetor + cada participante com o próprio acesso.

Sumário#

• Antes da reunião
• Agenda
• 1. Por que este sistema existe (10 min)
• 2. Primeiro acesso (10 min)
• 3. O ciclo do mês (15 min)
• 4. Mão na massa (25 min)
• 5. Acompanhar a equipe (15 min)
• 6. Conferência e contestação (10 min)
• 7. O que não fazer (5 min)
• Perguntas que sempre aparecem
• Cartão de bolso
• Depois da reunião

Antes da reunião#

Sobre o login de treinamento: ele é compartilhado. Se dez pessoas lançarem ao mesmo tempo na loja Treinamento, uma sobrescreve a outra. Então: demonstração na loja Treinamento (você, no projetor) e exercício cada um na própria loja, no mês em aberto.

Para recomeçar a loja Treinamento do zero (depois de a turma mexer), o administrador roda de novo o api/treinamento.sql — ver Manual Técnico.

Agenda#

1. Por que este sistema existe (10 min)#

Comece pelo problema, não pela tela. A planilha entregava três coisas ruins:

• ninguém sabia o resultado antes do fim do mês — quando dava para agir, já era tarde;
• cada loja calculava de um jeito, e a conta mudava conforme quem preenchia;
• não dava para provar nada depois: quem alterou, quando e por quê ficava no ar.

O que o sistema garante no lugar:

Deixe claro desde já: o valor de cada um sai do que a loja faz nos indicadores. O sistema não inventa nota nem julga pessoa — ele calcula o que foi lançado.

2. Primeiro acesso (10 min)#

Todos ao mesmo tempo, no próprio acesso.

1. Abrir kpi.petiskeira.com.br.
2. Entrar com o e-mail da loja e a senha recebida.
3. Trocar a senha — o sistema exige no primeiro acesso. Senha de no mínimo 10 caracteres.
4. Reparar na barra da esquerda:

• ☾ tema claro/escuro;
• Fonte −/+ — a tela da cozinha costuma ficar melhor em 110%;
• Ocultar valores na tela — já vem marcado.

Pare no "Ocultar valores" e explique. Os valores de pagamento aparecem como R$ •••• porque o sistema é aberto no balcão, com gente atrás. Quem precisa ver desmarca, olha e marca de novo — e no próximo acesso volta a ficar oculto sozinho. Salário de colega não é assunto para terceiros; isso não é desconfiança de ninguém, é cuidado com todo mundo.

3. O ciclo do mês (15 min)#

Desenhe o mês no quadro antes de mostrar a tela:

até dia 5          durante o mês        até dia 5 do mês seguinte      depois
  METAS       →     acompanhar     →         RESULTADOS           →   fechamento
                                                                       e pagamento

Fora da janela a tela fica só leitura — quem reabre é supervisor ou administrador, e a reabertura fica registrada.

Três coisas que geram erro e valem repetir:

1. Zero é resultado. Em branco é ausência de resultado. Em branco, o indicador sai da

conta; zero entra e pode até atingir a meta, quando o indicador é "menor é melhor".

1. ↑ ou ↓. Cada indicador diz o que é bom: faturamento é "maior é melhor", CMV e turnover

são "menor é melhor". A seta aparece embaixo do nome.

1. Forçar é para exceção real — obra, sistema fora, meta impossível descoberta tarde. O

indicador passa a contar como 100%, o motivo é obrigatório e sai no documento que acompanha o pagamento. Use pouco e explique bem.

4. Mão na massa (25 min)#

Demonstre cada passo na loja Treinamento, no projetor; em seguida cada um repete na própria loja. Circule pela sala — este é o bloco que faz a reunião valer.

Exercício 1 — lançar um resultado (8 min)#

1. Lançar Resultados → escolha o mês e a loja.
2. Digite o realizado de um indicador.
3. Olhe a pílula de atingimento mudar de cor na hora.
4. Salvar.

Pergunte à turma: por que este ficou verde e aquele amarelo? (Amarelo = não bateu, mas caiu numa faixa de consolação — recebe parcial.)

Exercício 2 — entender o próprio valor (7 min)#

1. Meus Resultados.
2. Desmarque Ocultar valores para ver os números.
3. Percorra a tabela: meta, realizado, atingimento, peso.

Explique o peso: é o quanto cada indicador vale no seu total. Um indicador de peso 30% que não bate custa muito mais que um de peso 5%. É onde colocar energia.

Exercício 3 — ler o Anual Acumulado (5 min)#

No mesmo lugar, mostre o gráfico: o que dava para receber × o que veio, mês a mês. A distância entre as duas barras é o que ficou na mesa.

Exercício 4 — o Valoriza (5 min)#

Abra o Valoriza e mostre a classificação do mês e do ano. É reconhecimento, não é dinheiro — e conta indicador atingido, não simpatia.

5. Acompanhar a equipe (15 min)#

Este bloco é para responsáveis de unidade. Quem não responde por loja não vê esta tela.

Minha Unidade → Painel da loja:

• os cartões do topo respondem "como estamos?" em cinco segundos;
• a lista de indicadores vem do pior para o melhor — é a pauta da sua reunião;
• a coluna Colab. mostra quantas pessoas dependem daquele indicador: um indicador ruim com

seis pessoas penduradas é prioridade sobre um ruim com uma.

Minha Unidade → Colaboradores: cada pessoa com indicadores atingidos, atingimento e valor.

O PDF da conversa. No botão ⬇ PDF de cada colaborador sai uma página com as metas do mês, a evolução dele em 12 meses e um espaço em branco — Combinados desta conversa — com linha para as duas assinaturas. Imprima, sente com a pessoa, escreva o combinado e guarde. Essa é a diferença entre "cobrar resultado" e acompanhar gente.

6. Conferência e contestação (10 min)#

O ponto que mais gera confiança no sistema. Mostre o caminho inteiro:

1. A loja lança os resultados.
2. A gestão fecha a folha — os valores ficam congelados.
3. Cada pessoa confere os próprios valores e responde: estou de acordo ou contesto.
4. Contestou? Aponta o indicador e escreve o motivo.
5. A gestão defere ou indefere, sempre com justificativa escrita.
6. Tudo isso sai no documento que acompanha o pagamento.

Duas coisas que os responsáveis precisam saber:

• dá para contestar antes de a folha fechar, assim que o erro aparece — o registro vai para

quem fecha, que corrige antes de congelar;

• deferir não muda o valor sozinho: para corrigir, reabre-se a folha e ajusta-se o

lançamento. Se a folha já foi paga, a diferença entra na folha seguinte como lançamento avulso, com a referência do mês corrigido.

Diga com todas as letras: contestar não é reclamar. É o caminho previsto, e ninguém é mal visto por usá-lo. O que não pode é descobrir o erro seis meses depois.

7. O que não fazer (5 min)#

Perguntas que sempre aparecem#

"Quem definiu minha meta?" A meta vem da gestão da loja e é lançada até o dia 5. Se está fora da realidade, o caminho é falar antes do fim do mês — não depois do pagamento.

"Por que o colega recebeu e eu não?" Cada um tem indicadores e pesos próprios. Abra o Meus Resultados dele com ele; a conta está escrita linha a linha.

"Errei o lançamento, e agora?" Dentro do prazo, corrija e salve de novo. Fora do prazo, peça reabertura ao supervisor — ela é registrada com motivo.

"Bati a meta por pouco e o sistema mostra 99%." É proposital. Abaixo da meta o percentual não arredonda para 100 — senão um resultado a um centésimo da meta pagaria como se tivesse batido.

"Posso ver o valor dos outros?" O responsável pela unidade vê, porque precisa acompanhar. Os demais veem só o próprio. E, por padrão, os valores ficam ocultos na tela.

Cartão de bolso#

Para imprimir e distribuir:

Sistema de KPIs — Petiskeira kpi.petiskeira.com.br | Quando | O quê | |---|---| | até dia 5 | lançar as metas do mês | | até dia 5 do mês seguinte | lançar os resultados | | depois do fechamento | conferir e, se preciso, contestar | - Zero é resultado; em branco é ausência de resultado. - Veja a seta: ↑ maior é melhor · ↓ menor é melhor. - Peso é o quanto o indicador vale no seu total. - Forçar exige motivo, e o motivo é lido por outras pessoas. - Os valores ficam ocultos na tela; desmarque para ver e marque de novo. - Discordou do valor? Conteste — é o caminho previsto, não é reclamação. Dúvida de acesso: administrador do sistema.

Depois da reunião#

1. Recriar a loja Treinamento se a turma mexeu nela (api/treinamento.sql de novo).
2. Conferir quem não trocou a senha — em Usuários, quem ainda está em primeiro acesso.
3. Marcar o acompanhamento do primeiro mês: dia 5, olhar *Relatórios → Status de

lançamentos* e cobrar quem ficou para trás. A primeira rodada é a que forma o hábito.

1. Deixar combinado quem responde dúvida e por qual canal.

Material para consulta depois: Manual do Usuário (tela a tela) · Manual do Gestor (o ciclo do mês) · Regras de Negócio (como a conta é feita).

Regras de Negócio

Como o sistema calcula atingimento, remuneração variável e classificação. Este documento é a referência para conferir se um valor na tela está certo. Voltar ao README.

1. Conceitos#

2. Sentido do indicador#

Cada indicador declara se maior é melhor (faturamento) ou menor é melhor (reclamações, desperdício).

Arredondamento#

O atingimento é mostrado em percentual inteiro, mas o inteiro nunca mente sobre a meta: quem não bateu tem o percentual truncado (9,04 contra 9,05 é 99,9% → 99%, não 100%); quem bateu ou passou tem o percentual arredondado, nunca abaixo de 100%. Sem isso um resultado a um centésimo da meta apareceria como 100% e pagaria integral.

Zero é um valor válido#

Zero é tratado como número, não como "vazio". Isso é intencional e importante:

Em "menor é melhor" com realizado 0, o atingimento é limitado a 100% — a divisão por zero seria infinita, então esse caso não gera superação.

Um indicador sem lançamento no mês é diferente de um com valor zero: ele aparece como "—" e não é contado como atingido nem como falha.

3. Remuneração variável#

O cálculo é por indicador e depois somado.

Valor do indicador = Possibilidade × (peso da competência ÷ 100)

Sobre esse valor:

1. Bateu a meta (atingimento ≥ 100%) → recebe o valor integral do indicador.
2. Não bateu → verifica as faixas de consolação. Recebe a melhor faixa alcançada; se

nenhuma for alcançada, recebe zero.

1. Passou da meta → verifica as faixas de superação, calculadas sobre o quanto

excedeu 100%. O extra é somado ao valor integral.

Os pesos das competências de um colaborador devem somar 100% — o sistema recusa salvar fora disso.

Faixas de consolação#

Cada faixa responde: "a partir de X, paga Y". A base do X pode ser:

• % atingido — ex.: a partir de 80% → paga 70% do valor;
• quantidade — ex.: a partir de 5 unidades → paga 85% do valor.

A base por quantidade existe para desacoplar o pagamento da proporção matemática. Exemplo real: meta de 6; o realizado 5 daria 83% na conta linear, mas a empresa considera que vale 85%.

O pagamento (Y) pode ser % do valor do indicador ou R$ fixo.

Quando várias faixas são alcançadas, vale a que paga mais.

⚠️ Limitação atual: faixas por quantidade comparam realizado ≥ X, o que só faz sentido em indicadores "maior = melhor". Em indicadores invertidos, use faixas por % atingido.

Faixas de superação#

Mesmo formato, mas o X é quanto passou de 100%. Ex.: acima de +10% → paga 20% a mais. Um indicador com 105% e faixa mínima de +10% não recebe superação.

Como na consolação, a faixa pode ser por % acima da meta ou por quantidade realizada — útil quando o indicador é contado em unidades e "passar 1%" não diz nada (turnover, unidades fora). Por quantidade, o sentido do indicador manda: em maior é melhor a faixa atinge com realizado a partir de X; em menor é melhor, com realizado até X. Ex.: turnover com meta 2, menor é melhor, faixa realizado até 0 → R$ 100: 2 e 1 batem a meta e recebem o valor cheio; 0 recebe o valor cheio mais os R$ 100; 3 não bate. A faixa por quantidade entra com a meta atingida ou superada (100% ou mais) — precisa ser assim porque, em menor é melhor, realizado 0 vale 100% (não existe percentual acima de zero) e é exatamente o caso que ela existe para pagar. A faixa por % continua exigindo passar de 100%.

Superação restrita a cargos#

Cada faixa de superação pode valer para todos os cargos (padrão) ou só para os cargos marcados — a marcação é múltipla, porque uma superação normalmente vale para um grupo de cargos, não para um só.

A faixa restrita entra a mais para quem é de algum dos cargos marcados: ela disputa o "paga mais" com as faixas gerais, que continuam valendo para ele. Consequência importante — uma faixa restrita nunca reduz o que a regra geral já daria. Se a faixa do cargo pagar menos que a geral, a pessoa recebe a geral.

Para quem não está entre os cargos marcados, a faixa restrita simplesmente não existe.

Os cargos vêm do cadastro de cargos (ver abaixo); a comparação ignora maiúsculas, acentos e espaços repetidos, para não depender de dados antigos digitados à mão.

No dado, kpis.superacao[].cargo aceita um texto (formato inicial, um cargo) ou uma lista. Os dois convivem, então faixas cadastradas antes da marcação múltipla continuam valendo sem migração.

Cadastro de cargos#

colaboradores.cargo era texto livre. Passou a ser escolhido de uma lista porque a superação por cargo depende dele: com texto livre, Gerente e Gerente de Loja são cargos diferentes e a faixa nunca pagaria, sem erro nenhum na tela.

O vínculo continua sendo pelo nome do cargo — mesma convenção usada para lojas —, para não quebrar folha_itens.cargo, relatórios e espelhos já emitidos. Por isso não há renomear: para trocar, cria-se o novo cargo e reatribuem-se as pessoas.

Cargo antigo que não esteja na lista continua aparecendo, tanto no cadastro da pessoa quanto na faixa que o referencia (marcado como fora da lista) — apagar em silêncio mudaria a regra de pagamento sem ninguém perceber.

4. Cores do atingimento#

A cor comunica a situação segundo a configuração do próprio indicador — não são faixas fixas:

5. Prazos de lançamento#

Fora da janela a tela fica somente leitura. Um supervisor ou admin pode reabrir temporariamente para corrigir. A aba Metas + Resultados (admin) não tem trava — foi feita para correções e carga de dados.

O dia 5 está fixo no código. Torná-lo configurável exige expor a tabela configuracoes na API.

Lançamento forçado#

Permite gravar um valor que não segue o fluxo normal, exigindo justificativa. Existe separadamente para meta e para resultado. Registros forçados ficam destacados na tela e a alteração fica na auditoria.

Resultado forçado paga como 100%. Por acordo, quando a gestão força um resultado, o indicador é tratado como atingido exatamente — paga o valor do indicador, sem consolação e sem superação, e entra no atingimento ponderado como 100%. O realizado digitado continua registrado e aparece na tela, no detalhe da folha e no espelho (marcado forçado / *), mas não é ele que paga: quem explica o valor é a justificativa do lançamento. Forçar a meta não altera o cálculo — só documenta por que a meta é aquela.

6. Valoriza (reconhecimento)#

Programa de reconhecimento com dois recortes na mesma tela.

Quem concorre com quem: definido pelo campo Grupo de disputa na ficha do colaborador. Colaboradores com o mesmo grupo competem entre si. Sem grupo preenchido, fica fora.

Indicador com resultado forçado conta como atingido (100%) no Valoriza, tanto na contagem de metas batidas quanto no ponderado: a premissa é que forçar exige autorização superior, e o que foi autorizado vale para o reconhecimento como vale para o pagamento.

Atingimento ponderado = média dos atingimentos (limitados a 100%) ponderada pelos pesos das competências.

Empate: quem tem o mesmo resultado ocupa a mesma posição, sem desempate. A posição seguinte é a próxima da sequência — três em 1º são seguidos por um 2º.

Meses sem lançamento não entram na conta do acumulado anual, para não penalizar quem entrou no meio do ano.

⚠️ Efeito colateral do critério anual: como a ordem é pela quantidade absoluta, alguém com 11 de 15 (73%) fica à frente de alguém com 10 de 10 (100%) se tiver mais meses lançados. Só ocorre quando os participantes têm números diferentes de meses.

O ranking pode ser exportado como imagem (vertical para redes sociais, horizontal para TV), com imagem de fundo personalizável.

7. Perfis de acesso#

As permissões são ajustáveis por usuário — o perfil apenas define o ponto de partida.

8. Fechamento da folha#

Resolve um problema real: o relatório de folha é calculado ao vivo. Se alguém corrigir um lançamento antigo, um mês já pago mudaria retroativamente. O fechamento congela os valores apurados no momento em que foram conferidos.

Escopo: um fechamento por loja e período.

Estados:

(em aberto) ──fechar──> fechado ──marcar como paga──> pago
                           │
                           └──reabrir (com motivo)──> (em aberto)

• Fechado — valores congelados. Correções em lançamentos do período não alteram mais

esta folha. Pode ser reaberto.

• Pago — definitivo. Não pode ser reaberto; correção só por lançamento avulso

(abaixo), que entra na próxima folha.

Ao fechar, o sistema grava para cada colaborador: possibilidade, valor a receber, superação, total, atingimento e a apuração indicador a indicador, permitindo explicar depois como cada valor foi formado. A folha fechada pode ser exportada em CSV para o financeiro.

Fechar, pagar e reabrir ficam registrados na auditoria; a reabertura exige motivo e guarda os valores descartados.

Conferência do colaborador#

Entre fechar e pagar, o colaborador vê em Meus Resultados o valor apurado e responde:

• Estou de acordo — registra a conferência;
• Contestar — aponta qual indicador está errado e explica o motivo.

A resposta é opcional e a contestação não interrompe o pagamento — ela registra e avisa. Quem administra vê, na folha fechada, quantos concordaram, quantas contestações houve e o que cada um alegou.

Depois de paga, a folha não aceita mais resposta.

Responsável da unidade#

Cada loja tem um ou mais responsáveis — usuários vinculados no cadastro da loja. O vínculo é a permissão: quem está marcado enxerga a seção Minha Unidade, quem não está não a vê. Não há caixa de permissão separada para marcar. A mesma pessoa pode responder por mais de uma loja, e o administrador responde por todas.

O responsável vê, para cada colaborador da sua unidade: indicadores atingidos, atingimento ponderado, possibilidade, valor a receber e o detalhamento indicador a indicador — a mesma visão que o colaborador tem de si mesmo. Além disso, um painel da loja: estado de cada indicador no mês (atingido, superação, consolação, não atingido, sem lançamento — a mesma regra do cálculo, inclusive o forçado = 100%), quantos colaboradores dependem de cada um, atingimento ponderado por colaborador e evolução de 12 meses (média de atingimento e % de indicadores atingidos). O painel é calculado ao vivo, dos lançamentos; não há R$ por indicador.

O responsável pode contestar pelo colaborador — inclusive com a folha ainda aberta (contestação prévia): o registro nasce ligado a loja/mês/ano, aparece para quem fecha a folha na prévia do fechamento (para corrigir antes de congelar) e é anexado à folha quando ela é fechada, seguindo então o fluxo normal de decisão. Reabrir a folha não apaga conferências e contestações: elas se soltam e voltam no próximo fechamento. O colaborador continua respondendo só depois de a folha ser fechada. Com a folha fechada e ainda não paga, vale o abaixo. Essa contestação é um registro separado, identificado com o nome de quem registrou: ela não substitui nem apaga a resposta que o colaborador tenha dado. As duas convivem, aparecem lado a lado na folha e saem no espelho da operação.

O colaborador é avisado em Meus Resultados quando o responsável contesta por ele — inclusive se já tiver registrado que estava de acordo.

A contestação do responsável recebe decisão da gestão pelo mesmo caminho da contestação do colaborador (a seguir).

Desligado dentro do período#

Por acordo, quem sai no meio do mês às vezes recebe, às vezes não. Não há regra — é decisão do gestor, caso a caso. Então o sistema não decide: exige que a decisão seja tomada e a registra.

• Quem tem data de desligamento dentro do mês continua na apuração mesmo já inativado no

cadastro — a decisão é no fechamento, não no cadastro.

• No fechamento, cada desligado aparece destacado com o valor apurado e dois botões: Pagar

ou Não pagar, ambos com motivo obrigatório. Sem decisão, a folha não fecha — o servidor recusa, não só a tela.

• Não pagar zera o valor no servidor (o cliente manda o apurado, nunca o pago) e guarda

o apurado em valor_apurado, para o espelho mostrar o que teria sido.

• Desligado antes do período não entra; desligado depois ainda não é desligado.
• A decisão e o motivo saem no espelho da operação, numa seção própria, inclusive quando

não foi pago — o documento existe para mostrar o que aconteceu.

Lançamento avulso (errata de folha passada)#

Uma folha paga nunca muda. Quando se descobre que alguém recebeu a menos ou a mais num mês já pago, a correção é um lançamento avulso: um valor (crédito ou estorno) que aponta o período de referência corrigido e entra na próxima folha da loja que for fechada.

• Campos obrigatórios: colaborador, valor (positivo = crédito, negativo = estorno), período de

referência (o mês a que o valor se refere — pode ser o próprio mês, para um avulso do período; nunca posterior à competência em que entra), competência de entrada e motivo. A competência de entrada precisa estar aberta — folha fechada não recebe nada.

• Estados: pendente → incorporado (com a folha que pagou) ou cancelado (com motivo e

autor). Nunca se apaga. Reabrir uma folha devolve a pendente tudo o que ela incorporou.

• Quem incorpora é o servidor, no fechamento: lê os pendentes da loja até aquela

competência e soma no total de cada colaborador. O que o cliente mandar em ajustes é ignorado. O valor do mês continua gravado à parte (valor_apurado) e os ajustes vão no item (ajustes, valor_ajustes); valor_total passa a ser o líquido.

• Estorno maior que o valor do mês: o CNAB não paga negativo, e o sistema não cria dívida

silenciosa. O fechamento recusa (422 com quem ficou negativo) e a tela oferece parcelar em 2 ou 3 vezes: o lançamento original é cancelado e cada parcela nasce apontada para uma competência seguinte, com centavos exatos (as primeiras levam o piso, a última o resto). Líquido zero é permitido.

• Desligado no período: a decisão Pagar / Não pagar engloba as parcelas pendentes dele —

pagar soma; não pagar cancela-as com esse motivo (e reabrir a folha as devolve).

• Quem não está na folha (inativo, sem competências) não entra sozinho: o lançamento fica

pendente e aparece no relatório Lançamentos avulsos pendentes (todas as lojas, inclusive de quem já saiu), que é o que se confere antes de fechar uma rescisão.

• O Relatório de folha mostra os lançamentos numa coluna própria (Ajustes) e o total

líquido: em loja com folha fechada, o que ela incorporou; em loja aberta, os pendentes que vão entrar (marcados pendente). Quem vê o relatório pode ler os lançamentos; lançar, cancelar e parcelar continuam só com a seção Folha.

• Sai no espelho da operação (seção própria, com referência, parcela, motivo e autor —

inclusive os cancelados pela decisão de não pagar), no CSV da folha e na tela do colaborador ("Ajustes de períodos anteriores incluídos neste valor").

Uma contestação deferida ainda não gera lançamento sozinha: hoje o gestor lança à mão, com a decisão como motivo. O desenho permite ligar isso depois.

Decisão da gestão sobre a contestação#

Cada contestação recebe uma decisão explícita — deferida ou indeferida — sempre com motivo obrigatório. A justificativa é o que o colaborador tem direito de saber, e é ela que transforma a contestação em um ciclo fechado em vez de um recado sem resposta.

• Deferida — a alegação procede. Deferir não altera o valor: para corrigir, reabre-se a

folha, ajusta-se o lançamento e fecha de novo — ou, se a folha já foi paga, faz-se um lançamento avulso na próxima.

• Indeferida — a alegação não procede, e o motivo explica por quê.

A decisão pode ser revista enquanto a folha permitir, e cada mudança fica na auditoria (FOLHA_DEFERIDA / FOLHA_INDEFERIDA), com o teor anterior preservado.

Contestação, decisão, motivo, autor e data saem no espelho da operação (seção 9).

A permissão para fechar é conferida no servidor, não apenas na tela — por envolver valores de pagamento.

8.1 Sincronização com o RH#

O KPI não tem conector próprio com a folha. Ele lê do hub Gorjetas, que é o espelho do Senior alimentado pelo conector on-prem — um cadastro, um desligamento, um lugar.

O KPI é um subconjunto. Ele remunera a gestão, não as 447 pessoas. Por isso a sincronização não cria ninguém sozinha:

Intocáveis pela sincronização: nome (é chave de vínculo em usuarios e kpis.gestor), Possibilidade, competências e pesos, grupo do Valoriza.

O que é "gestão": a própria lista de cargos do KPI. Quem tem cargo que resolve para um cargo do KPI — direto ou por de-para — é candidato; o resto é operacional e não vira pendência. Não há cadastro separado de "cargos gerenciais": criar o cargo no KPI é o que o torna elegível.

De-para. Loja do hub → loja do KPI e cargo do Senior → cargo do KPI. Nomes iguais (ignorando acento, maiúsculas e espaços) casam sozinhos; o resto pede um humano, uma vez. Pessoa com loja sem de-para fica sem loja; cargo sem de-para deixa a superação por cargo sem alcançá-la — os dois aparecem em Sem de-para.

Quando roda: todo dia numa hora configurada, e sob demanda pelo botão. Cada rodada guarda o resultado inteiro; a tela lê da última rodada, sem bater no hub de novo.

9. Roadmap de pagamento#

A ficha do colaborador guarda banco, agência, conta e endereço completo — exigidos pelo arquivo do banco. Esses dados podem ser preenchidos um a um ou importados do próprio arquivo de remessa já usado no banco, casando pelo CPF.

A fase 3 tem a especificação pronta, mapeada de um arquivo real já aceito pelo banco — ver CNAB 240 Santander.

O CNAE 6422-1/00 citado em conversas é a classificação de atividade do banco, não um formato de arquivo. O formato correto é o CNAB 240 (FEBRABAN).

Espelho da operação#

Junto com o arquivo de remessa é baixado um espelho em PDF — o extrato detalhado da mesma operação. O arquivo do banco é ilegível para conferência humana; o espelho é o documento que explica, para quem aprova e para quem audita, o que foi enviado e por quê.

O espelho traz:

O detalhamento vem da apuração congelada no fechamento, não de um recálculo: o espelho mostra o que foi pago como foi pago, mesmo que lançamentos mudem depois.

Contestações ainda sem decisão aparecem marcadas como pendente de decisão — o espelho não esconde o que ficou em aberto.

O PDF é montado no navegador, sem biblioteca externa, no mesmo padrão de documento usado pelo sistema de Auditoria de Qualidade Garantida.