Askora
Entrar Cadastre-se

SPM Manual do usuário

Manual passo a passo do usuário para utilização do SPM Askora.

1) Visão geral

O Askora é uma plataforma de SPM criada para dar mais controle, clareza e inteligência à gestão comercial e à remuneração variável. Na prática, ele ajuda a empresa a organizar toda a operação que envolve vendas, metas, comissões, incentivos e recebimentos, transformando processos que normalmente ficam espalhados em planilhas, controles manuais e conferências demoradas em um fluxo centralizado, claro e confiável.

Mais do que acompanhar resultados, o Askora foi pensado para resolver problemas reais da rotina comercial. Ele registra o pedido, acompanha o andamento financeiro daquela venda, controla o que está em aberto, o que venceu, o que foi recebido parcialmente, o que foi pago à vista e o que está parcelado. Com isso, a empresa consegue ter uma visão muito mais organizada do contas a receber e também do impacto disso na remuneração do time comercial.

Esse ponto é especialmente importante em operações em que a comissão não depende apenas da venda realizada, mas também do recebimento do pedido. Em muitos negócios, o vendedor fecha a venda, mas o pagamento da comissão só acontece depois que o cliente paga, seja de forma integral, parcial ou em parcelas como 30, 60 e 90 dias. Sem uma ferramenta adequada, esse controle costuma gerar dúvidas, ruídos, atrasos, retrabalho e desgaste entre gestão, financeiro e time comercial. O Askora resolve isso ao conectar o pedido ao recebimento e, a partir daí, refletir com clareza o que realmente entra na remuneração do vendedor.

Na prática, isso significa que tanto o gestor quanto o vendedor conseguem enxergar melhor a realidade da operação. O gestor passa a ter mais controle sobre o que foi vendido, o que foi recebido, o que ainda está pendente, o que já pode ser pago em comissão e o que ainda depende de pagamento do cliente. Já o vendedor deixa de trabalhar no escuro. Ele consegue entender com mais clareza quanto tem para receber, quais vendas já geraram saldo de comissão, quais ainda dependem de recebimento, quais estão vencidas e como sua remuneração está sendo formada em tempo real. Isso reduz muito as dúvidas e os desgastes comuns do dia a dia, trazendo mais transparência e confiança para a operação.

O Askora também vai além do controle financeiro da venda. Ele foi desenvolvido para concentrar em um único fluxo toda a lógica de remuneração variável da equipe. Isso inclui comissões simples e complexas, bônus, campanhas de incentivo, metas, ranking, regras específicas por operação e diferentes métricas de desempenho. Em vez de a empresa depender de controles paralelos e interpretações manuais, o sistema organiza essas regras de forma estruturada, deixando o cálculo da remuneração mais claro, consistente e fácil de acompanhar.

Outro diferencial importante é que o Askora não atua apenas como ferramenta de controle, mas também como motor de performance comercial. Como o sistema acompanha tudo em tempo real, ele consegue transformar dados da operação em acompanhamento prático para o vendedor. Isso aparece em recursos como metas diárias, evolução de performance, acompanhamento de resultados e visualização clara do progresso da remuneração. Quando o vendedor entende exatamente onde está, o quanto já produziu, o quanto falta para atingir seus objetivos e o que já está garantido para receber, ele trabalha com mais direção, mais confiança e menos distração com problemas operacionais.

Esse ganho de clareza gera impacto direto no dia a dia da empresa. A operação fica menos dependente de planilhas desorganizadas, menos sujeita a erros manuais, menos vulnerável a interpretações diferentes sobre comissão e menos carregada de retrabalho. O time de gestão ganha mais visibilidade e segurança para tomar decisões. O financeiro consegue acompanhar melhor o reflexo dos recebimentos. E o time comercial passa a focar mais no que realmente importa, que é vender, sabendo que sua remuneração está sendo acompanhada de forma organizada e transparente.

O uso do Askora também é flexível. Ele pode ser utilizado de forma totalmente interna, com a operação concentrada dentro do próprio sistema, permitindo que a empresa tenha em um só lugar tudo o que precisa para registrar pedidos, acompanhar recebimentos, analisar performance e controlar remuneração. Ao mesmo tempo, a plataforma também se adapta a diferentes realidades de negócio por meio de integrações. Isso permite que o Askora funcione em conjunto com outros sistemas, planilhas, APIs, importações e diferentes estruturas operacionais, sem exigir que a empresa abandone por completo sua forma atual de trabalho para começar a ganhar organização e inteligência no processo.

Além da experiência no sistema web, o Askora também conta com aplicativo, o que facilita muito o uso no dia a dia. Com informações acessíveis na palma da mão e notificações que mantêm o time atualizado, tanto gestores quanto vendedores conseguem acompanhar a operação de forma mais prática e constante. Isso aumenta o uso real da ferramenta e aproxima o sistema da rotina comercial, tornando o acompanhamento mais natural e útil.

De forma resumida, o Askora existe para transformar a gestão comercial e a remuneração variável em algo claro, organizado, confiável e vivo no dia a dia da empresa. Ele não serve apenas para mostrar números. Ele serve para dar contexto, controle e segurança sobre toda a jornada da venda até a remuneração. Com isso, reduz ruídos, evita desgastes, melhora a organização da operação, fortalece a gestão e cria um ambiente em que o time comercial entende melhor sua própria performance e sua remuneração. O resultado é uma operação mais estruturada, mais transparente e mais eficiente para todos os envolvidos.

Permissões e páginas principais

As páginas do Askora aparecem conforme o perfil do usuário. O objetivo é manter cada pessoa na visão que faz sentido para sua rotina: o Master tem acesso amplo, o Administrador trabalha dentro das organizações liberadas e o Vendedor usa as áreas operacionais e de acompanhamento.

Ação ou página Master Administrador Vendedor
Home, Performance, Resultados, Operações, Perfil e Suporte Sim Sim Sim
Financeiro Sim, quando o módulo estiver ativo Sim, quando o módulo estiver ativo Sim, quando o módulo estiver ativo
Gerenciador Sim Sim, com acesso limitado às organizações permitidas Não
Integrações Sim Não Não
Gerenciar organizações Sim Não Não
Gerenciar usuários, performance, clientes e produtos Sim Sim, dentro das organizações liberadas Não
Gerenciar Gerenciador Financeiro Sim Sim, dentro das organizações liberadas Não
Registrar lançamentos e acompanhar a própria operação Sim Sim Sim
Aprovar ou negar liberações Sim Sim Não

Se uma página não aparecer no menu, ou se um botão estiver indisponível, isso significa que o perfil não tem acesso àquela função ou que o recurso ainda não foi ativado no ambiente.

Página a página

Esta seção resume o uso prático de cada página principal do Askora no dia a dia da operação. A leitura ideal é: entender para que a página serve e, em seguida, usar os pontos abaixo como referência rápida do que você encontra e quando usar.

Home (/home)

A Home é a porta de entrada da operação. Ela serve para entender rapidamente como o time está no ciclo atual, sem precisar abrir vários módulos.

  • Filtros por performance e organização para trocar o recorte da leitura.
  • Cards com visão executiva do período selecionado.
  • Ranking dos vendedores e premiações da competição ativa.
  • Cronômetro de fechamento da performance.

Performance (/performance)

A página Performance é a visão analítica do ciclo. Ela transforma os dados da operação em leitura de ritmo, evolução e tendência, ajudando o usuário a enxergar onde agir.

  • Filtros por performance, organização e vendedor.
  • Resumo consolidado do período selecionado.
  • Visões de fluxo, ritmo e alertas para leitura rápida.
  • Gráficos e blocos de comparação com a performance anterior.

Painel de Performance (/painel-performance)

O Painel de Performance é a versão de exibição contínua para acompanhamento coletivo, como em TV, monitor ou reunião.

  • Visão ao vivo com atualização automática.
  • Exibe ranking, progresso de meta, vendas e premiações.
  • Funciona bem para acompanhamento do time em tela grande.

Resultados / Comissoes (/resultados, /comissoes)

Esta página é o consolidado de performance do ciclo. Aqui o usuário valida quanto foi gerado em comissão, bônus e total no período selecionado.

  • Resumo financeiro consolidado do período.
  • Filtros por performance, organização e vendedor.
  • Card de evolução de comissão com faixa ativa e indicadores do período.
  • Relatório gerencial e geração de documentos conforme o recorte aplicado.
  • Para follow-up de vencimento e pagamento, use a página Financeiro (/financeiro).

Operações (/operacoes)

A página Operações é a rotina diária da equipe. É nela que os lançamentos, bônus, score e liberações entram no fluxo de trabalho.

  • Lançamentos: registro da venda e dos dados comerciais.
  • Painel de Lançamentos: revisão e ajuste fino dos registros.
  • Painel Financeiro: acompanhamento dos status financeiros.
  • Bônus: atualização de resultados vinculados à performance.
  • Score: acompanhamento dos resultados de score.
  • Importações e liberações: envio de arquivos e análise das pendências do fluxo.

Painel de Lançamentos (/operacoes?aba=painel-lancamentos)

O Painel de Lançamentos é a camada de auditoria e ajuste fino. Ele é usado quando a operação precisa revisar registros, corrigir informações e manter rastreabilidade.

  • Busca e filtros para localizar lançamentos específicos.
  • Edição, exclusão e exportação para análise externa.
  • Uso recomendado quando a operação precisa corrigir dados já registrados.
  • O foco aqui é operacional, não o controle de vencimento ou pagamento.

Compatibilidade: o atalho legado /painel-lancamentos redireciona para esta aba.

Painel Financeiro (/operacoes?aba=financeiro)

O Painel Financeiro acompanha o ciclo financeiro dos lançamentos. Ele mostra o que precisa ser liberado, o que está no prazo, vencido, liberado ou cancelado.

  • Status operacionais: liberar, no_prazo, vencidos, liberado e cancelado.
  • Ações em lote para liberar, cancelar e reabrir conforme permissão.
  • Atualização de status e data financeira com rastreabilidade.
  • Exportação da visão financeira para Excel.

Perfil (/perfil)

A página Perfil centraliza a manutenção da conta de cada usuário. É a área para manter acesso e dados pessoais atualizados.

  • Atualização de nome, e-mail, foto e senha.
  • Consulta das informações da própria conta.
  • Visualização das conquistas e notificações do usuário.

Gerenciador (/gerenciador)

O Gerenciador é a central administrativa do Askora. Nessa tela, o usuário escolhe qual área quer administrar e entra diretamente no módulo correspondente.

  • Gerenciador de Performance: cadastro e manutenção das regras comerciais da operação.
  • Gerenciador Financeiro: configuração das regras do fluxo financeiro.
  • Gerenciador de Usuários: controle de acesso e vínculo com organizações.
  • Gerenciador de Organizações: cadastro da estrutura da conta, quando disponível no perfil.
  • Gerenciador de Clientes: organização da base de clientes.
  • Gerenciador de Produtos: cadastro e padronização dos itens usados na operação.

Gerenciador de Performance (/gerenciador/performance)

Este é o módulo em que o usuário monta e mantém as performances da operação. Ele concentra os filtros, os cartões de resumo e o acesso ao cadastro completo em 5 passos.

  • Busca por nome e filtros por competência e organização.
  • Cards com resumo da configuração da performance.
  • Ações de editar e duplicar para reaproveitar ciclos já montados.
  • Cadastro detalhado de vendedores, comissionamento, bônus e competição.

Gerenciador Financeiro (/gerenciador/financeiro)

Este módulo define as regras do fluxo financeiro da operação. É nele que o usuário ativa o financeiro e organiza as condições usadas nos lançamentos e no acompanhamento das comissões.

  • Ativação ou desativação do módulo financeiro.
  • Opção para exibir bônus no financeiro.
  • Cadastro de condições de pagamento, vencimentos e prazos.
  • Configuração de regras para liberação e acompanhamento financeiro.

Gerenciador de Usuários (/gerenciador/usuarios)

Aqui o usuário administra quem acessa o Askora e quais organizações cada pessoa pode ver.

  • Busca e filtros por organização e perfil de acesso.
  • Cadastro e edição de usuários.
  • Definição de perfil: Master, Administrador ou Vendedor.
  • Vínculo com uma ou mais organizações e registro de salário base, contato e links.

Gerenciador de Organizações (/gerenciador/organizacoes)

Esta página organiza a estrutura do ambiente em empresas, filiais, equipes ou unidades.

  • Busca por nome da organização.
  • Cadastro, edição e exclusão de organizações.
  • Visualização do nome e do CNPJ em tabela.
  • Base para filtros e escopo de acesso em outras páginas.

Gerenciador de Clientes (/gerenciador/clientes)

O módulo de Clientes ajuda a manter organizada a base comercial do Askora.

  • Busca, importação e exportação de clientes.
  • Cadastro com nome, CPF/CNPJ e detalhes adicionais.
  • Organização dos registros por empresa ou unidade.
  • Consulta rápida na tabela com edição e exclusão.

Gerenciador de Produtos (/gerenciador/produtos)

O módulo de Produtos padroniza os itens usados nas operações.

  • Busca, importação e exportação de produtos.
  • Cadastro com nome, valor, organização e detalhes adicionais.
  • Organização da lista por unidade, quando necessário.
  • Uso prático para reduzir erro e acelerar lançamentos.

Integrações (/integracoes)

A página Integrações é voltada para conexão com sistemas externos e rotinas de importação.

  • API Key e autenticação para integrações automáticas.
  • Google Sheets para leitura assistida por planilha.
  • Importação de lançamentos, bônus, financeiro e score por arquivo.
  • Webhook aparece como opção em breve.

Financeiro (/financeiro)

O Financeiro é a visão gerencial do fluxo financeiro do Askora. Ele reúne, em uma única leitura, o que está pendente, o que venceu, o que foi liberado e o que ainda precisa de acompanhamento antes de entrar no ciclo de pagamento.

Na prática, essa categoria funciona como um controle de contas a receber da operação ligado às vendas e às comissões liberadas. O usuário usa essa página para entender o cenário do período, acompanhar a receita e enxergar o que ainda está em aberto.

Como o Financeiro funciona no Askora

O fluxo financeiro começa no Gerenciador Financeiro, onde são definidas as regras de vencimento, parcelamento e liberação. Depois, essas regras são usadas na rotina de Operações, principalmente no Painel Financeiro, onde o usuário acompanha os lançamentos por status e executa ações como liberar, cancelar ou reabrir.

A página Financeiro fecha esse ciclo com uma visão consolidada. Em vez de mostrar uma linha por lançamento, ela organiza os números principais do período e ajuda o usuário a acompanhar a saúde financeira da operação.

Principais áreas do fluxo financeiro
  • Gerenciador Financeiro: usado para ativar o módulo, definir condições de pagamento e configurar prazos de vencimento e pagamento.
  • Painel Financeiro em Operações: usado para revisar lançamentos, controlar status e executar ações em lote.
  • Página Financeiro: usada para leitura consolidada, acompanhamento gerencial e geração de documentos financeiros.
O que o usuário acompanha
  • Vendas: total vendido no período, com leitura de vendas a vencer e vendas vencidas.
  • Comissões a liberar: valor que ainda não entrou na etapa de liberação financeira.
  • Resultados liberados: valor que já foi liberado e entrou na visão financeira consolidada.
  • Bônus liberado: quando o módulo financeiro exibe bônus, o valor aparece junto do restante do fluxo.
  • Fluxo realizado, provisionado e previsto: visão de tendência dos últimos meses para entender o comportamento do ciclo ao longo do tempo.
  • Composição dos resultados financeiros: leitura da estrutura do período e do que ainda está pendente na operação.
  • Relatório gerencial: detalhamento por organização e vendedor, com paginação quando há mais de uma organização no resultado.
Como ler parcelas e vencimentos

As regras de parcela e vencimento são configuradas no Gerenciador Financeiro e depois aparecem no fluxo operacional. Quando o registro de vencimentos está ativo, o usuário passa a enxergar melhor o que está no prazo e o que já venceu.

Na rotina de lançamento, o sistema pode usar uma condição padrão, um primeiro vencimento, quantidade de parcelas e intervalo entre parcelas. Isso ajuda a organizar o contas a receber de forma mais previsível e reduz erros no preenchimento.

  • À vista: a condição fica concentrada em um único vencimento.
  • A prazo: a venda pode ser dividida em parcelas, com vencimentos separados por intervalo.
  • Vencido: indica que o prazo já passou e o registro precisa de atenção.
  • No prazo: indica que o vencimento ainda está dentro do período esperado.
  • Liberado: indica que o lançamento já passou pela liberação financeira.
  • Cancelado: indica que o registro saiu do fluxo ativo.
Liberações, pendências e cancelamentos

No Painel Financeiro, o usuário trabalha com os status do fluxo. Os registros podem aparecer como a liberar, no prazo, vencidos, liberados ou cancelados. Esses status ajudam a enxergar rapidamente o que precisa de ação e o que já foi concluído.

O painel operacional também permite ações em lote, o que facilita liberar vários itens ao mesmo tempo, cancelar quando necessário e reabrir registros quando houver ajuste no fluxo. Isso torna o acompanhamento mais rápido e mais próximo da rotina real do financeiro.

Relação entre Financeiro e comissões

O Financeiro ajuda a controlar o momento em que a comissão entra no fluxo de pagamento. Em outras palavras, não basta a comissão existir no resultado: o financeiro acompanha se o lançamento já foi liberado, se ainda está pendente, se venceu ou se foi cancelado.

Essa separação é importante porque o resultado comercial e o pagamento financeiro não são a mesma coisa. Primeiro o sistema apura o desempenho. Depois, o fluxo financeiro organiza o que pode ser liberado e o que ainda precisa aguardar o prazo ou a conferência.

Documentos financeiros

A página Financeiro traz o botão Documentos, que abre uma janela para gerar arquivos do relatório financeiro. O usuário pode escolher entre:

  • Resumo (gerencial): visão mais executiva do período.
  • Detalhado (vendas liberadas): visão mais completa para conferência.
  • Excel (.xlsx), CSV ou PDF como formato de saída.
  • Recorte por performance, organização e, quando necessário, vendedor.
Pontos de atenção
  • Se não houver dados para os filtros atuais, a página mostra uma mensagem de ausência em vez de manter blocos vazios.
  • Alguns controles só aparecem quando o módulo financeiro está ativo.
  • O relatório financeiro é diferente de Resultados/Comissões: aqui a leitura é de fluxo de pagamento, não apenas de apuração comercial.
  • Para corrigir ou auditar um lançamento específico, o caminho continua sendo o Painel de Lançamentos ou o Painel Financeiro em Operações.
  • Quando o bônus está habilitado para a conta, ele pode aparecer na visão financeira consolidada.
Resumo prático

Na prática, o Financeiro é a área que ajuda o usuário a responder três perguntas: o que já foi liberado, o que ainda está pendente e o que venceu. A partir disso, a operação consegue acompanhar a receita com mais clareza e organizar melhor o pagamento das comissões.

Manuais (/manuais)

A página Manuais funciona como atalho para a documentação oficial centralizada.

  • Destino atual: https://askora.com.br/spm.
  • FAQ complementar: https://askora.com.br/faq.
  • Abertura em nova aba para preservar a navegação no sistema.

Blog (menu Blog)

O Blog é o canal público de conteúdo da Askora para artigos, guias e materiais de referência.

  • Destino: https://askora.com.br/blog.
  • Conteúdo institucional, educacional e páginas de apoio.
  • Abertura em nova aba para não interromper a sessão no sistema.

Suporte (/suporte)

Suporte é a página de apoio para dúvidas de operação. É o caminho recomendado quando a equipe precisa orientação para executar o processo correto.

  • Canal de orientação para o uso da plataforma no dia a dia.
  • Ajuda em dúvidas de fluxo, permissão e comportamento esperado das telas.

2) Arquitetura Funcional do Askora

2.1 Perfis de acesso

  • Master: tem controle total do ecossistema Askora e da assinatura do ambiente. A conta pode ter mais de um Master, mas o Master criador nunca pode ser removido.
  • Administrador: tem o mesmo acesso operacional do Master, porém limitado as organizações vinculadas a ele e sem acesso ao gerenciamento da assinatura Askora.
  • Vendedor: participa das competições, da performance, do comissionamento e das bonificações, com visão personalizada entre resultado individual e performance do time.

2.2 Como a regra do Askora funciona no dia a dia

A lógica do Askora é organizada por ciclo de performance (período). Em cada período, a empresa define as regras da competição e os participantes. É dentro dessa performance que o ranking acontece, os resultados são comparados e os incentivos são apurados.

Com base nessa estrutura, o sistema calcula comissionamento e bonificações do ciclo, e alimenta os dashboards de acompanhamento. Por isso, a performance é o núcleo do ecossistema Askora: ela conecta regra, execução e leitura gerencial em um único fluxo.

3) Onboarding

O onboarding do Askora é o processo inicial de configuração do sistema. É nessa etapa que a estrutura principal da operação é definida para que o sistema consiga acompanhar corretamente vendedores, metas, comissionamento, bônus, competição e, quando desejado, também o fluxo financeiro das vendas.

A lógica do onboarding foi pensada para ser simples de entender. Primeiro, são feitos os cadastros principais, que são a base para o funcionamento do sistema. Depois, podem ser feitos cadastros opcionais para complementar o uso. Por fim, a operação pode começar de duas formas: diretamente dentro do Askora ou por meio de integrações com fontes externas de dados.

Quando essa configuração inicial é feita com cuidado, o sistema passa a refletir de forma muito mais clara a realidade da operação, facilitando o acompanhamento da performance, da remuneração e da organização comercial como um todo.

Cadastro principal

O cadastro principal é a etapa mais importante do onboarding. Ele define a estrutura base da operação dentro do Askora e é formado por três partes: organizações, usuários e performance.

Cadastro de organizações

O primeiro passo para começar a usar o Askora é cadastrar a organização. Esse cadastro é o que define como a operação será separada e visualizada dentro do sistema.

A organização pode representar a empresa como um todo, mas não precisa ser usada apenas dessa forma. Ela também pode ser usada para separar diferentes estruturas internas, como lojas, sedes, equipes comerciais, setores ou qualquer outro agrupamento que faça sentido para o negócio.

Na prática, isso significa que a organização não serve apenas como um nome institucional. Ela serve para estruturar a forma como os dados serão analisados e controlados. Se a empresa deseja ter uma visão única e geral de toda a operação, o ideal é concentrar tudo em uma única organização. Já quando existe a necessidade de separar equipes, unidades ou modelos de remuneração diferentes, o melhor caminho é criar organizações distintas.

Essa separação é especialmente útil quando cada grupo da empresa trabalha com regras próprias. Em uma equipe, por exemplo, pode ser necessário acompanhar determinadas métricas e aplicar uma lógica de comissionamento específica. Em outra, as métricas e a remuneração podem funcionar de outra forma. Ao separar essas estruturas em organizações diferentes, o Askora permite que cada realidade seja controlada com mais clareza e sem misturar dados, regras ou visões.

Por isso, antes de avançar para os próximos cadastros, é importante pensar de forma estratégica em como a operação deve ser organizada dentro do sistema. Essa decisão influencia diretamente a forma como os usuários serão vinculados, como as performances serão configuradas e como a gestão irá acompanhar os resultados.

Campos do cadastro de organizações
Campo na tela Para que serve
Nome * Define o nome exibido da organização nas listas, filtros, vínculos de usuários, performance e demais áreas do sistema.
CNPJ * Registra o documento de identificação da organização. A tela exibe CNPJ, e a validação aceita documento válido com 11 ou 14 dígitos quando a base estiver preparada para CPF/CNPJ.

Cadastro de usuários

Depois da definição das organizações, o próximo passo é cadastrar os usuários. São eles que irão acessar o sistema e, dependendo do tipo de acesso, participar da gestão, da administração ou da apuração das métricas e remunerações.

No Askora, os usuários podem ter perfis diferentes, de acordo com a função que exercem na operação.

O usuário com acesso vendedor é aquele que participa diretamente das métricas da operação. É ele que será acompanhado por vendas, metas, incentivos, competição, score, comissão e resultados. Em outras palavras, é o perfil usado para quem realmente fará parte da apuração de performance dentro do sistema.

O usuário com acesso master possui controle total do sistema. Esse perfil tem uma visão mais ampla e acesso completo às configurações e à gestão geral da operação.

Já o usuário com acesso administrador também possui um alto nível de controle, mas pode ser vinculado a uma organização específica. Isso permite, por exemplo, que a empresa tenha administradores responsáveis apenas por determinadas unidades, equipes ou estruturas internas, sem necessariamente dar a todos uma visão completa de tudo.

Ao cadastrar um usuário, devem ser preenchidas as informações pessoais e os dados de acesso ao sistema. Além disso, existem campos que, embora opcionais, podem ser importantes dependendo da forma como a empresa utiliza o Askora.

O campo salário é opcional, mas se torna essencial quando a lógica de remuneração utiliza o salário como base de cálculo. Isso acontece, por exemplo, em estruturas de OTE, score ou bônus que remuneram o vendedor com base em múltiplos do salário ou faixas relacionadas a esse valor.

O campo link também é opcional, mas tem uma função prática importante em operações integradas. Ele serve para identificar o vendedor em integrações externas, especialmente quando os dados chegam ao Askora por meio de outro sistema que utiliza um identificador próprio para cada pessoa. Nesse caso, o link ajuda o sistema a entender exatamente qual registro externo pertence a qual vendedor cadastrado no Askora.

Esse cadastro correto dos usuários é fundamental para que a operação seja acompanhada de forma consistente. É a partir dele que o sistema consegue saber quem participa da performance, quem administra a operação e como cada pessoa deve ser tratada dentro do fluxo de acompanhamento.

Campos do cadastro de usuários
Campo na tela Para que serve
Master Define acesso total ao sistema, com visão ampla da operação e das configurações gerais.
Administrador Define acesso administrativo dentro do escopo permitido, normalmente vinculado a uma ou mais organizações.
Vendedor Define o usuário que participa da apuração comercial, metas, comissão, bônus, score, competição e resultados.
Organizações Define a quais organizações o usuário ficará vinculado. Esse é o vínculo operacional do usuário com a estrutura da empresa.
Nome * Nome da pessoa que será exibido em listas, filtros, rankings, resultados e demais telas do Askora.
E-mail / Login * Identificação usada pelo usuário para acessar o sistema.
Senha Senha de acesso. No cadastro inicial deve ser criada; na edição pode ficar em branco para manter a senha atual.
Contato Telefone ou contato de apoio do usuário, usado como informação operacional complementar.
Salário base Valor opcional usado quando comissão OTE, comissão Score ou bônus dependem do salário como base de cálculo.
Link Identificador externo do vendedor para integrações. Pode receber URL, ID ou código usado em outro sistema. Não vincula organização; o vínculo de organização é feito no bloco de organizações.

Cadastro de performance

Depois de cadastrar organizações e usuários, chega o momento de configurar a performance. A performance é o ciclo de controle que será acompanhado pelo sistema. É dentro dela que o Askora entende quem será analisado, em qual período e sob qual lógica de remuneração.

Esse ciclo pode ser mensal, bimestral, trimestral ou qualquer outro formato que faça sentido para a operação. O importante é entender que a performance representa o período oficial de acompanhamento de resultados.

Na configuração da performance, o primeiro passo é definir a quais organizações e vendedores aquele ciclo estará vinculado. Isso garante que o acompanhamento seja feito com base na estrutura criada anteriormente e somente para os usuários que realmente farão parte daquele período de análise.

Campos do passo 1 - Vendedores
Campo na tela Para que serve
Selecione uma organização Define a organização que será usada para listar os vendedores participantes daquela performance.
Buscar organização Ajuda a localizar rapidamente a organização dentro da lista disponível.
Adicionar organização Inclui outro bloco de organização quando a performance precisar considerar vendedores de mais de uma estrutura.
Remover organização Remove um bloco de organização da seleção da performance.
Meta (Define a meta do vendedor) Meta individual do vendedor dentro daquele ciclo. É a referência usada para atingimento de meta, ranking por meta, OTE e score quando aplicável.
Salário base (Opcional para comissão e bônus) Base opcional do vendedor dentro da performance. Deve ser preenchida quando OTE, Score ou bônus usarem salário como referência de cálculo.

Depois disso, é definido o período do ciclo. Essa etapa é importante porque é ela que delimita o intervalo em que vendas, métricas, metas e demais resultados serão considerados para aquela performance.

Campos do passo 2 - Competência
Campo na tela Para que serve
Mensal Define a performance para apenas um mês de referência.
Personalizada Define a performance por intervalo de meses, usando início e fim do período.
Mês * Seleciona o mês inicial da competência. No formato mensal, é o mês único do ciclo.
Ano * Seleciona o ano inicial da competência. No formato mensal, é o ano do mês único do ciclo.
De: Indica o início do intervalo quando a competência é personalizada.
Até: Indica o fim do intervalo quando a competência é personalizada.

Na sequência, é feita a definição do modelo de comissionamento. Esse é um dos pontos centrais da configuração da performance, porque é ele que determina como a remuneração principal do vendedor será calculada. No Askora, essa definição pode seguir três caminhos: comissionamento padrão, OTE ou score.

Comissionamento padrão

No comissionamento padrão, a lógica é baseada em percentual sobre vendas. É o formato mais direto para operações em que a comissão acompanha o valor vendido. Dentro desse modelo, também pode ser ativada a comissão escalonada. Nesse formato, são definidos marcos de atingimento de meta que alteram o percentual de comissão do vendedor. Isso significa que, conforme ele avança no cumprimento da meta, a comissão pode aumentar. Essa estrutura é muito usada para incentivar o vendedor a continuar evoluindo no ciclo, já que o ganho melhora conforme o resultado cresce.

OTE

No modelo OTE, a remuneração também pode trabalhar com marcos de atingimento, mas a lógica deixa de ser um percentual direto sobre vendas. Em vez disso, o pagamento pode ser calculado com base em percentual do salário ou em valor fixo. Nesse formato, a empresa define quais faixas de resultado desbloqueiam cada nível de remuneração. Assim, ao atingir determinados marcos, o vendedor recebe uma parcela do salário, múltiplos do salário ou valores fixos previamente definidos. É uma forma de remuneração muito útil para operações que preferem trabalhar com faixas de recompensa em vez de comissão puramente proporcional ao valor vendido.

Score

No comissionamento por score, a lógica se aproxima do OTE no formato de faixas de remuneração, mas o critério de atingimento muda. Em vez de depender apenas do volume de vendas, o score é construído a partir de métricas definidas pela empresa, cada uma com seu peso no resultado final. Dessa forma, a remuneração passa a refletir uma composição mais ampla da performance.

Na prática, isso permite que a empresa combine indicadores diferentes dentro de uma mesma lógica de resultado. Um exemplo simples seria uma operação em que vendas têm peso de 50 por cento e visitas também têm peso de 50 por cento. Se a meta de vendas é 100 mil e a meta de visitas é 100, um vendedor que atinge as duas metas chega a 100 por cento de score. Se a regra de remuneração definir que 100 por cento de score equivale a 1 vez o salário, essa será a remuneração dele. Mas se ele atingir a meta de vendas e fizer apenas metade da meta de visitas, o resultado final será menor, porque ele atingiu integralmente uma métrica e apenas parcialmente a outra. Com isso, o score final reflete o equilíbrio real da performance, e é esse score que determina a faixa de remuneração que será aplicada.

Campos do passo 3 - Comissionamento
Campo na tela Para que serve
Ativo / Inativo Ativa ou desativa o comissionamento da performance. Quando inativo, a performance pode seguir sem cálculo de comissão principal.
Padrão Seleciona a comissão por percentual aplicado sobre vendas.
OTE Seleciona a comissão por marcos de meta com multiplicador sobre salário base ou valor fixo.
Score Seleciona a comissão calculada por metas ponderadas e marcos de score.
Percentual de comissão Percentual fixo da comissão padrão ou percentual inicial quando a comissão escalonada estiver ativa.
Comissão escalonada Ativa marcos que mudam o percentual de comissão conforme o vendedor atinge faixas da meta.
Percentual da meta para ativar (%) Percentual de atingimento da meta necessário para ativar um marco de comissão padrão ou OTE.
Novo percentual de comissão (%) Novo percentual que passa a valer na comissão padrão quando o marco é atingido.
Base de cálculo da comissão OTE Define se a OTE será calculada sobre o salário base do vendedor ou sobre um valor fixo.
Valor fixo base (R$) Valor usado como base quando a comissão OTE ou Score estiver configurada para valor fixo.
Multiplicador sobre salário (x) Multiplicador aplicado sobre o salário base quando um marco de OTE é atingido.
Multiplicador sobre valor fixo (x) Multiplicador aplicado sobre o valor fixo quando um marco de OTE é atingido.
Nome da meta Nome da métrica que compõe o score. A primeira meta de vendas é fixa, e as demais podem ser criadas conforme a operação.
Tipo de métrica Define se a meta será medida por quantidade, valor, percentual ou vendas, conforme o modelo disponível.
Alvo Valor de referência que precisa ser atingido para calcular o resultado da meta no score.
Regra Define como o resultado será interpretado, como acima do alvo, abaixo do alvo, progressivo até o alvo ou progressivo do alvo a zero.
Peso da meta (%) Percentual de importância daquela meta no score final. A soma dos pesos deve fechar em 100%.
Limite do Peso Progressivo (opcional) Permite limitar até onde o peso progressivo pode crescer quando a regra usa progressão.
Peso máximo Multiplicador máximo que o peso daquela meta pode alcançar em regras progressivas.
Peso excelência Resultado em que o peso progressivo atinge o limite máximo definido.
Base de cálculo da comissão Score Define se os marcos de score serão aplicados sobre salário base do vendedor ou sobre valor fixo.
Percentual de score do marco (%) Percentual de score necessário para ativar um marco de remuneração.
Multiplicador da base (x) Multiplicador aplicado sobre a base escolhida quando o marco de score é atingido.
Bônus

Depois da definição do comissionamento, o próximo passo da performance é o bônus. O bônus é controlado separadamente da comissão principal. Ele é muito útil quando a empresa deseja medir ou incentivar algo específico em um ciclo, sem precisar alterar a estrutura principal do comissionamento.

Na prática, o bônus costuma ser usado para metas paralelas, campanhas pontuais ou ações específicas. Por exemplo, a empresa já possui uma lógica principal de comissionamento, mas naquele período quer incentivar a venda de um produto específico, aumentar uma rotina de prospecção ou estimular o cumprimento de uma atividade adicional, como quantidade de ligações ou visitas. Nesses casos, o bônus entra como uma camada separada de incentivo.

Ele é opcional e aparece de forma separada da comissão, mas o valor continua fazendo parte do fluxo de resultados do vendedor. Isso permite que a empresa mantenha a estrutura principal de remuneração estável, enquanto adiciona estímulos pontuais de acordo com a necessidade do ciclo.

Campos do passo 4 - Bônus
Campo na tela Para que serve
Ativo / Inativo Ativa ou desativa o cadastro de bônus na performance. Quando inativo, a performance segue sem bônus adicional.
Nome do bônus Nome usado para identificar o bônus dentro da performance e nas leituras de resultado.
Tipo de métrica Define se o bônus será medido por quantidade, valor ou percentual.
Alvo Valor de referência que libera ou calcula o bônus.
Regra Define como o resultado será comparado ao alvo, com ou sem progressão.
Tipo de pagamento Define se o pagamento do bônus será valor fixo ou percentual sobre o salário base do vendedor.
Valor do pagamento Valor base do bônus ao atingir 100% do alvo, em reais ou percentual do salário conforme o tipo escolhido.
Limite do Pagamento Progressivo (opcional) Permite limitar o crescimento do pagamento quando a regra do bônus usa progressão.
Pagamento máximo Multiplicador máximo que o pagamento progressivo pode alcançar em relação ao valor do pagamento.
Pagamento excelência Resultado em que o pagamento progressivo atinge o limite máximo definido.
Competição e premiação

Por fim, a performance também permite definir a competição. É nessa etapa que se estabelece como será feito o ranking daquele ciclo. Em outras palavras, é o critério que vai ordenar quem está melhor posicionado e quem está atrás dentro da competição.

Esse ranking pode ser definido com base em vendas, percentual de meta atingida, bônus ou score. Quando a competição é por vendas, o sistema considera o total vendido por cada vendedor. Quando é por meta, considera o percentual de atingimento da meta individual. Quando é por bônus, considera o percentual médio de atingimento dos bônus cadastrados. E quando é por score, considera o resultado final do score de cada vendedor.

Além disso, existe a possibilidade de definir uma premiação para a competição. Essa premiação é opcional e permite que o ciclo tenha recompensa para os melhores colocados, como primeiro, segundo e terceiro lugar. Isso ajuda a tornar a dinâmica mais motivadora e cria um estímulo adicional para o time acompanhar sua posição e buscar evolução ao longo do período.

Campos do passo 5 - Competição
Campo na tela Para que serve
Vendas Ordena o ranking pelo total vendido por cada vendedor.
Meta Ordena o ranking pelo percentual de atingimento da meta individual.
Bônus Ordena o ranking pelo percentual médio de atingimento dos bônus cadastrados.
Score Ordena o ranking pelo score final de performance de cada vendedor.
1º Colocação Ativa ou desativa premiação para o primeiro colocado.
2º Colocação Ativa ou desativa premiação para o segundo colocado.
3º Colocação Ativa ou desativa premiação para o terceiro colocado.
Subir imagem da premiação Permite enviar uma imagem para representar visualmente a premiação daquela colocação.
Remover imagem da premiação Remove a imagem cadastrada para a premiação daquela colocação.
Nome da premiação 1º / 2º / 3º Nome exibido para o prêmio de cada colocação ativa.

Com a conclusão dessa etapa, a estrutura principal do Askora já está pronta. A partir desse momento, o sistema já possui base suficiente para começar a acompanhar a operação.

Cadastros opcionais

Depois da configuração principal, o onboarding pode ser complementado com alguns cadastros e definições opcionais. Esses itens não impedem o funcionamento do sistema, mas podem enriquecer o uso da plataforma e ampliar o nível de controle da operação.

Cadastro de clientes e produtos

O Askora permite o cadastro de clientes e produtos para empresas que desejam usar o sistema de forma mais completa também no controle interno da operação.

Esses cadastros são úteis para quem quer manter uma estrutura mais organizada dentro da própria plataforma, relacionando pedidos, vendas e registros com clientes e produtos previamente definidos. Isso facilita a padronização das informações e melhora o controle interno.

Apesar disso, é importante entender que clientes e produtos não são obrigatórios para o funcionamento do sistema. O Askora pode operar normalmente sem esses cadastros, especialmente em cenários em que os registros já vêm de integrações externas ou quando a empresa não precisa desse detalhamento interno no momento inicial.

Campos do cadastro de clientes
Campo na tela Para que serve
Nome * Nome do cliente que será exibido na lista, nas buscas e nos vínculos operacionais.
CPF/CNPJ * Documento de identificação do cliente, usado para padronizar e reconhecer o cadastro.
Detalhes adicionais Campo opcional para observações úteis sobre o cliente, como informações comerciais ou contexto interno.
Campos do cadastro de produtos
Campo na tela Para que serve
Nome * Nome do produto que será exibido na lista e usado para padronizar lançamentos e registros.
Valor Preço ou valor de referência do produto, usado como apoio operacional quando a empresa deseja manter essa informação no cadastro.
Vincular este produto a uma organização específica Define se o produto ficará restrito a uma organização. Se não marcar, o produto fica disponível para todas as organizações.
Organização vinculada Organização que terá acesso ao produto quando a opção de vínculo específico estiver ativa.
Detalhes adicionais Campo opcional para observações sobre o produto, regras internas, contexto comercial ou informações de apoio.

Configuração financeira

Outro ponto opcional do onboarding é a ativação do módulo financeiro. Quando esse módulo é utilizado, o Askora passa a controlar também o fluxo de recebimento das vendas, permitindo uma gestão mais completa da operação comercial e da remuneração.

Com o módulo financeiro ativo, o sistema pode acompanhar quais vendas ainda estão em aberto, quais já foram recebidas, quais venceram, quais foram pagas parcialmente e como esses recebimentos impactam a liberação das comissões. Isso é especialmente importante em operações em que a comissão do vendedor depende do pagamento do cliente, e não apenas do fechamento da venda.

Além disso, o módulo financeiro permite configurar um prazo adicional para liberação do pagamento da comissão. Esse recurso é útil para empresas que, mesmo após o recebimento do pedido, preferem estabelecer alguns dias extras antes de considerar aquele valor apto para entrar no fluxo de pagamento da comissão.

Na prática, isso funciona de forma bastante simples. Se uma venda for recebida no dia 20 de janeiro e a empresa tiver configurado 7 dias de prazo para liberação, aquela comissão entra no fluxo de pagamento em 27 de janeiro. Nesse cenário, ela pode fazer parte do fechamento daquele mesmo mês. Mas se o recebimento ocorrer em 25 de janeiro, com os mesmos 7 dias de prazo, a entrada no fluxo de pagamento será em 1 de fevereiro. Nesse caso, a comissão já não pertence ao fechamento de janeiro, mas sim ao de fevereiro.

Esse controle traz mais precisão para operações que precisam alinhar vendas, recebimentos e pagamento de comissão dentro de uma lógica financeira mais rigorosa.

Campos da configuração financeira
Campo na tela Para que serve
Módulo financeiro Ativa o controle financeiro de lançamentos, vencimentos, prazos, condições de pagamento e liberação de comissões.
Exibir bônus no financeiro Inclui os bônus da competência nas visões e relatórios financeiros quando a empresa deseja acompanhar tudo de forma consolidada.
Tipo da condição Define se a condição de pagamento será à vista ou a prazo.
Prazo de pagamento (dias) Para condição à vista, indica em quantos dias após o pedido o pagamento vence.
Parcelas da condição a prazo Área usada para cadastrar mais de uma parcela quando a condição for a prazo.
Dias da parcela Quantidade de dias após o pedido em que cada parcela vence, como 30, 60 e 90 dias.
Adicionar condição Salva a condição montada para que ela fique disponível nos lançamentos financeiros.
Registrar vencimentos Ativa o acompanhamento de vencimentos, permitindo visualizar o que está no prazo ou vencido.
Vencimento padrão para liberação Define uma condição de pagamento padrão para abrir lançamentos já com essa opção preenchida.
Sem condição padrão Opção usada quando a empresa não quer aplicar uma condição padrão nos lançamentos.
Prazo de pagamento após liberação (dias) Quantidade de dias somada à data de liberação para calcular quando a comissão entra no fluxo de pagamento.

Utilização

Depois da configuração inicial, a operação já pode começar a ser usada. Essa utilização pode acontecer de duas formas, de acordo com a realidade de cada empresa.

Uso direto no Askora

A primeira possibilidade é operar diretamente dentro do próprio sistema. Nesse modelo, os registros são feitos no Askora, e o acompanhamento de vendas, performance, remuneração e, quando aplicável, financeiro, acontece de forma centralizada na plataforma.

Esse formato é ideal para empresas que querem concentrar a operação em um único ambiente e ter mais controle direto sobre os lançamentos e acompanhamentos do dia a dia.

Uso com integrações

A segunda possibilidade é utilizar o Askora em conjunto com integrações. Nesse caso, os registros podem vir de fontes externas, como outros sistemas, planilhas, APIs ou importações configuradas pela empresa.

Esse formato é útil para operações que já possuem um fluxo de dados em andamento e desejam aproveitar essa estrutura existente, conectando essas informações ao Askora para análise, controle e acompanhamento da remuneração.

Independentemente da forma escolhida, o mais importante é que, após o onboarding, o sistema já estará preparado para refletir a lógica da operação e acompanhar com clareza tudo o que foi estruturado.

Fechamento do onboarding

Ao concluir o cadastro principal e, quando necessário, os cadastros opcionais, o Askora já está pronto para entrar em uso. A partir daí, a empresa passa a ter uma base organizada para acompanhar vendedores, metas, comissões, bônus, competição e, se desejar, também o fluxo financeiro relacionado às vendas.

O onboarding é justamente a etapa que transforma o sistema em uma estrutura alinhada à realidade da operação. Quando ele é bem configurado desde o início, o uso do Askora se torna mais claro, mais eficiente e muito mais útil no dia a dia.

4) Gerenciadores

A área de Gerenciadores é a central de configuração do Askora. É nela que a empresa cadastra a estrutura da operação, libera acessos, organiza a base comercial, define regras de performance e, quando necessário, prepara o módulo financeiro.

Tudo que é configurado nos gerenciadores afeta o restante do sistema. Organizações influenciam filtros e permissões. Usuários definem quem participa da apuração. Performance define metas, comissão, bônus e competição. Clientes e produtos ajudam a padronizar lançamentos. O Gerenciador Financeiro define como o sistema vai tratar vencimentos, parcelas, recebimentos e prazos de pagamento.

Por isso, esta área deve ser usada com atenção. Um cadastro bem feito deixa a operação mais clara, reduz erros de lançamento e facilita o acompanhamento de resultados.

4.1 Gerenciador de Organizações

O Gerenciador de Organizações serve para cadastrar as estruturas que irão separar e organizar os dados dentro do Askora. Uma organização pode representar a empresa inteira, uma filial, uma loja, uma equipe comercial, uma unidade de negócio ou qualquer divisão que precise ser acompanhada separadamente.

Esse cadastro é a base para vários outros pontos do sistema. Usuários são vinculados a organizações, performances são configuradas a partir delas, produtos podem ser restritos por organização e várias telas usam essa estrutura como filtro de leitura.

Campo na tela Para que serve
Nome * Define o nome exibido da organização. Esse nome aparece em listas, filtros, vínculos de usuários, cadastro de performance, relatórios e demais áreas que precisam separar a operação.
CNPJ * Registra o documento de identificação da organização. A tela exibe CNPJ, e a validação aceita documento válido com 11 ou 14 dígitos quando a base estiver preparada para CPF/CNPJ.

4.2 Gerenciador de Usuários

O Gerenciador de Usuários define quem acessa o Askora, qual papel cada pessoa terá e em quais organizações ela poderá atuar. Esse cadastro também determina quem participa da apuração comercial como vendedor e quem terá acesso administrativo para configurar ou acompanhar a operação.

O perfil Vendedor é usado para quem entra nas métricas, metas, comissão, bônus, score, competição e resultados. O perfil Administrador permite gestão dentro do escopo liberado. O perfil Master possui visão ampla e controle completo do ambiente.

Campo na tela Para que serve
Master Define acesso total ao sistema, com visão ampla da operação e das configurações gerais.
Administrador Define acesso administrativo dentro do escopo permitido. Pode ser usado para pessoas que gerenciam apenas determinadas organizações, equipes ou unidades.
Vendedor Define o usuário que participa da apuração comercial. Esse perfil é acompanhado em vendas, metas, comissão, bônus, score, competição e resultados.
Organizações Define a quais organizações o usuário ficará vinculado. Esse é o vínculo operacional de visibilidade e atuação dentro da estrutura da empresa.
Nome * Nome da pessoa exibido em listas, filtros, rankings, resultados, performance e demais telas do Askora.
E-mail / Login * Identificação usada pelo usuário para acessar o sistema.
Senha Senha de acesso. No cadastro inicial deve ser criada; na edição pode ficar em branco para manter a senha atual.
Contato Telefone ou contato de apoio do usuário. É uma informação complementar para facilitar identificação e suporte operacional.
Salário base Valor usado quando a regra de remuneração depende do salário como base de cálculo, como OTE, comissão por Score ou bônus vinculados ao salário.
Link Identificador externo do vendedor para integrações. Pode receber uma URL, ID ou código usado por outro sistema para reconhecer aquele vendedor. Não vincula organização; o vínculo de organização é feito no bloco Organizações.

4.3 Gerenciador de Performance

O Gerenciador de Performance é o cadastro central da lógica comercial do Askora. É nele que a empresa define quem participa de um ciclo, qual período será acompanhado, como a comissão será calculada, se haverá bônus e qual critério será usado para o ranking da competição.

Uma performance bem configurada conecta a operação ao acompanhamento diário. A partir dela, o sistema sabe quais vendedores entram no ciclo, quais metas serão avaliadas, como calcular remuneração e como ordenar os resultados.

Passo 1 - Vendedores

Este passo define a organização e os vendedores participantes da performance. Também é aqui que são preenchidas as metas individuais e, quando necessário, o salário base específico daquele ciclo.

Campo na tela Para que serve
Selecione uma organização Escolhe a organização usada para listar os vendedores que poderão participar da performance.
Buscar organização Ajuda a localizar rapidamente a organização desejada dentro da lista.
Adicionar organização Inclui outro bloco de organização quando a performance precisa considerar vendedores de mais de uma estrutura.
Remover organização Remove um bloco de organização da configuração da performance.
Vendedores Seleciona quais vendedores entram no ciclo. Apenas vendedores marcados participam da apuração daquela performance.
Meta (Define a meta do vendedor) Meta individual do vendedor dentro do ciclo. É usada para calcular atingimento de meta, ranking por meta, OTE e score quando esses modelos forem aplicados.
Salário base (Opcional para comissão e bônus) Valor opcional usado como base de cálculo quando a performance trabalha com OTE, Score ou bônus que dependem do salário do vendedor.

Passo 2 - Competência

Este passo define o período oficial de acompanhamento da performance. O ciclo pode ser mensal ou personalizado, de acordo com a forma como a empresa acompanha metas, campanhas e apuração de remuneração.

Campo na tela Para que serve
Mensal Define a performance para um único mês de referência.
Personalizada Define a performance por intervalo de meses, com início e fim definidos manualmente.
Mês * Seleciona o mês inicial da competência. No formato mensal, representa o mês único do ciclo.
Ano * Seleciona o ano inicial da competência. No formato mensal, representa o ano do mês único do ciclo.
De: Indica o início do período quando a competência é personalizada.
Até: Indica o fim do período quando a competência é personalizada.

Passo 3 - Comissionamento

Este passo define a regra principal de comissão da performance. O comissionamento pode ficar inativo ou pode ser configurado como Padrão, OTE ou Score, dependendo da política comercial da empresa.

Campo na tela Para que serve
Ativo / Inativo Ativa ou desativa o cálculo de comissão principal naquela performance.
Padrão Seleciona o modelo de comissão por percentual aplicado sobre vendas.
OTE Seleciona o modelo de comissão por marcos de meta, com multiplicador aplicado sobre salário base ou valor fixo.
Score Seleciona o modelo de comissão por composição de métricas ponderadas e marcos de score.
Percentual de comissão Percentual fixo da comissão padrão ou percentual inicial quando a comissão escalonada estiver ativa.
Comissão escalonada Ativa marcos que alteram o percentual da comissão conforme o vendedor atinge faixas da meta.
Percentual da meta para ativar (%) Percentual de atingimento necessário para ativar um marco de comissão padrão ou OTE.
Novo percentual de comissão (%) Novo percentual aplicado na comissão padrão quando o marco configurado é atingido.
Base de cálculo da comissão OTE Define se a OTE será calculada sobre o salário base do vendedor ou sobre um valor fixo informado na regra.
Valor fixo base (R$) Valor usado como base quando a OTE ou o Score forem configurados para cálculo sobre valor fixo.
Multiplicador sobre salário (x) Multiplicador aplicado sobre o salário base quando o vendedor atinge um marco de OTE.
Multiplicador sobre valor fixo (x) Multiplicador aplicado sobre o valor fixo quando o vendedor atinge um marco de OTE.
Nome da meta Nome da métrica que compõe o score. A meta de vendas é fixa, e outras metas podem ser adicionadas conforme a operação.
Tipo de métrica Define se a meta será medida por quantidade, valor, percentual ou vendas, conforme a opção disponível no modelo.
Alvo Valor de referência que precisa ser atingido para calcular o resultado daquela meta no score.
Regra Define como o resultado será interpretado em relação ao alvo, como acima, abaixo, progressivo até o alvo ou progressivo do alvo a zero.
Peso da meta (%) Percentual de importância daquela meta no score final. A soma dos pesos deve fechar em 100%.
Limite do Peso Progressivo (opcional) Permite limitar até onde o peso progressivo pode crescer quando a regra usa progressão.
Peso máximo Multiplicador máximo que o peso daquela meta pode alcançar em regras progressivas.
Peso excelência Resultado em que o peso progressivo atinge o limite máximo definido.
Base de cálculo da comissão Score Define se os marcos de score serão aplicados sobre salário base do vendedor ou sobre valor fixo.
Percentual de score do marco (%) Percentual de score necessário para ativar um marco de remuneração.
Multiplicador da base (x) Multiplicador aplicado sobre a base escolhida quando o marco de score é atingido.

Passo 4 - Bônus

Este passo permite cadastrar incentivos adicionais dentro da performance. O bônus é separado da comissão principal e pode ser usado para campanhas pontuais, metas paralelas ou ações específicas.

Campo na tela Para que serve
Ativo / Inativo Ativa ou desativa o cadastro de bônus na performance.
Nome do bônus Nome usado para identificar o bônus dentro da performance e nas leituras de resultado.
Tipo de métrica Define se o bônus será medido por quantidade, valor ou percentual.
Alvo Valor de referência que libera ou calcula o bônus.
Regra Define como o resultado será comparado ao alvo, com ou sem progressão.
Tipo de pagamento Define se o pagamento do bônus será valor fixo ou percentual sobre o salário base do vendedor.
Valor do pagamento Valor base do bônus ao atingir 100% do alvo, em reais ou percentual do salário conforme o tipo escolhido.
Limite do Pagamento Progressivo (opcional) Permite limitar o crescimento do pagamento quando a regra do bônus usa progressão.
Pagamento máximo Multiplicador máximo que o pagamento progressivo pode alcançar em relação ao valor do pagamento.
Pagamento excelência Resultado em que o pagamento progressivo atinge o limite máximo definido.

Passo 5 - Competição

Este passo define o critério do ranking e a premiação da performance. A competição ajuda o time a acompanhar posição, evolução e resultado durante o ciclo.

Campo na tela Para que serve
Vendas Ordena o ranking pelo total vendido por cada vendedor.
Meta Ordena o ranking pelo percentual de atingimento da meta individual.
Bônus Ordena o ranking pelo percentual médio de atingimento dos bônus cadastrados.
Score Ordena o ranking pelo score final de performance de cada vendedor.
1º Colocação Ativa ou desativa premiação para o primeiro colocado.
2º Colocação Ativa ou desativa premiação para o segundo colocado.
3º Colocação Ativa ou desativa premiação para o terceiro colocado.
Subir imagem da premiação Permite enviar uma imagem para representar visualmente a premiação daquela colocação.
Remover imagem da premiação Remove a imagem cadastrada para a premiação daquela colocação.
Nome da premiação 1º / 2º / 3º Nome exibido para o prêmio de cada colocação ativa.

4.4 Gerenciador de Clientes

O Gerenciador de Clientes é opcional e serve para organizar a base de clientes dentro do Askora. Ele é útil para empresas que querem padronizar lançamentos, facilitar buscas e manter registros comerciais mais consistentes.

Quando a operação usa integrações ou ainda não precisa controlar clientes dentro do Askora, esse cadastro pode ficar para uma etapa posterior.

Campo na tela Para que serve
Nome * Nome do cliente exibido na lista, nas buscas e nos vínculos operacionais.
CPF/CNPJ * Documento de identificação do cliente, usado para padronizar e reconhecer o cadastro.
Detalhes adicionais Campo opcional para observações úteis sobre o cliente, como informações comerciais, contexto interno ou instruções de apoio.

4.5 Gerenciador de Produtos

O Gerenciador de Produtos é opcional e serve para padronizar os itens usados na operação. Ele ajuda a reduzir erro de digitação, manter valores de referência e organizar quais produtos ficam disponíveis para todas as organizações ou apenas para uma unidade específica.

Campo na tela Para que serve
Nome * Nome do produto exibido na lista e usado para padronizar lançamentos e registros.
Valor Preço ou valor de referência do produto, usado como apoio operacional quando a empresa deseja manter essa informação no cadastro.
Vincular este produto a uma organização específica Define se o produto ficará restrito a uma organização. Se não marcar, o produto fica disponível para todas as organizações.
Organização vinculada Organização que terá acesso ao produto quando a opção de vínculo específico estiver ativa.
Detalhes adicionais Campo opcional para observações sobre o produto, regras internas, contexto comercial ou informações de apoio.

4.6 Gerenciador Financeiro

O Gerenciador Financeiro define as regras base do fluxo financeiro do Askora. É nele que a empresa ativa o módulo financeiro, escolhe se bônus entram na visão financeira, cadastra condições de pagamento e configura padrões de vencimento e prazo de pagamento.

Essa configuração é importante quando a comissão depende do recebimento, quando existem vendas parceladas ou quando a empresa precisa acompanhar o que está aberto, vencido, liberado ou pronto para pagamento.

Campo na tela Para que serve
Módulo financeiro Ativa o controle financeiro de lançamentos, vencimentos, prazos, condições de pagamento e liberação de comissões.
Exibir bônus no financeiro Inclui os bônus da competência nas visões e relatórios financeiros quando a empresa deseja acompanhar remuneração de forma consolidada.
Tipo da condição Define se a condição de pagamento será à vista ou a prazo.
Prazo de pagamento (dias) Para condição à vista, indica em quantos dias após o pedido o pagamento vence.
Parcelas da condição a prazo Área usada para cadastrar mais de uma parcela quando a condição for a prazo.
Dias da parcela Quantidade de dias após o pedido em que cada parcela vence, como 30, 60 e 90 dias.
Adicionar condição Salva a condição montada para que ela fique disponível nos lançamentos financeiros.
Registrar vencimentos Ativa o acompanhamento de vencimentos, permitindo visualizar o que está no prazo ou vencido.
Vencimento padrão para liberação Define uma condição de pagamento padrão para abrir lançamentos já com essa opção preenchida.
Sem condição padrão Opção usada quando a empresa não quer aplicar uma condição padrão nos lançamentos.
Prazo de pagamento após liberação (dias) Quantidade de dias somada à data de liberação para calcular quando a comissão entra no fluxo de pagamento.

4.7 Ordem recomendada de configuração

  1. Cadastre as organizações para criar a estrutura base da operação.
  2. Cadastre os usuários e vincule cada pessoa ao perfil e às organizações corretas.
  3. Cadastre a performance para definir vendedores, metas, comissão, bônus e competição.
  4. Use clientes e produtos quando a operação precisar padronizar a base comercial dentro do Askora.
  5. Configure o Gerenciador Financeiro quando a empresa quiser acompanhar vencimentos, recebimentos e liberação de comissões.

Campos com asterisco são obrigatórios. Campos opcionais devem ser preenchidos quando fizerem sentido para a regra da empresa, especialmente salário base, vínculo de produto por organização e configurações financeiras.

5) Comissão

A comissão é a regra que transforma o desempenho comercial em valor calculado dentro do Askora. O usuário define essa regra no cadastro da performance e acompanha o resultado nas páginas de Resultados e Performance.

Na prática, esta categoria serve para duas coisas: configurar como a comissão vai funcionar e ler, de forma clara, quanto foi gerado no período selecionado.

5.1 Onde a comissão aparece

  • No cadastro de performance: no Passo 3 - Comissionamento, onde o usuário escolhe o tipo de comissão e ativa, se quiser, o Turbo da comissão.
  • Na página de Resultados: no cartão Evolução de Comissão, que mostra a regra aplicada, a faixa ativa e os indicadores do período.
  • Na página Performance: nos blocos de resumo do período, onde a comissão aparece junto das vendas, da meta e, quando existe, dos bônus.

5.2 Como configurar a comissão

Ao abrir o cadastro da performance, o usuário chega ao passo de comissão depois de definir os vendedores e o período. Nesse momento, a tela mostra o controle de ativação e as opções de modelo.

  • Comissionamento ativo: liga a regra de comissão daquela performance.
  • Comissionamento inativo: mantém a performance sem regra de comissão.
  • Padrão: comissão fixa sobre as vendas do período.
  • OTE: comissão ligada ao atingimento da meta, com base em salário.
  • Score: comissão orientada por score, com faixas e multiplicador.
  • Turbo da comissão: adiciona faixas de evolução para mudar a regra conforme o desempenho avança.

O usuário escolhe o modelo que faz sentido para a operação e preenche apenas os campos que aparecem para aquele tipo de regra. Isso mantém a configuração mais simples e evita informação desnecessária.

Campos da comissão padrão

Campo na tela Para que serve
Percentual de comissão Define o percentual base aplicado sobre as vendas no modelo padrão.
Comissão escalonada Ativa a troca do percentual da comissão conforme a meta avança em marcos.
Percentual da meta para ativar (%) Marca o nível de meta que libera a próxima faixa da comissão escalonada.
Novo percentual de comissão (%) Define o percentual que passa a valer quando o marco de ativação é atingido.
Atingimento simulado (%) Mostra, na prévia, qual percentual de meta foi calculado para o cenário informado.
Vendas simuladas (R$) Valor usado na simulação para calcular o percentual ativo e a comissão do período.

Campos da comissão OTE

Campo na tela Para que serve
Base de cálculo da comissão OTE Escolhe se o multiplicador será aplicado sobre salário base ou sobre valor fixo.
Valor fixo base (R$) Valor usado como base quando a comissão OTE trabalha com valor fixo.
Percentual da meta para ativar (%) Define o marco de meta que ativa o multiplicador daquele nível.
Multiplicador sobre salário (x) Multiplicador aplicado quando a base da OTE é o salário do vendedor.
Multiplicador sobre valor fixo (x) Multiplicador aplicado quando a base da OTE é um valor fixo.
Vendas simuladas (R$) Valor usado para simular o atingimento e o multiplicador ativo.

5.3 O que cada modelo significa para o usuário

Modelo Como o usuário entende Como a leitura aparece depois
Padrão Uma comissão fixa sobre o que foi vendido. A tela mostra comissão acumulada, alíquota efetiva e faixas de turbo, quando existirem.
OTE Uma regra baseada na meta, com leitura ligada ao salário base do vendedor. A tela destaca o multiplicador ativo, o atingimento da meta e as faixas OTE.
Score Uma regra baseada em score, com faixas e multiplicador. A tela mostra score atual, score efetivo e multiplicador ativo.

Campos do Score

Campo na tela Para que serve
Nome da meta Identifica cada meta que compõe o score.
Tipo de métrica Define se a meta será medida por quantidade, valor, percentual ou vendas.
Alvo É a referência usada para calcular o peso realizado em cada meta.
Regra Define como o peso reage ao resultado: acima, abaixo, progressivo ou inverso.
Peso da meta (%) Define quanto aquela meta participa do score total.
Limite do Peso Progressivo (opcional) Ativa o teto de progressão quando a regra permite crescimento progressivo.
Peso máximo Define até quantas vezes o peso pode crescer em relação ao peso da meta.
Peso excelência Marca o ponto de resultado em que o peso atinge o limite máximo configurado.
Base de cálculo da comissão Score Escolhe se a remuneração do score será calculada sobre salário base ou valor fixo.
Valor fixo base (R$) Valor usado como base quando o score trabalha com pagamento fixo.
Percentual de score do marco (%) Define qual nível de score libera cada marco de remuneração.
Multiplicador da base (x) Multiplica a base escolhida quando o score atinge o marco configurado.
Vendas simuladas (R$) Valor usado para testar a leitura do score na pré-visualização.

Regras do Score

Regra O que faz na prática
ABOVE O peso só entra quando o resultado alcança o alvo ou passa dele; abaixo do alvo, o peso fica zerado.
ABOVE PROGRESSIVE Funciona como ABOVE, mas o peso cresce acima do alvo até o teto definido no limite progressivo.
BELOW O peso vale quando o resultado fica abaixo do alvo; acima do alvo, o peso zera.
BELOW PROGRESSIVE Funciona como BELOW, com crescimento progressivo até o limite configurado.
MORE O peso cresce de forma proporcional do zero até o alvo, até completar 100% da faixa.
MORE PROGRESSIVE Funciona como MORE e continua crescendo acima do alvo até o teto definido.
LESS O peso fica maior quanto menor for o resultado, caindo até zero quando chega ao alvo.

5.4 Como ler a comissão na página de Resultados

Quando o usuário abre a página de Resultados, a área de comissão aparece com o título Evolução de Comissão. Esse bloco resume a regra aplicada ao período selecionado e facilita a leitura do que está valendo naquele momento.

O cartão pode mudar de acordo com o modelo escolhido. Em vez de mostrar sempre a mesma informação, o Askora adapta os rótulos para ficar mais claro para o usuário.

  • Comissão acumulada: mostra o valor total de comissão no período.
  • Comissão diária: mostra o que foi gerado no dia.
  • Atingimento da Meta: aparece quando a comissão está no modelo padrão.
  • Alíquota efetiva: indica a taxa que está valendo no momento para o modelo padrão.
  • Multiplicador efetivo: aparece nos modelos OTE e Score.
  • Faixa ativa: mostra qual etapa da regra está valendo naquele recorte.

Se a performance selecionada não tiver comissão configurada, a página informa isso de forma direta com a mensagem de que não há configuração para os filtros atuais.

5.5 Como interpretar os blocos da comissão

  • Se o painel mostrar Comissão acumulada, o usuário está vendo o valor total já formado no período.
  • Se o painel mostrar Comissão diária, o usuário está vendo o valor gerado no dia corrente.
  • Se aparecer Alíquota efetiva, a comissão está no modelo padrão.
  • Se aparecer Multiplicador efetivo, a comissão está usando OTE ou Score.
  • Se a área exibir Faixas de comissão, o usuário pode conferir onde está a regra ativa e quais faixas já foram concluídas.

5.6 Ações possíveis do usuário

  • Ativar ou desativar a comissão de uma performance.
  • Escolher entre Padrão, OTE ou Score.
  • Definir faixas de Turbo da comissão, quando a operação quiser premiar avanço por etapas.
  • Conferir o resultado na página de Resultados e comparar o valor acumulado com o período atual.
  • Gerar documentos e extratos com a comissão no resumo ou no detalhamento por vendedor.

5.7 Observações importantes

  • A comissão sempre depende da performance e dos filtros selecionados na tela.
  • O nome das informações na tela muda conforme o modelo escolhido para ficar mais fácil de entender.
  • No modelo OTE, o salário base precisa fazer parte da configuração dos vendedores para que a leitura fique coerente.
  • Se o Turbo estiver ativo, o usuário só verá faixas úteis quando houver marcos configurados.
  • Quando não houver comissão configurada, o Askora não inventa um valor: ele mostra que a configuração não existe para aquele recorte.

5.8 Fluxo prático de uso

Exemplo simples: o usuário cadastra uma performance mensal com comissão Padrão, define um percentual fixo e salva. Depois, abre a página de Resultados, seleciona a mesma performance e confere o cartão Evolução de Comissão. Ali ele vê a comissão acumulada, o valor diário e a alíquota que está valendo no período.

Se a empresa usar um modelo mais avançado, como OTE ou Score, o fluxo continua o mesmo. O que muda é a forma como a comissão é apresentada na tela: em vez de falar só de percentual fixo, a página mostra multiplicadores, faixas e o estágio ativo da regra.

6) Bônus

O bônus é um complemento opcional da performance. Ele serve para criar metas extras, premiar resultados específicos e mostrar, de forma clara, quanto cada vendedor já atingiu dentro da regra cadastrada.

Essa etapa aparece no Passo 4 - Bônus do cadastro da performance. Quando está ativa, o usuário pode criar uma ou mais regras, cada uma em sua própria aba, e testar a configuração antes de salvar.

6.1 Onde o bônus aparece

  • No cadastro de performance: no Passo 4 - Bônus, onde o usuário ativa o recurso, cria as regras e confere a simulação.
  • Na página de Resultados: no cartão Seu progresso em bônus ou nos cartões de bônus, quando a performance possui bônus configurado.
  • Na página Performance: nos blocos de resumo, quando o bônus faz parte da leitura da performance atual.
  • Na página Financeiro: quando o bônus foi liberado e precisa ser acompanhado no fluxo financeiro da operação.

6.2 Como utilizar o bônus

  1. Abra o cadastro da performance e avance até o Passo 4 - Bônus.
  2. Ative o bônus se a operação usar esse tipo de premiação.
  3. Crie uma regra para cada bônus que desejar acompanhar.
  4. Preencha os campos principais da regra: nome, métrica, alvo, regra, tipo de pagamento e valor.
  5. Se quiser premiar avanço progressivo, ative a opção de limite do pagamento progressivo e complete os campos adicionais.
  6. Use a área de Pré-visualização / Simulação para testar um cenário antes de salvar.
  7. Salve a performance e confira o resultado depois na página de Resultados.

6.3 O que o usuário encontra na tela

Elemento Para que serve O que o usuário faz
Ativo / Inativo Define se o bônus será usado naquela performance. O usuário liga ou desliga o passo conforme a necessidade da operação.
Abas de bônus Organizam várias regras dentro da mesma performance. O usuário cria uma aba para cada bônus, alterna entre elas e pode remover as que não quiser manter.
Nome do bônus Identifica a regra na tela e nos resultados. O usuário escolhe um nome claro para localizar a regra com facilidade.
Tipo de métrica Define como o resultado será lido. O usuário escolhe entre quantidade, valor ou percentual.
Alvo É o valor de referência da regra. O usuário informa o ponto que precisa ser atingido para o bônus fazer sentido.
Regra Define o comportamento do bônus em relação ao alvo. O usuário escolhe a lógica que combina com a operação, como acima, abaixo ou progressiva.
Tipo de pagamento Define a base do valor pago. O usuário decide entre valor fixo ou percentual sobre o salário base.
Valor do pagamento Define quanto o bônus pode pagar na regra principal. O usuário informa o valor inicial que será usado no cálculo.
Limite do Pagamento Progressivo Mostra se o bônus terá um teto de evolução. O usuário ativa essa opção quando quiser controlar até onde a regra pode crescer.
Pagamento máximo Define o teto da progressão. O usuário informa até quantas vezes o pagamento pode crescer em relação ao valor base.
Pagamento excelência Define o ponto em que a regra chega ao limite máximo. O usuário informa o resultado esperado para atingir o teto definido.
Pré-visualização / Simulação Permite testar a regra antes de salvar. O usuário digita um cenário e confere o resultado simulado na própria tela.

Campos do bônus

Campo na tela Para que serve
Nome do bônus Identifica a regra do bônus na performance e nos resultados.
Tipo de métrica Define como o alvo será medido: quantidade, valor ou percentual.
Alvo É o valor de referência usado para calcular o bônus.
Regra Define como o bônus reage ao resultado em relação ao alvo.
Tipo de pagamento Escolhe se o bônus será pago por valor fixo ou por salário base.
Valor do pagamento Define o valor base que será usado no cálculo do bônus.
Limite do Pagamento Progressivo (opcional) Ativa o teto de progressão quando a regra permite crescimento progressivo.
Pagamento máximo Define até quantas vezes o pagamento pode crescer em relação ao valor base.
Pagamento excelência Marca o ponto de resultado em que o pagamento chega ao limite máximo.
Salário Base Mostra a base salarial usada quando o bônus é calculado sobre salário.
Valor de atingimento do alvo simulado Valor digitado para testar o comportamento do bônus na simulação.
Resultado simulado Mostra o valor de bônus calculado para o cenário testado.

6.4 Como interpretar cada parte

  • Bônus ativo: a performance vai usar essa etapa no acompanhamento.
  • Várias abas: cada aba representa um bônus diferente.
  • Nome do bônus: ajuda a identificar rapidamente a regra na lista e nos resultados.
  • Tipo de métrica: mostra se o alvo será lido por quantidade, valor ou percentual.
  • Regra: define se o bônus começa quando o resultado passa do alvo, fica abaixo dele ou cresce de forma progressiva.
  • Pagamento fixo: o valor é definido em reais.
  • Pagamento por salário base: o bônus acompanha o salário do vendedor, o que é útil para modelos de remuneração variável.
  • Limite do pagamento progressivo: ajuda a evitar que o bônus cresça sem controle.
  • Simulação: permite validar a regra antes de salvar e reduz a chance de erro na configuração.

Regras do bônus

Regra O que faz na prática
ABOVE O bônus só é pago quando o resultado alcança o alvo ou passa dele.
ABOVE PROGRESSIVE Funciona como ABOVE, mas o pagamento cresce acima do alvo até o teto configurado.
BELOW O bônus é pago quando o resultado fica abaixo do alvo; acima do alvo, o valor zera.
BELOW PROGRESSIVE Funciona como BELOW, com crescimento progressivo até o limite definido.
MORE O pagamento cresce de forma proporcional do zero até o alvo.
MORE PROGRESSIVE Funciona como MORE e continua crescendo acima do alvo até o teto configurado.
LESS O pagamento fica maior quanto menor for o resultado, chegando a zero quando o alvo é atingido.

6.5 Como ler o bônus na página de Resultados

Depois de salvar a performance, o bônus pode ser consultado na página de Resultados. Quando ele existir para a seleção feita, a tela mostra um cartão com o progresso do bônus no período.

  • Seu progresso em bônus: visão resumida do bônus no período selecionado.
  • Nome do bônus: identifica cada regra cadastrada.
  • Resultado atual x alvo: mostra quanto já foi atingido em comparação com o objetivo da regra.
  • Barra de progresso: ajuda a visualizar o avanço de forma rápida.
  • Resultado do bônus: exibe o valor já apurado para aquela regra.

Quando a performance possui mais de um bônus, a leitura pode aparecer de forma consolidada ou separada por regra, de acordo com o contexto e com o acesso do usuário.

6.6 Ações possíveis do usuário

  • Ativar ou desativar o passo de bônus na performance.
  • Criar mais de uma regra de bônus dentro da mesma performance.
  • Alternar entre as abas para revisar cada bônus separadamente.
  • Remover uma aba de bônus quando ela não for mais necessária.
  • Testar o cenário com a simulação antes de salvar.
  • Conferir o andamento dos bônus depois na página de Resultados.

6.7 Observações importantes

  • O bônus é opcional. Se a operação não usar esse recurso, ele pode ficar desativado sem prejudicar a performance.
  • Cada aba guarda uma regra diferente. Isso ajuda quando a empresa quer premiar metas distintas na mesma performance.
  • Se o tipo de pagamento for baseado no salário, o salário base precisa estar preenchido corretamente para que a leitura faça sentido.
  • O limite do pagamento progressivo só aparece quando a regra escolhida permite esse tipo de progressão.
  • A simulação existe para ajudar o usuário a enxergar o resultado antes de salvar e evitar configuração incorreta.
  • Na página de Resultados, o bônus só aparece quando a performance selecionada realmente possui bônus configurado.

6.8 Fluxo prático de uso

Exemplo simples: o usuário abre a performance mensal, ativa o passo de bônus e cria uma aba chamada Bônus Meta Vendas. Depois, escolhe a métrica por valor, define o alvo, informa o valor do pagamento e testa o cenário na simulação.

Se a empresa quiser premiar avanços por etapas, o usuário ativa o limite do pagamento progressivo e completa os campos extras. Ao salvar, o bônus passa a fazer parte do ciclo e pode ser acompanhado na página de Resultados, com barra de progresso e valor já apurado.

7) Integrações

A área de Integrações centraliza as formas de conectar o Askora com a origem dos dados da operação. É aqui que o usuário escolhe entre API, Google Sheets ou importação por arquivo, de acordo com a forma como a empresa já trabalha.

Esta área é destinada ao perfil Master. Na tela, o usuário encontra abas bem separadas para cada formato de integração e consegue revisar o que já está configurado antes de liberar o uso no dia a dia.

Visão geral

O objetivo dessa categoria é receber os dados da operação do jeito mais prático possível, sem que o usuário precise refazer o processo toda vez. A tela foi organizada para três cenários principais:

  • API, quando o envio vem de outro sistema.
  • Google Sheets, quando a operação prefere trabalhar em planilhas conectadas.
  • Importação, quando o envio acontece por arquivo Excel ou CSV.

Há ainda uma quarta aba de Webhook, que aparece como em breve.

O que o usuário encontra nesta tela

  • Abas principais para alternar entre API, Google Sheets, Importação e Webhook.
  • Subabas de apoio dentro de cada canal, com áreas de informação e configuração.
  • Cartão de API Key, com opção de mostrar, copiar e gerar novamente a chave.
  • Botão para Conectar Google e controles de leitura das abas da planilha.
  • Modelos de planilha para escolher entre Planilha Única e Planilha Individual.
  • Resumo das configurações de importação já salvas.
  • Formulários para mapear colunas, formatos e opções de cada tipo de importação.
  • Botões de Salvar configuração e Remover configuração nas áreas de importação.

Como utilizar

  1. Escolha o canal que melhor combina com a rotina da operação.
  2. Na API, gere a chave e ajuste os campos que sua origem externa vai enviar.
  3. No Google Sheets, conecte a conta Google, escolha o modelo de planilha e defina quais abas serão lidas.
  4. Na Importação, configure uma vez o que cada coluna da planilha significa e depois use essa leitura sempre que precisar enviar arquivos.
  5. Salve as configurações e revise o resumo exibido na própria tela antes de seguir para a operação.

Detalhamento de cada seção

API

A aba de API é usada quando outro sistema envia os dados diretamente para o Askora. Ela serve para liberar a chave de acesso, mostrar os caminhos disponíveis e permitir que o usuário adapte os nomes dos campos quando a origem externa usa uma linguagem diferente da padrão do Askora.

  • Informações: mostra uma visão geral do fluxo e ajuda o usuário a escolher quando usar cada rota.
  • API Key: exibe a chave ativa, com botões para mostrar, ocultar, copiar e gerar ou regenerar a chave.
  • Autenticação e rotas: apresenta o cabeçalho obrigatório e os caminhos disponíveis para lançamentos, financeiro, bônus e score.
  • Campos personalizados: permite adaptar os nomes dos campos quando a origem externa usa uma estrutura diferente da padrão do Askora.
Visão geral

O objetivo desta integração é receber os dados no formato mais próximo possível da rotina da empresa e traduzir isso para o Askora de forma segura. O usuário pode usar a API quando já existe um sistema de origem, quando precisa sincronizar dados em tempo real ou quando quer atualizar registros já cadastrados sem depender de planilhas ou importações manuais.

Esta integração é voltada ao perfil Master. Quando a chave está ativa e os campos estão bem configurados, o Askora consegue receber lançamentos, atualizar o financeiro, registrar bônus e atualizar score sem que o usuário precise fazer tudo manualmente.

O que o usuário precisa antes de configurar
  • Ter acesso de Master para gerar e manter a chave da integração.
  • Conhecer os nomes dos campos que o sistema de origem envia.
  • Decidir se a integração vai tratar apenas lançamentos ou também financeiro, bônus e score.
  • Saber se a origem externa identifica o vendedor por e-mail ou por link cadastrado.
  • Se a empresa quiser usar regras financeiras, o módulo financeiro do Askora precisa estar ativo.
Como configurar a integração
  1. Abra a aba API Key e gere uma chave ativa para o ambiente.
  2. Copie essa chave e use-a no sistema de origem no cabeçalho Authorization: Bearer.
  3. Abra a aba Autenticação e rotas para conferir os caminhos disponíveis.
  4. Se a origem externa usa nomes diferentes dos padrões do Askora, vá até Campos personalizados e ajuste o mapeamento.
  5. Salve a configuração e envie um teste com poucos itens antes de liberar a rotina completa.
  6. Confira a resposta da API e valide o resultado nas áreas operacionais do Askora.
Detalhamento dos campos e parâmetros

API Key

A chave é o identificador que libera o acesso da integração. A tela mostra a chave ativa, com ações para exibir, copiar e gerar uma nova chave.

  • Existe apenas uma chave ativa por ambiente.
  • Ao gerar uma nova chave, a anterior deixa de funcionar.
  • Use esta ação com cuidado, porque o sistema externo precisa ser atualizado logo em seguida.

Autenticação e rotas

Toda chamada deve enviar a chave no cabeçalho Authorization: Bearer [sua chave]. Na própria tela, o usuário encontra os caminhos mais importantes para o fluxo da integração.

  • POST /api/v1/lancamentos: cria, atualiza, reativa ou inativa lançamentos.
  • POST /api/v1/financeiro: atualiza vencimento e/ou status financeiro de pedidos já existentes.
  • POST /api/v1/bonus: atualiza o resultado de bônus já cadastrados.
  • POST /api/v1/score: atualiza o resultado de metas de score já cadastradas.
  • Alguns fluxos também aceitam listas de itens para processar várias linhas de uma vez.

Campos personalizados

Esta área existe para quando o sistema de origem não usa os mesmos nomes do Askora. Ao ativar a personalização, o Askora passa a ler apenas os nomes configurados ali para aquele ambiente.

  • Use o nome exato que chega do sistema de origem para cada campo.
  • Se um campo não for usado pela origem, ele pode ficar em branco.
  • Se a operação já envia o padrão do Askora, a personalização pode ser desativada.
  • Os cards da tela separam os campos por rota: lançamentos, financeiro, bônus e score.

Lançamentos

Esta rota é usada para criar ou atualizar vendas e pedidos. Ela é a base da integração porque alimenta o fluxo comercial do Askora.

Campo Obrigatório Para que serve
vendedor_email ou vendedor_link Sim, escolha apenas um Identifica o vendedor que será vinculado ao lançamento.
pedido Sim É a chave comercial usada para localizar o lançamento.
data_venda Sim Data em que a venda aconteceu.
valor_total Sim Valor comercial total do pedido.
status Não Indica se o pedido está ativo ou inativo.
cliente_nome, produto_nome, detalhes_adicionais Não Complementam a leitura do lançamento com informações úteis para a operação.
status_financeiro, data_vencimento, data_atualizacao Não Levam informações financeiras junto com a venda quando o módulo financeiro está ativo.
parcela_numero, parcelas_total, valor_parcela Sim, quando o pedido for parcelado Permitem tratar o pedido parcela por parcela.

Quando a origem envia pedido parcelado, os três campos de parcela precisam vir juntos. Se um deles faltar, o Askora não monta o parcelamento corretamente.

Financeiro

Esta rota atualiza apenas pedidos já existentes. Ela não cria venda nova. É usada para alterar vencimento, liberar, cancelar ou reabrir o que já foi registrado.

Campo Obrigatório Para que serve
pedido Sim Localiza o lançamento que será atualizado.
status_financeiro Não, mas é um dos campos esperados Define se a venda ficará em liberação, já liberada ou cancelada.
data_vencimento Não, mas pode ser suficiente em alguns casos Atualiza o vencimento do pedido ou da parcela.
parcela_numero Só quando a atualização for de uma parcela específica Indica qual parcela do pedido deve ser alterada.
data_atualizacao Opcional Registra a data da liberação ou do cancelamento.

Se o pedido for parcelado, o Askora precisa da parcela correta para atualizar o vencimento ou o status financeiro daquela parte do pedido.

Bônus

Esta rota atualiza o resultado de bônus já cadastrados na performance do vendedor. O tipo do bônus já foi definido na performance, então a integração envia apenas o valor apurado.

Campo Obrigatório Para que serve
vendedor_email ou vendedor_link Sim, escolha apenas um Localiza o vendedor dono do bônus.
bonus_name Sim Nome da regra de bônus cadastrada na performance.
competencia ou competencia_inicio + competencia_fim Sim Define o período do bônus que será atualizado.
resultado Sim Valor ou quantidade apurada para o bônus.

O nome do bônus precisa bater com o nome cadastrado para que o Askora encontre a regra certa. Se houver mais de um candidato, o sistema sinaliza a ambiguidade para evitar atualização errada.

Score

Esta rota atualiza o resultado de metas de score já cadastradas. O score também é localizado pelo vendedor, pelo nome e pela competência.

Campo Obrigatório Para que serve
vendedor_email ou vendedor_link Sim, escolha apenas um Localiza o vendedor dono da meta.
meta_nome ou score_name Sim Nome da meta ou do score cadastrado.
competencia ou competencia_inicio + competencia_fim Sim Define o período da meta que será atualizada.
resultado Sim Valor final a ser gravado na meta.

Assim como no bônus, o Askora usa o nome e a competência para localizar a meta correta. Isso evita atualizar o score errado quando a operação tem metas parecidas.

Como funciona a comunicação com o Askora

O sistema externo envia os dados por chamada autenticada. O Askora valida a chave, identifica o vendedor, interpreta os campos recebidos e então grava ou atualiza o registro certo no fluxo operacional.

Em lançamentos, a integração pode criar, atualizar, reativar ou inativar pedidos. Em financeiro, ela atualiza pedidos já existentes. Em bônus e score, ela procura a regra já cadastrada e só então grava o resultado.

Quando o sistema de origem envia mais de um item por vez, o Askora processa item a item e devolve um resumo com o que foi concluído e o que precisa de ajuste.

Parte financeira da integração

A parte financeira aparece de duas formas: junto com o lançamento ou por atualização direta no fluxo financeiro. Isso ajuda a operação a acompanhar vencimentos, liberações, cancelamentos e parcelas sem precisar repetir o cadastro da venda.

  • Liberar: deixa o pedido aguardando etapa financeira ou operacional seguinte.
  • Liberado: indica que o pedido já foi liberado para seguir o fluxo.
  • Cancelado: mostra que aquele registro foi encerrado financeiramente.
  • Data de vencimento: ajuda a controlar o que está dentro ou fora do prazo.
  • Data de atualização: registra quando a liberação ou o cancelamento aconteceu.

Se o módulo financeiro estiver ativo, essas informações passam a refletir no Painel Financeiro e no Dashboard Financeiro. Assim, o usuário acompanha pendências, valores liberados e vencimentos com mais clareza.

Como validar se a configuração está correta
  1. Confirme se a API Key está ativa e foi copiada para o sistema de origem.
  2. Envie uma requisição de teste com poucos itens.
  3. Confira se o retorno da API trouxe sucesso ou indicou o campo que precisa ser ajustado.
  4. Verifique o resultado no módulo correspondente: Operações para lançamentos, Financeiro para prazos e liberações, e Resultados para bônus e score.
  5. Se estiver usando campos personalizados, confirme se os nomes configurados batem com os nomes reais da origem externa.
Pontos de atenção
  • Envie apenas um identificador de vendedor por vez: vendedor_email ou vendedor_link.
  • Ao gerar uma nova API Key, a anterior deixa de valer.
  • Se a personalização de campos estiver ativa, o Askora passa a ler apenas o que foi mapeado ali.
  • Em pedidos parcelados, os campos da parcela precisam vir completos e coerentes entre si.
  • data_atualizacao só deve ser usada quando o status financeiro for liberado ou cancelado.
  • Se o módulo financeiro não estiver ativo, os campos financeiros não vão refletir na operação como esperado.
  • Quando a origem enviar vários itens de uma vez, revise o retorno item a item antes de considerar o envio concluído.
Resumo prático

A API do Askora é o caminho certo para quem quer enviar dados de outro sistema com segurança e padronização. O usuário gera a chave, informa o cabeçalho de autenticação, ajusta os campos personalizados quando necessário e escolhe a rota certa para cada tipo de dado. Lançamentos alimentam a operação, financeiro controla vencimentos e liberações, bônus atualiza incentivos e score atualiza metas. Quando tudo está configurado corretamente, o Askora recebe os dados e devolve a leitura pronta para acompanhamento.

Google Sheets

A integração Google Sheets é indicada para quem quer trabalhar com planilhas conectadas ao Askora sem precisar importar um arquivo novo a cada atualização. Em vez de enviar arquivos soltos, o usuário conecta uma conta Google, gera a planilha no modelo certo e passa a preencher as linhas dentro de um arquivo que o Askora consegue ler continuamente.

  • Informações: explica se a planilha será usada apenas para vendas ou para vendas com financeiro.
  • Conta Google: mostra a conta conectada e a ação para autorizar, trocar ou desconectar o vínculo.
  • Configuração de leitura: define quais abas o Askora vai considerar na leitura, como Vendas, Bônus e Score.
  • Modelo de planilha: permite escolher entre Planilha Única e Planilha Individual.
  • Detalhes do modelo: mostra as orientações de uso conforme o tipo de planilha selecionado.
  • Planilhas por vendedor: aparece no modelo individual e permite gerar, abrir, acompanhar ou descartar as planilhas de cada vendedor.
Visão geral

O objetivo desta integração é manter a operação atualizada de forma prática e organizada. O Askora lê a planilha conectada, interpreta as linhas preenchidas e transforma essas informações em lançamentos usados pelo sistema. Dessa forma, a equipe consegue trabalhar com a mesma planilha ao longo do tempo, sem depender de importações manuais repetidas.

A integração funciona com uma conta Google autorizada e oferece dois caminhos de uso: Planilha Única, quando existe uma planilha central para a operação, e Planilha Individual, quando cada vendedor recebe a sua própria planilha. A leitura principal é de Vendas, enquanto Bônus e Score são opcionais. Quando a operação também usa financeiro, a variante Vendas e Financeiro acrescenta informações de parcela, vencimento e status financeiro.

O que o usuário precisa antes de configurar
  • Ter acesso de Master, já que é esse perfil que conecta ou desconecta a conta Google.
  • Ter uma conta Google pronta para receber as planilhas no Drive.
  • Definir se a operação vai usar uma planilha central ou uma planilha por vendedor.
  • Escolher se a leitura será apenas de vendas ou de vendas com financeiro.
  • Saber se a operação também vai precisar ler bônus e score pela planilha.
Como configurar a integração
  1. Abra a aba Google Sheets no módulo de Integrações.
  2. Clique em Conectar Google e autorize a conta que ficará vinculada ao fluxo.
  3. Escolha a variante correta: Vendas ou Vendas e Financeiro.
  4. Escolha o modelo de trabalho entre Planilha Única e Planilha Individual.
  5. Ative apenas as leituras que fizerem sentido para a operação. Vendas é a base; Bônus e Score são opcionais.
  6. Gere a planilha ou as planilhas individuais de acordo com o modelo escolhido.
  7. Abra o arquivo gerado e comece a preencher os dados conforme o modelo exibido na própria tela.
Detalhamento dos campos e parâmetros

Conta Google

Esse bloco mostra a conta conectada ao Askora e a ação para manter ou trocar o vínculo. A conta Google é o ponto central da integração porque é nela que o sistema cria e acompanha as planilhas.

  • Se ainda não houver conexão, a ação aparece como Conectar Google.
  • Se já existir uma conta conectada, o usuário pode desconectar para trocar o vínculo ou interromper o uso daquela conta.
  • O e-mail autorizado aparece na tela como referência para facilitar a conferência.

Configuração de leitura

Essa área define o que o Askora vai considerar dentro da planilha. A leitura de Vendas já faz parte do fluxo principal, e as abas de Bônus e Score só devem ser ativadas quando a operação realmente usar esses recursos.

  • Vendas: aba principal da integração, usada para registrar pedidos e vendas.
  • Bônus: ativa a leitura de bônus já configurados na performance.
  • Score: ativa a leitura de metas e resultados de score já configurados.
  • Ligar ou desligar uma aba altera apenas a leitura daquela informação, sem apagar a planilha criada.

Modelo de planilha

O usuário escolhe entre dois modos de uso.

  • Planilha Única: uma única planilha concentra a operação. Cada linha precisa identificar o vendedor responsável.
  • Planilha Individual: cada vendedor recebe a sua própria planilha. O Askora gera um arquivo separado por vendedor ativo.

A escolha do modelo muda a rotina de preenchimento e a forma como a equipe acompanha os registros no dia a dia.

Detalhes do modelo

Depois que o modelo é escolhido, a tela mostra instruções e ações específicas para aquele formato. Essa área ajuda o usuário a entender se a operação deve funcionar de forma centralizada ou distribuída por vendedor.

Planilhas por vendedor

Essa área aparece quando o modelo individual está em uso. Cada card representa um vendedor ativo e mostra se existe uma planilha vinculada, além das ações para gerar, abrir ou descartar o arquivo daquele vendedor.

  • Gerar planilha: cria e vincula a planilha do vendedor.
  • Abrir planilha: abre o arquivo já vinculado em uma nova aba.
  • Descartar: remove o vínculo com o Askora, mas mantém o arquivo no Google Drive.
  • Se o vendedor ficar inativo ou for removido, o vínculo pode aparecer em uma área separada para descarte.

Planilha Única (Vendas)

Esse modelo é indicado quando uma pessoa centraliza o preenchimento. A planilha traz os campos comerciais básicos e cada linha representa uma venda.

Campo Obrigatório Para que serve
updated_at Sim Identifica quando a linha foi atualizada pela última vez.
status Não Mostra se a venda está ativa ou inativa.
id_pedido Sim Identifica o pedido dentro do Askora.
id_vendedor Sim Vincula a linha ao vendedor correto.
data_venda Sim Data da venda registrada na linha.
valor_venda Sim Valor da venda daquela linha.

Se o campo status vier em branco, o Askora entende a linha como ativa. Quando a planilha for usada para vendas com financeiro, essa mesma estrutura continua, mas a leitura também aceita campos de parcela e vencimento.

Planilha Única (Vendas e Financeiro)

Esse modelo é indicado quando a mesma planilha precisa trazer informações comerciais e financeiras. Ele adiciona os campos que ajudam a acompanhar parcelas, vencimentos e status financeiro sem separar o fluxo em outro arquivo.

Campo Obrigatório Para que serve
parcela_numero Quando houver parcelamento Indica a posição da parcela dentro do pedido.
parcelas_total Quando houver parcelamento Mostra quantas parcelas o pedido possui.
data_vencimento Sim, quando houver dados financeiros Define o vencimento daquela parcela ou de uma venda única.
data_atualizacao Opcional Registra a data da última atualização da linha financeira.
status_financeiro Opcional Mostra se o financeiro está em liberação, liberado ou cancelado.

Quando a venda for parcelada, o ideal é preencher uma linha por parcela e manter o mesmo pedido em todas as linhas. Para venda única, use uma única linha com a parcela 1 de 1.

Planilha Individual (Vendas)

Nesse modelo, cada vendedor trabalha com a própria planilha. O Askora gera um arquivo para cada vendedor ativo e mostra o status do vínculo, o andamento da geração e as ações disponíveis em cada card.

Campo Obrigatório Para que serve
updated_at Sim Identifica quando a linha foi atualizada pela última vez.
status Não Mostra se a venda está ativa ou inativa.
id_pedido Sim Identifica o pedido dentro do Askora.
data_venda Sim Data da venda registrada na linha.
valor_venda Sim Valor da venda daquela linha.
  • Se a planilha já estiver vinculada, o card mostra o vínculo e libera a ação de abrir ou descartar.
  • Se o vendedor estiver inativo ou tiver sido removido, o vínculo pode aparecer em uma área separada para descarte.
  • Se a conta Google ainda não estiver conectada, a geração individual fica bloqueada.
Como funciona a comunicação com o Askora

O Askora não lê qualquer planilha: ele lê a planilha conectada, identifica a variante escolhida, verifica quais abas estão habilitadas e transforma as linhas atualizadas em lançamentos do sistema.

A leitura acontece de forma contínua. Quando a planilha muda, o Askora considera a atualização conforme a configuração salva e leva os dados para o fluxo usado em Operações. Se as abas de bônus ou score estiverem ativas, essas informações também seguem o mesmo vínculo.

Quando a variante inclui financeiro, os dados de parcela e vencimento entram junto com a venda, permitindo acompanhar o fluxo financeiro na mesma integração.

Parte financeira da integração

A variante Vendas e Financeiro existe para operações que precisam ler dados financeiros diretamente da planilha. Ela ajuda a controlar parcelas, vencimentos, liberação e cancelamento sem exigir um arquivo separado para cada etapa.

  • Use essa variante quando a planilha precisar carregar vencimentos e status financeiros junto com a venda.
  • Se a operação trabalha só com vendas comerciais, a variante Vendas já é suficiente.
  • Se o financeiro estiver ativo, os dados lidos na planilha podem refletir no acompanhamento financeiro do Askora.
Como validar se a configuração está correta
  1. Confirme se a conta Google aparece conectada na tela.
  2. Escolha o modelo correto: Planilha Única ou Planilha Individual.
  3. Verifique se a variante corresponde ao que a operação realmente usa: Vendas ou Vendas e Financeiro.
  4. Ative apenas as abas que a operação realmente precisa ler.
  5. Gere a planilha e abra o arquivo criado para conferir se o modelo foi copiado corretamente.
  6. Se for individual, confira se cada card de vendedor mostra o vínculo esperado.
  7. Depois de preencher uma linha de teste, valide se o resultado aparece no fluxo operacional do Askora.
Pontos de atenção
  • Somente o perfil Master pode conectar ou desconectar a conta Google.
  • Não misture modelos ativos. Antes de trocar de Planilha Única para Planilha Individual, ou de Vendas para Vendas e Financeiro, descarte os vínculos antigos.
  • Descartar a planilha remove o vínculo com o Askora, mas não apaga o arquivo do Google Drive nem os lançamentos já processados.
  • Se a planilha individual já existir para um vendedor, o sistema mostra esse vínculo na tela para evitar duplicidade.
  • As abas de Bônus e Score são opcionais e devem ser ativadas apenas quando a operação realmente usar essas leituras.
  • Na variante com financeiro, mantenha os dados de parcela e vencimento coerentes para evitar inconsistência no acompanhamento.
Resumo prático

A integração Google Sheets é a opção ideal para quem quer trabalhar com uma planilha contínua, vinculada ao Askora e atualizada sem importação manual a cada envio. O usuário conecta a conta Google, escolhe a variante da planilha, decide entre modelo único ou individual, ativa apenas as leituras que fizerem sentido e gera os arquivos necessários. Depois disso, o Askora lê a planilha conectada e leva os dados para Operações e, quando aplicável, para o fluxo financeiro, bônus e score.

Importação

A integração de Importação é indicada para quem envia dados por arquivo Excel ou CSV, sem uma conexão em tempo real. Em vez de importar qualquer planilha de forma avulsa, o usuário configura uma vez como o Askora deve interpretar cada coluna e depois repete esse fluxo sempre que precisar atualizar os dados.

  • Informações: resume o que já foi configurado e mostra os tipos de importação disponíveis.
  • Lançamentos: define como o Askora vai ler vendas e pedidos enviados por arquivo.
  • Bônus: define como atualizar bônus já cadastrados por arquivo.
  • Financeiro: define como atualizar vencimentos, liberações e cancelamentos quando o módulo financeiro estiver ativo.
  • Score: define como atualizar metas e resultados de score por arquivo.

Cada subaba mostra campos específicos para o tipo de dado. O usuário informa tipo de arquivo, linhas para ignorar, coluna do vendedor, coluna do pedido, datas, valores e, quando necessário, opções extras como cliente, produto, status e dados financeiros.

Visão geral

O objetivo da importação é transformar arquivos enviados pela operação em dados que o Askora consegue ler e processar. O sistema valida a configuração salva, interpreta cada linha do arquivo e envia o resultado para o fluxo central correspondente. Isso evita retrabalho e permite repetir o mesmo padrão sempre que novos arquivos chegarem.

Hoje existem quatro frentes de importação configurável: lancamentos, financeiro, bonus e score. Cada uma tem sua própria configuração e não interfere nas outras. Ajustar a leitura de bônus, por exemplo, não altera a leitura de lançamentos.

O que o usuário precisa antes de configurar
  • Saber se o arquivo será Excel ou CSV.
  • Entender quais colunas do arquivo representam vendedor, pedido, data, valor e, quando necessário, status financeiro.
  • Definir se o arquivo traz apenas vendas ou se também precisa carregar bônus, score e financeiro.
  • Ter clareza sobre como o vendedor será identificado: por e-mail/login ou por ID externo/link.
  • Decidir se a operação usa cabeçalho na primeira linha ou se precisa ignorar linhas iniciais.
Como a rotina funciona na prática

Depois que a configuração da importação está salva, o envio do arquivo acontece dentro da rotina de Operações, na área de Importação e Liberação. É ali que o usuário sobe o arquivo, confere o retorno e acompanha o que foi processado.

O comportamento muda conforme o perfil de acesso. Quando o usuário é Vendedor, os lançamentos importados passam por liberação e ficam aguardando aprovação do Master. Quando o usuário é Master, a importação pode ser aplicada de forma direta, sem precisar passar por liberação.

Como configurar a integração
  1. Abra a aba Importação e escolha o tipo de leitura que deseja configurar.
  2. Selecione o tipo de arquivo que será usado: Excel ou CSV.
  3. Informe quantas linhas iniciais devem ser ignoradas antes da leitura começar.
  4. Preencha o mapeamento de colunas de acordo com o tipo de importação escolhido.
  5. Defina o formato das datas, dos valores e, quando houver, da competência.
  6. Se o arquivo trouxer status, marque quais textos representam ativo, inativo, pendente, liberado ou cancelado.
  7. Salve a configuração e envie um arquivo de teste para validar a leitura.
Detalhamento dos campos e parâmetros

Tipo de arquivo

Esse campo define o formato que o Askora vai aceitar naquela configuração. O arquivo precisa bater com o que foi salvo.

  • Excel: use quando a operação enviar arquivos .xlsx ou .xls.
  • CSV: use quando a operação enviar arquivos .csv.
  • Se o tipo salvo for Excel e chegar um CSV, o sistema rejeita antes de processar.

Linhas para ignorar

Esse campo informa quantas linhas iniciais o Askora deve pular antes de começar a ler os dados. Ele é útil quando o arquivo tem título, instruções ou cabeçalho acima da tabela.

  • Use 1 quando o cabeçalho estiver na primeira linha.
  • Use 0 quando não houver linha de cabeçalho.
  • Use um número maior quando o arquivo tiver observações ou títulos antes da tabela.

Colunas mapeadas

Aqui o usuário diz ao Askora onde cada informação está no arquivo. Algumas colunas são obrigatórias e outras só aparecem quando o recurso está habilitado.

  • Vendedor: identifica quem será vinculado à linha, quando o tipo de importação exigir vendedor.
  • Pedido: identifica o registro principal que será localizado ou atualizado.
  • Data: informa a data da venda, competência ou vencimento, conforme o tipo de importação.
  • Valor: informa o valor financeiro ou comercial da linha.
  • Status: define se a linha está ativa, inativa, pendente, liberada ou cancelada, conforme o fluxo.
  • Cliente, Produto e Informações adicionais: complementam a leitura quando a operação precisa desses dados.
  • Colunas financeiras: aparecem quando a importação inclui parcelas, vencimentos ou atualização financeira.

Formato de datas, valores e competência

Esse ajuste ajuda o Askora a entender como os dados vêm escritos no arquivo.

  • Data: use o formato que mais se aproxima do arquivo, como DD/MM/AAAA, AAAA-MM-DD ou AUTO.
  • Valor: escolha o formato que o arquivo usa, como BR_DECIMAL, US_DECIMAL ou INTEGER.
  • Competência: use quando o arquivo trabalha com mês/ano, por exemplo AAAA-MM ou MM/AAAA.

Identificação do vendedor

Em algumas importações, o Askora precisa localizar o vendedor correto antes de processar a linha. Para isso, a configuração pode usar e-mail/login ou ID externo/link.

  • E-mail: funciona quando a origem envia o login ou o e-mail do vendedor.
  • ID: funciona quando a origem envia um identificador externo já cadastrado no usuário.
  • Se o usuário logado for vendedor, a operação fica limitada ao próprio vendedor.

Importação de lançamentos

Essa leitura é usada para vendas e pedidos. Ela pode criar, atualizar, reativar ou inativar registros no fluxo principal.

  • Campos essenciais: vendedor, pedido, data da venda e valor.
  • Campos complementares: status, cliente, produto, informações adicionais e dados financeiros.
  • Se o status não estiver habilitado, a linha é tratada como ativa por padrão.
  • Se houver pedidos em mais de uma linha, o sistema pode consolidar os dados antes de processar.
  • Quando o usuário é vendedor, os lançamentos importados entram em fila de liberação para o Master aprovar.
  • Quando o usuário é Master, os lançamentos podem ser aplicados direto, sem passar por liberação.

Importação de financeiro

Essa leitura serve para atualizar vencimentos, liberação e cancelamento de pedidos que já existem. Ela não cria uma nova venda.

  • Campos essenciais: pedido e status financeiro.
  • Campos complementares: vencimento, data de atualização ou liberação, e parcela quando houver parcelamento.
  • Essa opção só faz sentido quando o módulo financeiro estiver ativo.

Importação de bônus

Essa leitura atualiza bônus já cadastrados. O sistema localiza o bônus pelo vendedor, pelo nome e pela competência.

  • Campos essenciais: vendedor, nome do bônus, competência e valor.
  • Campo complementar: competência fim, quando a regra usar período fechado.
  • Use quando o arquivo vier com resultados de campanhas ou incentivos já criados na performance.

Importação de score

Essa leitura atualiza metas de score já cadastradas. Ela funciona melhor quando o arquivo consegue identificar claramente a meta e a competência usada.

  • Campos essenciais: vendedor, nome da meta, competência e resultado.
  • Campos complementares: competência fim, ID da meta, ID da performance, ordem da meta e tipo do score.
  • Use quando o arquivo trouxer atualização de metas ou desempenho já cadastrados no Askora.
Como funciona a comunicação com o Askora

A importação segue um fluxo simples: a configuração salva primeiro define como o arquivo deve ser lido, depois o arquivo enviado é validado contra essa configuração e, por fim, cada linha é transformada no tipo de dado esperado pelo Askora.

O sistema processa linha a linha, mas também pode agrupar registros do mesmo pedido quando o arquivo trouxer mais de uma linha para a mesma venda. Isso evita duplicidade e ajuda o Askora a interpretar corretamente pedidos parcelados, múltiplos produtos ou atualizações que dependem de um mesmo identificador.

Parte financeira da integração

Quando o módulo financeiro está ativo, a importação pode carregar vencimentos, liberações, cancelamentos e parcelas junto com a venda ou em um arquivo separado. Isso permite manter o fluxo de contas a receber organizado sem exigir lançamento manual.

  • Use a importação financeira quando a operação enviar ajustes de vencimento ou status por arquivo.
  • Se a venda vier parcelada, a parcela precisa estar coerente com o pedido e com o total de parcelas.
  • Se o arquivo vier de uma origem que separa venda e financeiro, a configuração de financeiro deve ser usada para atualizar apenas a parte financeira do pedido.
Como validar se a configuração está correta
  1. Confira se o tipo de arquivo salvo corresponde ao arquivo que será enviado.
  2. Verifique se as colunas obrigatórias estão apontando para a posição certa no arquivo.
  3. Faça um teste com poucas linhas antes de enviar um lote grande.
  4. Confirme se o fluxo esperado aparece na rotina de Operações: importação direta para Master ou envio para liberação quando o usuário é vendedor.
  5. Observe se o retorno da importação mostra importados, erros e ações esperadas.
  6. Valide o resultado no módulo correspondente: Operações para lançamentos, Financeiro para status e vencimentos, e Resultados para bônus ou score.
Pontos de atenção
  • Tipo de arquivo salvo e arquivo enviado precisam ser iguais.
  • Linhas de instrução ou cabeçalhos precisam ser ignorados corretamente para não quebrar a leitura.
  • Não reutilize a mesma coluna para dois campos diferentes dentro da mesma importação.
  • Se a importação usar vendedor, confirme se ele está identificado pelo mesmo padrão esperado na configuração.
  • O usuário vendedor não aplica lançamento direto como um Master; o arquivo importado por ele passa por liberação antes de entrar como definitivo.
  • O Master pode subir os lançamentos direto, sem depender dessa etapa de aprovação.
  • A importação financeira só funciona de forma útil quando o módulo financeiro está ativo.
  • Configurações de bônus e score não alteram lançamentos, e lançamentos não alteram bônus ou score; cada tipo mantém sua própria leitura.
  • Quando houver dados parcelados, mantenha número de parcela e total de parcelas coerentes para evitar recusa do grupo.
Resumo prático

A integração de Importação é a melhor opção para quem recebe arquivos Excel ou CSV e quer transformar essas informações em dados válidos no Askora sem configurar uma integração em tempo real. O usuário escolhe o tipo de arquivo, informa quantas linhas devem ser ignoradas, mapeia as colunas corretas e salva a leitura. Depois disso, o sistema valida cada arquivo enviado, processa as linhas e leva os dados para Operações, Financeiro, Bônus ou Score, conforme a configuração escolhida.

Webhook

Essa aba aparece desativada no momento e indica que o recurso ainda está em desenvolvimento.

Ações possíveis do usuário

  • Gerar ou regenerar a chave de API.
  • Copiar a chave ativa para usar na integração externa.
  • Conectar ou desconectar a conta Google usada nas planilhas.
  • Escolher entre planilha única ou individual no Google Sheets.
  • Ativar ou desativar a leitura de vendas, bônus e score nas planilhas.
  • Salvar ou remover configurações de importação.
  • Revisar os campos mapeados antes de enviar arquivos ou ativar a rotina de leitura.

Observações importantes

  • O acesso a esta área é voltado ao perfil Master.
  • O botão de Webhook aparece apenas como indicação de recurso futuro.
  • Na API, a chave deve estar ativa para que os envios externos funcionem corretamente.
  • No Google Sheets, a conta conectada é a que ficará responsável por guardar os arquivos e permitir a leitura.
  • Na importação, salvar a configuração não envia arquivo nenhum: o envio acontece depois, dentro da rotina operacional.
  • Se o módulo financeiro não estiver ativo, a área financeira da importação pode não aparecer ou pode ficar desabilitada.
  • Vale conferir com atenção o tipo de arquivo, a quantidade de linhas ignoradas e a coluna usada para identificar o vendedor, porque esses pontos influenciam diretamente a leitura dos dados.
  • Nos campos personalizados da API, preencha apenas o que for necessário para a sua origem externa. Campos em branco continuam sem efeito na leitura.

Fluxo prático de uso

Um fluxo comum começa pela escolha do canal. Se a empresa já tem um sistema próprio, o usuário entra na aba de API, gera a chave e ajusta os campos personalizados. Se a rotina usa planilhas, ele acessa Google Sheets, conecta a conta Google e define se vai usar uma planilha única ou por vendedor. Se a operação trabalha com Excel ou CSV, o usuário entra em Importação, mapeia as colunas da planilha e salva a configuração para repetir o processo sempre que precisar.

Depois disso, a origem dos dados fica preparada e a operação consegue seguir com mais segurança, sem precisar refazer o mapeamento a cada novo envio.