Importar metas por planilha
Baixe o modelo com o código de cada representante, preencha as metas e confira o resultado da importação.
Última revisão:
Para que serve
Cadastrar de uma vez as metas dos representantes para um mês. A meta é sempre por representante e por mês: o modelo XLSX já vem com o código e o nome de cada representante ativo, e você preenche só o valor de quem tem meta.
Quem pode usar
Administradores com acesso a Metas. Metas que usam outro KPI como referência ficam somente leitura e não passam por este fluxo.
Antes de começar
- Em Metas, escolha Representante no campo Segmento, o KPI de entrega e o mês. O mês escolhido é o que vem preenchido no modelo.
- O representante precisa estar ativo e com código no cadastro de representantes. Quem não tem código não aparece no modelo, e a meta dele não tem como ser importada.
A planilha
A primeira linha traz os cabeçalhos, exatamente como abaixo. Cada linha seguinte é um representante em um mês.
| Coluna | Obrigatória | O que colocar |
|---|---|---|
periodo | Sim | Mês da meta, como texto no formato AAAA-MM (ex.: 2026-10). Já vem preenchido. |
codigo_rep | Sim | Código do representante no cadastro. Já vem preenchido; não altere. |
nome_rep | Não | Nome do representante, só para você conferir. A importação ignora. |
realizado | Não | Realizado do mês, só como referência. A importação ignora. |
meta_valor | Sim, para quem tem meta | Valor da meta. Use vírgula para decimais (ex.: 150000,50). |
Deixe meta_valor em branco para quem não tem meta naquele mês: a linha é ignorada e uma meta já cadastrada continua como está. Se preferir montar a planilha por conta própria, use os mesmos cabeçalhos na primeira linha.
O mês que vale é o da coluna
periodo, não o selecionado na tela. Uma planilha com vários meses grava todos eles no KPI escolhido.
Como fazer
- Abra Metas e selecione Representante em Segmento, o KPI e o mês.
- Clique em Baixar modelo.
- Preencha a coluna
meta_valordos representantes que têm meta. As demais colunas ficam bloqueadas no modelo. - Salve o arquivo e volte à mesma seleção em Metas.
- Clique em Importar planilha e selecione o arquivo preenchido.
- Leia o resultado: a quantidade de metas importadas e, se houver, os erros por linha.
- Confira os valores na tela antes de considerar a rotina encerrada.
Por exemplo, Carla Rocha baixa o modelo de outubro da Aurora Distribuidora, que traz todos os representantes ativos. Ela preenche as metas de Ana Lima e Bruno Costa, deixa as demais linhas em branco e importa o arquivo. O resultado mostra "2 metas importadas".
O que conferir
A interface distingue três situações: nenhuma meta importada, importação parcial e sucesso. Em uma importação parcial, as metas aceitas já estão gravadas; um erro em uma linha não desfaz as outras. Use Baixar relatório para guardar a lista de erros, corrija as linhas indicadas e importe de novo. Importar a mesma meta outra vez apenas regrava o valor.
Dúvidas e problemas
Um representante não aparece no modelo. Ele está inativo ou sem código no cadastro de representantes. Ajuste o cadastro e baixe o modelo de novo.
"Código de representante desconhecido ou ambíguo". O código da linha não corresponde a um único representante ativo. Confira se o código foi alterado na planilha ou se o representante foi desativado.
"coluna codigo_rep ausente ou ambígua" (ou periodo, meta_valor). O cabeçalho está faltando, foi renomeado ou aparece duas vezes. A primeira linha precisa ter os nomes da tabela acima, uma vez cada.
"período inválido". A coluna periodo precisa ser texto no formato AAAA-MM. Se o Excel converteu a célula para data, digite o mês de novo como texto.
"nenhuma meta preenchida". Nenhuma linha tinha valor em meta_valor. Confira se você selecionou o arquivo preenchido, e não o modelo vazio.
"Código de representante exige KPI por representante". O KPI escolhido na tela não é por representante. Em Segmento, escolha Representante e selecione um KPI dele.
