Ao extrair uma nova base, selecione exatamente estas colunas em cada relatório. O Informativo de Vendas deve ser extraído sempre com Jan/2025 até a data mais recente (não só o mês corrente) — é o que alimenta os comparativos Ano a Ano.

📊 Informativo de Vendas (2025 + 2026, num arquivo só ou dois)

Novo (Out/2026): Escritório de Venda e Código Escritório Vendas (ex.: P074 – SP VALINHOS AT) passam a vir em toda extração do Informativo — no reprocessamento mensal (Parcial) e nas atualizações diárias (Vigente). Alimentam a tela Time vendendo (o time é formado pelos vendedores do mesmo escritório do usuário). Se as colunas faltarem, o dashboard assume o escritório P074 e avisa no processamento.

👥 Carteira de Clientes

🎯 Metas por vendedor

Quando eu monto uma base pra transferir clientes pra um vendedor, uso este layout fixo (peça "base de transferência" que eu já sigo esse padrão):

Mapeamento: Mês de referência = mês atual da geração · Escritório de Vendas/Código = colunas Escritório de Venda/Cód Escritório de Venda da Carteira · Atual Proprietário = Proprietário · Novo Proprietário = vendedor solicitado na transferência · Código ERP = Código ERP Proprietário · Categoria do cliente = Categoria.

Critério de seleção (padrão, ajustável por pedido): clientes ATIVOS ficam com o vendedor atual; clientes INATIVOS podem ser movidos; inadimplentes normalmente ficam fora da seleção, exceto quando a transferência é "limpeza de base" (vendedor saiu da empresa) — nesse caso a carteira inteira vai junto, sem exceção.

• Receita = Custo Total Venda + Margem Bruta R$ (confirmado batendo % Custo Total Venda + % Margem Bruta = 100%), ou direto da coluna Receita quando disponível.
• Cliente ativo (regra padrão do dashboard) = Qtd Dias Sem Comprar < 60 (Revenda) ou < 180 (Consumo); clientes que nunca compraram são sempre "inativos", nunca "ativos".
• Cluster BI (Ativo/Inativo/Prospect) é uma classificação separada, vinda pronta do BI de origem — não é a mesma coisa que a regra de recência acima; os dois números não batem entre si por design.
• Deduplicação da carteira: quando um cliente aparece em mais de uma linha (uma por Cluster BI), foi mantida apenas a linha com maior R$ Acumulado diferente de zero.
• Cruzamento vendedor entre relatórios feito pelo código ERP/SAP, não pelo nome em texto (nomes divergem entre bases — ex: "André Aguiar" nas vendas é "Andre Luiz Caricchio Aguiar" na carteira).
• Vendedores sem meta em algum mês = não trabalhavam na filial naquele período.
• Segmento (receita real): cruza o CNPJ do Informativo de Vendas com a Categoria da Carteira (Revenda/Consumo) — diferente do "Segmento (cadastro)", que é só o que está na Carteira sem olhar se o cliente realmente comprou.
• Positivação (ranking e KPIs gerais) = nº de clientes distintos por CNPJ que compraram no período filtrado (receita líquida > 0: cliente que só devolveu não conta; mesma regra de Clientes no Período) — conta de novo a cada período, não é "cliente novo".
• Meta Positivação (coluna do ranking): mínimo 40 clientes/mês; acima disso, meta = média dos 3 meses imediatamente anteriores × (​+20% até 60 · +15% até 80 · +10% até 100 · +5% acima de 100), sempre arredondado pra cima. Só existe a partir do 4º mês de histórico do vendedor, e some se ele não tem Meta R$ cadastrada naquele mês. Não é acumulativa — só aparece filtrando um único mês.
• Clientes inativos críticos = fora da regra de ativo, ordenado do MAIOR pro menor tempo sem comprar (mais difícil de reativar). Inativos menos críticos = mesmo grupo, ordenado do MENOR pro maior (compraram mais recentemente, mais fácil de reativar). Máximo 15 cada, geral ou por vendedor filtrado.
• Clientes sumidos = compraram em algum momento de 2025 e não têm nenhuma venda em 2026 até a data mais recente da base. Atribuídos ao vendedor atual da carteira (não a quem vendeu em 2025).
• Comparativo Ano a Ano: "mesmo recorte" corta o mês corrente no mesmo dia nos dois anos (ex: dados até 10/08 → agosto/2025 também cortado no dia 10) pra comparação justa. Só filtra por vendedor quando o nome é idêntico nos dois anos — quem não tem correspondência (equipe que já saiu, ex-"Vali") só entra no total "Todos os vendedores".
• Top clientes / Positivação sempre agrupam por CNPJ, nunca por nome — evita unificar filiais/empresas diferentes que compartilham nome de fantasia.

Janela da semana: Segunda a Sábado, mas nunca atravessa virada de mês — corta no último dia do mês (qualquer que seja o dia da semana) e a semana seguinte começa no dia seguinte, indo até o próximo Sábado.

Faturamento: meta calculada automaticamente = Meta Hoje (a mesma meta dinâmica diária já usada no Farol/card do vendedor: gap do mês ÷ dias úteis restantes do mês) × quantidade de dias da janela da semana — recalcula sozinha todo dia. Realizado = soma da receita nos dias da janela.

Positivação: mostrada como Ativações na semana (mesmo número já usado em "Ativações Ontem") — sem meta, só o realizado.

Pneus Truck / OHT / Roda: meta ainda vem da planilha que você envia toda semana (agora só essas 3 colunas). Realizado = unidades vendidas nos dias da janela.

Só aparece o vendedor que tiver pelo menos uma meta computável na semana (Meta R$ no mês vigente, ou meta de Truck/OHT/Roda na planilha). Quando a virada de mês cai no meio da semana, chegam duas planilhas de Truck/OHT/Roda naquele ciclo — uma pra cada pedaço da semana.

Quando um vendedor novo entra (ex: recebe uma transferência de carteira e começa do zero), preciso que você me passe manualmente:

• Nome e código ERP dele (acho automaticamente se ele já aparecer como Proprietário na Carteira).
• Meta de faturamento do mês (não tem histórico pra calcular sozinho — é a base da meta de Faturamento da semana também, já que ela é calculada a partir dela).
• Meta de positivação do mês — se não informado, uso o piso padrão de 40 clientes/mês (mesma regra dos demais).
• As metas semanais de Pneus Truck/OHT/Roda, quando quiser incluí-lo (pode ser numa semana seguinte, não precisa ser na primeira).

Sem venda ainda, ele aparece no ranking com R$0 realizado, mas os KPIs de carteira (clientes, ativos, cidades, etc.) já funcionam normalmente a partir do que ele já tem cadastrado como Proprietário.

A tela 🧭 Time vendendo (permissão time_vendendo, liberada por usuário em Gestão de Usuários) mostra as unidades vendidas pelo time por SKU e por medida na semana atual e na semana anterior (segunda a domingo, sempre dentro do mês; a semana de virada do mês é cortada no dia 1). "Semana atual" = semana do último dia com dado no Informativo. O time são os vendedores do mesmo escritório de vendas (filial) do usuário. A filial do vendedor vem automaticamente do Informativo (escritório onde ele mais vendeu; quem não vendeu no mês mantém a última conhecida, e quem nunca vendeu com escritório fica na P074 até o reprocessamento mensal) — não é editável. A coluna filial da aba Usuários vale só para admin (ex.: P074 - SP VALINHOS AT). Para cadastrar uma filial nova, ela basta aparecer no Informativo (colunas de escritório) — a lista da Gestão de Usuários é montada a partir dele.

Admin e filial (Time vendendo): admin com a filial em branco vê todas as filiais (seletor com “Todas as filiais” quando houver mais de uma); admin com filial preenchida vê só aquela (em Gestão de Usuários o admin tem caixas de seleção para marcar mais de uma filial — ex.: ver a P074 e a P080, mas não a P090; na planilha ficam separadas por ;). Por enquanto isso vale só para o Time vendendo; a restrição por filial no restante do dashboard fica para o próximo reprocessamento mensal.

O vendedor vê só totais do time (unidades, nº de vendedores, nº de clientes) e a própria venda — sem nomes de colegas e sem preço. A Gestão vê também preço mínimo / médio (média simples das linhas) / máximo, margem % e quem vendeu. Linhas de devolução (unidades ≤ 0) ficam de fora. Filtros de Período, Categoria, Marca e UF de faturamento (esta só para a Gestão, quando o Informativo traz a coluna UF Faturamento) aceitam seleção múltipla; a marca aparece sempre em maiúsculo e o SKU copia com um clique.

Este arquivo não se conecta ao BI automaticamente. Para atualizar: extraia as 3 bases (Informativo de Vendas 2025+2026, Carteira, Metas) com as mesmas colunas do checklist acima, envie os arquivos de novo pro Claude nesta conversa (ou uma nova) e peça para reprocessar o dashboard — ele reaplica todas as regras acima e gera uma nova versão do HTML. Metas de Pneus Truck/OHT/Roda já preenchidas na planilha da semana são preservadas automaticamente entre atualizações, só o realizado é recalculado; Faturamento e Positivação dos Resultados da Semana são sempre recalculados ao vivo, não dependem de planilha.