Processos de ponta a ponta

Última atualização: 23/07/2026

Este documento organiza os processos operacionais, seus responsáveis, entradas, decisões e resultados.

1. Acesso e escopo

Atores: todos os perfis.

1. O usuário acessa a experiência correspondente: backoffice, vendedor ou tablet.
2. O backend valida e-mail/senha, vendedor/PIN ou dispositivo/senha.
3. O token recebe empresa, papel e loja quando aplicável.
4. Menus, filtros e dados são limitados pelo perfil.
5. Uma resposta 401 encerra a sessão e leva o usuário ao login.

Resultado: o usuário acessa apenas as lojas, pessoas, metas e vendas autorizadas.

2. Preparação dos cadastros

Responsável: administrador; supervisor dentro de seu escopo.

1. Cadastrar ou revisar supervisores.
2. Cadastrar lojas com código, nome, CNPJ, código Protheus, cidade, estado, dias e horários de funcionamento.
3. Vincular cada loja ao supervisor responsável.
4. Cadastrar líderes e vendedores sem reutilizar e-mail ou código de PDV.
5. Definir a loja padrão e o período profissional.
6. Registrar foto somente por upload autorizado de até 2 MB, ajustar o recorte da miniatura e aplicar; o sistema não gera fotos nem armazena Base64 no banco.
7. Cadastrar férias, ausências, coberturas e transferências.
8. Conferir a aba Auditoria da pessoa.

Resultado: a estrutura organizacional fica apta a receber vendas e metas.

3. Calendário comercial

Responsável: administrador.

1. Abrir Configurações > Feriados.
2. Criar feriado ou ponto facultativo.
3. Informar abrangência nacional, estadual ou municipal.
4. Selecionar as lojas que usufruem da data.
5. Definir se a ocorrência sai da contagem dos dias de meta.
6. Revisar o calendário antes da criação das metas do mês.

Resultado: dias disponíveis respeitam calendário e operação de cada loja.

4. Criação e publicação de metas

Responsável: administrador ou supervisor.

Pré-condições: loja, vendedores, vigências, ausências e calendário atualizados.

1. Em Metas > Criar meta, selecionar a loja.
2. Informar mês e ano. A duplicidade só é verificada após essa escolha.
3. Confirmar período completo ou datas de início e fim.
4. Revisar a divisão automática por semanas e os dias da semana.
5. Informar Meta principal, Meta 2 e Meta 3.
6. Distribuir o total da loja entre os dias elegíveis, ajustando dias de maior ou menor movimento conforme a estratégia comercial.
7. Conferir que as três somas diárias fecham exatamente com as metas mensais.
8. Avançar para a distribuição por vendedor; cada meta diária da loja é dividida apenas entre os profissionais disponíveis naquela data.
9. Ajustar valor fixo ou percentual por vendedor, se necessário.
10. Abrir o calendário individual e ajustar vendedor por vendedor e dia por dia.
11. Conferir dois níveis de fechamento: cada dia deve fechar com a meta diária da loja e a soma do mês deve fechar com a meta mensal.
12. Salvar e publicar.

O cálculo considera:

• dias de funcionamento da loja;
• início e fim do vínculo do vendedor;
• loja padrão e lotações temporárias;
• férias e ausências;
• feriados e pontos facultativos excluídos;
• ajustes manuais feitos no assistente.

Para editar, abra Metas > Gerenciar. O mesmo assistente é carregado preenchido; loja, mês e período ficam travados quando não podem ser alterados.

Resultado: meta publicada e disponível nos indicadores da loja e do vendedor.

Importação de metas diárias por planilha

1. Em Metas > Gerenciar, selecionar Importar planilha.
2. Escolher o mês e baixar o modelo, que contém todas as lojas e datas.
3. Preencher a Meta principal por loja e dia; manter zero nos dias sem meta.
4. Preencher Meta 2 e Meta 3 ou deixá-las vazias para aplicar 115% e 130%.
5. Enviar o arquivo e conferir lojas, mês, dias zerados e total mensal na prévia.
6. Selecionar Importar e publicar.
7. Conferir os ciclos na matriz de gerenciamento e os valores no Dashboard.

O importador também reconhece a matriz de sazonalidade recebida para agosto de 2026. Linhas consolidadas por supervisão são ignoradas; somente linhas associadas a lojas cadastradas são importadas. O lote inteiro é cancelado se houver conflito ou erro. A planilha não altera cadastro de lojas, feriados, férias ou lotações.

Resultado: metas mensais, diárias e por vendedor publicadas com fechamento exato, mantendo explicitamente os dias zerados.

5. Entrada de vendas pelo Protheus

Responsável: agendador da API; administrador no acompanhamento.

1. A rotina horária consulta o dia atual.
2. A rotina diária revisa a janela retroativa configurada.
3. No fechamento, a rotina consulta o mês anterior inteiro.
4. A API identifica lojas, notas e itens; o vendedor é localizado somente nos cadastros existentes do GV, primeiro por CPF e depois por loja + código Protheus/PDV.
5. Novas notas são criadas; notas conhecidas são comparadas.
6. A sincronização não cria, ativa nem atualiza vendedores. Vendedor não localizado gera pendência no Validador NF para vínculo manual.
7. Cada carga tenta novamente vincular vendas pendentes aos vendedores cadastrados depois da carga anterior.
8. Divergências geram pendência de NF.
9. Totais de validação diária são recalculados.
10. O resultado fica no log da fonte de dados, incluindo vínculos encontrados e vendedores não localizados.

Resultado: vendas conciliáveis e rastreáveis, prontas para validação e análise.

6. Entrada manual por planilha

Responsável: administrador.

1. Em Configurações > Integrações, selecionar fonte Manual.
2. Baixar a planilha padrão.
3. Preencher data, identificação da loja, vendedor, valor, peças e documento.
4. Não alterar nomes de colunas do modelo.
5. Enviar arquivo XLSX, XLS ou CSV de até 10 MB.
6. Conferir linhas lidas, criadas, atualizadas e falhas.
7. Consultar o log de dados recebidos.
8. Corrigir somente as linhas com falha e reenviar.

Resultado: vendas manuais seguem a mesma base de lojas, vendedores e validações.

7. Validação diária de dados

Responsável: administrador, supervisor ou líder dentro do escopo.

1. Abrir Auditoria > Validador de dados.
2. Conferir os números de validados, aguardando e alterados.
3. Escolher visão em lista ou calendário.
4. Filtrar período, loja e status.
5. Na visão de lista, ajustar quantidade por página e navegar pela paginação.
6. Abrir o dia da loja.
7. Conferir total da loja e linhas por vendedor.
8. Validar sem edição ou corrigir venda, peças e quantidade de vendas.
9. Registrar observação quando necessário.
10. Ativar bloqueio de atualizações automáticas quando a conferência manual deve prevalecer sobre futuras cargas daquela data.
11. Salvar e validar.

Estados:

• Aguardando validação: carga recebida, ainda não conferida;
• Validado: conferido sem alteração;
• Validado com edição manual: algum total foi alterado.

Resultado: fechamento diário identificado por status, usuário e horário.

8. Validação de divergências de NF

Responsável: administrador, supervisor ou líder dentro do escopo.

1. Abrir Auditoria > Validador NF.
2. Filtrar pendências, período, loja, tipo ou número da nota.
3. Quando houver vendedores recém-cadastrados, usar Sincronizar novos vendedores.
4. O sistema reprocessa todas as NFs sem vendedor dentro do escopo selecionado, usando CPF ou loja + código PDV, e informa vinculadas e ainda pendentes.
5. Abrir uma nota restante e comparar anterior versus recebido.
6. Corrigir vendedor, data, quantidade e valor quando necessário.
7. Decidir se a NF deve contabilizar nos indicadores e metas.
8. Registrar observação.
9. Salvar e validar.

Resultado: uma decisão auditável substitui a pendência; futuras cargas idênticas reconhecem a versão já validada.

9. Lista da vez e atendimento no tablet

Responsável: líder de loja e vendedores.

1. Entrar no tablet cadastrado para a loja.
2. O vendedor informa seu PIN para entrar na fila.
3. A fila opera em ordem; arrastar para atendimento inicia o registro.
4. Pausas exigem um motivo e retiram temporariamente o vendedor da fila.
5. Ao finalizar, marcar venda ou perda.
6. Em perda, selecionar um dos motivos ativos configurados.
7. Sem conexão, os eventos ficam na fila local e são enviados em lote na retomada.
8. Ao encerrar o dia, o sistema abre cada atendimento pendente para conclusão no fluxo normal.
9. Depois do último atendimento, registra o encerramento e limpa a fila do dia.

Resultado: atendimentos, conversões, perdas e produtividade alimentam relatórios.

10. Acompanhamento no dashboard

Responsável: administrador, supervisor e líder.

1. O período padrão é o mês corrente.
2. O usuário pode mudar início, fim e loja dentro do próprio escopo.
3. O filtro é preservado ao sair e voltar ao dashboard.
4. O comparador com o mês anterior pode ser ligado ou desligado.
5. Cada indicador mostra valor atual, valor anterior, variação e direção.
6. Performance compara meta e venda do dia e do acumulado.
7. O quadro de lojas sinaliza atingimento versus avanço do período.
8. O detalhamento agrupa por supervisor ou loja.
9. No agrupamento por supervisor, todas as lojas do mesmo responsável são somadas.
10. No agrupamento por loja, a coluna do supervisor identifica o responsável.

Resultado: leitura executiva do período com contexto de ritmo e comparação.

11. Relatórios

Responsável: administrador, supervisor e líder.

• Raio-X: visão hierárquica por supervisor, loja e vendedor; filtros dependentes travam vínculos já determinados.
• Comparador de períodos: período atual, mesmo intervalo do ano anterior (L.Y.) e variação para metas, vendas, conversão, peças, ticket e produtividade; o período imediatamente anterior permanece disponível como alternativa.
• Analítico de vendas: cada venda/NF recebida, com origem, loja, vendedor, data, valor e estado; usado para reconciliação com o ERP.
• Motivo de perda: distribuição e evolução das perdas registradas no tablet.

Resultado: análise detalhada, investigação e prestação de contas.

12. Auditoria

Responsável: administrador; demais perfis no próprio escopo.

1. Acessar a trilha pela aba Auditoria do funcionário ou por Configurações.
2. Filtrar pessoa, entidade, ator ou quantidade.
3. Conferir ação, data, autor e estados anterior/posterior.
4. Não editar diretamente o banco para corrigir uma ação funcional.

Resultado: rastreabilidade de cadastros, validações, metas e configurações.