FAQ Askora: Perguntas Frequentes

Onboarding e estrutura

1) Qual é a ordem correta para implantar o Askora sem retrabalho?

A sequência recomendada é: Organizações -> Usuários -> Performance -> Clientes/Produtos (opcional) -> Operações ou Integrações. Se sua conta usar o módulo financeiro, complete com: Gerenciador Financeiro -> Lançamentos com dados financeiros -> Painel Financeiro -> Dashboard Financeiro. Essa ordem evita dependência quebrada e garante que as regras da performance já estejam prontas quando os dados começarem a entrar.

2) Para que servem as organizações dentro do Askora?

Organização define escopo de operação e visibilidade. Você pode usar para separar empresa, filial, equipe ou unidade. Esse recorte impacta filtros, regras, dashboards e quem pode enxergar cada dado no sistema.

3) Qual a diferença entre Master, Administrador e Vendedor?

Master tem controle total da conta e da assinatura. Administrador tem controle operacional similar, mas apenas nas organizações vinculadas e sem gestão da assinatura. Vendedor participa da execução (vendas, bônus e competição) com visão focada no próprio resultado e no ranking.

4) Vendedores de uma organização conseguem ver dados de outra?

Não. O escopo por organização restringe a visualização do vendedor ao grupo ao qual ele pertence. Isso protege a governança e evita leitura cruzada entre equipes que não deveriam compartilhar dados operacionais.

Configuração de performance

5) Clientes e produtos são obrigatórios para o Askora funcionar?

Não. O Askora funciona sem esses cadastros. Eles são opcionais e servem para operações que querem mais padronização e detalhamento no registro de lançamentos.

6) Qual a diferença entre competência mensal e personalizada?

A competência mensal cobre um único mês de apuração. A personalizada cobre um intervalo de meses (por exemplo, um ciclo trimestral). Essa escolha define como ranking, metas e resultados serão lidos ao longo do período.

7) Como evitar erro na competência e conflito entre ciclos ativos?

Antes de salvar, valide três pontos: tipo de competência, data inicial e data final (quando houver). O período final não pode ser anterior ao inicial, e é recomendado evitar sobreposição de ciclos ativos na mesma organização para não confundir a leitura de resultado.

8) Em quais casos o salário base precisa ser preenchido?

Salário base é obrigatório quando a regra usa referência salarial: comissão OTE ou bônus com tipo de pagamento SALARY_PERCENT. Em cenários sem cálculo sobre salário, esse campo pode ficar opcional.

Comissão, bônus e competição

9) Qual a diferença entre comissão Padrão e comissão OTE?

No modo Padrão, você aplica percentual fixo sobre vendas. No modo OTE, o ganho é calculado por faixas de atingimento de meta, com bônus percentual sobre salário base. A escolha depende da estratégia de remuneração variável que você quer incentivar no ciclo.

10) Como funciona o turbo da comissão na prática?

O turbo adiciona marcos de aceleração quando o vendedor atinge determinados percentuais da meta. Em cada marco, a comissão aumenta conforme a configuração do ciclo (no Padrão, percentual de comissão; no OTE, percentual adicional sobre salário).

11) Como montar bônus com QTD, VALOR ou PERCENT sem distorcer a regra?

Defina primeiro o comportamento que quer estimular e então escolha: métrica (QTD, VALOR ou PERCENT), alvo, comparador (ABOVE, BELOW, MORE, LESS) e tipo de pagamento (FIXED ou SALARY_PERCENT). A simulação antes de salvar ajuda a validar se o resultado financeiro da regra está coerente com a operação.

12) O que muda ao ativar turbo no bônus (limite, fator e excelência)?

Com turbo ativo, o bônus pode crescer além do valor base conforme o desempenho evolui. Você pode limitar esse crescimento com fator máximo (ex.: 1,50x ou 2,00x) e definir o ponto de excelência onde o teto do turbo é atingido.

13) API, Google Sheets ou importação criam novas regras de bônus?

Não. Esses canais atualizam resultado de bônus já existente na performance. Na API e no Google Sheets, a atualização considera a combinação técnica de vendedor + nome + tipo + competência. Na importação configurada (Excel/CSV), o tipo é inferido pelo bônus cadastrado para vendedor + nome + competência. A criação de regra de bônus é feita no cadastro da performance, não na integração.

14) Qual a diferença entre competição por Vendas e por Meta?

Na competição por Vendas, o ranking é ordenado pelo total vendido no ciclo. Na competição por Meta, o ranking considera percentual de atingimento da meta. Esse critério afeta o placar exibido em Home, Performance e Painel de Performance.

15) No Padrão, como preencher os campos do Turbo da comissão com exemplo?

No cadastro da comissão, ative Turbo da comissão (Ativo/Inativo). Depois crie os marcos usando Percentual da meta para ativar (%) e Percentual da comissão (%). Exemplo prático: comissão base de 2,0%; turbo com marcos em 100% e 120% da meta, pagando 2,5% e 3,0% respectivamente. Assim, quando o vendedor está abaixo de 100%, vale 2,0%; ao atingir 100%, passa para 2,5%; ao atingir 120%, passa para 3,0%.

16) No OTE, como o percentual adicional sobre salário entra no cálculo?

No OTE, o cálculo base já usa salário e faixas de meta (Meta mínima (%), Meta máxima (%), Bônus mínimo (%) e Bônus máximo (%)). Com turbo ativo, cada marco usa Percentual da meta para ativar (%) e Percentual adicional sobre salário (%). Exemplo: salário de R$ 4.000 e marco turbo com adicional de 6%. Ao atingir o marco, o adicional potencial é R$ 240 sobre a lógica base do OTE no ciclo.

17) Com vários marcos no Turbo da comissão, qual regra final prevalece?

A configuração deve ser progressiva por atingimento, sempre do menor para o maior marco em Percentual da meta para ativar (%). Na prática operacional, o cálculo acompanha o marco mais alto já atingido no período, evitando sobreposição ambígua de regras. Por isso, use marcos claros e crescentes para não criar conflito entre percentuais.

18) No bônus, quais campos precisam estar corretos antes de ativar Turbo?

Antes de ativar Turbo (opcional), a base do bônus precisa estar bem definida: Nome do bônus, Tipo de métrica (QTD / VALOR / PERCENT), Alvo (X), Regra (ABOVE / BELOW / MORE / LESS), Tipo de pagamento (FIXED / SALARY_PERCENT) e Valor do pagamento. O turbo acelera uma regra já consistente; se a base estiver mal definida, o turbo só amplifica erro.

19) Como configurar Limite do Turbo, Turbo máximo e Turbo excelência?

Ative Turbo (opcional) e, se quiser teto, habilite Limite do Turbo (opcional). Em seguida, preencha Turbo máximo (fator) e Turbo excelência (E). Exemplo: pagamento base de R$ 1.000, fator máximo 2,00 e excelência em 160. Quando o resultado atinge o ponto de excelência, o bônus pode chegar até R$ 2.000 e para de crescer acima disso.

20) Como usar o campo de simulação para validar cálculo de bônus com Turbo?

Use o campo Valor de atingimento do alvo simulado para testar cenários antes de salvar. Faça pelo menos três testes: abaixo do alvo, no alvo e acima do alvo/excelência. Isso mostra se a progressão do bônus está coerente com a estratégia e evita surpresa financeira no ciclo real.

Operação diária e leitura de resultado

21) Por que um lançamento pode ficar pendente de liberação?

Isso acontece por regra de permissão. Normalmente, vendedor envia e o lançamento entra em fluxo de liberação para aprovação ou negação do gestor. Master e Administrador podem ter lançamento direto, conforme a configuração operacional da conta.

22) Qual página usar para auditoria, edição e ajuste de lançamentos?

A página indicada é o Painel de Lançamentos na aba de Operações (/operacoes?aba=painel-lancamentos). O atalho legado /painel-lancamentos redireciona para essa aba. Ela concentra busca detalhada, edição, exclusão, exportação e rastreabilidade para correções operacionais.

23) Onde acompanhar o resultado financeiro de comissão e bônus?

Use Resultados/Comissões (/resultados e /comissoes). Esse é o ponto de leitura consolidada do ciclo, com filtros por performance, organização e vendedor. Para follow-up de vencimento e pagamento, use a página Financeiro (/financeiro) e o Painel Financeiro em Operações.

Integrações e troubleshooting

24) Quando usar API, Google Sheets ou importação de arquivos?

API é ideal para integração sistema a sistema com alto nível de automação. Google Sheets funciona bem para operação colaborativa em planilha com sincronização recorrente. Importação (Excel/CSV) é recomendada para cargas pontuais, retroativas, migração de base e também para rotina quando o sistema de origem só exporta arquivo. No novo modelo de importação, você salva o mapeamento uma vez e reaproveita nos próximos envios.

25) Quais regras da API mais geram erro (identificação, pedido e lote)?

As falhas mais comuns são: enviar email_vendedor e link_vendedor juntos, usar pedido não estável em vendas e ultrapassar o limite de 500 itens por requisição em reconciliação. Na API, use sempre um único identificador de vendedor por item e mantenha o pedido como chave confiável para evitar duplicidade.

26) Se eu descartar o Google Sheets, perco planilhas e dados do Askora?

Não. Ao descartar, você remove apenas o vínculo da integração. As planilhas continuam no Google Drive e os lançamentos já sincronizados no Askora não são apagados por esse descarte.

27) Como implementar autenticação e chamadas da API com segurança?

Gere a chave em /desenvolvedor e envie no header Authorization: Bearer SUA_CHAVE. Padronize timeout e retentativa no integrador, e registre o retorno de cada chamada para auditoria. Em produção, guarde a chave em variável de ambiente e nunca fixa no código cliente.

28) Como montar o payload de vendas da API sem falhar validação?

Em cada item de venda, envie: um identificador de vendedor (email_vendedor ou link_vendedor), pedido, data_venda em AAAA-MM-DD e valor numérico. Antes do envio, valide formato de data, número e duplicidade de pedido no seu sistema origem. Esse pré-validador reduz rejeição de payload e retrabalho no fechamento.

29) Como implementar reconciliação de API em lote sem duplicidade?

Envie lotes no formato { "items": [ ... ] } com no máximo 500 itens por requisição. Para vendas, trate pedido como chave estável e use status para controlar ciclo de vida: Ativo cria/atualiza e Inativo arquiva. Também é recomendado armazenar o resultado por item (processado, erro, pulado) para reenvio apenas do que falhou.

30) Quando usar Planilha Única ou Planilha Individual no Google Sheets?

Use Planilha Única quando uma pessoa centraliza o preenchimento e consegue manter governança do arquivo. Use Planilha Individual quando cada vendedor alimenta sua própria base. Na Única, o campo id_vendedor é obrigatório nas linhas; na Individual, o vínculo já vem do card do vendedor.

31) Quais colunas o Askora lê no Google Sheets e como estruturar a planilha?

Em vendas, a leitura técnica é no intervalo A:F. Em bônus, a leitura é A:Z com mapeamento por cabeçalho obrigatório. Colunas extras podem existir para controle interno, desde que os campos obrigatórios estejam corretos e padronizados. Na prática, mantenha uma aba de validação para checar preenchimento antes da sincronização automática.

32) Como funciona a sincronização do Google Sheets e o status Ativo/Inativo?

Depois de vincular, a sincronização ocorre de forma recorrente. Para vendas, Ativo cria/atualiza e Inativo arquiva pelo identificador do pedido; para bônus, a planilha atualiza resultado de regra já existente na performance. Se descartar a integração, o vínculo é removido, mas os arquivos no Drive e os dados já registrados no Askora permanecem.

33) Na importação Excel/CSV, ainda existe ordem fixa de colunas?

Não. A importação por arquivo agora é configurável. Em /desenvolvedor, você salva um mapeamento para lançamentos e outro para bônus, definindo em qual coluna/campo está cada informação. Também há o campo Ignorar linhas, para pular cabeçalhos estendidos e iniciar leitura apenas na linha útil. Para Excel, o mapeamento aceita A até AZ; para CSV, campo 1 até 200.

34) Como escolher os formatos corretos de data, competência e valor na importação?

Em lançamentos, configure Formato da data e Formato do valor conforme o padrão do arquivo, ou use Automático quando a origem varia. Em bônus, configure Formato da competência (mês/ano) e os três formatos separados: Valor, Qtd e Percentual. O ideal é manter padrão fixo na origem para reduzir ambiguidade e erro de parsing.

35) Como usar status opcional na importação de lançamentos para ativar/inativar pedidos?

Ative a opção de status no mapeamento de lançamentos e informe: coluna/campo do status, texto que representa ativo e texto que representa inativo. Na importação, quando o valor da linha bater com o texto configurado, o Askora converte para o status interno e aplica no pedido. Isso permite atualizar pedidos para inativo por planilha sem editar manualmente no painel.

36) Na importação de lançamentos, o que acontece em duplicidade de pedido?

Depende da configuração: com multi-linha desativado, o Askora reconcilia por pedido e mantém o último registro lido como versão atual; com multi-linha ativado e mesmo vendedor, soma os valores das linhas do pedido; com multi-linha ativado e vendedores diferentes, não descarta: envia para liberação na própria tela de importação, criando sufixos no pedido (/A, /B, /C...) para o gestor aprovar ou negar.

37) Na importação de bônus, preciso enviar bonus_type na planilha?

Não. Na importação configurada, não há coluna obrigatória de bonus_type. O Askora localiza o bônus por vendedor + nome + competência, identifica o tipo já cadastrado (QTD, VALOR ou PERCENT) e aplica o formato correspondente. Se não encontrar o bônus ou houver conflito de tipo no cadastro, a linha é rejeitada com erro no log.

Módulo financeiro

38) O que o Módulo Financeiro habilita no Askora?

Quando ativo, habilita o controle financeiro de lançamentos com condição de pagamento, vencimento, parcelamento e acompanhamento por status no painel financeiro. Também habilita leitura gerencial na página Financeiro (/financeiro), incluindo indicadores de liberar, no prazo, vencidos e liberados.

39) Qual a ordem correta para configurar e operar o financeiro?

Use esta sequência: Gerenciador Financeiro (/gerenciador/financeiro) -> Registro em Lançamentos (/operacoes) -> Painel Financeiro (/operacoes?aba=financeiro) -> Dashboard Financeiro (/financeiro). Essa ordem evita retrabalho e garante que as regras estejam prontas antes do volume operacional.

40) Quais campos financeiros aparecem no registro de lançamentos?

Na seção de informações financeiras do lançamento, você preenche: condição de pagamento, primeiro vencimento, parcelamento, intervalo entre parcelas e, quando necessário, detalhamento de valores por parcela. O somatório das parcelas precisa bater com o valor total da venda.

41) Qual a diferença entre Painel de Lançamentos e Painel Financeiro?

Painel de Lançamentos é para auditoria e correção operacional do registro (edição/exclusão/rastreabilidade). Painel Financeiro é para follow-up do ciclo financeiro (liberar, no prazo, vencidos, liberado e cancelado), com ações de status e controle de pagamento.

42) Quando aparecem os status no prazo e vencidos no financeiro?

Esses status aparecem quando o controle de vencimentos está ativo no Gerenciador Financeiro. Se o registro de vencimentos estiver desativado, a leitura do painel financeiro muda para visão por competência sem destaque de vencimento.

43) Qual a diferença entre Resultados e Financeiro?

Resultados/Comissões é o consolidado da performance do ciclo (geração de comissão e bônus). Financeiro é o consolidado gerencial do fluxo de pagamento e follow-up financeiro desses valores.

44) As integrações já cobrem o fluxo financeiro avançado?

Ainda não. No estado atual, integrações (API, Google Sheets e importação) não cobrem o fluxo financeiro avançado de vencimento e status financeiro. Esse controle é feito diretamente nas telas do módulo financeiro dentro do Askora.