{"schemaVersion":1,"title":"Manual do Askora","url":"/spm/manual/","pages":[{"id":"configuracoes-documentos","title":"Configurações de Documentos","summary":"Habilite o módulo de arquivos e entenda a relação das notas fiscais e reembolsos com Pagamentos.","module":"Configurações","version":"1.0.1","publication":"public","channels":["web"],"keywords":["Documentos","Usar Documentos","ativar","desativar","arquivos","nota fiscal","reembolso"],"related":["documentos-configuracao","documentos-operacao","pagamentos-configuracao"],"url":"/spm/manual/configuracoes-documentos/","markdownUrl":"/spm/manual/configuracoes-documentos.md","sections":[{"title":"Introdução","anchor":"","text":"O Master configura em Extensões → Documentos → Configurar, no web. Documentos centraliza registros e anexos, como documentos administrativos, comprovantes de reembolso e notas fiscais de participantes. Salvar aplica a opção; Cancelar descarta a edição.","links":[],"url":"/spm/manual/configuracoes-documentos/","version":"1.0.1"},{"title":"Usar Documentos","anchor":"usar-documentos","text":"Usar Documentos é o único controle desta configuração e começa desligado. Ativar disponibiliza o módulo; também é necessário haver uma aba ativa em Extensões e permissão para a operação. Não há interruptor global separado para anexos. Desativar preserva documentos, arquivos e vínculos existentes, mas impede usar o módulo para novas inclusões e manutenção enquanto desligado. Não revoga automaticamente pagamentos já documentados ou apaga seus comprovantes. Para enviar novos documentos exigidos por Pagamentos, Documentos precisa estar ativo.","links":[],"url":"/spm/manual/configuracoes-documentos/#usar-documentos","version":"1.0.1"},{"title":"Notas fiscais e reembolsos de Pagamentos","anchor":"notas-fiscais-e-reembolsos-de-pagamentos","text":"Exigir nota é uma regra das modalidades Fixo, Comissão, Bônus e Prêmio monetário em Gerenciador → Pagamentos → Configurar → Exigir nota fiscal, não um controle global de Documentos. Habilite Documentos e prepare uma aba do tipo Notas fiscais em Extensões para receber esses arquivos. Apenas enviar um anexo não libera o pagamento: a nota precisa estar aprovada, com anexo e vínculo compatível ao pagamento. A cobertura pode ser parcial. Uma aba do tipo Reembolsos identifica documentos que podem gerar obrigações de reembolso após aprovação e anexo, conforme a modalidade e os beneficiários habilitados em Pagamentos. Reembolso utiliza os cupons e recibos da origem, sem exigir nota fiscal separada. Notas fiscais comprovam pagamentos; não geram uma nova dívida só por serem cadastradas.","links":[],"url":"/spm/manual/configuracoes-documentos/#notas-fiscais-e-reembolsos-de-pagamentos","version":"1.0.1"},{"title":"O que pertence ao cadastro de abas","anchor":"o-que-pertence-ao-cadastro-de-abas","text":"Tipo de documento, Data de pagamento, Usar previsão e Disponibilidade pertencem ao cadastro de cada aba em Extensões → Documentos → Abas. Não aparecem como opções na configuração global. Documentos gerais não geram pagamentos; reembolsos seguem as regras de Pagamentos. Ativar o módulo não altera esses cadastros nem aprova documentos pendentes.","links":[],"url":"/spm/manual/configuracoes-documentos/#o-que-pertence-ao-cadastro-de-abas","version":"1.0.1"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"O aplicativo utiliza as abas operacionais disponíveis, sem editor desta configuração.","links":[],"url":"/spm/manual/configuracoes-documentos/#disponibilidade","version":"1.0.1"}]},{"id":"configuracoes-fechamentos","title":"Configurações de Fechamento","summary":"Habilite o controle de períodos e programe regras mensais ou por Performance sem confundir ativação com fechamento.","module":"Configurações","version":"1.0.0","publication":"public","channels":["web"],"keywords":["Fechamentos","Fechamento","ativar","desativar","automático","período","Apurar períodos a partir de","reabrir"],"related":["fechamentos","performance"],"url":"/spm/manual/configuracoes-fechamentos/","markdownUrl":"/spm/manual/configuracoes-fechamentos.md","sections":[{"title":"Introdução","anchor":"","text":"O Master configura em Gerenciador → Fechamento → Configurar, no web. O recurso protege períodos encerrados contra alterações. Salvar aplica as regras; Cancelar descarta a edição. Configurar, fechar e reabrir são ações distintas e exclusivas do Master.","links":[],"url":"/spm/manual/configuracoes-fechamentos/","version":"1.0.0"},{"title":"Usar Fechamento","anchor":"usar-fechamento","text":"Usar Fechamento começa desligado. Ativar permite criar fechamentos manuais e executar regras automáticas; não fecha registros só por ligar a opção. Com as regras em Somente manual, nenhum período é fechado automaticamente. Desativar interrompe novos fechamentos e automação, mas não reabre períodos já fechados e não remove o histórico. Os bloqueios continuam valendo. Consulta e reabertura permanecem disponíveis ao Master mesmo com o módulo desligado.","links":[],"url":"/spm/manual/configuracoes-fechamentos/#usar-fechamento","version":"1.0.0"},{"title":"Fechamento por módulo","anchor":"fechamento-por-modulo","text":"Há uma seção de regra para Vendas, Pipeline, Tarefas, Pagamentos, Documentos, Métricas e Performance. Cada módulo pode usar uma programação diferente. A seção Pipeline e Tarefas (anterior) só aparece quando a empresa conserva uma regra legada conjunta. Campo ou opção Preenchimento e efeito Fechamento → Somente manual Padrão de uma regra nova. Não agenda fechamentos; os campos de dia e vigência ficam indisponíveis. Fechamento → Mês anterior Fecha meses completos anteriores. Exibe Dia do fechamento e Apurar períodos a partir de. Dia do fechamento Inteiro de 1 a 28; define em qual dia do mês seguinte o mês anterior poderá ser fechado. Fechamento → Performance encerrada Usa os intervalos de performances prontas, ativas e encerradas. Exibe Dias após o encerramento e Apurar períodos a partir de. Dias após o encerramento Inteiro de zero a 365. Zero e um ficam aptos no primeiro dia seguinte ao Fim; valores maiores aguardam essa quantidade de dias após o Fim. Apurar períodos a partir de Data de início da vigência. Inclui apenas períodos cujo Início seja igual ou posterior a ela; não basta que o Fim esteja depois. É obrigatória na automação. Sem regra salva, o formulário sugere dia 1 e o primeiro dia do mês atual como vigência, com Fechamento em Somente manual. As datas aceitas vão de 01/01/2000 a 31/12/2199. Salvar uma regra automática com vigência passada pode fechar períodos anteriores elegíveis na próxima execução; a ação não se limita ao último período.","links":[],"url":"/spm/manual/configuracoes-fechamentos/#fechamento-por-modulo","version":"1.0.0"},{"title":"Execução automática e impedimentos","anchor":"execucao-automatica-e-impedimentos","text":"A manutenção diária é prevista para 00:10, no horário de São Paulo, depois das atualizações de Performance e Pagamentos; também verifica pendências ao iniciar o serviço. Erros nessas atualizações podem adiar o fechamento. A tela mostra o erro disponível. Não há botão de atualização imediata de Fechamentos nesta configuração. A rotina cria bloqueios por módulo e intervalo, para toda a empresa. Não fecha novamente um ciclo automático que já tenha sido reaberto: após corrigir os dados, faça um novo fechamento manual. Configurar a regra não equivale a aprovar dados pendentes, pagar obrigações ou encerrar tarefas e oportunidades.","links":[],"url":"/spm/manual/configuracoes-fechamentos/#execucao-automatica-e-impedimentos","version":"1.0.0"},{"title":"Bloqueio dos registros e reabertura","anchor":"bloqueio-dos-registros-e-reabertura","text":"O fechamento impede inclusões e alterações que afetem as datas protegidas, inclusive exclusão/inativação, aprovações, anexos e vínculos que repercutam no período. Não é um bloqueio geral de todos os cadastros. Cada módulo usa suas datas: venda e pagamento da venda, criação/conclusão de oportunidades e tarefas, competência dos pagamentos, data de documentos ou intervalo da Performance. Para fechar manualmente, use Gerenciador → Fechamento → Novo fechamento, escolha módulos, intervalo encerrado ou Performance e informe a justificativa. O Fim precisa ser anterior a hoje. Para Reabrir período, abra os detalhes e informe nova justificativa, de 10 a 1.000 caracteres. Sobreposições são independentes: todas as restrições que abrangem a correção precisam ser reabertas. O histórico de quem fechou e reabriu é preservado.","links":[],"url":"/spm/manual/configuracoes-fechamentos/#bloqueio-dos-registros-e-reabertura","version":"1.0.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"A proteção também vale para aplicativo e integrações, embora eles não tenham esta tela de administração.","links":[],"url":"/spm/manual/configuracoes-fechamentos/#disponibilidade","version":"1.0.0"}]},{"id":"configuracoes-organizacoes","title":"Configurações de Organizações","summary":"Ative a segmentação por organizações e suborganizações e entenda seus efeitos nos vínculos e no acesso.","module":"Configurações","version":"1.0.0","publication":"public","channels":["web"],"keywords":["Organizações","Suborganizações","ativar","desativar","segmentação","unidades","obrigatório"],"related":["organizacoes","permissoes-e-escopos"],"url":"/spm/manual/configuracoes-organizacoes/","markdownUrl":"/spm/manual/configuracoes-organizacoes.md","sections":[{"title":"Introdução","anchor":"","text":"O Master configura em Gerenciador → Atribuições → Configurar, no web. Organizações separam empresas, unidades, lojas ou outras divisões; Suborganizações detalham uma organização pai. São opcionais para utilizar o Askora. Salvar aplica; Cancelar descarta a edição.","links":[],"url":"/spm/manual/configuracoes-organizacoes/","version":"1.0.0"},{"title":"Usar organizações e Usar suborganizações","anchor":"usar-organizacoes-e-usar-suborganizacoes","text":"Campo Padrão e efeito Usar organizações Desligado. Disponibiliza os cadastros de organizações e seus campos de associação e filtros nas telas compatíveis. Usar suborganizações Desligado e indisponível sem Usar organizações. Habilita subdivisões de uma organização; a suborganização deve pertencer à organização selecionada. Desligar Usar organizações também desliga Usar suborganizações. Os cadastros e vínculos históricos são preservados. Ao reativar Organizações, revise separadamente se também deseja reativar Suborganizações. A configuração é global: não há outro interruptor de organizações dentro de Produtos ou Pessoas.","links":[],"url":"/spm/manual/configuracoes-organizacoes/#usar-organizacoes-e-usar-suborganizacoes","version":"1.0.0"},{"title":"Efeito nos registros e no acesso","anchor":"efeito-nos-registros-e-no-acesso","text":"Habilitar a segmentação disponibiliza vínculos, mas não obriga todo registro a escolher uma organização. Muitos cadastros e operações permitem associação vazia, compartilhada dentro do alcance autorizado. Uma suborganização exige sua organização pai. Regras específicas, filtros e o alcance do acesso podem exigir uma associação válida; consulte a tela utilizada. Nos acessos administrativos restritos por organização, desligar globalmente essa dimensão pode ampliar os registros visíveis nas páginas autorizadas, pois a restrição organizacional deixa de ser aplicada. Não transforma Padrão em acesso de equipe nem concede novas páginas. Os vínculos preservados voltam a participar do alcance quando a dimensão é reativada. Inativar apenas o cadastro de uma unidade não remove a restrição do acesso vinculado a ela. Use organizações quando precisar segmentar informações. Se não houver essa necessidade, é possível operar sem habilitá-las. Ativar o recurso não cria unidades nem distribui acessos: os cadastros ficam em Gerenciador → Atribuições → Organizações, e os vínculos de pessoas são mantidos em Pessoas.","links":[],"url":"/spm/manual/configuracoes-organizacoes/#efeito-nos-registros-e-no-acesso","version":"1.0.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"O aplicativo usa os vínculos e filtros habilitados, sem esta tela de configuração.","links":[],"url":"/spm/manual/configuracoes-organizacoes/#disponibilidade","version":"1.0.0"}]},{"id":"pagamentos-configuracao","title":"Configurações de Pagamentos","summary":"Defina início da apuração, modalidades, beneficiários, vencimentos e exigência de nota, com histórico de apuração e baixas.","module":"Configurações","version":"1.3.2","publication":"public","channels":["web"],"keywords":["pagamentos","fixo","vigência","nota fiscal","prazo","Beneficiários","Início da apuração"],"related":["apuracao","pessoas-cargos-e-acessos","configuracoes-documentos","pagamentos-operacao"],"supportScope":["pagamento","pagar","pago","baixa","lote","reembolso","fixo","nota fiscal","cupom","recibo","comprovante","beneficiário","CNAB","split","vencimento","compensação"],"url":"/spm/manual/pagamentos-configuracao/","markdownUrl":"/spm/manual/pagamentos-configuracao.md","sections":[{"title":"Introdução","anchor":"","text":"O Master configura em Gerenciador → Pagamentos → Configurar, no web. Pagamentos gerencia obrigações aos colaboradores e parceiros nas modalidades Fixo, Comissão, Bônus, Prêmio monetário e Reembolso. Não há cadastro de outros tipos nem duplicação dessas regras. Salvar aplica; Cancelar descarta a edição. O aplicativo não oferece tela nativa de configuração ou operação de Pagamentos.","links":[],"url":"/spm/manual/pagamentos-configuracao/","version":"1.3.2"},{"title":"Início da apuração e regras para ativar Pagamentos","anchor":"inicio-da-apuracao-e-regras-para-ativar-pagamentos","text":"Abra Configurar e informe Início da apuração. Em cada modalidade utilizada, escolha Disponibilidade → Habilitado e Beneficiários. Defina Vencimento, o dia ou intervalo correspondente e, com Documentos ativo e exceto em Reembolso, Exigir nota fiscal. Ative Usar Pagamentos, confira os efeitos e salve. O módulo começa desligado, com regras desabilitadas. Para ativar, precisa de data inicial e ao menos um tipo habilitado. A data inicial pode ser alterada. Ela delimita novas apurações pelo fim do ciclo da Performance e pela data do documento de reembolso. Antecipar a data permite alcançar origens anteriores na próxima atualização; avançá-la não apaga nem cancela obrigações já reconhecidas. Fechamentos e pagamentos existentes continuam protegidos. A configuração sem valores anteriores sugere cinco dias após o encerramento, ambos os públicos e nota opcional; revise antes de ativar. Início da apuração, na seção Informações principais, não tem data padrão e é obrigatório para salvar o formulário. Para o Fixo, a vigência delimita a competência mensal e o vencimento não fica antes desse início. A manutenção diária prevista para 00:10 no horário de São Paulo atualiza obrigações elegíveis; não executa transferência bancária. A tela de regras pode mostrar erros da última apuração.","links":[],"url":"/spm/manual/pagamentos-configuracao/#inicio-da-apuracao-e-regras-para-ativar-pagamentos","version":"1.3.2"},{"title":"Campos de cada modalidade","anchor":"campos-de-cada-modalidade","text":"Campo Opções e efeito Disponibilidade Habilitado ou Desabilitado; padrão Desabilitado. Pausa ou permite a geração dessa modalidade para o público escolhido. Beneficiários Colaboradores e parceiros (padrão), Colaboradores ou Parceiros. A modalidade só gera novas obrigações para o público habilitado e elegível na origem. Vencimento Prazo após a referência da modalidade ou Dia fixo do mês. O prazo é a opção inicial. Exigir nota fiscal Aparece somente com a extensão Documentos ativa. Nas modalidades Fixo, Comissão, Bônus e Prêmio monetário: Não exigir (padrão) ou Exigir. A obrigação nova conserva essa exigência e precisa de cobertura documental para ficar disponível para pagamento. Não aparece para Reembolso, que usa os comprovantes da origem. Mudar prazo, público ou exigência de nota não reescreve automaticamente vencimentos e exigências já gravados em obrigações anteriores. Desabilitar a modalidade não apaga dívidas nem o histórico. A regra também pode ser editada pelo Master em Gerenciador → Pagamentos → Configurar [modalidade] → Salvar regra, na linha correspondente.","links":[],"url":"/spm/manual/pagamentos-configuracao/#campos-de-cada-modalidade","version":"1.3.2"},{"title":"Vencimento por modalidade","anchor":"vencimento-por-modalidade","text":"Modalidade Opção por prazo e campo apresentado Fixo Após o fim do mês de competência; Quantidade de dias após o fim do mês. Comissão, Bônus e Prêmio monetário Após o encerramento da performance; Quantidade de dias após o fim da performance. Reembolso Após a aprovação; Quantidade de dias após a aprovação. A data de reconhecimento é preservada nas reapurações. O intervalo aceita inteiro de zero a 365, inicialmente 5. Zero usa a própria data de referência. Com Dia fixo do mês, aparece Dia do mês, inteiro de 1 a 31. Para Comissão, Bônus, Prêmio monetário e Reembolso, é a próxima ocorrência desse dia depois da referência; para Fixo, pertence ao próprio mês de competência. Se o mês não tiver o dia escolhido, usa o último dia. Esse vencimento não possui ajuste configurável por dias úteis ou feriados.","links":[],"url":"/spm/manual/pagamentos-configuracao/#vencimento-por-modalidade","version":"1.3.2"},{"title":"Fixo mensal","anchor":"fixo-mensal","text":"O valor integral vem da remuneração fixa cadastrada na pessoa. São elegíveis colaboradores e parceiros ativos que participem de uma Performance ativa, com cadastro pronto e período que alcance o mês, a partir do início da apuração. Pessoas fora dos participantes, em rascunhos ou apenas em ciclos inativos não geram novos fixos. Ativar a regra, salvar a Performance ou atualizar uma pessoa elegível pode criar a competência atual. A atualização diária abre os meses seguintes, sem inventar competências antigas ausentes. Não há proporcionalidade automática. Existe uma obrigação integral por pessoa e mês, mesmo que ela participe de vários ciclos no mês. Sair dos participantes impede novos fixos nos meses sem participação; não cancela obrigações já geradas. A organização principal identifica a empresa pagadora; múltiplas associações não multiplicam o fixo. Alterações de valor atualizam competências pendentes elegíveis; valores com baixa, reserva, compensação ou fechamento ficam protegidos.","links":[],"url":"/spm/manual/pagamentos-configuracao/#fixo-mensal","version":"1.3.2"},{"title":"Gerenciador de Pagamentos","anchor":"gerenciador-de-pagamentos","text":"A tabela contém cinco regras fixas e mostra Tipo, Disponibilidade, Beneficiários, Vencimento e Nota fiscal. Configurar na linha abre a regra correspondente; Configurar no cabeçalho abre a configuração global. Não há criação, exclusão ou duplicação de modalidades, cadastro rápido ou um catálogo financeiro adicional. Para Reembolso, Nota fiscal mostra Não se aplica. Obrigações e lotes ficam em Operações → Pagamentos.","links":[],"url":"/spm/manual/pagamentos-configuracao/#gerenciador-de-pagamentos","version":"1.3.2"},{"title":"Reembolso e comprovantes","anchor":"reembolso-e-comprovantes","text":"Reembolso usa o documento aprovado e seus cupons ou recibos, sem nota fiscal separada. Configure público, vigência e vencimento em Pagamentos; os comprovantes e a apuração permanecem vinculados ao documento de origem. Consulte as condições de geração e comprovantes de Reembolso.","links":["/spm/manual/pagamentos-reembolso/"],"url":"/spm/manual/pagamentos-configuracao/#reembolso-e-comprovantes","version":"1.3.2"},{"title":"Exigir nota fiscal e dados de recebimento","anchor":"exigir-nota-fiscal-e-dados-de-recebimento","text":"Ative a extensão Documentos para exibir essa opção. Desativar a extensão oculta o campo e preserva a configuração salva. Nas modalidades Fixo, Comissão, Bônus e Prêmio monetário, para exigir nota, escolha Exigir nota fiscal → Exigir na modalidade e salve antes da geração das obrigações correspondentes. Ative Documentos e mantenha uma aba do tipo Notas fiscais. O beneficiário com acesso autorizado pode enviar o documento pela área de Documentos; também é possível que um responsável autorizado o registre. Ele precisa estar aprovado, em aba ativa, com anexo, para o mesmo beneficiário, organização e suborganização do pagamento. Em Operações → Pagamentos, um gestor autorizado abre os detalhes e usa Vincular nota fiscal. Apenas enviar a nota não a vincula automaticamente a todas as obrigações. Uma nota válida e vinculada libera somente o valor coberto: o saldo sem cobertura aparece como Aguardando NF; cobertura parcial libera apenas a parte correspondente. Em processamento indica reserva em lote, não falta de nota. Diferenças de apuração que exigem revisão também podem impedir o pagamento. Confira o procedimento e o exemplo de cobertura parcial por nota fiscal. Receber a nota depois não muda a competência original. A cobertura é conferida ao preparar e confirmar o pagamento; documento pendente, inativo, sem anexo ou alterado sem vínculo válido não comprova a liberação. Reembolso usa os comprovantes da origem, sem essa exigência; cupons de reembolso não substituem notas exigidas para as demais modalidades. Essas verificações são de compatibilidade no Askora, não uma certificação fiscal externa. Pix/TED são mantidos em Forma de recebimento e titular. Esses dados não são obrigatórios para apurar nem para registrar pagamento realizado externamente. Validação do cadastro não confirma titularidade no banco.","links":["/spm/manual/pagamentos-operacao/#notas-fiscais-e-ajustes","/spm/manual/pessoas-dados-de-recebimento/#forma-de-recebimento-e-titular"],"url":"/spm/manual/pagamentos-configuracao/#exigir-nota-fiscal-e-dados-de-recebimento","version":"1.3.2"},{"title":"Base da Performance e desativação","anchor":"base-da-performance-e-desativacao","text":"A base salva em cada Performance define a data usada: Data da venda considera saleDate; Data de pagamento considera paymentDate. Ambas usam o valor integral das vendas ativas menos devoluções. Vendas sem data de pagamento ficam fora dessa segunda base. Desligar a opção nas configurações não muda a base dos ciclos existentes. Pagamentos registra diretamente as obrigações, reservas, revisões e baixas. Desativar Usar Pagamentos interrompe novas gerações e a preparação de novos pagamentos, preservando consulta e histórico. Um lote já preparado pode ser concluído mesmo depois da desativação, sujeito às verificações de elegibilidade. Desligar o módulo não é uma forma de cancelar uma reserva ou transferência já registrada.","links":[],"url":"/spm/manual/pagamentos-configuracao/#base-da-performance-e-desativacao","version":"1.3.2"},{"title":"Erros e disponibilidade","anchor":"erros-e-disponibilidade","text":"Se outra sessão alterou regras, atualize a tela antes de salvar. Confira bloqueios por fechamento e mensagens da última apuração. CNAB e Split não estão disponíveis para executar dinheiro; arquivos de conferência não são ordens bancárias.","links":[],"url":"/spm/manual/pagamentos-configuracao/#erros-e-disponibilidade","version":"1.3.2"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"Configuração e operação de Pagamentos ficam no web. Não há tela nativa equivalente no aplicativo. As consultas de pagamentos continuam sujeitas a permissões e escopo próprios.","links":[],"url":"/spm/manual/pagamentos-configuracao/#disponibilidade","version":"1.3.2"}]},{"id":"configuracoes-performance","title":"Configurações de Performance","summary":"Ative Performance, configure a duplicação dos ciclos e escolha como calcular a meta diária.","module":"Configurações","version":"1.2.0","publication":"public","channels":["web"],"keywords":["Performance","ativar","desativar","duplicação automática","meta diária","feriados","Forma de cálculo","Computar meta diária"],"related":["performance","performance-participantes","metas","pagamentos-configuracao"],"url":"/spm/manual/configuracoes-performance/","markdownUrl":"/spm/manual/configuracoes-performance.md","sections":[{"title":"Introdução","anchor":"","text":"O Master configura em Gerenciador → Performance → Configurar, no web. Performance reúne ciclos, participantes, metas, comissões, bônus e competições. Salvar aplica as opções; Cancelar descarta a edição. Cadastrar um ciclo e seus valores é outra etapa, na lista do Gerenciador.","links":[],"url":"/spm/manual/configuracoes-performance/","version":"1.2.0"},{"title":"Usar Performance e desativação","anchor":"usar-performance-e-desativacao","text":"Usar Performance começa desligado. Ativar permite manter ciclos e utilizar suas métricas, metas e resultados, conforme permissões e participantes. Desativar preserva ciclos, regras e registros: bloqueia a manutenção do módulo, suas métricas operacionais, a duplicação automática e a seleção dos ciclos nos dashboards correspondentes. Desativar Performance não exclui nem impede por si só registrar vendas. Também não é uma suspensão geral de Pagamentos: com Pagamentos ativo, suas rotinas podem continuar apurando ciclos já cadastrados. As vendas preservadas podem voltar a compor os resultados quando Performance for reativada; não há um descarte automático das vendas registradas enquanto o módulo estava desligado.","links":[],"url":"/spm/manual/configuracoes-performance/#usar-performance-e-desativacao","version":"1.2.0"},{"title":"Duplicar ciclos automaticamente","anchor":"duplicar-ciclos-automaticamente","text":"Duplicar ciclos automaticamente começa desligado e fica indisponível para edição quando Usar Performance está desligado. As duas opções precisam estar salvas e ativas. A rotina diária, prevista para 00:10 no horário de São Paulo, procura ciclos Ativos, com cadastro pronto e Fim anterior a hoje. Não duplica rascunhos nem ciclos inativos. A cópia automática nasce Ativa e pronta; pode ser editada no Gerenciador, respeitando permissões, validações e fechamentos. O novo Início é o dia seguinte ao Fim anterior. Meses completos conservam a quantidade de meses; quinzenas de 1 a 15 e de 16 ao último dia alternam esses intervalos; os demais períodos conservam a quantidade de dias, contando início e fim. A sequência automática preserva essa periodicidade. Um ciclo pronto e ativo já existente no período seguinte é respeitado; outras sobreposições podem impedir a geração. Inativar a cópia existente não solicita outra cópia da mesma origem. Consulte as informações reaproveitadas na duplicação: a seleção da origem é preservada somente para as pessoas que continuam ativas.","links":["/spm/manual/configuracoes-performance/#informacoes-reaproveitadas-na-duplicacao"],"url":"/spm/manual/configuracoes-performance/#duplicar-ciclos-automaticamente","version":"1.2.0"},{"title":"Informações reaproveitadas na duplicação","anchor":"informacoes-reaproveitadas-na-duplicacao","text":"A duplicação automática reaproveita Nome, Atribuição, Base de cálculo para resultados, tipos de participante e a seleção ativa da origem, vínculos, valores fixo e variável dos colaboradores no ciclo, comissão, bônus, indicadores, faixas, metas e competições com seus prêmios. Cria novas identidades para os registros do novo ciclo; não copia vendas, resultados de métricas, aprovações nem pagamentos. São mantidos somente os colaboradores e parceiros associados à origem cujo cadastro de Pessoa continua ativo. Filtros antigos não são reaplicados e pessoas novas não são incluídas. Vínculos e valores dos participantes restantes são preservados, sem atualização a partir de Pessoas. O histórico da origem não é alterado. As metas e os grupos da cópia respeitam os participantes mantidos na duplicação. Se ninguém continuar ativo, a atualização registra erro e não cria um ciclo vazio. Revise a seleção no Gerenciador; a rotina não escolhe outras pessoas para completar a cópia. Configurações, referências indisponíveis e demais validações ainda podem impedir a geração sem modificar a origem.","links":["/spm/manual/performance-participantes/#participantes-na-duplicacao-manual-e-automatica"],"url":"/spm/manual/configuracoes-performance/#informacoes-reaproveitadas-na-duplicacao","version":"1.2.0"},{"title":"Computar meta diária e Forma de cálculo","anchor":"computar-meta-diaria-e-forma-de-calculo","text":"Na seção Meta diária, Computar meta diária oferece Habilitado e Desabilitado; o padrão é Habilitado. Desabilitar retira a referência diária, preservando as metas totais do ciclo. Forma de cálculo começa em Período completo da performance e só pode ser alterada com Performance ativa e a meta diária habilitada. As opções salvas valem para os ciclos existentes da empresa, não apenas para os próximos cadastros. O cálculo respeita as condições de saldo, calendário e ausência de meta diária. Forma de cálculo Dias considerados Período completo da performance Todos os dias, incluindo sábados, domingos e feriados. Período completo da performance (exceto feriados) Todos os dias, exceto os feriados do calendário nacional utilizado pelo sistema. Dias úteis (segunda a sexta, exceto feriados) Segunda a sexta, excluindo feriados nacionais. Segunda a sábado Segunda a sábado, incluindo feriados; exclui domingos. Segunda a sábado (exceto feriados) Segunda a sábado, excluindo domingos e feriados nacionais.","links":["/spm/manual/configuracoes-performance/#saldo-calendario-e-ausencia-de-meta-diaria"],"url":"/spm/manual/configuracoes-performance/#computar-meta-diaria-e-forma-de-calculo","version":"1.2.0"},{"title":"Saldo, calendário e ausência de meta diária","anchor":"saldo-calendario-e-ausencia-de-meta-diaria","text":"Com Computar meta diária habilitado, a referência para valores e quantidades é o saldo ainda necessário dividido pelos dias válidos restantes até o Fim do ciclo, incluindo hoje quando permitido. O resultado acumulado até hoje, inclusive o próprio dia, reduz esse saldo. A divisão arredonda para cima em duas casas decimais. Não substitui a meta total cadastrada. Metas compartilhadas contam uma vez; o excedente de uma meta individual não cobre o déficit de outra. Indicadores percentuais usam a média dos alvos, sem dividir a porcentagem pela quantidade de dias. O calendário é interno ao Askora: 1º de janeiro, 21 de abril, 1º de maio, 7 de setembro, 12 de outubro, 2 e 15 de novembro, 25 de dezembro, Sexta-feira Santa calculada por ano e 20 de novembro a partir de 2024. Não inclui feriados estaduais, municipais nem pontos facultativos; não existe campo para cadastrá-los nesta configuração. Nos dias excluídos pelo calendário escolhido, não há meta diária, mas suas vendas continuam no acumulado. Também não há referência diária fora do período do ciclo, sem dias válidos restantes, sem meta positiva ou sem dados comparáveis. Isso difere de uma meta diária de valor zero, que pode indicar objetivo já alcançado. Os dias seguem a data de São Paulo. A disponibilidade em cada dashboard depende do indicador e do alcance do acesso; habilitar a opção não torna todo recorte comparável.","links":[],"url":"/spm/manual/configuracoes-performance/#saldo-calendario-e-ausencia-de-meta-diaria","version":"1.2.0"},{"title":"Atualização dos ciclos: Atualizar performances","anchor":"atualizacao-dos-ciclos-atualizar-performances","text":"Atualizar performances, na seção Atualização dos ciclos, permite ao Master executar a verificação imediatamente, com as opções de ativação e duplicação já salvas. O botão não salva as mudanças do formulário. A seção mostra Última atualização, Nenhuma atualização realizada., resultado ou erro. A rotina também verifica pendências ao iniciar o serviço. Cada execução gera até 180 ciclos para recuperar períodos atrasados; use nova atualização se houver pendências. Vínculos indisponíveis, sobreposições e regras incompletas podem impedir um ciclo sem apagar a origem. Atualizar não garante que todas as cópias tenham sido geradas: confira o resultado.","links":[],"url":"/spm/manual/configuracoes-performance/#atualizacao-dos-ciclos-atualizar-performances","version":"1.2.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"O aplicativo utiliza as opções salvas, sem editor dessas configurações.","links":[],"url":"/spm/manual/configuracoes-performance/#disponibilidade","version":"1.2.0"},{"title":"Usar data de pagamento nas vendas","anchor":"usar-data-de-pagamento-nas-vendas","text":"À direita de Usar Performance, este controle começa desativado. Quando ativo, exibe a coluna Data de pagamento em Vendas e libera o seletor da base de data no cadastro da Performance, com Data de pagamento pré-selecionada. Cada ciclo conserva sua própria escolha; desativar o controle não altera os cálculos de ciclos existentes.","links":[],"url":"/spm/manual/configuracoes-performance/#usar-data-de-pagamento-nas-vendas","version":"1.2.0"}]},{"id":"configuracoes-pessoas","title":"Configurações de Pessoas","summary":"Escolha tipos de pessoa, cargos, remuneração, permissões e exigência de autenticador.","module":"Configurações","version":"1.0.0","publication":"public","channels":["web"],"keywords":["Pessoas","Colaboradores","Parceiros","Fornecedores","Clientes","Cargos","permissões por cargo","remuneração","2FA","autenticador"],"related":["pessoas-cargos-e-acessos","permissoes-e-escopos","configuracoes-produtos"],"url":"/spm/manual/configuracoes-pessoas/","markdownUrl":"/spm/manual/configuracoes-pessoas.md","sections":[{"title":"Introdução","anchor":"","text":"O Master configura em Gerenciador → Pessoas → Configurar, no web. Pessoas permanece disponível; não existe um interruptor geral para desativá-la. Administradores ficam sempre disponíveis. Salvar aplica tipos, recursos e permissões; Cancelar descarta a edição.","links":[],"url":"/spm/manual/configuracoes-pessoas/","version":"1.0.0"},{"title":"Tipos de pessoa","anchor":"tipos-de-pessoa","text":"Campo Padrão e finalidade Colaboradores Ligado. Cadastra integrantes da operação, com ou sem acesso ao sistema, que podem participar de performances. Parceiros Desligado. Cadastra participantes comerciais separadamente dos colaboradores, também com ou sem acesso e com participação própria em performances. Fornecedores Desligado. Disponibiliza fornecedores utilizados nos registros da empresa. Desabilitar um tipo oculta sua aba e impede novos cadastros e alterações desse tipo, preservando pessoas e vínculos já existentes. Para Colaboradores e Parceiros, também bloqueia o login e o uso das sessões enquanto o tipo estiver desabilitado, sem excluir as credenciais. Clientes e fornecedores não recebem login pelo cadastro. Clientes, Responsável pelo cliente, Organizações e Produtos ficam em Atribuições. Configure esses recursos em Gerenciador → Atribuições → Configurar. Clientes e Produtos podem aparecer juntos em vendas, mas são ativados separadamente.","links":[],"url":"/spm/manual/configuracoes-pessoas/#tipos-de-pessoa","version":"1.0.0"},{"title":"Recursos dos cadastros","anchor":"recursos-dos-cadastros","text":"Todos os controles desta seção começam desligados. Campo Efeito e dependências Cargos Permite cadastrar cargos e associá-los a colaboradores ou parceiros. Cada cargo pertence a um desses tipos; administradores não usam cargo. Cadastre os cargos na aba Cargos, depois de habilitar o recurso. Permissões por cargo Depende de Cargos. Permite configurar a política de acesso de cada cargo ativo e aplicá-la ao acesso Padrão associado. Desligar Cargos também desliga esta opção; reativar Cargos não a religa sozinho. Valores de remuneração Exibe Remuneração fixa e Remuneração variável em colaboradores, parceiros e cargos, com valores não negativos. São referências usadas conforme as regras de Performance e Pagamentos; não efetuam pagamento automaticamente apenas por habilitar o campo. Os valores de cargo podem servir de referência aos participantes de Performance. Pagamentos fixos usam a remuneração fixa cadastrada na pessoa; não presuma que informar um salário no cargo atualizou todos os cadastros ou ciclos existentes. Campos ocultos não significam que seus valores e vínculos históricos foram excluídos.","links":[],"url":"/spm/manual/configuracoes-pessoas/#recursos-dos-cadastros","version":"1.0.0"},{"title":"Pessoa, acesso e política do cargo","anchor":"pessoa-acesso-e-politica-do-cargo","text":"Colaborador e Parceiro são cadastros operacionais; acesso é a autorização de entrar no Askora com login e nível de permissão. A pessoa pode participar da operação sem acesso. Habilitar um tipo de pessoa, cadastrar um cargo ou configurar permissões não cria credenciais. Com Cargos e Permissões por cargo ativos, o cargo associado substitui a política geral Padrão daquele acesso. Sem cargo ou com esse recurso desligado, vale Padrão. Cargo inativo não concede permissões. A política do cargo não transforma o alcance pessoal em visão de equipe nem concede acesso ao Gerenciador. Administrador e Visualizador mantêm suas políticas próprias.","links":[],"url":"/spm/manual/configuracoes-pessoas/#pessoa-acesso-e-politica-do-cargo","version":"1.0.0"},{"title":"Permissões de acesso","anchor":"permissoes-de-acesso","text":"Na seção Permissões de acesso, Nível de acesso oferece Administrador, Padrão e Visualizador. Com permissões por cargo ativas, aparecem Padrão (sem cargo) e os cargos ativos, identificados como Colaboradores ou Parceiros. Master não é uma política editável. Escolha a área Dashboards, Operações ou Gerenciador e a permissão de cada página. Trocar área ou nível conserva as alterações locais até Salvar. Um seletor com apenas Sem acesso fica bloqueado porque aquele nível não pode receber a página. As opções e exceções por nível estão em Configurar permissões. O padrão inicial do perfil Padrão permite Registrar sem aprovação em Operações → Pipeline e Tarefas. Vendas, Métricas e Documentos continuam com aprovação. O Master pode configurar essas permissões por perfil ou cargo. Nas empresas existentes, o perfil Padrão também passa de Registrar com aprovação para Registrar sem aprovação nessas duas páginas. Sem acesso, Somente visualizar e as permissões próprias dos cargos são preservados. Registros já pendentes continuam exigindo liberação.","links":["/spm/manual/permissoes-e-escopos/#configurar-permissoes"],"url":"/spm/manual/configuracoes-pessoas/#permissoes-de-acesso","version":"1.0.0"},{"title":"Autenticação em dois fatores (2FA)","anchor":"autenticacao-em-dois-fatores-2fa","text":"Autenticação em dois fatores (2FA) fica em Permissões de acesso e oferece Não exigir (padrão) e Exigir autenticador. É uma exigência para os acessos da empresa, não apenas para o nível selecionado no editor. Ao exigir, o login passa a solicitar o autenticador; no primeiro uso sem autenticador configurado, a pessoa realiza a vinculação. Sessões ainda não verificadas precisarão autenticar novamente. Desabilitar a exigência não troca senhas nem apaga os cadastros de pessoas. A autenticação é diferente das permissões: um acesso autenticado continua limitado às páginas e registros autorizados.","links":[],"url":"/spm/manual/configuracoes-pessoas/#autenticacao-em-dois-fatores-2fa","version":"1.0.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"O aplicativo respeita as opções salvas, sem editor dessas configurações.","links":[],"url":"/spm/manual/configuracoes-pessoas/#disponibilidade","version":"1.0.0"}]},{"id":"configuracoes-pipeline","title":"Configurações de Pipeline","summary":"Habilite o acompanhamento de oportunidades e diferencie a ativação do cadastro das etapas e campos.","module":"Configurações","version":"1.0.1","publication":"public","channels":["web"],"keywords":["Pipeline","ativar","desativar","Usar Pipeline","oportunidades"],"related":["pipeline-configuracao","pipeline-operacao"],"supportScope":["pipeline","oportunidade","funil","valor personalizado","campo moeda"],"url":"/spm/manual/configuracoes-pipeline/","markdownUrl":"/spm/manual/configuracoes-pipeline.md","sections":[{"title":"Introdução","anchor":"","text":"O Master configura em Extensões → Pipeline → Configurar, no web. Pipeline acompanha oportunidades comerciais por etapas, da entrada ao encerramento. Salvar aplica a configuração; Cancelar descarta a edição.","links":[],"url":"/spm/manual/configuracoes-pipeline/","version":"1.0.1"},{"title":"Usar Pipeline","anchor":"usar-pipeline","text":"Usar Pipeline é o único controle desta configuração e começa desligado. Ativar disponibiliza o módulo; não habilita Tarefas nem concede permissões automaticamente. Para colaboradores sujeitos ao vínculo de responsáveis, também é necessário estar associado ao Pipeline e possuir permissão para a página utilizada. Desativar preserva etapas, campos, oportunidades e histórico, mas torna o uso do módulo indisponível. Não conclui, ganha, perde nem exclui oportunidades. Reativar permite retomar os registros preservados conforme as permissões e a situação de cada cadastro.","links":[],"url":"/spm/manual/configuracoes-pipeline/#usar-pipeline","version":"1.0.1"},{"title":"Configuração, cadastros e operação","anchor":"configuracao-cadastros-e-operacao","text":"Configurar controla a ativação. As abas Status, Campos e Responsáveis em Extensões → Pipeline preparam os cadastros e os colaboradores participantes. Operações → Pipeline é a área para registrar e acompanhar oportunidades. A permissão para uma dessas páginas não concede automaticamente acesso às demais. Não existem nesta tela interruptores para cada etapa, tipo de campo ou responsável. Esses elementos pertencem aos cadastros da extensão.","links":[],"url":"/spm/manual/configuracoes-pipeline/#configuracao-cadastros-e-operacao","version":"1.0.1"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"O aplicativo utiliza a configuração salva, sem editor dessa opção.","links":[],"url":"/spm/manual/configuracoes-pipeline/#disponibilidade","version":"1.0.1"}]},{"id":"configuracoes-produtos","title":"Configurações de Produtos","summary":"Disponibilize o catálogo de produtos usado nas vendas, independentemente das configurações de Pessoas.","module":"Configurações","version":"1.0.0","publication":"public","channels":["web"],"keywords":["Produtos","Usar Produtos","ativar","desativar","catálogo","Pessoas"],"related":["produtos","configuracoes-pessoas","vendas"],"url":"/spm/manual/configuracoes-produtos/","markdownUrl":"/spm/manual/configuracoes-produtos.md","sections":[{"title":"Introdução","anchor":"","text":"O Master configura em Gerenciador → Atribuições → Configurar, no web. O catálogo permite cadastrar itens comercializados e selecioná-los nas vendas. Salvar aplica; Cancelar descarta a edição.","links":[],"url":"/spm/manual/configuracoes-produtos/","version":"1.0.0"},{"title":"Usar Produtos","anchor":"usar-produtos","text":"Usar Produtos é o controle de Produtos em Atribuições e começa desligado. Ativar disponibiliza o catálogo e seus vínculos nas operações, respeitando permissões. Os cadastros de Nome, Valor e associações são mantidos em Gerenciador → Atribuições → Produtos. O valor do catálogo pode ajudar a preencher a venda; a opção não registra uma venda automaticamente nem oferece controle de estoque. Desativar preserva produtos e vínculos históricos nas vendas. Torna o catálogo e novos vínculos indisponíveis enquanto desligado; não apaga as vendas nem altera seus valores já gravados. Reativar não substitui a revisão dos produtos ativos e das permissões.","links":[],"url":"/spm/manual/configuracoes-produtos/#usar-produtos","version":"1.0.0"},{"title":"Produtos, Pessoas e Organizações","anchor":"produtos-pessoas-e-organizacoes","text":"Não existe uma segunda ativação de Produtos em Configurações de Pessoas: ali ficam Colaboradores, Parceiros e Fornecedores. Clientes também é configurado em Atribuições. Habilitar Clientes não habilita Produtos, e Produtos não exige habilitar Clientes. Organizações e Suborganizações dos produtos dependem da configuração global de Gerenciador → Atribuições → Configurar. Não são interruptores próprios de Produtos. Habilitar essas dimensões apenas disponibiliza as associações compatíveis; não exige cadastrar unidades para utilizar o catálogo em geral.","links":[],"url":"/spm/manual/configuracoes-produtos/#produtos-pessoas-e-organizacoes","version":"1.0.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"O aplicativo pode usar produtos nas operações compatíveis, mas não oferece esta configuração nem o cadastro do Gerenciador.","links":[],"url":"/spm/manual/configuracoes-produtos/#disponibilidade","version":"1.0.0"}]},{"id":"configuracoes-tarefas","title":"Configurações de Tarefas","summary":"Ative as atividades e rotinas sem confundir essa opção com o cadastro ou a conclusão de tarefas.","module":"Configurações","version":"1.0.1","publication":"public","channels":["web"],"keywords":["Tarefas","ativar","desativar","Usar Tarefas","rotinas"],"related":["tarefas-configuracao","tarefas-operacao"],"supportScope":["tarefa","rotina","recorrência","checklist","missão","atividade"],"url":"/spm/manual/configuracoes-tarefas/","markdownUrl":"/spm/manual/configuracoes-tarefas.md","sections":[{"title":"Introdução","anchor":"","text":"O Master configura em Extensões → Tarefas → Configurar, no web. Tarefas organiza atividades avulsas e rotinas, responsáveis, prazos e execução. Salvar aplica a opção; Cancelar descarta a edição.","links":[],"url":"/spm/manual/configuracoes-tarefas/","version":"1.0.1"},{"title":"Usar Tarefas","anchor":"usar-tarefas","text":"Usar Tarefas é o único controle desta configuração e começa desligado. Ativar disponibiliza o módulo independentemente do Pipeline. Para colaboradores sujeitos ao vínculo de responsáveis, também são necessárias associação a Tarefas e permissão para a página utilizada. Desativar Tarefas preserva categorias, rotinas e ocorrências já registradas, mas torna o uso do módulo indisponível. Não conclui nem cancela as tarefas e não apaga o histórico. Reativar não equivale a alterar a vigência das rotinas nem elimina pendências anteriores; as ocorrências seguem seu calendário e estado.","links":[],"url":"/spm/manual/configuracoes-tarefas/#usar-tarefas","version":"1.0.1"},{"title":"Configuração, cadastros e operação","anchor":"configuracao-cadastros-e-operacao","text":"Configurar controla a ativação. Extensões → Tarefas mantém as abas Tarefas, Categorias e Responsáveis, com rotinas e modelos de checklist. Operações → Tarefas acompanha tarefas avulsas e ocorrências, registra o checklist e permite concluir ou cancelar conforme a permissão. Não há interruptor nesta tela para desligar a exigência de Categoria, definir uma recorrência ou concluir atividades. Essas informações pertencem aos cadastros e operações correspondentes.","links":[],"url":"/spm/manual/configuracoes-tarefas/#configuracao-cadastros-e-operacao","version":"1.0.1"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"O aplicativo utiliza a configuração salva, sem editor dessa opção.","links":[],"url":"/spm/manual/configuracoes-tarefas/#disponibilidade","version":"1.0.1"}]},{"id":"configuracoes-do-produto","title":"Configurações do produto","summary":"Ative os módulos e ajuste suas dependências, preservando a distinção entre disponibilidade e permissão.","module":"Configurações","version":"1.1.0","publication":"public","channels":["web"],"keywords":["configurações","ativar","desativar","módulo","Master"],"related":["configuracoes-performance","configuracoes-pipeline","configuracoes-tarefas","pagamentos-configuracao","configuracoes-documentos","configuracoes-pessoas","configuracoes-organizacoes","configuracoes-produtos","configuracoes-fechamentos","integracao-arquivos"],"url":"/spm/manual/configuracoes-do-produto/","markdownUrl":"/spm/manual/configuracoes-do-produto.md","sections":[{"title":"Introdução","anchor":"","text":"O Master configura os recursos da empresa em Gerenciador → página desejada → Configurar, no web. As configurações do Gerenciador reúnem abas por módulo. Pipeline, Tarefas e Documentos ficam em Extensões; abra Configurar dentro de cada extensão para ajustar suas opções, sem abas compartilhadas com outras páginas.","links":[],"url":"/spm/manual/configuracoes-do-produto/","version":"1.1.0"},{"title":"Configurar ou cadastrar no Gerenciador","anchor":"configurar-ou-cadastrar-no-gerenciador","text":"Configurar define a disponibilidade do módulo, seus campos opcionais, dependências e regras gerais. As abas de cadastro do Gerenciador mantêm informações usadas na operação, como ciclos, naturezas e pessoas. Atribuições reúne Clientes, Organizações e Produtos, com os controles correspondentes em Configurar. Extensões mantém etapas, rotinas e abas de documentos. Arquivos fica em Integrações. Arquivos começa desativado; ao ativar, sua página fica disponível em Operações. Operações registra os acontecimentos, como vendas, oportunidades, tarefas, documentos e pagamentos. Ativar um módulo não cria seus cadastros nem concede permissões. Cada acesso continua sujeito às páginas autorizadas e ao alcance dos registros. Desativar preserva o histórico, mas os efeitos sobre acesso, automações e bloqueios variam por módulo.","links":[],"url":"/spm/manual/configuracoes-do-produto/#configurar-ou-cadastrar-no-gerenciador","version":"1.1.0"},{"title":"Alterar uma configuração","anchor":"alterar-uma-configuracao","text":"Abra Configurar na página do Gerenciador e escolha a aba do módulo, ou abra Configurar diretamente na extensão desejada. Ajuste os campos. Quando uma opção estiver indisponível, confira sua dependência no tópico específico. Use Salvar para aplicar e retornar à tabela; Cancelar descarta a edição. Confira os efeitos e eventuais resultados de atualização nas páginas envolvidas. O estado visual de um controle ainda não salvo não altera a empresa. Não use desativação para desfazer vendas, pagamentos ou fechamentos.","links":[],"url":"/spm/manual/configuracoes-do-produto/#alterar-uma-configuracao","version":"1.1.0"},{"title":"Tópicos por módulo","anchor":"topicos-por-modulo","text":"Os tópicos relacionados desta página detalham separadamente Performance, Pipeline, Tarefas, Pagamentos, Documentos, Pessoas, Organizações, Produtos, Fechamento e Arquivos, incluindo campos, opções, padrões e condições. Abra o módulo desejado para consultar suas regras.","links":[],"url":"/spm/manual/configuracoes-do-produto/#topicos-por-modulo","version":"1.1.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"O aplicativo utiliza as configurações e permissões salvas, sem editor nativo equivalente.","links":[],"url":"/spm/manual/configuracoes-do-produto/#disponibilidade","version":"1.1.0"}]},{"id":"pagamentos-reembolso","title":"Reembolso e comprovantes","summary":"Configure a geração do reembolso, seus cupons e recibos e os comprovantes, sem exigir nota fiscal separada.","module":"Configurações","version":"1.0.1","publication":"public","channels":["web"],"keywords":["reembolso","cupom","recibo","nota fiscal","comprovante","Pagamentos","Documentos"],"related":["pagamentos-configuracao","documentos-configuracao"],"supportScope":["pagamento","pagar","pago","baixa","lote","reembolso","fixo","nota fiscal","cupom","recibo","comprovante","beneficiário","CNAB","split","vencimento","compensação"],"url":"/spm/manual/pagamentos-reembolso/","markdownUrl":"/spm/manual/pagamentos-reembolso.md","sections":[{"title":"Introdução","anchor":"","text":"Reembolso reconhece despesas do colaborador ou parceiro a partir de Documentos. A regra fica em Pagamentos; os comprovantes permanecem no documento de origem. O Master configura a modalidade, e as operações respeitam aprovação e alcance do acesso.","links":[],"url":"/spm/manual/pagamentos-reembolso/","version":"1.0.1"},{"title":"Documentos e comprovantes","anchor":"documentos-e-comprovantes","text":"Configure Reembolso em Gerenciador → Pagamentos → Configurar: habilite a modalidade, escolha Beneficiários, Vencimento e a vigência em Início da apuração, e ative Usar Pagamentos. Em Documentos, utilize uma aba ativa do tipo Reembolsos. O documento deve estar aprovado, com cupom fiscal, recibo ou outro comprovante anexado e aprovado, e com beneficiário e associações elegíveis. Pendência, ausência de anexo ou origem inválida impede gerar ou liberar o reembolso; alterações após movimentação podem exigir revisão. Reembolso não exige nota fiscal separada: o campo Exigir nota fiscal e a ação Vincular nota fiscal não aparecem nessa modalidade. Uma exigência antiga de NF deixa de bloquear o reembolso; seus valores, baixas e notas anteriormente vinculadas permanecem no histórico. Os comprovantes da origem continuam obrigatórios e são reconferidos antes de confirmar um lote. Documentos gerais e Notas fiscais não geram novas obrigações. Reembolsos elegíveis geram a obrigação diretamente em Pagamentos; reprocessar a mesma origem não duplica a dívida.","links":[],"url":"/spm/manual/pagamentos-reembolso/#documentos-e-comprovantes","version":"1.0.1"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"Configuração e operação de Pagamentos ficam no web. Enviar o documento pelo aplicativo, quando autorizado, não substitui a aprovação nem confirma transferência bancária.","links":[],"url":"/spm/manual/pagamentos-reembolso/#disponibilidade","version":"1.0.1"}]},{"id":"assinatura-e-uso","title":"Assinatura e uso","summary":"Entenda os participantes acompanhados, o consumo de vendas e a gestão da assinatura disponível na Conta.","module":"Conta e acesso","version":"1.0.0","publication":"public","channels":["web"],"keywords":["plano","assinatura","fatura","capacidade","participantes","limite"],"related":["conta-e-perfil","pessoas-cargos-e-acessos","performance","vendas"],"url":"/spm/manual/assinatura-e-uso/","markdownUrl":"/spm/manual/assinatura-e-uso.md","sections":[{"title":"Introdução","anchor":"","text":"O painel de assinatura fica em Conta, para Master. A contratação e a gestão de cobrança implementadas estão restritas ao ambiente de testes; não representam uma oferta de cobrança em produção. Consulte a disponibilidade comercial pelo site do Askora.","links":[],"url":"/spm/manual/assinatura-e-uso/","version":"1.0.0"},{"title":"Consultar plano e faturas","anchor":"consultar-plano-e-faturas","text":"O painel mostra plano, situação e uso de participantes e vendas. Contas sem assinatura vinculada mostram essa condição, sem estimar limites ou valores. Admin vê o painel de Usuários; os demais perfis elegíveis veem suas conquistas. As faturas disponíveis mostram situação, valor, vencimento quando aplicável e links para visualizar/pagar ou baixar PDF. Falha ao carregar faturas não significa que o perfil ou o plano foram apagados. Gerenciar pagamento abre o portal de cobrança para as opções permitidas, como dados de pagamento e cancelamento.","links":[],"url":"/spm/manual/assinatura-e-uso/#consultar-plano-e-faturas","version":"1.0.0"},{"title":"O que conta como participante","anchor":"o-que-conta-como-participante","text":"Uma pessoa ativa do tipo Colaborador ou Parceiro ocupa capacidade quando tem remuneração direta positiva, fixa ou variável, ou participa ativamente de uma Performance ativa, pronta e ainda não encerrada. Ciclos futuros prontos já reservam capacidade; rascunhos e ciclos encerrados não reservam por esse vínculo. Uma mesma pessoa em vários ciclos conta uma vez. Ter login, isoladamente, não ocupa uma vaga de participante acompanhado. Administradores não entram nessa contagem. Desabilitar uma tela não equivale a remover os vínculos que compõem o uso.","links":[],"url":"/spm/manual/assinatura-e-uso/#o-que-conta-como-participante","version":"1.0.0"},{"title":"O que conta como venda","anchor":"o-que-conta-como-venda","text":"O consumo mensal considera registros criados no mês, no calendário de São Paulo, incluindo vendas e devoluções. Usa a data de criação no sistema, não a data comercial informada na venda. A edição de um registro existente não acrescenta vendas ao consumo. Cancelar, inativar ou reativar não devolve a capacidade já consumida naquele mês. Assim, o número do plano pode diferir do total filtrado no dashboard de Vendas.","links":[],"url":"/spm/manual/assinatura-e-uso/#o-que-conta-como-venda","version":"1.0.0"},{"title":"Alterar capacidade","anchor":"alterar-capacidade","text":"Use Alterar plano e capacidade quando disponível. Confira a simulação do valor recorrente, ajuste proporcional e eventual crédito. Revise e use Confirmar alteração para aplicar. Se a resposta ficar incerta, consulte a operação pendente antes de iniciar outra. A simulação não aplica a mudança. Enquanto uma alteração aguarda pagamento, o plano pago continua sendo apresentado; uma redução pendente pode reservar a capacidade menor. O sistema impede inclusões acima do limite e orienta ampliar ou regularizar a assinatura. Uma assinatura sem direito vigente impede novo consumo, preservando o histórico. Atrasos elegíveis têm tolerância de sete dias após o período pago; isso não é uma extensão de capacidade. A data de cancelamento e o período já pago determinam o direito restante.","links":[],"url":"/spm/manual/assinatura-e-uso/#alterar-capacidade","version":"1.0.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"A gestão descrita é web e restrita ao ambiente de testes de cobrança. O aplicativo não oferece esse painel de contratação ou alteração de plano. Limites, autorização e validações do servidor continuam valendo para operações feitas pelos canais disponíveis. A mensagem de retorno do pagamento, sozinha, não confirma contratação: aguarde a confirmação apresentada pelo sistema.","links":[],"url":"/spm/manual/assinatura-e-uso/#disponibilidade","version":"1.0.0"}]},{"id":"conquistas","title":"Conquistas","summary":"Consulte suas medalhas, entenda os critérios e a atualização dos resultados.","module":"Conta e acesso","version":"1.1.0","publication":"public","channels":["web","mobile"],"keywords":["medalha","bônus","meta","ranking","pódio","galeria"],"related":["conta-e-perfil","performance","metas","remuneracao-e-premios"],"url":"/spm/manual/conquistas/","markdownUrl":"/spm/manual/conquistas.md","sections":[{"title":"Introdução","anchor":"","text":"As Conquistas são pessoais, para colaboradores e parceiros elegíveis. Em Conta, abra a galeria e consulte as medalhas obtidas ou bloqueadas. A galeria contém 22 tipos; abra uma medalha para ler seu critério. Administradores, clientes e fornecedores não recebem essa galeria pessoal por esses tipos de cadastro. O maior marco de vendas já conquistado aparece primeiro. Depois vêm as outras conquistas desbloqueadas e, no fim desse grupo, os marcos de vendas anteriores. As conquistas bloqueadas de vendas ficam por último, depois de todas as demais medalhas.","links":[],"url":"/spm/manual/conquistas/","version":"1.1.0"},{"title":"Entender a contagem","anchor":"entender-a-contagem","text":"O total de tipos conquistados difere das repetições de uma medalha. A indicação ×N informa quantas vezes o critério foi reconhecido. Medalhas bloqueadas mostram objetivos ainda não reconhecidos; um cálculo pendente não deve ser interpretado como resultado definitivo zero. Conquistas reconhecem fatos apurados. Não criam pagamento, comissão nem premiação financeira por si mesmas.","links":[],"url":"/spm/manual/conquistas/#entender-a-contagem","version":"1.1.0"},{"title":"Vendas acumuladas","anchor":"vendas-acumuladas","text":"Os marcos são R$ 10 mil, R$ 100 mil, R$ 500 mil, R$ 1 milhão, R$ 5 milhões e R$ 10 milhões. Consideram vendas aprovadas até hoje, descontadas as devoluções, com total mínimo zero. Não exigem vínculo com uma Performance e não representam dinheiro recebido em banco. Uma mesma venda não é contada duas vezes para a mesma pessoa. Correções ou devoluções podem reduzir o resultado e retirar um marco anteriormente reconhecido.","links":[],"url":"/spm/manual/conquistas/#vendas-acumuladas","version":"1.1.0"},{"title":"Metas e sequências","anchor":"metas-e-sequencias","text":"Os demais critérios usam Performances ativas, prontas e encerradas antes de hoje, com a participação elegível da pessoa. Medalha Critério Meta alcançada Pelo menos 100% e menos de 120% da meta apurada. Meta superada Pelo menos 120% da meta apurada. Meta alcançada ×3 ou ×6 Três ou seis ciclos consecutivos com pelo menos 100%, incluindo ao menos um abaixo de 120%. Meta superada ×3 ou ×6 Três ou seis ciclos consecutivos com pelo menos 120%. Para uma sequência, o ciclo seguinte começa no dia posterior ao fim do anterior. Lacunas ou sobreposições interrompem a sequência. Cada série contínua conta uma vez para seu marco; não gera nova medalha a cada janela sobreposta de três ciclos.","links":[],"url":"/spm/manual/conquistas/#metas-e-sequencias","version":"1.1.0"},{"title":"Bônus, posições e prêmios","anchor":"bonus-posicoes-e-premios","text":"Bônus no alvo usa objetivos configurados com meta positiva, respeitando a direção: alcançar ou superar, ou ficar no máximo no limite quando a regra for inversa. Todos os bônus exige mais de um indicador com meta e cumprimento de todos. Bônus + meta acrescenta pelo menos 100% da meta de Performance ao mesmo conjunto. Sem ganhos considera três Performances consecutivas sem atingir os objetivos configurados; não significa ausência de salário ou de movimentação financeira. Primeiro, segundo e terceiro lugares seguem o ranking apurado e suas regras de empate. Subiu ao pódio reúne as primeiras três colocações. Eterno lanterninha exige a última colocação por três ciclos consecutivos. Ganhador do prêmio reconhece premiação apurada, em dinheiro ou física, sem confirmar entrega ou pagamento.","links":[],"url":"/spm/manual/conquistas/#bonus-posicoes-e-premios","version":"1.1.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"Os resultados são processados diariamente, com recuperação após interrupções do serviço. Abrir a galeria não recalcula todo o histórico. Enquanto a atualização estiver pendente, aguarde sua conclusão; mudanças nos registros de origem podem alterar contagens anteriores. Web e aplicativo oferecem a consulta da própria pessoa quando elegível. A configuração de metas, bônus, ranking e prêmios ocorre no Gerenciador web, conforme as permissões. Exemplos de demonstração do aplicativo não comprovam conquistas na conta real.","links":[],"url":"/spm/manual/conquistas/#disponibilidade","version":"1.1.0"}]},{"id":"conta-e-perfil","title":"Conta e Meu Perfil","summary":"Atualize seus dados pessoais, sua foto e sua senha e entenda o que aparece na página Conta.","module":"Conta e acesso","version":"1.0.0","publication":"public","channels":["web","mobile"],"keywords":["perfil","foto","nome","e-mail","senha","conta"],"related":["acesso-e-sessoes"],"url":"/spm/manual/conta-e-perfil/","markdownUrl":"/spm/manual/conta-e-perfil.md","sections":[{"title":"Introdução","anchor":"","text":"A página Conta reúne seu perfil e informações relacionadas ao acesso ativo. Confira o nome, o nível de acesso e o código da conta antes de alterar dados, principalmente se você utiliza mais de uma empresa.","links":[],"url":"/spm/manual/conta-e-perfil/","version":"1.0.0"},{"title":"Editar seus dados","anchor":"editar-seus-dados","text":"No web, abra Conta pelo menu da sua conta e escolha Editar perfil no card do perfil. Altere os campos desejados e selecione Salvar. Cancelar descarta os campos que ainda não foram salvos. Ao sair ou trocar de contexto com alterações pendentes, confira o aviso apresentado. Campo Regra Nome Obrigatório; até 150 caracteres. Altera o nome da própria pessoa. E-mail Obrigatório; deve ser válido e ter até 190 caracteres. Colaboradores e parceiros precisam solicitar a alteração a um administrador autorizado. Senha atual Necessária para alterar o e-mail permitido ou definir uma nova senha. Não é exigida apenas para trocar o nome. Nova senha Opcional. Quando preenchida, deve ter de 8 a 128 caracteres, maiúscula, minúscula e caractere especial. O bloqueio de e-mail de colaboradores e parceiros também vale quando tentam alterar os dados fora da tela. A mudança deve ser feita no cadastro de Pessoas por quem tenha autorização. Trocar e-mail ou senha encerra as outras sessões daquele acesso. A sessão em uso é atualizada para continuar autenticada. Se a atualização falhar, confira a mensagem: uma tela com dados preenchidos não significa que eles foram salvos.","links":[],"url":"/spm/manual/conta-e-perfil/#editar-seus-dados","version":"1.0.0"},{"title":"Foto do perfil","anchor":"foto-do-perfil","text":"Na edição, escolha Alterar foto para enviar uma imagem PNG, JPEG ou WebP de até 2 MB. A opção Remover foto aparece quando há uma foto cadastrada. A foto é uma alteração própria, salva separadamente dos demais campos do formulário; cancelar a edição textual não desfaz uma foto já salva. A foto pertence ao perfil da conta ativa e é exibida somente a partir de um acesso autorizado. Arquivos com extensão de imagem, mas formato incompatível, são recusados.","links":[],"url":"/spm/manual/conta-e-perfil/#foto-do-perfil","version":"1.0.0"},{"title":"Painéis da Conta","anchor":"paineis-da-conta","text":"O painel apresentado depende do acesso. Master vê assinatura e faturamento. Administrador vê o resumo de usuários dentro do seu escopo e das suas permissões. Colaboradores e parceiros elegíveis, quando não estão nesses níveis administrativos, veem Conquistas. Outros acessos recebem o resumo do próprio acesso. O fato de um painel não aparecer não autoriza abrir dados de outra pessoa ou empresa. Falhas de carregamento devem ser tratadas na área correspondente, sem assumir valores ou conquistas que não foram retornados. Para adicionar, trocar, remover ou sair de contas, consulte Entrar e gerenciar suas contas. Remover uma conta conectada não exclui seu cadastro no Askora.","links":["/spm/manual/acesso-e-sessoes/"],"url":"/spm/manual/conta-e-perfil/#paineis-da-conta","version":"1.0.0"},{"title":"Erros e dúvidas comuns","anchor":"erros-e-duvidas-comuns","text":"E-mail desabilitado: para colaborador ou parceiro, peça a alteração ao administrador responsável. Senha atual incorreta: confira a senha usada para entrar nessa conta. Caso não a lembre, utilize a recuperação. Imagem recusada: confira o formato e o tamanho do arquivo, não apenas seu nome. Alteração não aparece em outro acesso: cada acesso está associado à sua própria pessoa e empresa; confira qual conta está ativa. Cancelar depois de mudar a foto: a ação não desfaz o upload ou a remoção que já foi concluída.","links":[],"url":"/spm/manual/conta-e-perfil/#erros-e-duvidas-comuns","version":"1.0.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"No web, a edição acontece dentro do card do perfil. No aplicativo, Conta abre a edição em um painel inferior. O aplicativo permite escolher foto pela galeria ou pela câmera, sujeito às permissões do aparelho, e apresenta confirmação da nova senha ao alterá-la. As mesmas restrições de e-mail e senha são aplicadas pelo Askora. As preferências de aparência do aplicativo são próprias do aparelho; elas não alteram as permissões ou os registros da empresa.","links":[],"url":"/spm/manual/conta-e-perfil/#disponibilidade","version":"1.0.0"}]},{"id":"acesso-e-sessoes","title":"Entrar e gerenciar suas contas","summary":"Entre no Askora, recupere sua senha, use o segundo fator e alterne entre acessos conectados.","module":"Conta e acesso","version":"1.0.0","publication":"public","channels":["web","mobile"],"keywords":["login","senha","autenticador","2FA","código da conta","sair"],"related":[],"url":"/spm/manual/acesso-e-sessoes/","markdownUrl":"/spm/manual/acesso-e-sessoes.md","sections":[{"title":"Introdução","anchor":"","text":"Para entrar, você precisa de um acesso ativo, com e-mail e senha cadastrados. Pertencer a uma organização ou estar cadastrado como pessoa não significa, por si só, ter acesso ao Askora. Quando não tiver credenciais, procure o administrador responsável pela sua empresa.","links":[],"url":"/spm/manual/acesso-e-sessoes/","version":"1.0.0"},{"title":"Entrar no Askora","anchor":"entrar-no-askora","text":"No site, escolha Entrar. No aplicativo, abra a tela de login. Preencha E-mail e Senha e selecione Entrar. Se aparecer Código da conta, informe o código da empresa desejada. Essa informação distingue acessos com as mesmas credenciais em empresas diferentes. Se sua empresa exigir autenticação em dois fatores, conclua a verificação apresentada. No web, um endereço interno aberto antes do login pode ser retomado depois de entrar, conforme suas permissões. A senha começa oculta; o botão de mostrar senha permite conferir o que foi digitado. Exemplo fictício: Marina tem acesso a duas empresas com o mesmo e-mail e a mesma senha. Ao receber a solicitação do código da conta, deve usar o código informado pelo administrador da empresa em que pretende trabalhar. O código não substitui a senha.","links":[],"url":"/spm/manual/acesso-e-sessoes/#entrar-no-askora","version":"1.0.0"},{"title":"Autenticação em dois fatores","anchor":"autenticacao-em-dois-fatores","text":"A exigência é uma configuração da empresa e também se aplica ao Master. No primeiro acesso em que precisar configurar o autenticador, leia o QR code com um aplicativo compatível ou use a chave manual oferecida na tela. Digite o código gerado para concluir a ativação. Guarde os oito códigos de recuperação apresentados após a configuração. Cada um pode ser usado uma única vez, junto com sua senha, se você perder acesso ao autenticador. Nos próximos logins, use o código atual do aplicativo ou escolha a alternativa de recuperação. O desafio de verificação expira em dez minutos e admite até cinco tentativas. Quando expirar, entre novamente com e-mail e senha. Um código do autenticador já utilizado não pode ser reutilizado. Recuperar a senha não remove a configuração do autenticador.","links":[],"url":"/spm/manual/acesso-e-sessoes/#autenticacao-em-dois-fatores","version":"1.0.0"},{"title":"Recuperar a senha","anchor":"recuperar-a-senha","text":"Escolha Esqueceu sua senha? e informe o e-mail do acesso. Confira a mensagem de envio e sua caixa de entrada, incluindo spam. A mensagem na tela não confirma a existência de um acesso com aquele e-mail. Abra Redefinir minha senha no e-mail recebido. Informe a nova senha e sua confirmação, salve e volte ao login. O link vale por 30 minutos e é consumido quando a nova senha é salva. Se houver acessos com o mesmo e-mail em empresas diferentes, os e-mails identificam a conta correspondente: escolha o link certo. No web, se recarregar a página de redefinição e perder o fluxo, reabra o link do e-mail. Novas senhas devem ter de 8 a 128 caracteres, com pelo menos uma letra maiúscula, uma minúscula e um caractere especial. Espaço sozinho não conta como caractere especial. A confirmação precisa ser igual à nova senha. Ao redefinir, os acessos anteriormente conectados são encerrados e precisarão autenticar novamente.","links":[],"url":"/spm/manual/acesso-e-sessoes/#recuperar-a-senha","version":"1.0.0"},{"title":"Adicionar e trocar contas","anchor":"adicionar-e-trocar-contas","text":"No web, use o menu da sua conta ou expanda Contas neste navegador, na página Conta. Adicionar conta solicita as credenciais do outro acesso; depois, você pode alternar entre as contas já conectadas. O limite é de oito contas conectadas no mesmo conjunto de sessões. Trocar de conta muda a empresa, a pessoa e as permissões utilizadas. Antes de registrar ou editar informações, confira a conta ativa. Uma aba desatualizada pode pedir que você atualize o contexto antes de continuar; não trate esse aviso como uma gravação concluída. Remover desconecta o acesso escolhido daquele navegador ou aparelho. Essa ação não exclui a pessoa nem seus registros de negócio. Sair encerra os acessos conectados no navegador ou aparelho utilizado.","links":[],"url":"/spm/manual/acesso-e-sessoes/#adicionar-e-trocar-contas","version":"1.0.0"},{"title":"Erros e dúvidas comuns","anchor":"erros-e-duvidas-comuns","text":"Situação Como proceder E-mail ou senha incorretos Confira o e-mail e a digitação; use a recuperação se não lembrar a senha. Código da conta solicitado Peça ao administrador o código da empresa desejada. Muitas tentativas Aguarde o intervalo indicado antes de tentar novamente. Link inválido, expirado ou já utilizado Solicite um novo link na recuperação de senha. Conta deixou de abrir O acesso pode ter sido desativado, ter expirado ou exigir nova verificação. Entre novamente e, se necessário, consulte o administrador. Página sem permissão depois do login Estar autenticado não libera todos os módulos e registros. A empresa define suas permissões.","links":[],"url":"/spm/manual/acesso-e-sessoes/#erros-e-duvidas-comuns","version":"1.0.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"O web oferece login, segundo fator, recuperação e gerenciamento das contas conectadas. O aplicativo também usa os acessos da empresa, exige o segundo fator quando configurado e permite adicionar, trocar e remover contas. Na recuperação pelo aplicativo, siga o link enviado por e-mail para redefinir a senha no fluxo oficial. As contas conectadas são próprias de cada navegador ou aparelho. Adicionar uma conta no computador não a conecta automaticamente no celular.","links":[],"url":"/spm/manual/acesso-e-sessoes/#disponibilidade","version":"1.0.0"}]},{"id":"notificacoes","title":"Notificações","summary":"Consulte sua caixa, avisos pessoais, pendências de aprovação e resumos gerenciais.","module":"Conta e acesso","version":"1.3.0","publication":"public","channels":["web","mobile"],"keywords":["sino","aviso","lida","push","agenda","resumo","aprovação pendente"],"related":["conta-e-perfil","conquistas","permissoes-e-escopos","liberacoes"],"url":"/spm/manual/notificacoes/","markdownUrl":"/spm/manual/notificacoes.md","sections":[{"title":"Introdução","anchor":"","text":"O sino leva às notificações da conta ativa. No web, Conta mostra um card com quatro avisos por página; Ver todas abre a central com oito por página. Os avisos mais recentemente atualizados aparecem primeiro.","links":[],"url":"/spm/manual/notificacoes/","version":"1.3.0"},{"title":"Novidade e leitura","anchor":"novidade-e-leitura","text":"A bolinha ciano indica uma novidade ainda não visualizada. Exibir uma página confirma apenas os avisos daquela página e versão; não marca automaticamente a leitura. Uma notificação pode estar não lida mesmo sem a bolinha. Na central, escolha Todas, Não lidas ou Lidas. Marque ou desmarque uma notificação individualmente, ou marque a página exibida como lida. Essa ação não alcança páginas que você ainda não abriu. Uma atualização relevante do conteúdo pode tornar o aviso novo e não lido novamente. Ver mais abre o texto completo ou os detalhes do resumo. Ao voltar, a central mantém o contexto de consulta. Se a consulta falhar, use a opção de tentar novamente; a falha não apaga os registros de origem.","links":[],"url":"/spm/manual/notificacoes/#novidade-e-leitura","version":"1.3.0"},{"title":"Avisos pessoais","anchor":"avisos-pessoais","text":"Colaboradores e parceiros sem nível administrativo recebem eventos dos próprios vínculos, conforme o acesso atual: alterações e decisões sobre vendas, documentos e métricas, atribuições e prazos de Pipeline/Tarefas, pagamentos, marcos de Performance e conquistas. O aviso de venda aprovada informa o valor: Sua venda de R$ 4.500,00 foi aprovada. Bom trabalho! Nos avisos de documentos, o texto identifica a aba, como Reembolsos: há novidades no seu registro. ou Notas fiscais: aprovação concluída., em vez do número do documento. Marcos de metas e bônus são apurados diariamente, sem promessa de aviso a cada venda. Prazos de Tarefas consideram ocorrências já materializadas; previsões virtuais da recorrência não geram os mesmos avisos. Ranking em tempo real, meta diária e análise de ritmo não são categorias de notificação disponíveis nesta entrega. Alterações frequentes de um registro podem atualizar um aviso existente. O texto representa o fato comunicado; abra o módulo correspondente para consultar seu estado atual.","links":[],"url":"/spm/manual/notificacoes/#avisos-pessoais","version":"1.3.0"},{"title":"Horários dos avisos","anchor":"horarios-dos-avisos","text":"Avisos de rotina são liberados das 08h até antes das 19h, no horário de Brasília, diariamente. Isso inclui marcos de meta e objetivos de bônus apurados pela rotina, início/fim de Performance, lembretes de prazo, conquistas e resumos. Uma apuração durante a madrugada fica aguardando a abertura dessa janela; reinicializações e novas tentativas de envio respeitam a mesma regra. Avisos ligados ao registro ou à alteração de uma operação podem chegar em qualquer horário: venda aprovada, aprovação pendente, atualização de documentos, métricas, Tarefas/Pipeline e registros de Pagamentos ou lotes, inclusive pagamentos de bônus. O aviso diário de objetivos de bônus alcançados segue a janela de rotina. No aplicativo, o push de rotina tem validade limitada ao fim dessa janela. Se o aparelho permanecer offline até depois desse horário, o aviso continua disponível na caixa, mas o push pode expirar.","links":[],"url":"/spm/manual/notificacoes/#horarios-dos-avisos","version":"1.3.0"},{"title":"Aprovações para Master e Admin","anchor":"aprovacoes-para-master-e-admin","text":"Uma nova operação enviada como Pendente gera o aviso Aprovação pendente. A descrição identifica a origem: Venda, Devolução, Documento e nome da aba, Métrica e nome do indicador, Tarefa ou Pipeline. Recebem o aviso os usuários Master e Admin com acesso ativo e permissão de aprovação em Liberações e na operação de origem, dentro de suas organizações e suborganizações. Para Tarefas e Pipeline, o Admin também precisa estar atribuído ao respectivo fluxo. O aviso direciona para Operações → Liberações. Os avisos podem chegar mesmo quando um módulo ou fluxo estiver desativado, pois pendências anteriores continuam disponíveis para revisão por quem tem acesso. A edição de um registro que continua pendente não gera novos pedidos de aprovação. Uma nova submissão após uma decisão gera outro aviso. Ao aprovar, negar ou perder acesso ao registro, o pedido deixa de aparecer na caixa e não recebe novos envios de push. Uma métrica vazia não gera aviso de aprovação; um resultado preenchido, inclusive zero, pode gerar. Esses avisos acompanham novas submissões e não aguardam o horário dos resumos. A atualização não reenvia automaticamente todas as pendências antigas. No aplicativo, usam o som geral de notificação, sujeito às configurações e à permissão do aparelho.","links":[],"url":"/spm/manual/notificacoes/#aprovacoes-para-master-e-admin","version":"1.3.0"},{"title":"Resumos para Master e Admin","anchor":"resumos-para-master-e-admin","text":"Além das novas pendências de aprovação, esses perfis recebem resumos gerenciais. Operações já aprovadas não geram um aviso administrativo a cada alteração. O calendário usa São Paulo. Resumo Conteúdo Sua agenda, às 08h Compromissos, atrasos, liberações, prazos, saldos/revisões de Pagamentos e ciclos próximos do início ou fim, dentro do acesso. Seu dia em números, às 18h Vendas, devoluções e movimentos registrados como pagos/recebidos até a apuração. Sem atividade relevante, não há resumo vazio. Os números são um retrato na hora da apuração, não o fechamento definitivo do dia civil nem uma confirmação bancária. Alterações posteriores devem ser consultadas no módulo. Não há envio de resumos gerenciais de madrugada.","links":[],"url":"/spm/manual/notificacoes/#resumos-para-master-e-admin","version":"1.3.0"},{"title":"Acesso e troca de conta","anchor":"acesso-e-troca-de-conta","text":"Cada caixa pertence à pessoa e à empresa da sessão. Uma notificação não concede acesso ao registro. Mudanças de permissão, organização ou responsável podem ocultar avisos antigos; resumos cujo alcance mudou podem deixar de ser exibidos integralmente. Ao trocar de conta, confira a empresa ativa antes de consultar os avisos. Recebimento de push, visualização e marcação como lida são estados diferentes.","links":[],"url":"/spm/manual/notificacoes/#acesso-e-troca-de-conta","version":"1.3.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"A caixa pessoal existe no web e no aplicativo. No aplicativo, as preferências permitem escolher e ouvir sons para Vendas e Bônus, inclusive Sem som, e salvar para a conta ativa. Após entrar no aplicativo, a permissão do aparelho é solicitada se você ainda não tiver respondido. Ativar avisos também permite solicitá-la; quando negada, use os ajustes do sistema. Trocar de conta durante a edição exige abrir novamente as preferências. O aparelho recebe push das contas que permanecem conectadas no aplicativo, mesmo quando outra conta está aberta. Cada conta mantém seus sons; tocar no aviso abre a conta correspondente. Remover uma conta interrompe os avisos dela neste aparelho. Push depende da configuração do serviço e da permissão em iOS/Android. Se estiver indisponível, consulte a caixa e a indicação de estado no aplicativo. A existência do aviso na caixa não comprova entrega ao aparelho. As preferências de som não alteram as regras que geram notificações.","links":[],"url":"/spm/manual/notificacoes/#disponibilidade","version":"1.3.0"}]},{"id":"permissoes-e-escopos","title":"Perfis, permissões e alcance dos dados","summary":"Entenda quais ações cada acesso pode realizar e por que duas pessoas podem ver registros diferentes.","module":"Conta e acesso","version":"1.0.2","publication":"public","channels":["web","mobile"],"keywords":["Master","Administrador","Padrão","Visualizador","cargo","aprovação","organização"],"related":["acesso-e-sessoes","conta-e-perfil"],"url":"/spm/manual/permissoes-e-escopos/","markdownUrl":"/spm/manual/permissoes-e-escopos.md","sections":[{"title":"Introdução","anchor":"","text":"O Askora separa o que você pode fazer de quais registros você pode acessar. Uma permissão de edição não libera dados de outra empresa nem registros fora do seu alcance. Ativar um módulo também não concede automaticamente permissão para utilizá-lo.","links":[],"url":"/spm/manual/permissoes-e-escopos/","version":"1.0.2"},{"title":"Níveis de acesso","anchor":"niveis-de-acesso","text":"Nível Comportamento Master Acesso às ações da empresa ativa e às configurações globais. Não é uma política editável no seletor dos demais níveis. Administrador Gerencia as páginas autorizadas, respeitando seus vínculos organizacionais e as restrições específicas da ação. Padrão Trabalha nos próprios registros. As operações podem exigir aprovação. Não recebe acesso ao Gerenciador ou a Liberações. Visualizador Consulta e, quando liberado, exporta. Não recebe ações de gravação. O tipo de pessoa é outra informação. Administradores podem ter nível Master, Administrador ou Visualizador; colaboradores e parceiros utilizam acesso Padrão quando habilitado. Clientes e fornecedores não recebem login por serem cadastrados. Gerenciador é uma área do produto, não um nível de acesso.","links":[],"url":"/spm/manual/permissoes-e-escopos/#niveis-de-acesso","version":"1.0.2"},{"title":"Configurar permissões","anchor":"configurar-permissoes","text":"No web, o Master abre Gerenciador → Pessoas → Configurar, na seção Permissões de acesso. Escolhe o Nível de acesso e a área Dashboards, Operações ou Gerenciador. Trocar área ou nível preserva as mudanças locais; Salvar aplica e Cancelar descarta. Nível e páginas Opções disponíveis Política inicial Administrador, exceto Fechamentos Sem acesso; Acesso total Acesso total. Padrão, operações exceto Pagamentos e Liberações Sem acesso; Somente visualizar; Registrar com aprovação; Registrar sem aprovação Registrar sem aprovação em Pipeline e Tarefas; Registrar com aprovação em Vendas, Métricas e Documentos. Padrão, Pagamentos em Operações Sem acesso; Somente visualizar Sem acesso. Padrão, Dashboards Sem acesso; Somente visualizar; Visualizar e exportar Visualizar e exportar. Padrão, Gerenciador e Liberações Somente Sem acesso; controle indisponível Sem acesso. Visualizador, exceto Fechamentos Sem acesso; Somente visualizar; Visualizar e exportar Visualizar e exportar, exceto Pagamentos: Somente visualizar em Operações e Sem acesso no Gerenciador. Fechamentos, todos os níveis editáveis Somente Sem acesso; controle indisponível Exclusivo do Master. Sem acesso oculta a página. Somente visualizar permite consulta; Visualizar e exportar acrescenta exportação. Registrar com aprovação e Registrar sem aprovação permitem inclusão/edição e exportação, respeitando as ações existentes na página; a primeira política exige revisão. Acesso total também permite aprovar e inativar conforme a funcionalidade. Nenhuma opção cria uma ação ausente na tela nem ignora períodos fechados ou restrições do registro. As páginas configuráveis são Home, Competição, Pipeline, Tarefas, Vendas, Métricas, Resultados em Dashboards; Vendas, Pipeline, Tarefas, Métricas, Documentos, Liberações e Pagamentos em Operações; e Pessoas, Performance, Atribuições, Pagamentos e Fechamento no Gerenciador; e Pipeline, Tarefas e Documentos em Extensões. Configurações globais, Cargos e determinadas ações de cadastros exigem Master mesmo quando a página está visível. Ser beneficiário de um pagamento não libera sua página. Com Cargos e Permissões por cargo habilitados, o seletor oferece Padrão (sem cargo) e os cargos ativos de Colaboradores e Parceiros. O cargo associado substitui a política geral Padrão da pessoa, com as mesmas opções permitidas para Padrão. Sem cargo ou com o recurso desligado, vale Padrão; cargo inativo não concede permissões. O cargo não transforma alcance pessoal em visão de equipe.","links":[],"url":"/spm/manual/permissoes-e-escopos/#configurar-permissoes","version":"1.0.2"},{"title":"Alcance organizacional e pessoal","anchor":"alcance-organizacional-e-pessoal","text":"Master acessa os dados da empresa ativa. Administrador ou Visualizador sem vínculos organizacionais tem alcance da empresa nas páginas autorizadas. Com organizações vinculadas, o alcance fica restrito a essas organizações. Suborganizações vinculadas acrescentam a restrição correspondente. Colaborador ou parceiro com Padrão consulta seus próprios registros, conforme o responsável ou participante definido em cada operação. Exemplo fictício: uma administradora vinculada apenas à Unidade Norte não pode editar uma venda da Unidade Sul só porque tem acesso à página Vendas. Um colaborador com acesso por cargo continua vendo suas próprias vendas. Vínculos com unidades inativas conservam a restrição de acesso. Ocultar uma unidade no seletor não significa remover o vínculo. Desligar globalmente uma dimensão pode mudar sua aplicação; reativá-la recupera as associações preservadas. Em Competição, o acesso Padrão pode acompanhar participantes dos ciclos de Performance dos quais participa. Essa exceção não libera vendas, documentos, remunerações privadas ou outras operações dessas pessoas.","links":[],"url":"/spm/manual/permissoes-e-escopos/#alcance-organizacional-e-pessoal","version":"1.0.2"},{"title":"Registrar para si mesmo","anchor":"registrar-para-si-mesmo","text":"No acesso Padrão, com ou sem cargo, o campo que identifica você como Colaborador, Parceiro ou Responsável já vem preenchido e bloqueado nos registros permitidos. Isso vale para Vendas e devoluções, Pipeline, Tarefas, Documentos, conforme os módulos disponíveis. Na web, a regra também vale no cadastro rápido, no quadro e nas edições; esse vínculo não pode ser alterado em lote. Em Vendas, você ainda pode informar vínculos complementares permitidos, como o parceiro associado à venda de um colaborador. Isso não transfere o registro para outra pessoa. Em Documentos, o beneficiário permanece sendo o próprio colaborador; escolher um parceiro substituiria esse beneficiário e fica indisponível. Master e Administrador continuam escolhendo pessoas dentro do alcance autorizado. A regra não concede novas operações nem altera a necessidade de aprovação. No app, o preenchimento e bloqueio estão disponíveis na atualização que inclui esse ajuste; versões anteriores continuam sujeitas à restrição de registros próprios no servidor.","links":[],"url":"/spm/manual/permissoes-e-escopos/#registrar-para-si-mesmo","version":"1.0.2"},{"title":"Registros com aprovação","anchor":"registros-com-aprovacao","text":"Com Registrar com aprovação, o registro ou a edição fica pendente para revisão. Editar um registro ativo pode exigir nova aprovação, assim como adicionar um anexo. A tarefa estar concluída ou a oportunidade estar ganha não substitui a situação de aprovação do registro. Registrar sem aprovação permite novos registros de acordo com essa política; não aprova pendências anteriores. A decisão em Liberações exige acesso à ação, à página de origem e ao registro. Padrão não aprova nem inativa registros.","links":[],"url":"/spm/manual/permissoes-e-escopos/#registros-com-aprovacao","version":"1.0.2"},{"title":"Limites e dúvidas comuns","anchor":"limites-e-duvidas-comuns","text":"Um catálogo usado como opção de formulário pode ser legível sem permitir sua alteração. Anexos seguem a autorização do documento. Cadastros e agregados fora do alcance do gestor não se tornam editáveis só porque parte dos dados é visível em um dashboard. Se uma página desapareceu ou uma ação foi negada, confira a conta ativa, a permissão, a disponibilidade do módulo e os vínculos. Uma aba aberta antes de uma mudança pode precisar atualizar seus controles; o Askora já aplica a política vigente ao receber a ação. Exportação é uma capacidade própria da interface, mas não impede copiar dados que você legitimamente pode visualizar.","links":[],"url":"/spm/manual/permissoes-e-escopos/#limites-e-duvidas-comuns","version":"1.0.2"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"As configurações de permissões são feitas no web. Web e aplicativo respeitam a mesma identidade, empresa e autorização do Askora. A ausência de uma tela no aplicativo não cria uma nova permissão nem amplia a existente.","links":[],"url":"/spm/manual/permissoes-e-escopos/#disponibilidade","version":"1.0.2"}]},{"id":"dashboard-competicao","title":"Dashboard de Competição","summary":"Leia ranking, metas, destaques e prêmios de cada grupo da Performance.","module":"Dashboards","version":"1.0.0","publication":"public","channels":["web","mobile"],"keywords":["competição","ranking","empate","prêmio","destaques","meta diária"],"related":["performance","remuneracao-e-premios","metas","permissoes-e-escopos"],"url":"/spm/manual/dashboard-competicao/","markdownUrl":"/spm/manual/dashboard-competicao.md","sections":[{"title":"Introdução","anchor":"","text":"Dashboards → Competição mostra os grupos de competição das Performances ativas e prontas. Escolha ciclo, público e grupo disponíveis. O período seleciona ciclos completos; não reescreve as regras nem reduz automaticamente suas metas.","links":[],"url":"/spm/manual/dashboard-competicao/","version":"1.0.0"},{"title":"Ranking e resumo","anchor":"ranking-e-resumo","text":"O critério vem da configuração: vendas líquidas, contribuição sobre meta de Comissão/Bônus ou Score. A unidade aparece como dinheiro ou percentual. Competição Geral pode ordenar contribuições para informação, mas a liberação do prêmio depende da condição coletiva, não da posição. A base salva em cada Performance define a data usada: Data da venda considera saleDate; Data de pagamento considera paymentDate. Ambas usam o valor integral das vendas ativas menos devoluções. Vendas sem data de pagamento ficam fora dessa segunda base. Desligar a opção nas configurações não muda a base dos ciclos existentes. O resumo informa resultado do ciclo/dia, participantes, atingimento e metas. Indicadores com unidades diferentes conservam sua identificação. Empates usam posições como 1, 1, 3. A indicação de prêmio não confirma pagamento nem entrega de um bem físico.","links":[],"url":"/spm/manual/dashboard-competicao/#ranking-e-resumo","version":"1.0.0"},{"title":"Metas diárias e pendências","anchor":"metas-diarias-e-pendencias","text":"A barra geral usa a meta integral; a diária usa o saldo e os dias restantes, incluindo hoje, quando habilitada. Em meta compartilhada, o alvo diário é comum e a contribuição diária de cada pessoa permanece individual. Se o alcance não cobre o grupo necessário, a diária pode ficar indisponível. Métricas manuais não têm histórico diário: um resultado acumulado não é distribuído ficticiamente entre dias. Fora do ciclo ativo, Hoje e diária não são apresentados como resultado atual. Vazio não equivale a zero. Participantes com resultado pendente ficam sem posição definitiva e a indicação de premiação pode ser suspensa até completar o grupo. Consulte Metas para a fórmula diária.","links":["/spm/manual/metas/"],"url":"/spm/manual/dashboard-competicao/#metas-diarias-e-pendencias","version":"1.0.0"},{"title":"Destaques e filtros","anchor":"destaques-e-filtros","text":"Destaques mostra até três resultados positivos de uma janela recente: um quinto da duração do ciclo, arredondado para cima, limitado entre um e sete dias. A janela termina hoje ou no fim do ciclo encerrado. Não é variação percentual contra uma janela anterior. Filtros e paginação percorrem ciclos/grupos autorizados. Padrão pode consultar os agregados dos participantes das Performances em que participa; essa exceção não libera vendas, documentos ou remuneração dos colegas. Gestores com alcance organizacional veem seu recorte, sem redistribuir metas compartilhadas.","links":[],"url":"/spm/manual/dashboard-competicao/#destaques-e-filtros","version":"1.0.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"Web e aplicativo possuem a consulta. O web oferece Tela cheia, com saída por botão ou Escape. A consulta recalcula os dados disponíveis e não grava pagamentos; ciclos encerrados podem refletir correções posteriores. Sem dados, confira módulo, competição habilitada, ciclo e permissões.","links":[],"url":"/spm/manual/dashboard-competicao/#disponibilidade","version":"1.0.0"}]},{"id":"dashboard-metricas","title":"Dashboard de Métricas","summary":"Veja preenchimento, aprovação e consolidados sem misturar unidades ou inventar evolução diária.","module":"Dashboards","version":"1.0.0","publication":"public","channels":["web","mobile"],"keywords":["métricas","informados","ausentes","média","indicador","ciclo"],"related":["metricas-operacao","performance","metas"],"url":"/spm/manual/dashboard-metricas/","markdownUrl":"/spm/manual/dashboard-metricas.md","sections":[{"title":"Introdução","anchor":"","text":"Dashboards → Métricas acompanha resultados manuais de Quantidade, Valor e Percentual. O período seleciona Performances que cruzam o intervalo; os valores continuam representando o ciclo inteiro, sem rateio por dias.","links":[],"url":"/spm/manual/dashboard-metricas/","version":"1.0.0"},{"title":"Preenchimento e aprovação","anchor":"preenchimento-e-aprovacao","text":"Estado Contagem Informados Ativos com resultado preenchido, inclusive zero. Não preenchidos Ativos com resultado vazio. Em aprovação Todos os pendentes, inclusive os vazios. Essas contagens são exclusivas. Disponibilidade de resultados é informados divididos pelo total, sem percentual fictício quando não há registros. Pendentes podem aparecer identificados, mas não entram no consolidado. O resumo também conta indicadores, pessoas e ciclos. Ciclos futuros/em andamento/encerrados são classificados em relação a hoje, em São Paulo; encerrado não significa completo. Atenção apresenta até três ciclos com resultados a concluir.","links":[],"url":"/spm/manual/dashboard-metricas/#preenchimento-e-aprovacao","version":"1.0.0"},{"title":"Consolidado do indicador","anchor":"consolidado-do-indicador","text":"Selecione um indicador e confira Performance, grupo, origem e unidade. Nomes iguais não fundem identidades. Quantidade e Valor usam soma; Percentual usa média aritmética simples dos valores informados, sem pesos presumidos. Menor e maior são referências, não uma avaliação automática de melhor desempenho. O consolidado inclui todas as linhas autorizadas do indicador, não apenas a página visível. Indicadores e resultados por pessoa têm paginações independentes de seis itens. Não existe total somando dinheiro, quantidade e porcentagem.","links":[],"url":"/spm/manual/dashboard-metricas/#consolidado-do-indicador","version":"1.0.0"},{"title":"Filtros e limites","anchor":"filtros-e-limites","text":"Performance, colaborador/parceiro, organização e origem Comissão/Bônus refinam o recorte. Rascunhos, ciclos inativos e resultados inativos ficam fora deste painel. Dimensões desligadas não ampliam filtros. Métricas manuais não têm evolução diária histórica; a data de edição não é uma medição daquele dia. O painel também não calcula metas ou remuneração. Para corrigir um valor, use Operações → Métricas, com sua permissão própria.","links":[],"url":"/spm/manual/dashboard-metricas/#filtros-e-limites","version":"1.0.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"Web e aplicativo possuem a consulta autorizada. No web, Exportar resumo inclui resumo e consolidado do indicador selecionado, não todas as páginas de pessoas. O acesso pessoal não recebe a exceção coletiva da Competição. Consultar é somente leitura e reflete os resultados atuais.","links":[],"url":"/spm/manual/dashboard-metricas/#disponibilidade","version":"1.0.0"}]},{"id":"dashboard-pipeline","title":"Dashboard de Pipeline","summary":"Acompanhe oportunidades abertas, conversão, ciclo médio e previsões no intervalo escolhido.","module":"Dashboards","version":"1.1.1","publication":"public","channels":["web","mobile"],"keywords":["pipeline","conversão","ciclo médio","etapas","previsão"],"related":["pipeline-operacao","pipeline-configuracao","remuneracao-e-premios"],"supportScope":["pipeline","oportunidade","funil","valor personalizado","campo moeda"],"url":"/spm/manual/dashboard-pipeline/","markdownUrl":"/spm/manual/dashboard-pipeline.md","sections":[{"title":"Introdução","anchor":"","text":"Dashboards → Pipeline analisa oportunidades autorizadas. Permissão do dashboard, módulo e associação a responsáveis são verificados separadamente das telas de cadastro. Use o filtro de Período e confira a data de referência.","links":[],"url":"/spm/manual/dashboard-pipeline/","version":"1.1.1"},{"title":"Indicadores e fórmulas","anchor":"indicadores-e-formulas","text":"Indicador Definição Em aberto Oportunidades ativas sem encerramento na referência, inclusive anteriores ao início do filtro. Oportunidades ganhas Encerradas como ganhas no período até a referência. Conversão Ganhas divididas por ganhas mais perdidas; indisponível sem encerramentos. Ciclo médio Média dos dias entre abertura e encerramento das ganhas do período. A conversão deste painel usa os encerramentos. O indicador de taxa usado em certas regras de Performance utiliza outra base operacional; confira a definição da regra antes de comparar porcentagens. No web, a visão destaca abertas, conversão, novas oportunidades, ganhos e tempo médio até ganhar. A barra de encerramentos separa ganhas e perdidas. A evolução mostra Entradas, Ganhas e Perdidas em até 12 intervalos. Uma edição de texto não conta como nova entrada. A comparação usa o mesmo número de dias já decorridos, imediatamente anteriores ao início do filtro. Por exemplo, 1 a 20 de setembro compara com 12 a 31 de agosto. Usa o histórico disponível em cada referência e o mesmo alcance autorizado. A variação da conversão é exibida em pontos percentuais apenas quando ambos os recortes têm encerramentos. Sem base, fica indisponível; não significa conversão zero. Os detalhes ficam recolhidos em Comparação e critérios. Oportunidades por etapa mostra quantidade, participação no estoque, tempo médio na etapa atual e previsões vencidas. Não é uma taxa de passagem entre colunas. O tempo na etapa usa a última entrada registrada nessa etapa: editar o nome, a previsão ou o checklist não reinicia a contagem; sair e voltar à mesma etapa reinicia. Quando não há informação histórica, o tempo fica indisponível.","links":[],"url":"/spm/manual/dashboard-pipeline/#indicadores-e-formulas","version":"1.1.1"},{"title":"Período e atenção","anchor":"periodo-e-atencao","text":"A referência é o menor valor entre hoje e o fim do período, no calendário de São Paulo. Intervalo futuro mantém o estoque de hoje e apresenta previsões futuras, sem antecipar negócios ganhos. No web, Oportunidades para acompanhar oferece cinco grupos, com total e até cinco registros por grupo: Previsão vencida: abertas com previsão anterior à referência, começando pela mais antiga. Mais tempo na etapa: abertas ordenadas pela permanência na etapa atual. Não pressupõe ausência de contatos ou um prazo máximo universal. Próximas previsões: previsões da referência em diante, dentro do intervalo, incluindo o próprio dia. Sem previsão: abertas sem data prevista. Sem responsável: abertas sem responsável, quando visíveis no alcance autorizado. Os grupos podem se sobrepor. Previsão vencida não representa automaticamente um prazo contratual descumprido. Aprovações pendentes ficam nos detalhes da visão e não entram nos resultados ativos. Resultados por responsável relaciona carteira aberta e previsão vencida na referência com entradas, ganhos, perdas e conversão do período. Inclui a linha Sem responsável quando houver registros autorizados nessa situação. A visão individual não repete essa tabela. Histórico utiliza a versão disponível na referência e verifica o alcance atual. Pendentes não entram nos resultados ativos. Valores monetários personalizados não são somados indiscriminadamente e não há cálculo de probabilidade de fechamento.","links":[],"url":"/spm/manual/dashboard-pipeline/#periodo-e-atencao","version":"1.1.1"},{"title":"Filtros e disponibilidade","anchor":"filtros-e-disponibilidade","text":"Colaborador, Organização e Suborganização refinam somente o alcance autorizado. Parceiros não recebem oportunidades de colaboradores apenas por participar da mesma Performance. Sem registros, indicadores/listas mantêm o estado vazio coerente; uma divisão sem base fica indisponível.","links":[],"url":"/spm/manual/dashboard-pipeline/#filtros-e-disponibilidade","version":"1.1.1"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"Web e aplicativo oferecem o dashboard. Esta reorganização gerencial é exclusiva do web; o aplicativo mantém sua apresentação anterior (evolução de entradas e encerramentos, oportunidades mais antigas e próximas previsões). No web, Exportar resumo exige autorização de exportação e inclui indicadores, comparação, etapas, evolução, responsáveis e os registros exibidos nos grupos de acompanhamento do recorte. Ler o painel não cria oportunidades nem altera etapas; resultados mudam quando os registros da origem são atualizados e consultados novamente.","links":[],"url":"/spm/manual/dashboard-pipeline/#disponibilidade","version":"1.1.1"}]},{"id":"dashboard-resultados","title":"Dashboard de Resultados","summary":"Consulte remuneração calculada, faixas e pendências por pessoa sem confundir o painel com uma baixa.","module":"Dashboards","version":"1.0.0","publication":"public","channels":["web","mobile"],"keywords":["resultados","remuneração","comissão","bônus","faixa","Score"],"related":["remuneracao-e-premios","apuracao","pagamentos-operacao","performance"],"url":"/spm/manual/dashboard-resultados/","markdownUrl":"/spm/manual/dashboard-resultados.md","sections":[{"title":"Introdução","anchor":"","text":"Dashboards → Resultados calcula Comissão, Bônus e prêmios monetários de uma Performance por vez. O período filtra ciclos que cruzam as datas; escolha o ciclo e a pessoa para detalhar. Público, organização e pessoa refinam a apresentação autorizada.","links":[],"url":"/spm/manual/dashboard-resultados/","version":"1.0.0"},{"title":"Ler o total","anchor":"ler-o-total","text":"Remuneração apurada reúne Comissão, Bônus e prêmios em dinheiro. A lista de participantes pagina oito pessoas, mas o resumo considera todo o recorte. Fixo e variável são referências guardadas no ciclo: o fixo não é acrescentado ao total e a variável não é somada de novo ao pagamento que ajudou a calcular. Prêmios não monetários permanecem em Competição. Parceiros não recebem referências salariais próprias de colaboradores. Comissão permanece visível mesmo zerada; Bônus/Prêmios podem ficar ocultos sem valor positivo.","links":[],"url":"/spm/manual/dashboard-resultados/#ler-o-total","version":"1.0.0"},{"title":"Detalhamento e faixas","anchor":"detalhamento-e-faixas","text":"O detalhe informa unidade, resultado, meta integral, atingimento, regra e valor. Em fórmulas por faixa, mostra atual/próxima e distância. Mais detalhes revela as referências; Score apresenta contribuição e peso de cada indicador com um único pagamento por grupo. A barra de faixas representa o intervalo entre a atual e a próxima, não o atingimento integral da meta. OTE usa a faixa efetivamente alcançada, sem interpolação; arredondar a porcentagem exibida não antecipa uma faixa.","links":[],"url":"/spm/manual/dashboard-resultados/#detalhamento-e-faixas","version":"1.0.0"},{"title":"Datas, bases e pendências","anchor":"datas-bases-e-pendencias","text":"Vendas acumulam até hoje ou o fim do ciclo, o que vier primeiro. A base salva no ciclo seleciona a Data da venda ou a Data de pagamento das vendas/devoluções. Métricas representam resultados acumulados, sem histórico diário inventado. Metas não são proporcionalizadas ao dia. Ausência de resultado aprovado, meta válida ou regra compatível deixa uma pendência. Um grupo incompleto não apresenta pagamento parcial; outros grupos completos podem formar um subtotal conhecido. Total indisponível não equivale a zero. Percentual Padrão pode calcular sobre base pessoal completa mesmo que uma meta opcional esteja pendente. Ciclos futuros não antecipam pagamentos. Encerrados refletem dados atuais: o painel não é um fechamento imutável nem comprovação de liquidação.","links":[],"url":"/spm/manual/dashboard-resultados/#datas-bases-e-pendencias","version":"1.0.0"},{"title":"Acesso e disponibilidade","anchor":"acesso-e-disponibilidade","text":"O cálculo pode usar a base coletiva necessária para determinar a remuneração própria sem revelar operações dos demais. Filtros de apresentação não alteram a fórmula contratada. Bases coletivas e faixas derivadas podem ficar ocultas para acessos restritos.","links":[],"url":"/spm/manual/dashboard-resultados/#acesso-e-disponibilidade","version":"1.0.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"Web e aplicativo oferecem a consulta. No web, Exportar resumo exige permissão e inclui resumo/detalhe selecionado, não todas as pessoas paginadas. Corrigir configuração exige acesso ao Gerenciador; pagar exige a operação e autorização próprias.","links":[],"url":"/spm/manual/dashboard-resultados/#disponibilidade","version":"1.0.0"}]},{"id":"dashboard-tarefas","title":"Dashboard de Tarefas","summary":"Diferencie pendências acumuladas, conclusões do período e ocorrências programadas.","module":"Dashboards","version":"1.1.1","publication":"public","channels":["web","mobile"],"keywords":["tarefas","pendentes","programadas","concluídas","categorias"],"related":["tarefas-operacao","tarefas-configuracao","recorrencia"],"supportScope":["tarefa","rotina","recorrência","checklist","missão","atividade"],"url":"/spm/manual/dashboard-tarefas/","markdownUrl":"/spm/manual/dashboard-tarefas.md","sections":[{"title":"Introdução","anchor":"","text":"Dashboards → Tarefas combina tarefas avulsas e previsões recorrentes do alcance autorizado. Use o filtro de Período; o filtro refina datas, colaborador e vínculos organizacionais disponíveis.","links":[],"url":"/spm/manual/dashboard-tarefas/","version":"1.1.1"},{"title":"Indicadores","anchor":"indicadores","text":"Indicador Definição Pendentes Tarefas disponíveis e abertas na referência, incluindo saldo de dias anteriores. Concluídas Encerramentos por conclusão dentro do período até a referência. Canceladas Cancelamentos no mesmo intervalo, mesmo que a tarefa tenha começado antes. Programadas Ocorrências e avulsas disponíveis após a referência, dentro do período escolhido. Disponibilizadas Tarefas que se tornaram disponíveis dentro do período até a referência. Tempo médio até concluir Dias entre disponibilidade e conclusão, em média, das tarefas concluídas no período. A referência é hoje ou o fim do período, o que vier primeiro, no calendário de São Paulo. Não compare conclusões do período com pendências acumuladas como se fossem a mesma população.","links":[],"url":"/spm/manual/dashboard-tarefas/#indicadores","version":"1.1.1"},{"title":"Categorias, evolução e atenção","anchor":"categorias-evolucao-e-atencao","text":"No web, a Visão das tarefas destaca pendências acumuladas, conclusões do período, disponibilizações, pendências de dias anteriores e próximas programações. A barra distribui as pendências pela idade: disponíveis na referência, 1–7 dias, 8–30 dias e 31+ dias. Essas faixas não se sobrepõem. Demanda e entregas compara disponibilizações e conclusões em até 12 intervalos. O saldo indica quanto o estoque pendente cresceu ou diminuiu entre o início do período e a referência. Em intervalos inteiramente futuros, esse saldo não é calculado. Cancelamentos, pendências iniciais, tempo médio até concluir, ausência de responsável e aprovações ficam recolhidos em Detalhes da rotina. Rotina por responsável reúne pendentes e antigas na referência, mais disponibilizadas, concluídas e canceladas no período. Não aparece na visão individual. As categorias mostram volume pendente, antigas e conclusões. Pendências mais antigas apresenta até cinco ocorrências, com disponibilidade e idade; o calendário apresenta próximas programações quando existem. Disponibilidade utiliza a abertura ou previsão, a mais recente, salvo encerramento real anterior à previsão. Previsão não é presumida como prazo obrigatório de entrega. Conclusões posteriores à referência são tratadas como abertas naquela consulta histórica.","links":[],"url":"/spm/manual/dashboard-tarefas/#categorias-evolucao-e-atencao","version":"1.1.1"},{"title":"Execução dos checklists no web","anchor":"execucao-dos-checklists-no-web","text":"O card separa Pendentes na referência de Concluídas no período. Cada grupo mostra a tarefa, o responsável, o número de ocorrências e os itens realizados. Abra o grupo para conferir cada atividade: Marcação: quantidade realizada sobre quantidade de itens disponíveis. Contagem: quantidade registrada com o nome da atividade. Contatos, documentos e outras atividades não são somados entre si. Somente ocorrências da mesma versão de agenda, com responsável, categoria, nome da tarefa e estrutura do checklist equivalentes, são agrupadas. Avulsas ficam separadas. Cada página mostra até cinco grupos; a paginação permite consultar os demais. A exportação inclui todos os grupos do recorte. As recorrências ainda não registradas contribuem com os itens previstos e resultado zero. Uma ocorrência registrada substitui sua previsão, inclusive após mudança de responsável. Tarefas canceladas, inativas, em aprovação ou ainda indisponíveis não entram nos resultados dos checklists. Os resultados das concluídas são os valores finais das tarefas encerradas no período, mesmo que parte do trabalho tenha ocorrido antes. Não representam um histórico dos incrementos feitos apenas dentro do filtro. O progresso das pendentes está disponível somente quando a referência é hoje. Consultas históricas mostram apenas checklists de tarefas concluídas até aquela referência: não existe histórico de cada alteração dos itens das tarefas abertas.","links":[],"url":"/spm/manual/dashboard-tarefas/#execucao-dos-checklists-no-web","version":"1.1.1"},{"title":"Recorrências e histórico","anchor":"recorrencias-e-historico","text":"As contagens reutilizam a agenda e suas revisões, incluindo quotas. Consultar não materializa tarefas. Uma ocorrência já registrada substitui sua previsão, inclusive quando inativa ou fora do filtro, impedindo duplicação. Nomes, categorias e responsáveis de tarefas materializadas refletem os dados armazenados atuais; não há uma fotografia completa de cada antiga edição desses campos. Esse limite é diferente do histórico de versões de oportunidades.","links":[],"url":"/spm/manual/dashboard-tarefas/#recorrencias-e-historico","version":"1.1.1"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"Consulta no web e no aplicativo, com módulo, permissão e responsáveis autorizados. Parceiros não herdam tarefas de colaboradores por vínculo à Performance. Esta reorganização é exclusiva do web; o aplicativo mantém a apresentação anterior. Exportar resumo fica no web, exige autorização própria e inclui carga, evolução, responsáveis, categorias, atividades dos checklists e programações. Ausência de dados não cria ocorrências; alterações na origem aparecem em nova consulta.","links":[],"url":"/spm/manual/dashboard-tarefas/#disponibilidade","version":"1.1.1"}]},{"id":"dashboard-vendas","title":"Dashboard de Vendas","summary":"Compare vendas e devoluções por competência, com evolução, atividade diária e metas disponíveis.","module":"Dashboards","version":"1.0.0","publication":"public","channels":["web","mobile"],"keywords":["vendas","ticket médio","devoluções","evolução","clientes","produtos"],"related":["vendas","metas","dashboard-competicao"],"url":"/spm/manual/dashboard-vendas/","markdownUrl":"/spm/manual/dashboard-vendas.md","sections":[{"title":"Introdução","anchor":"","text":"Dashboards → Vendas considera vendas e devoluções aprovadas. Na visão Performance, usa a Data da venda ou Data de pagamento salva no ciclo selecionado; na visão Período, usa a Data da venda. O resumo identifica a base. Sem Data de pagamento, uma venda não entra na segunda base. Em Período, a referência inicial é o mês atual de São Paulo.","links":[],"url":"/spm/manual/dashboard-vendas/","version":"1.0.0"},{"title":"Indicadores","anchor":"indicadores","text":"Indicador Cálculo Vendas Soma dos valores comerciais das vendas ativas no intervalo. Devoluções Soma dos registros de devolução do intervalo. Após devoluções Vendas menos devoluções. Quantidade de vendas Número de vendas, separado das devoluções. Ticket médio Valor bruto das vendas dividido pela quantidade; indisponível sem vendas. Gráficos e atividade diária usam vendas antes das devoluções. A barra de composição compara valores movimentados de vendas e devoluções sobre sua soma; não é uma taxa de devolução sobre vendas.","links":[],"url":"/spm/manual/dashboard-vendas/#indicadores","version":"1.0.0"},{"title":"Evolução e comparação","anchor":"evolucao-e-comparacao","text":"A evolução agrupa intervalos longos em até 62 pontos. Dias futuros sem registro ficam indisponíveis, sem queda fictícia a zero. Registros aprovados com data futura podem integrar o período e são identificados; nesse caso, o comparativo anterior fica indisponível. O comparativo usa o intervalo imediatamente anterior com duração equivalente aos dias decorridos do recorte. Variação percentual exige base anterior positiva. Atividade por dia da semana divide o valor pelos dias correspondentes já transcorridos, incluindo dias sem venda. O calendário diário aparece nos intervalos compatíveis. Melhor dia e dias com venda descrevem atividade, sem substituir o total líquido. Metas diárias, quando disponíveis, seguem as regras da Performance e do alcance, não uma divisão arbitrária do valor mensal.","links":[],"url":"/spm/manual/dashboard-vendas/#evolucao-e-comparacao","version":"1.0.0"},{"title":"Filtros, clientes e produtos","anchor":"filtros-clientes-e-produtos","text":"Pessoa, organização, cliente e produto refinam os registros autorizados. Opções vêm das vendas do intervalo, sem exigir que toda venda pertença a uma Performance. Dimensões desligadas deixam de oferecer seus cards e filtros. Clientes em destaque considera vendas com cliente vinculado. Produtos considera o valor dos itens vendidos, que pode diferir do valor comercial informado no pedido. Os cards mostram até quatro destaques e a quantidade de vendas com vínculo; não inferem dados ausentes. A tabela pagina dez registros por vez, mas o resumo considera todo o recorte. Padrão/cargo vê seu alcance pessoal; a exceção coletiva de Competição não se aplica aqui.","links":[],"url":"/spm/manual/dashboard-vendas/#filtros-clientes-e-produtos","version":"1.0.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"Consulta disponível no web e no aplicativo com permissão e módulo habilitado. Exportar resumo no web exige permissão própria e exporta resumo/série agregada; não representa exportação integral da tabela paginada. Atualizar a consulta reflete os registros atuais, sem gerar operações.","links":[],"url":"/spm/manual/dashboard-vendas/#disponibilidade","version":"1.0.0"}]},{"id":"home","title":"Home: novidades, manual e blog","summary":"Encontre informações do produto e acesse os guias sem confundir a Home com um painel de indicadores.","module":"Dashboards","version":"1.1.0","publication":"public","channels":["web","mobile"],"keywords":["home","início","novidades","blog","manual"],"related":["conta-e-perfil","configuracoes-do-produto"],"url":"/spm/manual/home/","markdownUrl":"/spm/manual/home.md","sections":[{"title":"Introdução","anchor":"","text":"Dashboards → Home reúne boas-vindas, novidades e conteúdo de ajuda. Não calcula indicadores da operação nem oferece filtros analíticos. A saudação utiliza o nome e a foto da conta, com iniciais quando não há foto disponível.","links":[],"url":"/spm/manual/home/","version":"1.1.0"},{"title":"Novidades e leitura","anchor":"novidades-e-leitura","text":"Use anterior/próxima para percorrer novidades; não há troca automática. Saiba mais abre a leitura no painel lateral. Essa leitura não cria nem altera cadastros. O card Manual e Ajuda → Manuais levam ao SPM. Nele, Abrir o manual do Askora apresenta os assuntos e a busca desta mesma documentação.","links":[],"url":"/spm/manual/home/#novidades-e-leitura","version":"1.1.0"},{"title":"Blog e atualização","anchor":"blog-e-atualizacao","text":"O web apresenta até quatro artigos recentes do catálogo público. Ler artigo abre a matéria e Ver tudo abre o blog. O catálogo pode permanecer em cache por 15 minutos; ao revalidar, os artigos anteriores continuam visíveis. Em falha temporária, pode ser preservado conteúdo de até 24 horas. Sem conteúdo disponível, use a opção de tentar novamente. Uma falha de imagem utiliza a capa de apoio; não significa que o artigo foi excluído. O blog é conteúdo editorial, não informação da sua empresa.","links":[],"url":"/spm/manual/home/#blog-e-atualizacao","version":"1.1.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"Home existe no web e no aplicativo, conforme permissão. Os links de conteúdo público utilizam o site do Askora. A Kora oferece suporte a dúvidas sobre o uso do produto, com base no manual. Ela não consulta nem modifica os registros da empresa. Veja Manual e suporte.","links":["/spm/manual/manual-e-suporte/#tirar-duvidas-com-a-kora"],"url":"/spm/manual/home/#disponibilidade","version":"1.1.0"}]},{"id":"documentos-configuracao","title":"Abas de Documentos","summary":"Cadastre abas, escolha tipos e datas e entenda a origem dos reembolsos em Pagamentos.","module":"Extensões","version":"1.1.0","publication":"public","channels":["web"],"keywords":["documentos","abas","reembolso","nota fiscal","previsão","pagamento"],"related":["configuracoes-documentos","documentos-operacao","pagamentos-configuracao"],"url":"/spm/manual/documentos-configuracao/","markdownUrl":"/spm/manual/documentos-configuracao.md","sections":[{"title":"Introdução","anchor":"","text":"Em Extensões → Documentos → Abas, cadastre os grupos exibidos em Operações → Documentos. Configurar habilita o módulo; Abas organiza os tipos; nas Operações, registre documentos e envie arquivos. Ativar Documentos não aprova anexos nem gera pagamentos automaticamente.","links":[],"url":"/spm/manual/documentos-configuracao/","version":"1.1.0"},{"title":"Campos da aba","anchor":"campos-da-aba","text":"Abra o cadastro completo ou acrescente uma linha no cadastro rápido, preencha os campos e salve. Campo Opções, padrão e efeito Nome Obrigatório, até 150 caracteres. Ao selecionar um tipo de sistema com nome vazio, sugere Reembolsos ou Notas fiscais. Renomear não converte o tipo. Tipo de documento Documentos gerais (padrão), Reembolsos ou Notas fiscais. Fica bloqueado depois de salvar. Há no máximo uma aba de Reembolsos e uma de Notas fiscais por empresa, inclusive inativas. Data de pagamento Não (padrão) ou Sim, disponível apenas em Documentos gerais. Exibe a data informativa de pagamento na operação; não gera um pagamento. Em Reembolsos e Notas fiscais permanece desabilitado. Usar previsão Não (padrão) ou Sim, em qualquer tipo. Exibe uma data opcional de previsão no documento. Não substitui o vencimento calculado pela regra de Pagamentos. Disponibilidade Ativo (padrão) ou Inativo. Só abas ativas ficam disponíveis para novos registros operacionais. Inativar preserva o histórico. As abas são gerais da empresa, sem responsável ou organização próprios. Beneficiário e associações são informados nos documentos operacionais. Ocultar uma data não apaga os valores já gravados. O tipo da aba e o tipo dos registros antigos não são migrados ao renomear.","links":[],"url":"/spm/manual/documentos-configuracao/#campos-da-aba","version":"1.1.0"},{"title":"Tipos de documento e relação com Pagamentos","anchor":"tipos-de-documento-e-relacao-com-pagamentos","text":"Tipo Finalidade Documentos gerais Arquivos administrativos e registros diversos. Novos documentos não geram obrigação em Pagamentos . Reembolsos Cupons fiscais, recibos e comprovantes de despesas do beneficiário. Documento aprovado, em aba ativa e com anexo aprovado pode gerar a obrigação conforme a regra Reembolso de Pagamentos. Não exige uma nota fiscal separada. Notas fiscais Comprovação de pagamentos de modalidades que exigem nota. Apenas cadastrar ou aprovar uma nota não cria uma nova dívida; a cobertura depende do vínculo com a obrigação correspondente. Para gerar reembolsos, configure Gerenciador → Pagamentos → Configurar → Reembolso, incluindo Disponibilidade, Beneficiários, Início da apuração e Vencimento. A pessoa, o documento e seus vínculos precisam ser elegíveis. Consulte Reembolso e comprovantes.","links":["/spm/manual/pagamentos-reembolso/"],"url":"/spm/manual/documentos-configuracao/#tipos-de-documento-e-relacao-com-pagamentos","version":"1.1.0"},{"title":"Tabela e manutenção","anchor":"tabela-e-manutencao","text":"Filtros, seleção, paginação, edição, duplicação e cadastro rápido seguem as permissões de catálogo. Uma cópia precisa ser salva e não permite repetir um tipo de sistema já existente. Importação e exportação usam JSON dos campos da tabela; não transferem documentos ou anexos operacionais. Confira os registros já salvos antes de repetir um envio dividido em lotes.","links":[],"url":"/spm/manual/documentos-configuracao/#tabela-e-manutencao","version":"1.1.0"},{"title":"Permissões e disponibilidade","anchor":"permissoes-e-disponibilidade","text":"Configurar o módulo exige Master; manter abas exige as capacidades de Extensões. Consultar, registrar e aprovar documentos/anexos depende das permissões e do alcance próprios das operações. Um usuário sem aprovação pode enviar um documento pendente, sem que isso libere reembolso.","links":[],"url":"/spm/manual/documentos-configuracao/#permissoes-e-disponibilidade","version":"1.1.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"O cadastro das abas fica no web. O aplicativo utiliza as abas operacionais disponíveis, sem editor nativo das extensões.","links":[],"url":"/spm/manual/documentos-configuracao/#disponibilidade","version":"1.1.0"}]},{"id":"tarefas-configuracao","title":"Categorias, rotinas e responsáveis de Tarefas","summary":"Cadastre categorias, rotinas recorrentes, responsáveis e modelos de checklist.","module":"Extensões","version":"1.1.2","publication":"public","channels":["web"],"keywords":["tarefa","rotina","categoria","recorrência","checklist","responsável","missões","atividades"],"related":["configuracoes-do-produto","pipeline-configuracao","permissoes-e-escopos","configuracoes-tarefas"],"supportScope":["tarefa","rotina","recorrência","checklist","missão","atividade"],"url":"/spm/manual/tarefas-configuracao/","markdownUrl":"/spm/manual/tarefas-configuracao.md","sections":[{"title":"Introdução","anchor":"","text":"Extensões → Tarefas oferece Tarefas, Categorias e Responsáveis para definir rotinas. Configurar habilita o módulo; Operações → Tarefas acompanha ocorrências das rotinas e tarefas avulsas. Alterar um modelo não conclui suas execuções.","links":[],"url":"/spm/manual/tarefas-configuracao/","version":"1.1.2"},{"title":"Acompanhar atividades e missões dos vendedores","anchor":"acompanhar-atividades-e-missoes-dos-vendedores","text":"Use Tarefas para acompanhar atividades, objetivos de execução ou “missões” dos vendedores, incluindo oferecer produtos aos clientes, entrar em contato pelo WhatsApp (WPP) todo mês e registrar vendas diariamente. Cadastre uma rotina recorrente para cada atividade e responsável em Extensões → Tarefas → Tarefas, no web. Os vendedores acompanham as ocorrências e registram a conclusão em Operações → Tarefas no aplicativo, conforme acesso. O Askora oferece recorrência automática de tarefas; não é necessário cadastrar manualmente cada repetição. Para configurar, selecione uma Categoria existente ou cadastre uma em Extensões → Tarefas → Categorias e, na aba Tarefas, abra o cadastro completo, preencha Nome, Categoria, Responsável e Recorrência, mantenha Status → Ativo e salve. Categoria é obrigatória e pode ser reutilizada em várias rotinas; não é necessário criar três categorias. Organização/Suborganização são opcionais quando habilitadas. O modelo recorrente não tem campo Descrição nem Previsão; instruções podem ser incluídas na Descrição dos itens do Checklist, no cadastro completo. Confira as condições de acesso dos responsáveis. Atividade a acompanhar Configuração da rotina Atualizar as vendas diariamente Recorrência Diária, uma ocorrência por dia para o vendedor responsável. Registrar a venda é uma ação separada; concluir a tarefa não lança vendas automaticamente. Entrar em contato com clientes todo mês Recorrência Mensal e Dia do mês, de 1 a 31. A ocorrência permite conferir a atividade do vendedor; não envia mensagens no WhatsApp nem cria uma tarefa por cliente automaticamente. Oferecer produtos durante as vendas Se o controle desejado for uma conferência diária, use Diária; opcionalmente, um item Contador no Checklist registra quantas ofertas o vendedor informou. Não há geração automática de uma tarefa a cada venda. Se precisar de uma tarefa por atendimento, cadastre avulsas para os atendimentos. Cada rotina possui um responsável individual, selecionado entre colaboradores; o campo não aceita uma equipe ou vários vendedores. Para execução independente por vendedor, cadastre os modelos de cada pessoa; deixar Sem responsável não distribui cópias a todos. Metas da Performance medem resultados de indicadores; essas atividades são acompanhadas pela execução das tarefas. Checklist e conclusão registram o que foi informado, sem comprovar automaticamente que houve contato ou oferta de produto. No app, o vendedor abre a ocorrência em Tarefas, preenche o checklist quando houver e conclui a tarefa. As próximas ocorrências seguem a recorrência configurada, sem exigir recriar o modelo. A previsão no calendário não conclui a atividade: a execução é registrada pelo responsável. Modelos, categorias e responsáveis são configurados no web; o aplicativo executa as ocorrências autorizadas.","links":["/spm/manual/tarefas-configuracao/#associar-responsaveis"],"url":"/spm/manual/tarefas-configuracao/#acompanhar-atividades-e-missoes-dos-vendedores","version":"1.1.2"},{"title":"Cadastrar uma rotina","anchor":"cadastrar-uma-rotina","text":"No web, acesse Extensões → Tarefas → Tarefas. Com Tarefas habilitado pelo Master, cadastre a Categoria na aba Categorias. Na aba Tarefas, abra o cadastro completo pelo cabeçalho ou use o cadastro rápido. Preencha Nome, Categoria e Recorrência; confira Responsável e associações. No cadastro completo, acrescente itens na aba Checklist, se necessário. Salve o registro. Cancelar descarta as alterações do formulário. Campo Preenchimento e condições Nome Obrigatório; até 150 caracteres. Categoria Obrigatória; selecione uma categoria ativa. Uma categoria inativa pode permanecer no vínculo histórico, mas não pode ser atribuída a uma nova tarefa. Responsável Um colaborador ativo, ou Sem responsável. Não é seleção de vários executores nem de parceiros. Organização e Suborganização Opcionais quando habilitadas globalmente. Todas representa ausência de vínculo específico; uma suborganização exige sua organização pai. Status Ativo ou Inativo; padrão Ativo. Controla a disponibilidade do modelo, não a conclusão de uma ocorrência. Recorrência Define quando e quantas execuções ficam disponíveis; começa Diária. Veja as opções em Recorrência. As seções de associações aparecem conforme os campos disponíveis. Uma rotina sem responsável não distribui automaticamente cópias a todos os colaboradores. Permissões, associação ao workflow e alcance limitam quem pode consultar ou executar suas ocorrências.","links":["/spm/manual/tarefas-configuracao/#recorrencia"],"url":"/spm/manual/tarefas-configuracao/#cadastrar-uma-rotina","version":"1.1.2"},{"title":"Categorias e Kanban","anchor":"categorias-e-kanban","text":"Em Categorias, preencha Nome obrigatório, até 150 caracteres; Organização e Suborganização opcionais, conforme a configuração global; e Status, Ativo por padrão ou Inativo. Categoria é obrigatória nas tarefas e não possui interruptor próprio para desabilitar seu uso. No Kanban operacional, as categorias formam as colunas, na ordem alfabética do cadastro. Não existe campo Ordem para reorganizá-las como os status do Pipeline. Uma categoria inativa pode continuar visível quando há tarefas vinculadas, sem liberar novos vínculos. Inativar preserva os registros históricos.","links":[],"url":"/spm/manual/tarefas-configuracao/#categorias-e-kanban","version":"1.1.2"},{"title":"Recorrência","anchor":"recorrencia","text":"Tipo de recorrência Campos e comportamento Diária Uma ocorrência por dia; sem complemento. É o padrão. Semanal Dia da semana: Segunda-feira a Domingo. O formulário inicialmente sugere Segunda-feira. Mensal Dia do mês de 1 a 31; sugestão inicial Dia 1. Em mês mais curto, usa o último dia. Anual Uma ocorrência na data de início da agenda a cada ano. Não há seletor separado de mês/dia. Ajusta ao último dia quando a data não existe naquele ano. Personalizada A cada: inteiro de 1 a 999, inicialmente 1; Unidade do período: Dias, Semanas, Meses ou Anos, inicialmente Dias. Em Semanas, Dia da semana pode ser Dia do início ou Segunda-feira a Domingo. X vezes por semana Quantidade no período: inteiro de 1 a 999, inicialmente 1. Toda a quantidade fica disponível na segunda-feira, ou no início da primeira vigência. X vezes por mês Quantidade no período: inteiro de 1 a 999, inicialmente 1. Toda a quantidade fica disponível no primeiro dia do mês, ou no início da primeira vigência. X vezes por semana/mês não distribui as execuções ao longo dos dias. Três vezes por semana disponibiliza três ocorrências no mesmo dia de abertura do período. Essas opções são diferentes de Personalizada → A cada 3 Semanas, que produz uma ocorrência a cada três semanas. A agenda começa no dia de criação, pelo calendário de São Paulo; não há campo de data inicial/final no cadastro da rotina. Em Personalizada com semanas e dia específico, a primeira ocorrência usa esse dia a partir do início. Meses/anos preservam a referência original, ajustando meses mais curtos, sem redistribuição por dias úteis ou feriados. Alterar recorrência ou Status reinicia a referência da agenda na data da edição. Alterações geram revisões de vigência; execuções já materializadas e seu histórico são preservados. Mudar Nome ou associações, sem mudar a recorrência, conserva a referência do calendário. Não use a edição do modelo para reescrever ocorrências concluídas.","links":[],"url":"/spm/manual/tarefas-configuracao/#recorrencia","version":"1.1.2"},{"title":"Checklist da rotina","anchor":"checklist-da-rotina","text":"No cadastro completo, abra Checklist e use Adicionar item. Cada item tem Nome, obrigatório até 150 caracteres; Descrição, opcional até 4.000; e Tipo, Marcação ou Contador, inicialmente Marcação. Remover item retira o item do modelo em edição. Há até 100 itens, exibidos em páginas de oito. Salve o cadastro para aplicar. Marcação registra concluído/não concluído. Contador registra quantidade inteira de zero a 999.999, que pode ser aumentada ou corrigida durante a execução. No modelo não há quantidade inicial editável, meta de contagem, mínimo obrigatório nem configuração de conclusão automática. Cada ocorrência começa com sua própria lista zerada; a tarefa pode ser encerrada mesmo com checklist incompleto. Alterar o modelo afeta sua agenda, preservando as execuções já registradas. O editor não aparece em Categorias nem no cadastro rápido. Checklist detalha atividades de uma ocorrência; não cria novas tarefas ou responsáveis automaticamente.","links":[],"url":"/spm/manual/tarefas-configuracao/#checklist-da-rotina","version":"1.1.2"},{"title":"Associar responsáveis","anchor":"associar-responsaveis","text":"O Master abre Extensões → Tarefas → Responsáveis, adiciona uma linha, seleciona Colaborador responsável ativo ainda não associado e salva. A associação permite participar de Tarefas, mas não cria login ou concede permissões. Esse vínculo se limita a Tarefas; não seleciona participantes nem libera indicadores ou comissionamento de uma Performance. O campo Responsável de cada tarefa define sua atribuição individual; associar alguém ao workflow não o atribui a todas as rotinas. Nome, E-mail, Nível de acesso e Status são informações de leitura vindas de Pessoas. A tabela permite filtrar, exportar JSON e remover a associação com confirmação, preservando a pessoa e o histórico. Não há importação nem edição dos dados pessoais nesta aba. Salve ou cancele as associações antes de sair.","links":[],"url":"/spm/manual/tarefas-configuracao/#associar-responsaveis","version":"1.1.2"},{"title":"Duplicação, arquivos e permissões","anchor":"duplicacao-arquivos-e-permissoes","text":"Duplicar prepara outro cadastro para revisão e salvamento; não define recorrência e não transfere o histórico das ocorrências. Revise Responsável, Categoria e Recorrência da cópia. Limitação atual: duplicar um modelo com checklist salvo conserva identificadores dos itens e pode impedir o salvamento da cópia. Nesse caso, cancele a cópia e crie um novo modelo, cadastrando seu checklist no formulário completo. Uma rotina recorrente gera execuções conforme sua agenda; duplicar cria mais um modelo independente. Tarefas e Categorias oferecem filtros, seleção, cadastro rápido, edição e importação/exportação JSON. Checklist não faz parte dos campos exportados da tabela e precisa ser mantido no cadastro completo. Os arquivos mantêm os complementos da recorrência; use o conjunto completo. A importação cria registros, sem reutilizar identidades como atualização automática. Cada lote enviado é transacional; envios distintos não são uma única transação. Extensões, Operações e Dashboard exigem permissões próprias; também se aplicam o alcance e a associação dos colaboradores ao workflow. Ter acesso ao Pipeline não concede acesso a Tarefas. Fechamentos podem impedir mudanças em agendas que afetem períodos protegidos.","links":[],"url":"/spm/manual/tarefas-configuracao/#duplicacao-arquivos-e-permissoes","version":"1.1.2"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"A extensão fica no web. O aplicativo permite execução de tarefas autorizadas, sem editor nativo dos modelos, categorias e responsáveis.","links":[],"url":"/spm/manual/tarefas-configuracao/#disponibilidade","version":"1.1.2"}]},{"id":"pipeline-configuracao","title":"Etapas, campos e responsáveis do Pipeline","summary":"Defina etapas, campos e responsáveis antes de acompanhar oportunidades.","module":"Extensões","version":"1.2.2","publication":"public","channels":["web"],"keywords":["pipeline","status","campos","responsáveis","oportunidade","valor","permanente"],"related":["configuracoes-do-produto","permissoes-e-escopos","configuracoes-pipeline","pipeline-operacao"],"supportScope":["pipeline","oportunidade","funil","valor personalizado","campo moeda"],"url":"/spm/manual/pipeline-configuracao/","markdownUrl":"/spm/manual/pipeline-configuracao.md","sections":[{"title":"Introdução","anchor":"","text":"Em Extensões → Pipeline, as abas Status, Campos e Responsáveis estruturam as oportunidades da empresa. Configurar habilita o módulo; Operações → Pipeline cadastra e acompanha oportunidades usando essas definições. Não há associação com ciclo de Performance nesta extensão.","links":[],"url":"/spm/manual/pipeline-configuracao/","version":"1.2.2"},{"title":"Preparar a jornada","anchor":"preparar-a-jornada","text":"Com Pipeline habilitado pelo Master, abra Status e revise as etapas. Em Campos, cadastre as informações adicionais e confira Uso na operação. O Master associa os colaboradores em Responsáveis. Use as definições em Operações → Pipeline. Extensões, Operações e Dashboard têm permissões independentes. Para colaboradores sujeitos à associação de responsáveis, permissão e associação são requisitos conjuntos. Manter etapas e campos exige permissão para a página; habilitar o módulo e administrar Responsáveis exige Master.","links":[],"url":"/spm/manual/pipeline-configuracao/#preparar-a-jornada","version":"1.2.2"},{"title":"Status","anchor":"status","text":"Campo Opções e regras Nome Obrigatório, até 150 caracteres. Pode ser alterado inclusive nos três status fixos. Etapa da jornada Em andamento para etapas intermediárias; Saída ganha para sucesso; Saída perdida para encerramento sem sucesso. Entrada é reservada ao status fixo inicial. Ordem Inteiro de 1 a 99; em novos cadastros, a ausência de valor usa a próxima ordem sugerida. Define a posição das colunas do Kanban, da esquerda para a direita. Empates usam uma ordenação estável por identidade do cadastro. Disponibilidade Ativo ou Inativo; padrão Ativo. Os três status fixos exibem Permanente e não permitem mudar sua disponibilidade. Entrada, Ganha e Perdida existem como status fixos. Apenas o Nome pode ser editado: tipo, ordem e disponibilidade são protegidos. Não podem ser duplicados nem inativados. Renomear Ganha não muda sua classificação de Saída ganha. Há até 20 status, contando fixos, ativos e inativos. Etapas novas começam em Em andamento; também podem representar saídas ganhas ou perdidas. Inativar uma etapa adicional preserva seus vínculos e não libera outra vaga. Disponibilidade é o estado do cadastro da etapa, não o resultado de uma oportunidade.","links":[],"url":"/spm/manual/pipeline-configuracao/#status","version":"1.2.2"},{"title":"Campos fixos e personalizados","anchor":"campos-fixos-e-personalizados","text":"Nome, Valor, Criação, Previsão, Descrição e Status são os seis campos fixos: não podem ser editados, duplicados, inativados ou excluídos nesta extensão. São parte permanente da estrutura; Valor, Criação, Previsão e Descrição continuam opcionais no preenchimento da oportunidade. Valor já existe como campo monetário nativo, com Obrigatório = Não e Disponibilidade = Permanente. Não é preciso criar um personalizado Moeda para informar o valor da oportunidade ou utilizar as bases monetárias da Performance. O valor é preenchido em Operações → Pipeline. Se um campo antigo aparecer como Valor (personalizado #...) ou o nativo tiver ficado vazio, consulte Valores anteriores à adoção do campo nativo: a preservação do personalizado e a cópia inicial têm condições próprias. Além dos fixos, há até 20 campos configuráveis, incluindo os campos com associação e os inativos. Campo do editor Opções e regras Tipo de campo Sem associação ou Com associação. Não muda depois de salvar. Tipo de dado Para Sem associação: Texto, Número ou Moeda. Texto é o padrão. Não muda depois de salvar. Nome Para Sem associação: obrigatório, até 150 caracteres e editável posteriormente. Para Com associação, é definido pela origem. Associar a Para Com associação: Organização, Suborganização, Cliente, Produto ou Vendas. Selecione a origem, não um registro específico. Obrigatório Não ou Sim; começa Não no campo sem associação. Nos campos associados é Sim, bloqueado para edição. A exigência só atua quando o campo está disponível na operação. Ordem Inteiro de 1 a 99; organiza a apresentação dos campos. Não transforma um campo em etapa do Kanban. Disponibilidade Ativo ou Inativo; padrão Ativo para os configuráveis. Campos fixos exibem Permanente. Origem Leitura: Campo fixo, Personalizado ou nome da associação. Uso na operação Indicador de leitura. Distingue campo ativo, módulo inativo, origem inativa e integração futura; antes de salvar, informa Após salvar. Um campo personalizado acrescenta informação à oportunidade; não cria uma coluna do Kanban. O tipo Moeda não transforma seu valor em venda e não altera os cálculos da Performance.","links":["/spm/manual/pipeline-operacao/#valor-da-oportunidade","/spm/manual/pipeline-operacao/#valores-anteriores-a-adocao-do-campo-nativo"],"url":"/spm/manual/pipeline-configuracao/#campos-fixos-e-personalizados","version":"1.2.2"},{"title":"Dependências das associações e integração com Vendas","anchor":"dependencias-das-associacoes-e-integracao-com-vendas","text":"Cada origem só pode ser cadastrada uma vez, mesmo se o campo existente estiver inativo; o seletor indica já cadastrado. Organização, Suborganização, Cliente e Produto dependem da disponibilidade dos cadastros de origem. O campo Suborganização também exige o campo Organização ativo; inativar Organização inativa Suborganização. Desligar a origem preserva a definição, mas a indicação Uso na operação mostra sua indisponibilidade. Escolher um cliente ou produto concreto acontece no registro operacional. Vendas aparece no seletor, com nome de campo Venda, mas permanece Preparado para integração futura: ganhar uma oportunidade não gera uma venda automaticamente.","links":[],"url":"/spm/manual/pipeline-configuracao/#dependencias-das-associacoes-e-integracao-com-vendas","version":"1.2.2"},{"title":"Associar responsáveis","anchor":"associar-responsaveis","text":"Em Extensões → Pipeline → Responsáveis, o Master usa o cadastro rápido, escolhe Colaborador responsável e salva. Só colaboradores ativos, ainda não associados, aparecem para nova associação. Não é possível repetir a pessoa. Não se cadastra um parceiro ou novo colaborador nesta aba. A tabela mostra Nome, E-mail, Nível de acesso e Status, com filtros e oito linhas por página. Esses dados vêm de Pessoas e não são editados aqui. Remover associação pede confirmação e preserva o cadastro do colaborador; sua habilitação no workflow é retirada, sem apagar oportunidades históricas. Associar não cria login nem concede permissões. Há exportação JSON dos responsáveis filtrados, sem importação, duplicação ou edição dos dados pessoais. Salve ou cancele as associações pendentes antes de sair da aba.","links":[],"url":"/spm/manual/pipeline-configuracao/#associar-responsaveis","version":"1.2.2"},{"title":"Edição, arquivos e erros","anchor":"edicao-arquivos-e-erros","text":"Status e Campos oferecem cadastro completo/rápido, filtros, seleção, edição e inativação dos registros permitidos. Duplicar prepara novos cadastros para revisar e salvar; os fixos permanecem protegidos. Salvar valida o lote enviado; Cancelar descarta os rascunhos. Importar/exportar usa JSON da aba. Campos exporta apenas os configuráveis, sem os seis fixos. A importação cria registros, sem restaurar identidades ou atualizar automaticamente os existentes. Confira limites, nomes, associação já cadastrada e dependências; as restrições dos fixos também valem para edição em lote e arquivos.","links":[],"url":"/spm/manual/pipeline-configuracao/#edicao-arquivos-e-erros","version":"1.2.2"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"O Gerenciador e os arquivos ficam no web. O aplicativo utiliza as definições nas operações autorizadas, sem editor nativo de Status, Campos ou Responsáveis.","links":[],"url":"/spm/manual/pipeline-configuracao/#disponibilidade","version":"1.2.2"}]},{"id":"atribuicoes","title":"Atribuições: clientes, organizações e produtos","summary":"Mantenha clientes, organizações, suborganizações e produtos em uma página, com configuração conjunta.","module":"Gerenciador","version":"1.0.0","publication":"public","channels":["web"],"keywords":["Atribuições","Clientes","Organizações","Suborganizações","Produtos","carteira de clientes"],"related":["organizacoes","produtos","configuracoes-organizacoes","configuracoes-produtos","pessoas-cargos-e-acessos"],"url":"/spm/manual/atribuicoes/","markdownUrl":"/spm/manual/atribuicoes.md","sections":[{"title":"Introdução","anchor":"","text":"Abra Gerenciador → Atribuições. As abas Clientes, Organizações e Produtos reúnem esses cadastros. Clientes saiu de Pessoas; Organizações e Produtos passaram a ser abas desta página. Os registros, IDs e vínculos existentes são preservados.","links":[],"url":"/spm/manual/atribuicoes/","version":"1.0.0"},{"title":"Configurar","anchor":"configurar","text":"O Master abre Configurar em Atribuições. Ative Usar Clientes, Usar Organizações e Usar Produtos conforme necessário. Responsável pelo cliente depende de Clientes; Usar Suborganizações depende de Organizações. Salvar aplica o conjunto; Cancelar descarta as alterações. Desativar preserva os cadastros e seus vínculos históricos.","links":[],"url":"/spm/manual/atribuicoes/#configurar","version":"1.0.0"},{"title":"Cadastrar e editar","anchor":"cadastrar-e-editar","text":"Selecione a aba desejada e use o botão de cadastro ou as ações da tabela. Em Clientes, informe o nome e as associações disponíveis. Em Organizações, as abas secundárias permitem consultar as suborganizações de cada organização. Em Produtos, mantenha nome, valor e associações. As permissões e os escopos dos cadastros continuam sendo respeitados.","links":[],"url":"/spm/manual/atribuicoes/#cadastrar-e-editar","version":"1.0.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"A página e sua configuração estão disponíveis no web. O aplicativo continua usando esses cadastros nas seleções operacionais autorizadas. Links anteriores de Clientes, Organizações e Produtos abrem o destino correspondente em Atribuições. No Gerenciador, Pessoas vem antes de Performance e Atribuições; Pagamentos e Fechamento encerram o menu. Em Operações, Pagamentos fica na penúltima posição e Liberações na última. As configurações são organizadas em três seções: Organização (Usar Organizações e Usar Suborganizações), Cliente (Usar Clientes e Responsável pelo cliente) e Produto (Usar Produtos). Cada seção reúne seus controles.","links":[],"url":"/spm/manual/atribuicoes/#disponibilidade","version":"1.0.0"}]},{"id":"performance","title":"Cadastrar e duplicar uma Performance","summary":"Estruture o ciclo, período, atribuição e etapas de configuração, com rascunhos, prévia e duplicação revisável.","module":"Gerenciador","version":"1.2.0","publication":"public","channels":["web"],"keywords":["performance","ciclo","período","cadastro","rascunho","atribuição","duplicação"],"related":["performance-participantes","performance-bases-de-calculo","remuneracao-e-premios","metas","competicoes-e-premiacoes","configuracoes-performance"],"url":"/spm/manual/performance/","markdownUrl":"/spm/manual/performance.md","sections":[{"title":"Introdução","anchor":"","text":"Uma Performance reúne período, participantes, indicadores, regras de comissionamento e bônus, metas e competições. Gerenciador → Performance define as regras do ciclo; as Operações fornecem os registros elegíveis; os Dashboards exibem seus resultados. Cadastrar uma regra não registra uma venda nem executa um pagamento.","links":[],"url":"/spm/manual/performance/","version":"1.2.0"},{"title":"Criar o ciclo","anchor":"criar-o-ciclo","text":"Com Performance habilitada e acesso autorizado, abra Gerenciador → Performance → Performance no cabeçalho. Em Dados Gerais, informe Início e Fim, revise o Nome da performance e a Atribuição e selecione os participantes. Configure Comissionamento e/ou Bônus, Metas e Competição conforme a necessidade. Use Pré-visualizar resultados para testar os cálculos compatíveis, sem gravar operações. Use Salvar performance para concluir ou Salvar rascunho para continuar depois. Campo ou etapa Padrão, opções e condições Nome da performance Pré-preenchido como De: mmm/AA Até: mmm/AA, editável e com até 150 caracteres. Se vazio, usa o período ao salvar. Início e Fim Sem data preenchida no novo cadastro. Obrigatórios para concluir; Fim não pode ser anterior ao Início. Delimitam o intervalo inclusivo das fontes elegíveis. Atribuição Novos cadastros começam em Única. O campo aparece somente com Organizações e/ou Cargos ativos. Organização, Suborganização e Cargo aparecem apenas quando seus recursos estão habilitados; Personalizada permite escolhas por seção. Define agrupamento das regras, não quem participa automaticamente. Base de cálculo para resultados Data da venda ou Data de pagamento. Com a opção de data de pagamento ativa, ela vem selecionada em novos ciclos; caso contrário, o padrão é Data da venda. Colaboradores e Parceiros Tipos e seleções conforme Pessoas; o cadastro pronto exige pelo menos um participante. Login não é requisito para participar. Comissionamento e Bônus Comissionamento começa habilitado e Bônus desabilitado. Mantenha ao menos uma dessas abas; cada uma possui grupos, indicadores e regras próprios. Metas e Competição Começam habilitadas, podendo ser retiradas conforme as dependências das regras. Um ciclo pronto e ativo não pode sobrepor outro pronto e ativo da mesma empresa. Rascunhos podem ter período ou participantes incompletos; nome, valores, referências preenchidas e regras estruturais continuam sujeitos a validação. Salvar não garante que já existam resultados aprovados e metas positivas para apurar.","links":[],"url":"/spm/manual/performance/#criar-o-ciclo","version":"1.2.0"},{"title":"Atribuição e grupos","anchor":"atribuicao-e-grupos","text":"Única usa uma configuração geral por tipo de participante. Organização, Suborganização ou Cargo separam os grupos pelos vínculos guardados no ciclo; exigem o recurso e as associações compatíveis. A escolha central orienta Comissionamento, Bônus, Metas e Competição, tanto para colaboradores quanto para parceiros. Personalizada permite escolher a atribuição de cada seção e público. Atribuição é diferente de distribuição de metas: uma meta individual pode aparecer agrupada por cargo e continuar individual. Mudar a atribuição pode reconstruir grupos e metas incompatíveis; confira a confirmação antes de aplicar. Desativar um grupo preserva suas definições.","links":[],"url":"/spm/manual/performance/#atribuicao-e-grupos","version":"1.2.0"},{"title":"Atribuição e base","anchor":"atribuicao-e-base","text":"O seletor Base de cálculo para resultados aparece quando Usar data de pagamento nas vendas está ativo ou ao editar um ciclo que já usa Data de pagamento. A opção começa desligada; ativada, novos ciclos iniciam com Data de pagamento selecionada. A escolha salva no ciclo continua valendo depois de desligar a opção. Data da venda/Data de pagamento afeta Vendas e Faturamento. Métricas pertencem aos indicadores e participantes do ciclo. Consulte as fontes e datas da Performance.","links":["/spm/manual/performance-bases-de-calculo/"],"url":"/spm/manual/performance/#atribuicao-e-base","version":"1.2.0"},{"title":"Participantes e valores do ciclo","anchor":"participantes-e-valores-do-ciclo","text":"Novos ciclos não selecionam todas as pessoas automaticamente. Selecione individualmente ou use Filtro de colaboradores/parceiros com critérios explícitos. A seleção salva identifica os participantes; o filtro não cria inclusão automática de pessoas novas na duplicação. Os valores de remuneração dos colaboradores podem ser guardados e ajustados no próprio ciclo. Parceiros têm seleção e regras separadas. Consulte os participantes e seus valores para os campos, vínculos e controles disponíveis.","links":["/spm/manual/performance-participantes/#escolher-colaboradores-e-parceiros"],"url":"/spm/manual/performance/#participantes-e-valores-do-ciclo","version":"1.2.0"},{"title":"Estados, listagem e edição","anchor":"estados-listagem-e-edicao","text":"Disponibilidade Significado A definir Datas incompletas. Agendada Início futuro. Em andamento Hoje entre Início e Fim, inclusive. Encerrada Fim anterior a hoje. Essas classificações por data são diferentes de Status → Ativo/Inativo e Rascunho/Pronto. A lista separa Performances e Rascunhos, mostra oito registros por página e permite filtrar Nome, Início, Fim, Participantes, Disponibilidade e Status. Não possui cadastro rápido, importação/exportação ou edição em lote de ciclos. Editar abre o conjunto do ciclo; Excluir pede confirmação e inativa, preservando os dados. Cancelar e sair com alterações pendentes podem pedir confirmação para descartar. Salvar a tabela interna de metas ou valores ainda não substitui Salvar performance. Se outra sessão alterou o cadastro, reabra e confira a versão atual. Imagens de prêmios em processamento precisam terminar antes de salvar.","links":[],"url":"/spm/manual/performance/#estados-listagem-e-edicao","version":"1.2.0"},{"title":"Duplicar e revisar","anchor":"duplicar-e-revisar","text":"Duplicar permite revisar Início e Fim e usar Continuar para abrir a cópia em preparação. A seleção mantém somente colaboradores e parceiros ativos que pertenciam à origem. Não inclui pessoas novas por filtros antigos; o ciclo original conserva seus participantes e histórico. Se ninguém estiver ativo, a prévia manual orienta selecionar participantes antes de concluir. A sugestão começa após o fim anterior, preservando meses completos, quinzenas ou quantidade de dias conforme a duração original. Configurações e referências elegíveis são copiadas; vendas, resultados e pagamentos não são duplicados. A cópia só é gravada depois de revisar e salvar.","links":[],"url":"/spm/manual/performance/#duplicar-e-revisar","version":"1.2.0"},{"title":"Duplicação automática e limites","anchor":"duplicacao-automatica-e-limites","text":"O Master define a automação em Duplicar ciclos automaticamente. Ela também mantém apenas os participantes ativos da origem. Sem participantes elegíveis ou com referências inválidas, a execução informa erro; não gera um ciclo pronto vazio. O cadastro aceita até 100 grupos de remuneração e 5.000 metas por ciclo; cada grupo de remuneração possui seus limites de indicadores e faixas. A manutenção do ciclo depende das capacidades do Gerenciador e das proteções de fechamento. Consultar um dashboard não concede edição da Performance. Recursos desabilitados podem ocultar grupos históricos sem apagar suas configurações.","links":["/spm/manual/configuracoes-performance/#duplicar-ciclos-automaticamente"],"url":"/spm/manual/performance/#duplicacao-automatica-e-limites","version":"1.2.0"},{"title":"Pré-visualizar resultados","anchor":"pre-visualizar-resultados","text":"No rodapé do cadastro, Pré-visualizar resultados abre Simular resultados. Escolha Comissão ou Bônus e o Grupo ativo; preencha Resultado de cada indicador e Meta quando o modelo depende de atingimento. Remuneração variável aparece quando essa é a referência de pagamento. Use Calcular e confira Resultado da simulação, Configuração aplicada e Detalhamento do cálculo. A prévia usa a regra em edição, inclusive ainda não salva; não altera registros, resultados reais ou pagamentos. Alterar o cenário invalida o resultado anterior. No Score há um total único, com peso e faixa aplicada; não são pagamentos separados por indicador. Limitações da prévia: Em OTE percentual com meta compartilhada, a tela não permite informar separadamente resultado coletivo e base pessoal do pagamento; portanto a prévia não reproduz integralmente esse cenário. A apuração real mantém essas referências separadas.","links":[],"url":"/spm/manual/performance/#pre-visualizar-resultados","version":"1.2.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"O Gerenciador, os rascunhos e a simulação ficam no web. O aplicativo consulta resultados e indicadores autorizados, sem editor nativo de Performance. Apuração e baixas seguem as permissões próprias de Pagamentos. O campo Nome da performance fica sempre visível e é preenchido pelo período, por exemplo De: out/26 Até: nov/26. Você pode editar esse texto. Enquanto o nome segue o preenchimento automático, alterar as datas atualiza o nome; um texto personalizado é preservado. Se salvar o nome vazio, o sistema usa o período. Não existe opção de ativação desse campo.","links":[],"url":"/spm/manual/performance/#disponibilidade","version":"1.2.0"}]},{"id":"remuneracao-e-premios","title":"Comissionamento e bônus da Performance","summary":"Configure indicadores, bases e pagamentos e compreenda as transições entre Padrão, OTE e Score.","module":"Gerenciador","version":"1.4.0","publication":"public","channels":["web"],"keywords":["comissão","comissionamento","bônus","indicador","OTE","Score","remuneração","pagamento","Performance","calculadora","base de cálculo"],"related":["performance","performance-regras-de-calculo","performance-bases-de-calculo","metas","competicoes-e-premiacoes"],"url":"/spm/manual/remuneracao-e-premios/","markdownUrl":"/spm/manual/remuneracao-e-premios.md","sections":[{"title":"Introdução","anchor":"","text":"Em Gerenciador → Performance → criar ou editar, use Comissionamento e Bônus para cadastrar remuneração. Ambos utilizam a mesma calculadora oficial; mantêm indicadores, grupos, metas e pagamentos de origens separadas. Base fornece o resultado; indicador identifica o critério; regra transforma esse resultado em remuneração; Pagamentos gerencia a obrigação após a apuração elegível.","links":[],"url":"/spm/manual/remuneracao-e-premios/","version":"1.4.0"},{"title":"Configurar o grupo e os indicadores","anchor":"configurar-o-grupo-e-os-indicadores","text":"Para cadastrar comissão ou bônus, abra a Performance do período e siga o preenchimento: Selecione participantes em Dados Gerais e habilite Comissionamento e/ou Bônus. Escolha Colaboradores/Parceiros e o grupo, quando houver mais de uma opção. Com Atribuição Personalizada, escolha a Atribuição local: Única, Organização, Suborganização ou Cargo, conforme os recursos ativos. Nomeie cada indicador, escolha Tipo de comissão/bônus, Tipo de pagamento e Base de cálculo. Complete as regras/faixas e as metas exigidas; confira e salve a Performance. Comissão do Grupo ou Bônus do Grupo ativa/desativa a configuração do grupo quando o controle está disponível. Desativar conserva indicadores e faixas. Mudar a atribuição pede confirmação antes de retirar grupos e metas incompatíveis daquele público e origem; não redistribui automaticamente resultados de outras pessoas. Cada grupo admite até 50 indicadores. Nome do indicador aceita até 150 caracteres; começa Comissão/Bônus, com numeração nos adicionais. Adicionar indicador cria outro critério; Remover indicador pede confirmação e retira suas faixas e metas relacionadas do cadastro em edição. O último indicador não oferece remoção direta.","links":[],"url":"/spm/manual/remuneracao-e-premios/#configurar-o-grupo-e-os-indicadores","version":"1.4.0"},{"title":"Campos do indicador e bases de cálculo","anchor":"campos-do-indicador-e-bases-de-calculo","text":"Campo Opções e comportamento Tipo de comissão / Tipo de bônus Padrão ou OTE (On Target Earnings). Inicialmente Padrão; com vários indicadores, a escolha do primeiro orienta o modelo do grupo. Tipo de pagamento Percentual sobre base de cálculo; Definir valor de pagamento; Remuneração variável para colaboradores; Score em OTE. Percentual requer base monetária. Percentual sobre a base de cálculo (%) Em Padrão percentual, define o percentual aplicado diretamente à base. Sem regra de meta para esse pagamento. Valor do pagamento (R$) Em pagamento definido, fornece o valor-base que a regra ou faixa ajusta. Não significa valor já liberado em Pagamentos. Base de cálculo Vendas individuais do colaborador/parceiro, Faturamento total da performance ou Métricas. Tipo de métrica Com Métricas: Métrica de quantidade, Métrica de valor ou Métrica de percentual. Pagamento percentual restringe a escolha a Métrica de valor. Regra de pagamento Em Padrão com valor definido/variável, define condição ou proporcionalidade em relação à meta. Limitar progressão Não/Sim, somente em regra progressiva. Sim apresenta Limite de pagamento e Resultado de excelência (opcional). Peso do indicador (%) No Score; entre zero e 100 e soma de 100% no grupo. Mede contribuição ao atingimento composto, não um pagamento isolado. O primeiro indicador começa com Vendas individuais, pagamento percentual zero, sem progressão ou limite. Um adicional Padrão começa em Métrica de quantidade, com valor definido zero. Confira sempre a base e a unidade sugeridas. Na modalidade Remuneração variável, o pagamento-base vem do valor guardado para o colaborador no ciclo, sem outro campo monetário no indicador. Alterações posteriores em Pessoas ou Cargos não atualizam automaticamente esse valor no ciclo.","links":[],"url":"/spm/manual/remuneracao-e-premios/#campos-do-indicador-e-bases-de-calculo","version":"1.4.0"},{"title":"Referência da remuneração variável","anchor":"referencia-da-remuneracao-variavel","text":"A Remuneração variável utiliza o valor guardado para o colaborador na Performance. Para o significado, a origem e a precedência dos valores, consulte Remuneração fixa e variável. Confira o valor do ciclo ao revisar uma configuração; alterar a referência em Pessoas ou Cargos não recalcula automaticamente esse registro da Performance.","links":["/spm/manual/pessoas-cargos-e-acessos/#remuneracao-fixa-e-variavel"],"url":"/spm/manual/remuneracao-e-premios/#referencia-da-remuneracao-variavel","version":"1.4.0"},{"title":"Padrão, OTE e Score","anchor":"padrao-ote-e-score","text":"Padrão percentual aplica o percentual ao resultado monetário. Padrão com valor definido/variável usa uma das seis regras de pagamento em relação à meta, podendo ter progressão, teto e excelência. OTE Integral usa a última faixa de atingimento alcançada, sem interpolar; o percentual ou multiplicador vem da faixa. Em OTE percentual, Progressivo permite somar cada trecho com sua própria taxa. Consulte as regras da calculadora para interpretar condições e limites. OTE com múltiplos indicadores usa Score. Adicionar um segundo indicador OTE pede confirmação para transformar todos em OTE/Score. A conversão preserva nomes e bases, substitui pagamentos/faixas individuais pelos do grupo e redistribui pesos. Adicionar/remover indicadores de Score redistribui os pesos igualmente, com ajuste residual no último; revise antes de salvar. No Score, Pagamento do Score escolhe Definir valor de pagamento ou Remuneração variável do colaborador. Há uma única remuneração pelas faixas do grupo. Ao remover indicadores até restar um, o editor volta a OTE individual, reaproveitando pagamento e faixas do grupo. Alterar o primeiro indicador para Padrão é uma mudança de configuração que requer revisão, não uma conversão financeira de valores já pagos.","links":["/spm/manual/performance-regras-de-calculo/#regras-padrao"],"url":"/spm/manual/remuneracao-e-premios/#padrao-ote-e-score","version":"1.4.0"},{"title":"Faixas de progresso","anchor":"faixas-de-progresso","text":"Em OTE, cada card de Faixas de progresso separa o limite que libera a faixa do pagamento. Progresso de meta da faixa (%), no modo Meta, recebe o atingimento exigido; Percentual de comissão da faixa (%) ou Percentual de bônus da faixa (%) recebe a taxa paga. Com meta de R$ 100 mil, digite progresso 50 e comissão 1 para pagar 1% a partir de R$ 50 mil; progresso 100 e comissão 2 para pagar 2% a partir de R$ 100 mil. Os dois percentuais têm funções diferentes. Para preencher o limite diretamente na unidade do indicador, alterne Meta/Valor à direita do título Faixas de progresso, no card principal. Todas as faixas seguem essa escolha, inclusive as novas. Os campos são: Valor da faixa (R$), Quantidade da faixa ou Valor da faixa (%). O progresso equivalente aparece ao lado. Sem alvo preenchido, a maior faixa em Valor preenche a meta do indicador na distribuição individual ou compartilhada; metas manuais têm prioridade. Ao reabrir, o modo é Meta, usando os percentuais salvos. Confira conversão e edição das metas. OTE com valor-base utiliza Multiplicador de pagamento da faixa: pagamento-base de R$ 500 e multiplicador 1 pagam R$ 500 ao atingir a faixa. Portanto, OTE também admite valor definido, além de percentual sobre a base e Remuneração variável. No Score, as faixas ficam em Pagamento e faixas de progresso do Score e usam progresso por Meta. A primeira faixa começa em 100% e fator 1; em pagamento percentual, confira o percentual exibido. Adicionar faixa sugere dez pontos percentuais acima da maior existente e fator 1. Há até 100 faixas por conjunto; progressos devem ser únicos e valores não negativos. Uma regra OTE pronta exige ao menos uma faixa. Remover exige confirmação, e a última faixa não pode ser retirada pela ação da tela. No modo Integral, abaixo da primeira faixa o pagamento é zero; atingir exatamente um limiar aplica a faixa correspondente. Somente no OTE percentual, o botão da faixa 1 escolhe Integral ou Progressivo, refletido e bloqueado nas demais faixas. Integral aplica a taxa da última faixa atingida à base inteira. Progressivo aplica cada taxa ao seu trecho, começando em zero e continuando a última taxa sobre o excedente. Consulte exemplos do cálculo progressivo. As orientações estão nos ícones de informação; campos vazios não exibem erro só por alternar o modo de entrada.","links":["/spm/manual/performance-regras-de-calculo/#preencher-faixas-por-meta-ou-valor","/spm/manual/performance-regras-de-calculo/#ote-percentual-integral-ou-progressivo"],"url":"/spm/manual/remuneracao-e-premios/#faixas-de-progresso","version":"1.4.0"},{"title":"Metas, públicos e limitações","anchor":"metas-publicos-e-limitacoes","text":"Metas compartilham atingimento conforme sua distribuição; não tornam a comissão individual automaticamente coletiva. Padrão percentual não exige meta para remunerar. Regras que dependem de atingimento exigem meta habilitada, positiva e compatível; OTE/Score mantêm Metas e seus alvos habilitados e exigem meta positiva para concluir o cadastro. Zero pode permanecer em rascunho, mas impede o cálculo que depende dessa meta. Parceiros possuem regras próprias, mas não oferecem Remuneração variável. Cadastros anteriores podem mostrar % da remuneração fixa ou Regressivo até a meta como opções legadas. A calculadora atual exige revisão dessas modalidades antes de apurar; não são alternativas novas disponíveis. Um erro de regra não significa pagamento calculado como zero.","links":[],"url":"/spm/manual/remuneracao-e-premios/#metas-publicos-e-limitacoes","version":"1.4.0"},{"title":"Competição e prêmios","anchor":"competicao-e-premios","text":"Competição é outra etapa do ciclo: premia posição ou atingimento, enquanto Comissionamento e Bônus aplicam regras remuneratórias. Consulte tipos e critérios de competição. Apenas prêmios em dinheiro elegíveis podem integrar Pagamentos.","links":["/spm/manual/competicoes-e-premiacoes/#tipos-e-criterios"],"url":"/spm/manual/remuneracao-e-premios/#competicao-e-premios","version":"1.4.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"O cadastro e a edição ficam no web, sujeitos às permissões de Performance e aos períodos protegidos. Web e aplicativo exibem resultados autorizados; não há editor nativo dessas regras no aplicativo. O simulador não grava pagamentos e possui limitações para cenários compartilhados percentuais.","links":[],"url":"/spm/manual/remuneracao-e-premios/#disponibilidade","version":"1.4.0"}]},{"id":"pessoas-dados-de-recebimento","title":"Dados de recebimento: Pix e TED","summary":"Preencha titular, chave Pix ou conta TED de colaboradores e parceiros, com suas validações e permissões.","module":"Gerenciador","version":"1.0.0","publication":"public","channels":["web"],"keywords":["Pessoas","recebimento","Pix","TED","titular","CPF","CNPJ","banco","agência","chave","CNAB","split"],"related":["pessoas-cargos-e-acessos","pagamentos-configuracao"],"url":"/spm/manual/pessoas-dados-de-recebimento/","markdownUrl":"/spm/manual/pessoas-dados-de-recebimento.md","sections":[{"title":"Introdução","anchor":"","text":"Abra Gerenciador → Pessoas → Colaboradores ou Parceiros, edite o cadastro completo e localize Dados de recebimento em Informações principais. O bloco não aparece em Administradores, Clientes, Fornecedores, Cargos ou na edição isolada da aba Acessos. Cadastre primeiro o Documento da pessoa para que possa corresponder ao titular.","links":[],"url":"/spm/manual/pessoas-dados-de-recebimento/","version":"1.0.0"},{"title":"Forma de recebimento e titular","anchor":"forma-de-recebimento-e-titular","text":"Campo Opções e validações Forma de recebimento Não informado (inicial), Pix ou TED. O perfil é opcional; escolher Pix/TED exige preencher os respectivos dados. Depois de salvar um perfil, não é possível voltar a Não informado por esse seletor. Titular Obrigatório para Pix/TED, até 150 caracteres. Sugere o nome da pessoa na ausência de perfil anterior. CPF/CNPJ do titular Obrigatório, até 20 caracteres informados; deve corresponder ao Documento da pessoa, desconsiderando pontuação e diferenças de maiúsculas. Sugere o documento do cadastro. Salvar os dados da pessoa e do recebimento é uma única operação. A conferência de formato e correspondência não verifica titularidade bancária nem consulta uma instituição externa. Não confunda Documento opcional no cadastro geral com a exigência de titular ao configurar recebimento.","links":[],"url":"/spm/manual/pessoas-dados-de-recebimento/#forma-de-recebimento-e-titular","version":"1.0.0"},{"title":"Campos e tipos de chave Pix","anchor":"campos-e-tipos-de-chave-pix","text":"Com Forma de recebimento → Pix, preencha Tipo de chave e Chave Pix, obrigatória com até 150 caracteres. Tipo de chave Regra CPF Os números da chave devem corresponder ao documento do titular. CNPJ Os números da chave devem corresponder ao documento do titular. E-mail Exige formato de endereço de e-mail válido. Telefone com código do país Exige sinal + seguido de 8 a 15 dígitos, começando pelo código do país, sem espaços ou pontuação. Exemplo de formato: +5511999999999. Aleatória Exige formato UUID, com grupos de 8-4-4-4-12 caracteres hexadecimais separados por hífen. Selecionar Pix não cria chave no banco. Informe uma chave pertencente ao beneficiário e confira antes de utilizar os dados fora do Askora.","links":[],"url":"/spm/manual/pessoas-dados-de-recebimento/#campos-e-tipos-de-chave-pix","version":"1.0.0"},{"title":"Campos da conta TED","anchor":"campos-da-conta-ted","text":"Campo Obrigatoriedade e limite Código do banco Obrigatório, até 8 dígitos. Agência Obrigatória, até 10 dígitos. Dígito da agência Opcional, até 2 caracteres. Conta Obrigatória, até 20 dígitos. Dígito da conta Opcional, até 2 caracteres. Tipo de conta Corrente, Poupança ou Pagamento. Código do banco, Agência e Conta aceitam somente números e preservam zeros à esquerda. Os dígitos verificadores são campos separados. Os campos de TED aparecem somente ao selecionar TED; trocar a forma de recebimento não exige preencher os campos ocultos de Pix.","links":[],"url":"/spm/manual/pessoas-dados-de-recebimento/#campos-da-conta-ted","version":"1.0.0"},{"title":"Permissões, histórico e uso em Pagamentos","anchor":"permissoes-historico-e-uso-em-pagamentos","text":"Consultar segue o alcance e a permissão de visualização de Pessoas; alterar recebimento exige a capacidade de aprovação de Pessoas e acesso ao cadastro. Se outra sessão alterou o perfil, recarregue antes de salvar. As revisões anteriores são preservadas; salvar sem mudança no recebimento não cria uma revisão bancária. Esses dados identificam o destinatário nos processos de Pagamentos, mas não são obrigatórios para apurar obrigações nem para registrar pagamento realizado externamente. CNAB e Split estão indisponíveis para execução bancária na implementação atual; preencher Pix/TED não ativa essas integrações. Excel e PDF servem à conferência, sem transferir dinheiro.","links":[],"url":"/spm/manual/pessoas-dados-de-recebimento/#permissoes-historico-e-uso-em-pagamentos","version":"1.0.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"O editor de Dados de recebimento fica no web.","links":[],"url":"/spm/manual/pessoas-dados-de-recebimento/#disponibilidade","version":"1.0.0"}]},{"id":"fechamentos","title":"Fechar e reabrir períodos","summary":"Proteja períodos encerrados e entenda quais operações e vínculos precisam ser reabertos para correções.","module":"Gerenciador","version":"1.1.0","publication":"public","channels":["web"],"keywords":["fechamento","reabertura","período fechado","histórico","automação"],"related":["performance","pagamentos-configuracao","permissoes-e-escopos","configuracoes-fechamentos"],"url":"/spm/manual/fechamentos/","markdownUrl":"/spm/manual/fechamentos.md","sections":[{"title":"Introdução","anchor":"","text":"Gerenciador → Fechamento administra os bloqueios de períodos encerrados. Configurar define ativação e automação; Novo fechamento aplica um bloqueio; Reabrir período retira um bloqueio para permitir correções. As três ações e a consulta são exclusivas do Master.","links":[],"url":"/spm/manual/fechamentos/","version":"1.1.0"},{"title":"Fechar um período","anchor":"fechar-um-periodo","text":"Com Usar Fechamento habilitado, abra Novo fechamento. Escolha Período: Intervalo de datas ou Período da performance. Informe as datas ou selecione a Performance, marque os Módulos protegidos e preencha Justificativa. Use Salvar para abrir Confirmar fechamento. Confira Período, Módulos, Abrangência e os avisos de sobreposição. Confirme em Fechar período. Cancelar antes da confirmação não cria o fechamento. Campo Opções e validações Período Intervalo de datas é a seleção inicial; Período da performance usa um ciclo pronto, ativo e encerrado. Data inicial e Data final Obrigatórias em Intervalo de datas, entre 01/01/2000 e 31/12/2199. Inicial não pode ser posterior à Final; Final deve ser anterior a hoje. Performance Obrigatória em Período da performance. Usa o intervalo inteiro do ciclo escolhido; não restringe o bloqueio aos participantes ou registros vinculados àquele ciclo. Módulos protegidos Marque ao menos um: Vendas, Pipeline, Tarefas, Pagamentos, Documentos, Métricas ou Performance. Justificativa Obrigatória, de 10 a 1.000 caracteres. Registra o motivo e acompanha o histórico. O fechamento abrange toda a empresa, incluindo todas as organizações e suborganizações, inclusive registros sem associação com a Performance selecionada. Um envio com vários módulos cria um bloqueio por módulo. O mesmo módulo já fechado exatamente no intervalo é recusado; sobreposições parciais são avisadas e permanecem independentes. Confira as datas protegidas e as condições para consultar e reabrir.","links":["/spm/manual/fechamentos/#datas-protegidas","/spm/manual/fechamentos/#consultar-e-reabrir"],"url":"/spm/manual/fechamentos/#fechar-um-periodo","version":"1.1.0"},{"title":"Datas protegidas","anchor":"datas-protegidas","text":"Módulo Referência e alcance principal Vendas Data da venda e Data de pagamento e seus filhos/vínculos. Pipeline Criação e conclusão da oportunidade, histórico e checklist. Tarefas Criação e conclusão, checklist e vigência dos agendamentos. Pagamentos Competência, revisões, notas vinculadas, compensações, lotes e baixas. Documentos Data do documento e seus anexos. Métricas Intervalo da Performance associada. Performance Intervalo do ciclo, regras, metas, participantes e operações que afetam seus resultados. O bloqueio alcança inclusões, alterações, exclusões/inativações e aprovações que afetem as datas protegidas. Uma ação em outra tela também pode ser impedida quando repercute no período: vincular uma nota posteriormente pode exigir reabrir a competência de Pagamentos. Anexos e configurações que reinterpretam dados históricos podem ficar protegidos; não é um congelamento de todos os nomes, contatos e acessos. Referências antigas sem data podem exigir revisão conservadora do período. Reabrir apenas o módulo da tela de origem pode ser insuficiente quando o vínculo afeta outro módulo fechado.","links":[],"url":"/spm/manual/fechamentos/#datas-protegidas","version":"1.1.0"},{"title":"Consultar e reabrir","anchor":"consultar-e-reabrir","text":"Fechados mostra bloqueios ativos; Histórico permite consultar fechados e reabertos. O seletor Módulo oferece Todos os módulos ou um módulo específico. A tabela tem vinte registros por página e colunas Módulo, Período, Origem, Situação e Responsável. Origem distingue Manual, Mensal automático e Performance automática. Situação mostra Fechado ou Reaberto. A classificação legada Pipeline e Tarefas (anterior) pode aparecer no histórico/filtro; não é uma opção para novos fechamentos manuais. Em Detalhes, confira módulo, intervalo, situação, origem, Fechado por, Data e Justificativa. No fechamento ativo, preencha nova Justificativa de 10 a 1.000 caracteres e use Reabrir período. A versão atual é exigida; se outra sessão alterou o registro, atualize a página. O histórico passa a mostrar Reaberto por, Data da reabertura e Justificativa. Sobreposições são independentes: todos os bloqueios que abrangem uma correção precisam ser reabertos. Reabrir não altera os dados operacionais automaticamente. Depois de corrigir, crie um novo fechamento; o histórico não é editado nem apagado. Não há cadastro rápido, importação, exportação ou edição em lote nesta página. Desativar Usar Fechamento interrompe novos fechamentos e automação, mas não reabre períodos já fechados. Consulta e reabertura continuam disponíveis ao Master.","links":[],"url":"/spm/manual/fechamentos/#consultar-e-reabrir","version":"1.1.0"},{"title":"Automação","anchor":"automacao","text":"As modalidades, dias e vigência são definidos em Fechamento por módulo. Configurar uma regra é diferente de realizar Novo fechamento. Um período automático reaberto não é fechado novamente pela rotina. Depois da correção, crie um novo fechamento manual.","links":["/spm/manual/configuracoes-fechamentos/#fechamento-por-modulo"],"url":"/spm/manual/fechamentos/#automacao","version":"1.1.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"A administração fica no web. Os bloqueios valem também para aplicativo, importações e integrações. A ausência dessa tela no aplicativo não permite contornar um período fechado.","links":[],"url":"/spm/manual/fechamentos/#disponibilidade","version":"1.1.0"}]},{"id":"organizacoes","title":"Organizações e suborganizações","summary":"Organize unidades de trabalho e entenda como seus vínculos são usados em cadastros, operações e permissões.","module":"Gerenciador","version":"1.1.0","publication":"public","channels":["web"],"keywords":["organização","suborganização","unidade","documento","associação"],"related":["permissoes-e-escopos","configuracoes-organizacoes"],"url":"/spm/manual/organizacoes/","markdownUrl":"/spm/manual/organizacoes.md","sections":[{"title":"Introdução","anchor":"","text":"Organizações representam unidades que sua empresa deseja distinguir no Askora. Suborganizações detalham uma organização pai. Esses vínculos aparecem em outros cadastros e operações quando a configuração permite, e também podem restringir o alcance dos acessos administrativos.","links":[],"url":"/spm/manual/organizacoes/","version":"1.1.0"},{"title":"Preparar o módulo","anchor":"preparar-o-modulo","text":"Abra Gerenciador → Atribuições → Organizações. A disponibilidade de Organizações e Suborganizações é definida pelo Master nas Configurações de Organizações. Com o recurso habilitado, mantenha os cadastros nas abas do Gerenciador.","links":["/spm/manual/configuracoes-organizacoes/#usar-organizacoes-e-usar-suborganizacoes"],"url":"/spm/manual/organizacoes/#preparar-o-modulo","version":"1.1.0"},{"title":"Cadastrar e editar","anchor":"cadastrar-e-editar","text":"Na aba Organizações, escolha Nova organização no cabeçalho. Informe Nome, Documento quando houver e Status. Salve e confira o cadastro na lista. Com suborganizações habilitadas, abra a aba da organização pai e escolha Nova suborganização. Campo Obrigatoriedade e comportamento Nome Obrigatório, até 150 caracteres. Documento Opcional, até 50 caracteres. É uma identificação informada por sua empresa. Status Ativo ou Inativo; novos registros usam Ativo quando nenhum outro estado é informado. Organização pai Obrigatória no cadastro da suborganização, selecionada entre organizações ativas; ao editar, a alteração de pai exige acesso à origem e ao destino. Exemplo fictício: crie Comercial como organização e Equipe Norte como suborganização. Vincular pessoas a essas unidades é uma etapa distinta; apenas criar a organização não distribui acessos automaticamente.","links":[],"url":"/spm/manual/organizacoes/#cadastrar-e-editar","version":"1.1.0"},{"title":"Uso das associações","anchor":"uso-das-associacoes","text":"Organizações e Suborganizações são opcionais para utilizar o Askora. Ative quando houver necessidade de separar unidades, equipes ou canais; manter os vínculos acrescenta preenchimento e conferência aos cadastros. Nos módulos com associação opcional, deixar em Todas/sem associação mantém o registro compartilhado conforme as permissões; habilitar Organizações não torna toda associação obrigatória. Uma suborganização sempre pertence a uma organização pai.","links":[],"url":"/spm/manual/organizacoes/#uso-das-associacoes","version":"1.1.0"},{"title":"Tabela e ações","anchor":"tabela-e-acoes","text":"Os filtros incluem nome, documento, status e, conforme a aba, organização pai ou quantidade de suborganizações. Confira filtros e situação quando uma lista estiver vazia. A tabela apresenta oito registros por página. O cadastro rápido permite preencher novas linhas e salvar em conjunto. Também existem seleção, duplicação de linhas para novo cadastro e edição em tabela. Uma duplicação precisa ser revisada e salva; não cria uma unidade só por ser selecionada. A edição de registros já existentes é enviada registro por registro. Se houver falha durante uma sequência, confira o que já foi salvo antes de repetir a ação; não presuma que toda a sequência foi desfeita.","links":[],"url":"/spm/manual/organizacoes/#tabela-e-acoes","version":"1.1.0"},{"title":"Inativação e permissões","anchor":"inativacao-e-permissoes","text":"A ação de excluir pede confirmação e retira o cadastro das visualizações ativas por inativação. Ela preserva o registro histórico. Suborganizações são apresentadas nas abas das organizações ativas quando esse recurso está ligado. Criar, editar e inativar dependem das permissões e do alcance do acesso. Configurações globais são exclusivas do Master. Um vínculo com organização inativa não deve ser interpretado como remoção da restrição de acesso; consulte Perfis, permissões e alcance dos dados.","links":["/spm/manual/permissoes-e-escopos/"],"url":"/spm/manual/organizacoes/#inativacao-e-permissoes","version":"1.1.0"},{"title":"Limitações e dúvidas","anchor":"limitacoes-e-duvidas","text":"Os controles Importar e Exportar desta tabela ainda exibem uma orientação, sem executar a transferência de arquivos. Não os utilize como confirmação de importação ou de download concluído. Se uma organização pai não estiver disponível, confira sua situação, a configuração de suborganizações e seu acesso. Documento não preenchido é permitido; Nome vazio impede salvar.","links":[],"url":"/spm/manual/organizacoes/#limitacoes-e-duvidas","version":"1.1.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"O cadastro e a configuração são feitos no web. O aplicativo utiliza organizações como opções e filtros das telas operacionais compatíveis, mas não oferece a tela de Gerenciador → Atribuições → Organizações.","links":[],"url":"/spm/manual/organizacoes/#disponibilidade","version":"1.1.0"}]},{"id":"performance-participantes","title":"Participantes da Performance","summary":"Selecione colaboradores e parceiros, confira seus vínculos e valores do ciclo e entenda quem permanece na duplicação.","module":"Gerenciador","version":"1.0.0","publication":"public","channels":["web"],"keywords":["Performance","participantes","colaboradores","parceiros","seleção","filtros","duplicação","ativos","inativos","remuneração"],"related":["performance","configuracoes-performance","pessoas-cargos-e-acessos"],"url":"/spm/manual/performance-participantes/","markdownUrl":"/spm/manual/performance-participantes.md","sections":[{"title":"Introdução","anchor":"","text":"Em Gerenciador → Performance, abra o cadastro e use Dados Gerais para selecionar participantes. A Performance precisa estar habilitada e seu acesso autorizado. A seleção associa pessoas já cadastradas ao ciclo; não cria pessoas nem concede login. Colaboradores podem participar sem acesso ao sistema.","links":[],"url":"/spm/manual/performance-participantes/","version":"1.0.0"},{"title":"Escolher Colaboradores e Parceiros","anchor":"escolher-colaboradores-e-parceiros","text":"As abas Colaboradores e Parceiros separam os participantes e mostram a quantidade selecionada de cada tipo. Um novo ciclo começa sem pessoas selecionadas. Para incluir novas pessoas, o tipo correspondente precisa estar habilitado nas configurações de Pessoas. Clientes, fornecedores e administradores não são participantes dessas abas. Use o controle ao lado da aba para acrescentar ou remover um tipo. Mantenha ao menos Colaboradores ou Parceiros. Remover um tipo com pessoas selecionadas pede confirmação: retira da edição suas seleções e configurações de remuneração, metas e competição, sem excluir os cadastros de Pessoas. As alterações do ciclo só são gravadas ao salvar.","links":[],"url":"/spm/manual/performance-participantes/#escolher-colaboradores-e-parceiros","version":"1.0.0"},{"title":"Seleção individual e paginação","anchor":"selecao-individual-e-paginacao","text":"Marque ou desmarque a caixa da pessoa. O cabeçalho Selecionar todos nesta página afeta somente as linhas da página visível, com até oito registros; não seleciona toda a empresa. As setas mudam a página sem perder a seleção. Confira o total selecionado(s) de e a contagem da aba antes de continuar. A tabela mostra Nome e o identificador da pessoa; em Parceiros, mostra também Documento. São informações de consulta, não campos para renomear ou alterar o cadastro. Pessoas inativas sem vínculo com o ciclo não aparecem para inclusão. Ao editar um ciclo existente, participantes históricos inativos continuam identificados e podem ser mantidos; removê-los não inativa nem exclui a pessoa. Cada pessoa pode aparecer uma vez por tipo. São até 500 colaboradores e 500 parceiros por ciclo, respeitando também os limites contratados. Para concluir uma Performance, selecione ao menos uma pessoa; um rascunho pode continuar incompleto.","links":[],"url":"/spm/manual/performance-participantes/#selecao-individual-e-paginacao","version":"1.0.0"},{"title":"Filtro de colaboradores e Filtro de parceiros","anchor":"filtro-de-colaboradores-e-filtro-de-parceiros","text":"Filtro de colaboradores ou Filtro de parceiros abre os critérios da aba atual. Organização, Suborganização e Cargo aparecem conforme as respectivas configurações; Cargo oferece os cargos daquele tipo de pessoa. Se nenhuma dessas dimensões estiver habilitada, o botão de filtro fica indisponível e a seleção individual continua disponível. Escolha ao menos um critério. A Suborganização deve pertencer à Organização escolhida, quando ambas forem informadas. Use Aplicar seleção. São selecionadas as pessoas ativas que atendem a todos os critérios preenchidos, considerando todas as páginas. Confira a contagem e os vínculos. Cancelar fecha o filtro sem aplicar mudanças. Aplicar o filtro substitui a seleção inteira da aba, inclusive retirando quem não corresponde aos critérios; não altera a outra aba. Sem critérios, a seleção é recusada. Depois, você pode ajustar as caixas individualmente. Não existe opção de inclusão indiscriminada de todos os colaboradores ou parceiros. O filtro é uma facilidade de seleção, não uma regra contínua de participação. Depois de salvar, pessoas novas ou alterações de cargo e organização não refazem automaticamente a lista do ciclo. A duplicação também utiliza apenas os participantes da origem que continuam ativos.","links":[],"url":"/spm/manual/performance-participantes/#filtro-de-colaboradores-e-filtro-de-parceiros","version":"1.0.0"},{"title":"Organização, Suborganização e Cargo no ciclo","anchor":"organizacao-suborganizacao-e-cargo-no-ciclo","text":"As colunas Organização, Suborganização e Cargo aparecem quando seus recursos estão habilitados. Os vínculos são guardados com o participante no ciclo e orientam os agrupamentos da Performance. Não são campos livres de edição na tabela. Na seleção individual, o Askora utiliza os vínculos da pessoa: a primeira organização, uma suborganização correspondente quando disponível e o cargo do respectivo tipo. Aplicar um filtro de Organização ou Suborganização define esses vínculos para os selecionados. Confira as colunas, especialmente quando a pessoa pertence a mais de uma unidade. Suborganização deve corresponder à organização, e novas associações precisam estar disponíveis para seu acesso. Alterar depois a organização ou o cargo em Pessoas não reescreve os vínculos já guardados no ciclo. A duplicação conserva os vínculos da origem dos participantes que continuam ativos; referências que se tornaram indisponíveis podem exigir revisão antes de salvar o novo ciclo.","links":[],"url":"/spm/manual/performance-participantes/#organizacao-suborganizacao-e-cargo-no-ciclo","version":"1.0.0"},{"title":"Remuneração fixa e variável no ciclo","anchor":"remuneracao-fixa-e-variavel-no-ciclo","text":"Com o recurso de remuneração habilitado em Pessoas, a aba Colaboradores mostra Remuneração fixa e Remuneração variável. A seleção inicial copia os valores da pessoa; se um valor não estiver preenchido, utiliza o valor do cargo e, na ausência de ambos, zero. Um zero já cadastrado na pessoa prevalece sobre o cargo. Os conceitos e a indicação de uso estão em Remuneração fixa e variável em Pessoas. Atualizar: substitui os dois valores de todos os colaboradores selecionados pelos valores atuais de Pessoas, com a referência do cargo quando aplicável. Limpar: zera os dois valores de todos os colaboradores selecionados. Editar: libera os valores dos selecionados. Salvar encerra a edição da tabela; Cancelar restaura os valores anteriores a essa edição. Enquanto edita, seleção, abas e filtros ficam bloqueados; a paginação continua disponível. Os valores aceitam zero e números não negativos, até 99.999.999.999,9999, com até quatro casas decimais no armazenamento; a apresentação monetária da tabela usa duas casas. Salvar a tabela não grava a Performance inteira: conclua com a ação de salvar o ciclo. Esses comandos alteram os valores do ciclo, não os cadastros de Pessoas. Mudanças posteriores em Pessoas não atualizam automaticamente essa cópia. A aba Parceiros não possui esses valores nem seus comandos de edição na Performance, mesmo quando o cadastro da pessoa contém remuneração. A duplicação conserva os valores já guardados dos colaboradores ativos, sem substituí-los pelos valores atuais de Pessoas.","links":["/spm/manual/pessoas-cargos-e-acessos/#remuneracao-fixa-e-variavel"],"url":"/spm/manual/performance-participantes/#remuneracao-fixa-e-variavel-no-ciclo","version":"1.0.0"},{"title":"Participantes na duplicação manual e automática","anchor":"participantes-na-duplicacao-manual-e-automatica","text":"Tanto Duplicar quanto a duplicação automática partem dos colaboradores e parceiros associados ao ciclo de origem e mantêm somente aqueles cujo cadastro de Pessoa continua ativo. Não incluem pessoas novas, não reaplicam filtros antigos e não reativam inativos. Os vínculos e o histórico da origem permanecem intactos. Exemplo: dos dez participantes originais, dois ficaram inativos. A cópia contém os oito ativos; o ciclo original mantém seus dez participantes. Isso vale também para parceiros. Uma pessoa reativada depois não entra automaticamente em uma sequência de cópias da qual já deixou de participar. A cópia conserva os vínculos e valores dos participantes restantes. Metas individuais de pessoas excluídas não são copiadas. Grupos de remuneração ou competição por Organização, Suborganização ou Cargo sem nenhum participante restante são retirados somente da cópia, junto das metas que perderam seu grupo ou indicador. As definições e valores dos grupos restantes são mantidos, inclusive configurações desativadas; resultados operacionais, vendas e pagamentos não são copiados.","links":[],"url":"/spm/manual/performance-participantes/#participantes-na-duplicacao-manual-e-automatica","version":"1.0.0"},{"title":"Duplicação quando ninguém continua ativo","anchor":"duplicacao-quando-ninguem-continua-ativo","text":"Na duplicação manual, o aviso informa que não há participantes ativos na origem. Você pode continuar para revisar o novo cadastro e selecionar pessoas antes de concluir, ou cancelar sem gravar. A prévia vazia não cria uma Performance pronta; salvar como rascunho permite continuar depois. Na duplicação automática, um ciclo sem participantes não é criado. A atualização registra o erro e preserva a origem. Confira o resultado em Atualização dos ciclos e revise a seleção; não espere que o Askora inclua outras pessoas da empresa para preencher a cópia. A ativação e o processamento estão em Duplicar ciclos automaticamente.","links":["/spm/manual/configuracoes-performance/#duplicar-ciclos-automaticamente"],"url":"/spm/manual/performance-participantes/#duplicacao-quando-ninguem-continua-ativo","version":"1.0.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"Seleção, edição dos valores e duplicação ficam no web, com o módulo Performance e as permissões necessárias. O aplicativo apresenta consultas autorizadas dos ciclos, sem editor de participantes. Participar da Performance não amplia o acesso a vendas, documentos ou dados privados das demais pessoas.","links":[],"url":"/spm/manual/performance-participantes/#disponibilidade","version":"1.0.0"}]},{"id":"pessoas-cargos-e-acessos","title":"Pessoas, cargos e acessos","summary":"Cadastre pessoas, associe unidades e cargos e conceda ou revogue acesso sem confundir identidade com login.","module":"Gerenciador","version":"1.2.1","publication":"public","channels":["web"],"keywords":["pessoas","colaborador","parceiro","cliente","fornecedor","administrador","cargo","login","Pix","TED","remuneração fixa","remuneração variável","OTE","vendedor","vendedores","equipe comercial"],"related":["organizacoes","permissoes-e-escopos","acesso-e-sessoes","configuracoes-pessoas","pessoas-dados-de-recebimento","performance-participantes","remuneracao-e-premios"],"url":"/spm/manual/pessoas-cargos-e-acessos/","markdownUrl":"/spm/manual/pessoas-cargos-e-acessos.md","sections":[{"title":"Introdução","anchor":"","text":"Gerenciador → Pessoas reúne Acessos, Administradores, Colaboradores, Parceiros, Cargos e Fornecedores. As abas dependem dos tipos habilitados nas configurações. Clientes ficam em Gerenciador → Atribuições → Clientes. Uma pessoa pode participar da operação sem ter login; conceder acesso é uma decisão separada.","links":[],"url":"/spm/manual/pessoas-cargos-e-acessos/","version":"1.2.1"},{"title":"Tipos e pré-requisitos","anchor":"tipos-e-pre-requisitos","text":"Pessoas permanece disponível. Colaboradores começam habilitados; Parceiros, Fornecedores, Cargos e Permissões por cargo dependem de ativação. Somente o Master altera essas configurações e as políticas globais. As associações de organizações/suborganizações seguem a configuração global de Organizações. Tipo Particularidades Administrador Cadastro completo com acesso obrigatório; pode ser Master, Administrador ou Visualizador. Não tem cargo e não pode ser inativado. Colaborador ou Parceiro Pode existir sem acesso. Quando recebe acesso, utiliza Padrão ou a política do cargo habilitado. Cliente Não recebe login; pode ter um colaborador responsável. Fornecedor Não recebe login. Cargo É uma classificação para colaborador ou parceiro, com regras próprias; não é uma pessoa nem um acesso. O tipo da pessoa não pode ser trocado depois de salvar. Para evitar cadastros incorretos, selecione a aba apropriada antes de criar.","links":[],"url":"/spm/manual/pessoas-cargos-e-acessos/#tipos-e-pre-requisitos","version":"1.2.1"},{"title":"Cadastrar vendedores","anchor":"cadastrar-vendedores","text":"Cadastre seus vendedores no web em Gerenciador → Pessoas → Colaboradores. Abra o novo cadastro, preencha Nome e salve com Status → Ativo. Se a dúvida for sobre vendedores que não aparecem na comissão, depois de cadastrar volte à Performance → Dados Gerais e selecione essas pessoas na aba Colaboradores do ciclo. Cadastrar a pessoa não a seleciona automaticamente numa Performance já existente. Não é necessário conceder login para ela participar. Veja a seleção de participantes.","links":["/spm/manual/performance-participantes/#selecao-individual-e-paginacao"],"url":"/spm/manual/pessoas-cargos-e-acessos/#cadastrar-vendedores","version":"1.2.1"},{"title":"Cadastrar uma pessoa","anchor":"cadastrar-uma-pessoa","text":"Abra a aba do tipo desejado e a ação de novo cadastro no cabeçalho. Preencha Nome, obrigatório, com até 150 caracteres. Documento é opcional e aceita até 50 caracteres. Se disponíveis, escolha organizações, suborganizações e cargo. Cada suborganização deve ter sua organização selecionada; o cargo precisa corresponder ao tipo da pessoa. Preencha as demais opções aplicáveis, revise o acesso e salve. Campo condicional Quando aparece e como preencher Organizações e Suborganizações Quando habilitadas globalmente; permitem múltiplos vínculos. Uma suborganização exige sua organização selecionada. As escolhas e alterações respeitam o alcance do editor. Cargo Colaborador ou Parceiro, com Cargos habilitados; pode ficar Sem cargo. Escolha cargo ativo do mesmo tipo de pessoa. Colaborador responsável Cliente, com Responsável pelo cliente e Colaboradores habilitados. Opcional, inicialmente Sem responsável. Não concede login ao cliente. Remuneração fixa e Remuneração variável Colaboradores e Parceiros, com Valores de remuneração habilitado. Opcionais, não negativas, até 9.999.999.999.999,99, com precisão monetária. Não significam pagamento executado nem atualização geral de ciclos. Status Ativo ou Inativo, inicialmente Ativo, exceto Administradores, que permanecem ativos. Inativar preserva identidade e histórico, sujeito às proteções do acesso. Novos registros usam situação Ativo. Colaboradores e parceiros podem apresentar remuneração fixa e variável quando esse recurso está habilitado; os valores informados precisam ser não negativos. Alterações na pessoa podem atualizar pagamentos fixos conforme a configuração de Pagamentos e estão sujeitas aos limites contratados de participantes. Isso não significa executar uma transferência bancária. Exemplo fictício: cadastre Ana como colaboradora, vincule-a à organização Comercial e deixe Não conceder se ela participará das apurações sem entrar no sistema. Conceda o acesso posteriormente, se necessário.","links":[],"url":"/spm/manual/pessoas-cargos-e-acessos/#cadastrar-uma-pessoa","version":"1.2.1"},{"title":"Conceder e revogar acesso","anchor":"conceder-e-revogar-acesso","text":"Para colaboradores e parceiros, use a seção Acesso e escolha Conceder. Um acesso novo exige Login (E-mail) válido, até 190 caracteres, normalizado para minúsculas, e a escolha entre Atribuir senha (de 8 a 128 caracteres) ou Primeiro acesso por e-mail. Colaborador e Parceiro começam com Não conceder. Para Administrador, conceder acesso é obrigatório: selecione Nível de acesso → Master, Administrador ou Visualizador, inicialmente Administrador; somente um Master pode atribuir Master. A senha segue os requisitos descritos em Entrar e gerenciar suas contas. Ao editar um acesso já configurado, deixar Senha vazia preserva a senha existente. Escolher Não conceder revoga o acesso e as sessões sem apagar a pessoa nem seus vínculos. Alterar login ou senha também invalida sessões anteriores. O último Master com acesso não pode perder esse papel/acesso. A aba Acessos lista as credenciais existentes. Editar nela abre somente os dados de acesso; não altera a identidade e as associações da pessoa. Excluir acesso preserva a pessoa e encerra suas sessões. Essa exclusão não é oferecida para Master. Para editar o cadastro completo, use a aba do tipo de pessoa.","links":["/spm/manual/acesso-e-sessoes/#recuperar-a-senha"],"url":"/spm/manual/pessoas-cargos-e-acessos/#conceder-e-revogar-acesso","version":"1.2.1"},{"title":"Cadastrar cargos","anchor":"cadastrar-cargos","text":"Somente o Master mantém Cargos. No cadastro completo, preencha: Campo Regra Nome Obrigatório, até 100 caracteres. Cargo de Colaborador (inicial) ou Parceiro; não muda depois de salvar. Remuneração fixa e Remuneração variável Opcionais quando Valores de remuneração está habilitado; valores não negativos com precisão monetária. Status Ativo (inicial) ou Inativo. Permissões Editor disponível com Permissões por cargo habilitado; parte da política Padrão em novo cargo e permite definir capacidades por página. O cargo tem tipo Colaborador ou Parceiro, que não muda depois de criado. O nome é único dentro da empresa para aquele tipo. Com Cargos e Permissões por cargo ativados, a política do cargo substitui a política geral Padrão da pessoa associada. Sem essa combinação, continua valendo a política geral. Cargo inativo não concede permissões. Administradores não usam cargo. A política do cargo não amplia o alcance para registros de outros participantes; consulte Perfis, permissões e alcance dos dados.","links":["/spm/manual/permissoes-e-escopos/"],"url":"/spm/manual/pessoas-cargos-e-acessos/#cadastrar-cargos","version":"1.2.1"},{"title":"Remuneração fixa e variável","anchor":"remuneracao-fixa-e-variavel","text":"Com Valores de remuneração habilitado, Colaboradores, Parceiros e seus Cargos oferecem os dois campos opcionais. Aceitam valores monetários não negativos até 9.999.999.999.999,99, com duas casas decimais. Preencher esses campos não cria uma transferência nem garante remuneração no ciclo. Campo Finalidade e utilização Remuneração fixa Referência para a parcela fixa, independente do atingimento das metas. Sua geração como obrigação deve ser configurada em Pagamentos, no vínculo de Pagamento fixo. Não é somada automaticamente a toda comissão ou bônus. Remuneração variável Referência de remuneração vinculada a resultados. Pode compor a base de uma regra de Performance, especialmente OTE ou Score; o valor efetivo depende do atingimento e da faixa/fator configurados. Não é um bônus garantido nem o valor realizado de vendas. Ao selecionar um colaborador na Performance, o sistema usa o valor informado na pessoa; se estiver ausente, usa o cargo; se ambos estiverem ausentes, usa zero. Zero informado é um valor explícito e não é substituído pelo cargo. Fixa e variável seguem essa prioridade de forma independente. A Performance guarda uma cópia dos valores e vínculos do colaborador no ciclo. Alterar Pessoas ou Cargos não reescreve automaticamente todos os ciclos: Atualizar busca os valores atuais, Editar ajusta apenas aquele ciclo e Limpar zera os valores do ciclo. Duplicar preserva a referência da origem para os participantes que continuam ativos; não atualiza silenciosamente para o cadastro atual. Veja remuneração fixa e variável no ciclo. Exemplo: uma colaboradora tem fixa de R$ 2.000 e variável de R$ 1.000. Uma regra OTE baseada na variável com fator 1 paga R$ 1.000 de variável quando sua faixa é atingida; com fator 1,2, paga R$ 1.200. A fixa continua sujeita à configuração própria de Pagamentos. O cálculo não soma automaticamente R$ 2.000 à regra OTE. Parceiros também podem ter esses campos em Pessoas/Cargos, mas a Performance atual não oferece a mesma tabela de valores do ciclo nem pagamento pela referência Remuneração variável para parceiros. Use apenas as opções disponibilizadas para esse público.","links":["/spm/manual/performance-participantes/#remuneracao-fixa-e-variavel-no-ciclo"],"url":"/spm/manual/pessoas-cargos-e-acessos/#remuneracao-fixa-e-variavel","version":"1.2.1"},{"title":"Dados de recebimento","anchor":"dados-de-recebimento","text":"O cadastro completo de Colaboradores e Parceiros oferece Forma de recebimento → Não informado, Pix ou TED, com Titular e CPF/CNPJ do titular. Pix exige Tipo de chave e Chave Pix; TED exige Código do banco, Agência, Conta e Tipo de conta, com dígitos opcionais. O documento do titular deve corresponder ao da pessoa. Alterar exige aprovação em Pessoas; configurar recebimento não movimenta dinheiro nem ativa CNAB/Split. Veja todos os campos e validações de recebimento.","links":["/spm/manual/pessoas-dados-de-recebimento/"],"url":"/spm/manual/pessoas-cargos-e-acessos/#dados-de-recebimento","version":"1.2.1"},{"title":"Tabela, importação e cuidados","anchor":"tabela-importacao-e-cuidados","text":"Use filtros e seleção antes de editar, duplicar ou exportar. A exportação da tabela gera JSON com os registros filtrados ou selecionados. A importação aceita uma lista JSON; duplicações e importações não copiam credenciais e começam sem acesso. Revise os dados antes de conceder logins. A aba Acessos não permite novo cadastro, importação ou edição em lote. Administradores exigem o cadastro completo; cadastro rápido, duplicação e importação ficam indisponíveis para esse tipo. Nas demais abas, as ações visíveis continuam dependendo da permissão. Se uma opção estiver ausente, confira o tipo habilitado, o cargo compatível, os vínculos, os filtros e seu alcance. Um Administrador não pode alterar o próprio acesso/associações nem contas Master pelo Gerenciador.","links":[],"url":"/spm/manual/pessoas-cargos-e-acessos/#tabela-importacao-e-cuidados","version":"1.2.1"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"O cadastro de Pessoas e a configuração de Cargos/Acessos estão no web. No aplicativo, a pessoa pode gerenciar o próprio perfil e usar os dados e seletores autorizados das operações; não há a tela de Gerenciador → Pessoas.","links":[],"url":"/spm/manual/pessoas-cargos-e-acessos/#disponibilidade","version":"1.2.1"},{"title":"Primeiro acesso por e-mail","anchor":"primeiro-acesso-por-e-mail","text":"Em Pessoas → Acessos, edite o acesso e escolha Primeiro acesso por e-mail em Definição de senha, entre o e-mail e a senha. Essa opção também está disponível ao cadastrar uma pessoa com acesso. Ao tentar entrar com o e-mail cadastrado, o usuário recebe um link para criar sua senha, válido por 30 minutos e de uso único. Depois de definir a senha, entra normalmente com ela. O cadastro não envia o e-mail antecipadamente. Para definir uma senha diretamente, escolha Atribuir senha. Na edição de um acesso com senha cadastrada, deixar o campo vazio mantém a senha atual. Selecionar Primeiro acesso por e-mail remove a senha anterior e invalida as sessões existentes; pode ser usado novamente quando o usuário precisar definir outra senha. Acessos inativos continuam bloqueados. O suporte autorizado pelo Admin pode acessar a conta antes da definição de senha.","links":[],"url":"/spm/manual/pessoas-cargos-e-acessos/#primeiro-acesso-por-e-mail","version":"1.2.1"}]},{"id":"produtos","title":"Produtos","summary":"Cadastre os produtos utilizados nas vendas, seus valores e suas associações organizacionais.","module":"Gerenciador","version":"1.1.0","publication":"public","channels":["web"],"keywords":["produto","valor","catálogo","importação","JSON"],"related":["organizacoes","permissoes-e-escopos","configuracoes-produtos"],"url":"/spm/manual/produtos/","markdownUrl":"/spm/manual/produtos.md","sections":[{"title":"Introdução","anchor":"","text":"O catálogo de Produtos fornece opções para as vendas quando o módulo está habilitado. Ele registra nome e valor de referência; não gerencia estoque, tributos ou variantes de produto.","links":[],"url":"/spm/manual/produtos/","version":"1.1.0"},{"title":"Preparar e cadastrar","anchor":"preparar-e-cadastrar","text":"Abra Gerenciador → Atribuições → Produtos. O módulo começa desativado e o Master pode habilitar Usar Produtos nas configurações. Com o recurso ativo e permissão de cadastro, use Produto no cabeçalho ou preencha uma linha de cadastro rápido na tabela. Campo Regra Nome Obrigatório; até 150 caracteres. Valor Obrigatório; número não negativo, até 9.999.999.999.999,99, com precisão monetária de duas casas decimais. Organização Opcional quando a separação está habilitada; deve estar disponível ao acesso. Suborganização Opcional, condicionada ao recurso; deve pertencer à organização selecionada. Status Ativo ou Inativo; um novo cadastro usa Ativo por padrão. Com associações organizacionais disponíveis, o formulário separa Informações principais e Associações. Sem elas, os campos aparecem sem essas abas. Salve e confira o produto na lista antes de usá-lo em outra tela. Exemplo fictício: cadastre Serviço mensal com valor de R$ 150,00. Se o produto puder ser usado em toda a empresa, deixe as associações vazias; para restringi-lo a uma unidade, selecione a organização adequada, respeitando seu acesso.","links":[],"url":"/spm/manual/produtos/#preparar-e-cadastrar","version":"1.1.0"},{"title":"Valor e quantidade nas vendas","anchor":"valor-e-quantidade-nas-vendas","text":"Ao selecionar um produto em uma venda, o item começa com Quantidade = 1 e Valor unitário igual ao valor do catálogo. Os valores do item podem ser ajustados na venda. Alterar o valor desse item não edita o preço do catálogo. O total informado da venda é mantido separadamente; adicionar produtos não deve ser interpretado como recálculo automático desse total. Quando as permissões permitem cadastrar ou editar produto pela venda, a ação mantém o próprio catálogo e precisa ser salva separadamente. Criar o produto não salva a venda nem registra recebimento. Confira os itens e o total antes de concluir a operação.","links":[],"url":"/spm/manual/produtos/#valor-e-quantidade-nas-vendas","version":"1.1.0"},{"title":"Consultar e alterar","anchor":"consultar-e-alterar","text":"Use os filtros dos campos da tabela, inclusive situação e associações. Registros compartilhados podem continuar aparecendo ao filtrar uma organização; isso não significa que pertencem exclusivamente à unidade filtrada. A tabela oferece seleção, edição, duplicação para novo cadastro e alteração em lote conforme as permissões. Revisar uma cópia não salva automaticamente o novo produto. Ao mudar a organização, confira novamente a suborganização antes de salvar. Excluir exige confirmação e inativa o cadastro, preservando seu histórico. Uma lista vazia pode decorrer de filtro, situação, módulo desligado ou alcance de acesso; confira esses pontos antes de criar outro produto.","links":[],"url":"/spm/manual/produtos/#consultar-e-alterar","version":"1.1.0"},{"title":"Importar e exportar","anchor":"importar-e-exportar","text":"A tabela exporta seus registros filtrados em arquivo JSON com os campos editáveis. A importação espera uma lista JSON e cria cadastros a partir desses campos, sem reutilizar o ID exportado como atualização automática. Para preparar um arquivo, utilize uma exportação como referência e revise Nome, Valor, associações e Status. Cada lote enviado é validado em conjunto; um item inválido impede a gravação daquele lote. Uma seleção grande pode ser dividida em mais de um envio pela interface. Em caso de erro, confira os resultados já salvos antes de repetir toda a importação.","links":[],"url":"/spm/manual/produtos/#importar-e-exportar","version":"1.1.0"},{"title":"Permissões e limitações","anchor":"permissoes-e-limitacoes","text":"Cadastro, edição, inativação e exportação dependem das capacidades da página. Configurar o módulo exige Master. As organizações e suborganizações são configuradas em Organizações, não por um segundo interruptor dentro de Produtos. Não use o valor do catálogo como prova de que uma venda foi gravada ou de que uma parcela foi paga: essas ações pertencem às respectivas operações. O catálogo não oferece controle de quantidade em estoque.","links":[],"url":"/spm/manual/produtos/#permissoes-e-limitacoes","version":"1.1.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"O gerenciamento de Produtos está no web. No aplicativo, os produtos podem ser selecionados nas operações que os utilizam e que estão disponíveis ao acesso; não há tela de cadastro do Gerenciador.","links":[],"url":"/spm/manual/produtos/#disponibilidade","version":"1.1.0"}]},{"id":"integracao-api","title":"API e conectores","summary":"Crie credenciais com permissões explícitas e configure consultas a sistemas externos.","module":"Integrações","version":"1.0.0","publication":"public","channels":["web"],"keywords":["API","chave","conector","permissão","sincronização","atividade"],"related":["identificadores-externos","importacoes-operacionais","permissoes-e-escopos"],"url":"/spm/manual/integracao-api/","markdownUrl":"/spm/manual/integracao-api.md","sections":[{"title":"Introdução","anchor":"","text":"Integrações → API reúne Chaves de API, Conectores, Mapeamentos, Testar API, Atividade e o guia disponível na interface. Administração exige Master. A API externa é REST; não representa um servidor MCP nem uma conversa com IA.","links":[],"url":"/spm/manual/integracao-api/","version":"1.0.0"},{"title":"Criar e manter uma chave","anchor":"criar-e-manter-uma-chave","text":"Em Chaves de API, use + Chave. Informe Nome, validade e limite por minuto. Marque explicitamente as permissões necessárias aos recursos utilizados. Salve e guarde o segredo exibido uma única vez no sistema que fará a integração. A validade deve estar no futuro e em até 366 dias. O limite aceita de uma a 1.000 requisições por minuto, com padrão 120. Ao atingir o limite, o consumidor precisa respeitar o tempo de nova tentativa informado. Substituir emite nova chave e revoga a anterior; atualize consumidores e vínculos de conectores/webhooks. Revogar interrompe seu uso. Não há edição livre do segredo existente. Credencial de serviço pertence à empresa e não deve ser distribuída como login pessoal de colaboradores.","links":[],"url":"/spm/manual/integracao-api/#criar-e-manter-uma-chave","version":"1.0.0"},{"title":"Configurar um conector","anchor":"configurar-um-conector","text":"Use + Conector, escolha destino externo, tabela/recurso, chave de escrita, mapeamento de entrada e caminhos da lista/cursor na resposta. Defina horários ou intervalo e fuso. O conector começa inativo para permitir conferência. Autorização externa não é devolvida na edição; deixar o campo vazio preserva o segredo salvo. Testar faz uma consulta real ao destino e valida a resposta sem persistir registros nem avançar o cursor. Ativar permite a execução agendada conforme a configuração do serviço. O destino precisa ser HTTPS público compatível. Endereços locais/privados, redirecionamentos e respostas fora dos limites são recusados. Cada página remota comporta até 100 linhas; cursor sem avanço ou resposta incompatível gera erro. Falha de uma página não deve ser tratada como sincronização concluída.","links":[],"url":"/spm/manual/integracao-api/#configurar-um-conector","version":"1.0.0"},{"title":"Mapeamento, identidade e repetição","anchor":"mapeamento-identidade-e-repeticao","text":"Escolha os campos aceitos pelo destino. Vendas usa Pedido; outros registros podem usar código externo durável com espaço de nomes. O sistema não deduz identidade pelo nome. Configuração do módulo, validações, registros pagos e fechamentos continuam valendo. Uma repetição deve conservar a identificação da operação e seu conteúdo. Alterar conteúdo, mapeamento ou contexto pode gerar conflito. Para coleções e exportações, continue pelo cursor devolvido até o fim; uma primeira página não representa todos os dados.","links":[],"url":"/spm/manual/integracao-api/#mapeamento-identidade-e-repeticao","version":"1.0.0"},{"title":"Testar e acompanhar","anchor":"testar-e-acompanhar","text":"Testar API usa a sessão Master, não simula as permissões de uma chave. A validação executa o domínio em transação revertida; IDs apresentados na prévia não são registros salvos nem reservas. Conferir um exemplo de mapeamento apenas transforma campos e é um teste diferente. Atividade mostra horário, origem, método, recurso, resposta e duração, sem corpos ou segredos. Erro de autorização exige conferir chave/permissões; conflito exige rever identidade/versão; erro de entrada exige corrigir os campos. Não repita uma gravação com nova identidade antes de conferir o resultado anterior.","links":[],"url":"/spm/manual/integracao-api/#testar-e-acompanhar","version":"1.0.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"Gestão e testes ficam no web. O aplicativo usa sua sessão pessoal nas funções nativas e não oferece administração de chaves/conectores. A disponibilidade local do conector não significa homologação com um ERP específico; confira seu contrato e resultado de teste.","links":[],"url":"/spm/manual/integracao-api/#disponibilidade","version":"1.0.0"}]},{"id":"identificadores-externos","title":"Identificadores externos","summary":"Relacione códigos de outros sistemas aos cadastros do Askora, com validade opcional.","module":"Integrações","version":"1.0.0","publication":"public","channels":["web"],"keywords":["identificador","código externo","validade","integração","referência"],"related":["organizacoes","pessoas-cargos-e-acessos","importacoes-operacionais"],"url":"/spm/manual/identificadores-externos/","markdownUrl":"/spm/manual/identificadores-externos.md","sections":[{"title":"Introdução","anchor":"","text":"Em Integrações → Identificadores, o Master mantém correspondências para Colaboradores, Parceiros, Organizações e Suborganizações. O código externo referencia um cadastro existente; não renomeia nem troca seu ID interno.","links":[],"url":"/spm/manual/identificadores-externos/","version":"1.0.0"},{"title":"Cadastrar uma correspondência","anchor":"cadastrar-uma-correspondencia","text":"Escolha a aba do tipo correto. Informe Identificador externo como texto e selecione o cadastro em Identificador interno. Se Validade estiver habilitada, confira Início e Fim opcionais. Salve e confira a correspondência antes de utilizá-la na integração. São até 150 caracteres, sem espaços ou caracteres de controle. Zeros iniciais e maiúsculas são preservados: 001, 1, ABC e abc são códigos diferentes. Vários códigos podem apontar ao mesmo cadastro. Um código pode existir em tipos diferentes sem representar a mesma pessoa.","links":[],"url":"/spm/manual/identificadores-externos/#cadastrar-uma-correspondencia","version":"1.0.0"},{"title":"Validade e conflito","anchor":"validade-e-conflito","text":"Validade começa desativada. Sem início, não há limite inicial; sem fim, não há limite final. No mesmo tipo e empresa, associações ativas do mesmo código não podem sobrepor datas, inclusive os limites. Com validade ativa, a resolução exige a data do negócio. Sem ela, apenas uma associação ativa pode existir para o código. Não é possível desligar Validade enquanto reutilizações por período tornarem a resolução ambígua. Ocultar datas não apaga o histórico. Se código e ID interno forem enviados juntos, precisam corresponder. Cadastro interno inativo ou fora da empresa não resolve uma referência válida. Código não encontrado exige corrigir a correspondência, não escolher alguém pelo nome semelhante.","links":[],"url":"/spm/manual/identificadores-externos/#validade-e-conflito","version":"1.0.0"},{"title":"Manutenção e limites","anchor":"manutencao-e-limites","text":"A tabela oferece filtros, paginação, cadastro rápido/completo, seleção, edição e arquivos JSON. Inativar preserva a associação histórica; versão desatualizada exige recarregar. Cada lote enviado é transacional. Essas referências a pessoas/organizações são diferentes do código durável de um próprio registro importado. Uma venda, por exemplo, é identificada pelo Pedido e pode referenciar o colaborador por seu código externo com validade.","links":[],"url":"/spm/manual/identificadores-externos/#manutencao-e-limites","version":"1.0.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"Administração no web, exclusiva do Master. Integrações autorizadas podem resolver as referências nos destinos compatíveis. O aplicativo não oferece editor nativo de Identificadores; cadastros manuais continuam usando as referências internas autorizadas.","links":[],"url":"/spm/manual/identificadores-externos/#disponibilidade","version":"1.0.0"}]},{"id":"integracao-arquivos","title":"Mapeamentos e arquivos de integração","summary":"Relacione campos, traduza opções e importe ou exporte dados com limites e identificação claros.","module":"Integrações","version":"1.1.0","publication":"public","channels":["web"],"keywords":["mapeamento","CSV","Excel","JSON","exportação","conversão"],"related":["importacoes-operacionais","integracao-api","integracao-webhook","identificadores-externos"],"url":"/spm/manual/integracao-arquivos/","markdownUrl":"/spm/manual/integracao-arquivos.md","sections":[{"title":"Introdução","anchor":"","text":"Integrações → Arquivos começa desativada. Abra Configurar, ative Usar Arquivos e salve. A configuração pertence somente a essa extensão. Quando desativada, Operações → Arquivos fica oculta e transferências de arquivos não são executadas. Desativar preserva os mapeamentos; API e Webhook continuam com suas configurações próprias. Arquivos utiliza os mesmos mapeamentos de API e Webhook. Um mapeamento relaciona campos de uma tabela e sentido; não cria novos campos livres no produto. A aba Mapeamentos mantém essas correspondências; Importar permite escolher destino e mapeamento, e Exportar extrai dados. Em Operações → Arquivos, a execução começa por um mapeamento de entrada já cadastrado, que fixa o destino da transferência.","links":[],"url":"/spm/manual/integracao-arquivos/","version":"1.1.0"},{"title":"Criar um mapeamento","anchor":"criar-um-mapeamento","text":"Use + Mapeamento, informe Nome e escolha Receber dados no Askora ou Enviar dados do Askora. Selecione Área, Página e Tabela; Suborganizações também exige a organização. Preencha o nome externo apenas nos campos que serão relacionados. Abra Opções para obrigatoriedade, padrão, formato ou correspondência de valores. Confira um exemplo e salve. Depois selecione o mapeamento na transferência ou conexão. Tabela e sentido ficam fixos na edição. Durante a criação, trocar a combinação preserva rascunhos enquanto o formulário estiver aberto; recarregar não salva esses rascunhos. Mapeamentos diferentes podem atender a mesma tabela.","links":[],"url":"/spm/manual/integracao-arquivos/#criar-um-mapeamento","version":"1.1.0"},{"title":"Valores, referências e formatos","anchor":"valores-referencias-e-formatos","text":"Uma correspondência pode traduzir Venda = V e Devolução = D. Com correspondências definidas, códigos desconhecidos geram erro; valor padrão atende campo ausente, não código desconhecido. Zeros iniciais e maiúsculas são significativos. Consultar opções do Askora permite escolher referências cadastradas por nome. É uma correspondência explícita do perfil, diferente dos identificadores externos com validade. Campos temporariamente desligados são preservados no mapeamento, mas não podem ser usados como se estivessem disponíveis. Conversões incluem texto, número, inteiro, booleano, data, decimal brasileiro e JSON. Listas de produtos podem ser copiadas na estrutura permitida, sem transformar automaticamente cada elemento ou expandir uma linha em vários documentos. São até 100 regras e 100 correspondências por campo. Conferir com um exemplo transforma a amostra; não valida sozinho todas as regras do cadastro de destino. Uma transformação correta ainda pode conter referência inativa, parcela incompatível ou período fechado.","links":[],"url":"/spm/manual/integracao-arquivos/#valores-referencias-e-formatos","version":"1.1.0"},{"title":"Importar e retomar","anchor":"importar-e-retomar","text":"CSV, XLSX e JSON aceitam até dois MB, 100 linhas e 100 colunas; Excel usa uma planilha sem fórmulas. Confira formato, separador, mapeamento e comportamento Criar/Atualizar/Criar ou atualizar. Valide o arquivo antes de confirmar. Mudanças invalidam a prévia. Após iniciar a execução, mantenha código do lote, conteúdo e configuração para retentar sem duplicar. Alterar o mapeamento exige novo lote depois de nova conferência, preservando Pedido/código externo para identificar atualizações. O resultado informa linhas concluídas e erros; baixe o relatório. O sistema não oferece uma biblioteca visual de todos os arquivos enviados. O fluxo de execução também está em Operações → Arquivos.","links":["/spm/manual/importacoes-operacionais/#selecionar-e-validar"],"url":"/spm/manual/integracao-arquivos/#importar-e-retomar","version":"1.1.0"},{"title":"Exportar","anchor":"exportar","text":"Escolha tabela, formato e mapeamento de saída. Exportar primeira página baixa até 100 registros. Continue em Exportar próxima página até a indicação de conclusão; Voltar à primeira página reinicia a leitura. A exportação é paginada sobre o estado atual, não uma fotografia imutável de toda a empresa. CSV/Excel protegem conteúdo interpretável como fórmula; JSON preserva os dados originais. Permissões e configuração do destino delimitam o que é oferecido.","links":[],"url":"/spm/manual/integracao-arquivos/#exportar","version":"1.1.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"Gestão, importação e exportação ficam no web, exclusivas do Master nas páginas de Integrações. O aplicativo não possui essa interface. Métricas, Pagamentos, lotes e Fechamentos usam ações próprias e não aceitam criação genérica por planilha.","links":[],"url":"/spm/manual/integracao-arquivos/#disponibilidade","version":"1.1.0"}]},{"id":"integracao-webhook","title":"Webhooks de entrada e saída","summary":"Configure recebimento ou envio de alterações e acompanhe entregas, assinaturas e repetições.","module":"Integrações","version":"1.0.0","publication":"public","channels":["web"],"keywords":["webhook","evento","entrega","assinatura","reenvio","segredo"],"related":["integracao-api","identificadores-externos","importacoes-operacionais"],"url":"/spm/manual/integracao-webhook/","markdownUrl":"/spm/manual/integracao-webhook.md","sections":[{"title":"Introdução","anchor":"","text":"Em Integrações → Webhook, o Master configura Receber no Askora ou Enviar alterações do Askora. Entrada aplica dados ao destino autorizado; saída informa alterações ao sistema externo.","links":[],"url":"/spm/manual/integracao-webhook/","version":"1.0.0"},{"title":"Cadastrar e ativar","anchor":"cadastrar-e-ativar","text":"Use + Webhook e escolha direção, recurso, chave compatível e mapeamento opcional. Na saída, informe o destino HTTPS público. Na entrada, utilize a URL de recebimento apresentada nos detalhes. Salve e guarde o segredo exibido uma única vez. Configure o sistema externo, confira o teste pertinente e ative a conexão. O formulário cria a conexão inativa. Direção, recurso e destino ficam imutáveis depois de salvar; crie outra conexão para mudar esses dados. Nome, chave, mapeamento e situação podem ser editados com a versão atual. Trocar o segredo exige atualizar o correspondente no sistema externo.","links":[],"url":"/spm/manual/integracao-webhook/#cadastrar-e-ativar","version":"1.0.0"},{"title":"Receber dados","anchor":"receber-dados","text":"O remetente envia identidade estável do evento e dados conforme o guia da interface. A assinatura usa os bytes originais do corpo e timestamp, com tolerância de cinco minutos. Alterar o corpo exige nova assinatura. A entrada aceita objeto ou até 100 linhas e aplica a entrega de forma transacional. Repetir a mesma identidade e conteúdo evita nova gravação; reutilizar identidade com conteúdo diferente gera conflito. Assinatura inválida, chave expirada, recurso incompatível ou campos incorretos impedem a entrada. O teste de entrada valida dados sem persistir e sem verificar assinatura. Portanto, passar nesse teste não comprova que o remetente assinou corretamente uma entrega real.","links":[],"url":"/spm/manual/integracao-webhook/#receber-dados","version":"1.0.0"},{"title":"Enviar alterações","anchor":"enviar-alteracoes","text":"A saída utiliza eventos posteriores ao cursor inicial e não faz uma carga completa do histórico. O conteúdo é lido na primeira tentativa, preservado nas novas tentativas e pode diferir do instante exato da alteração. Exclusões podem apresentar dados ausentes. O destinatário deve reconhecer repetições pela identidade do evento: a entrega pode ocorrer mais de uma vez. Resposta de sucesso exige código HTTP 2xx. Há até oito tentativas automáticas, com intervalos crescentes limitados a uma hora; falhas podem ser reagendadas em Entregas. Destino precisa ser HTTPS público compatível, sem redirecionamento. Chave revogada, conexão inativa ou permissão removida impedem envio. O teste de saída pede confirmação porque envia um evento real de teste ao destino, sem dados de negócio.","links":[],"url":"/spm/manual/integracao-webhook/#enviar-alteracoes","version":"1.0.0"},{"title":"Acompanhar falhas","anchor":"acompanhar-falhas","text":"Em Entregas, confira tentativas, resposta HTTP e erro. Corrija destino, autorização ou contrato antes de reagendar. Reenviar não deve criar outra identidade para o mesmo evento. Consulte Atividade da integração para correlacionar a execução, sem expor segredos.","links":[],"url":"/spm/manual/integracao-webhook/#acompanhar-falhas","version":"1.0.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"Administração no web, exclusiva do Master; sem tela nativa no aplicativo. Webhooks reutilizam regras dos módulos, inclusive escopo da credencial e fechamentos. Configurar a conexão não comprova entrega a um fornecedor externo até o teste e a operação efetivos.","links":[],"url":"/spm/manual/integracao-webhook/#disponibilidade","version":"1.0.0"}]},{"id":"pipeline-operacao","title":"Acompanhar oportunidades no Pipeline","summary":"Cadastre oportunidades, preencha Valor e campos configurados, mova etapas e consulte checklist, datas e histórico.","module":"Operações","version":"1.4.0","publication":"public","channels":["web","mobile"],"keywords":["pipeline","oportunidade","kanban","ganha","perdida","previsão","valor","monetário","duplicar","checklist","importar","responsável","histórico"],"related":["pipeline-configuracao","configuracoes-pipeline","liberacoes","fechamentos","performance-bases-de-calculo"],"supportScope":["pipeline","oportunidade","funil","valor personalizado","campo moeda"],"url":"/spm/manual/pipeline-operacao/","markdownUrl":"/spm/manual/pipeline-operacao.md","sections":[{"title":"Introdução","anchor":"","text":"Operações → Pipeline acompanha negócios em Kanban, Tabela e Calendário. As colunas do Kanban são as etapas configuradas no Gerenciador. Registrar uma oportunidade não cria venda, recebimento ou pagamento.","links":[],"url":"/spm/manual/pipeline-operacao/","version":"1.4.0"},{"title":"Criar e preencher","anchor":"criar-e-preencher","text":"No web, abra o cadastro completo pelo cabeçalho ou use o + da Entrada no Kanban. A Tabela também oferece cadastro rápido. Preencha os dados, confira a aba Checklist no cadastro completo e salve. Cancelar descarta o rascunho. Entrada é o padrão do cadastro; você pode selecionar outra etapa ativa antes de salvar. Duplicar preenche Entrada como sugestão; importações começam na Entrada. Campo Para que serve e como preencher Nome Identifica o negócio; obrigatório, até 150 caracteres. Valor Referência monetária opcional e não negativa; veja Valor da oportunidade. Status Etapa comercial. Na criação, Entrada vem selecionada; você pode escolher qualquer etapa ativa. Os nomes podem ter sido personalizados. Responsável Colaborador que acompanha o negócio, ou Sem responsável. Não é seleção de parceiro, cliente ou vários responsáveis; também não identifica o autor de cada alteração. Criação Data informativa opcional. Não retroage a abertura real registrada pelo sistema. Previsão Data esperada para o negócio, opcional; não pode anteceder a abertura real. Não encerra nem ganha a oportunidade automaticamente. Descrição Contexto e observações, opcionais, até 4.000 caracteres. Organização e Suborganização Aparecem se os campos e suas origens estiverem disponíveis. Quando aparecem, são obrigatórias; a suborganização precisa pertencer à organização escolhida. Cliente e Produto Aparecem conforme os campos e módulos disponíveis; quando aparecem, são obrigatórios. Escolha cadastros ativos do tipo correto. Associar Produto não preenche Valor automaticamente. Campos personalizados Seguem o nome, tipo, ordem e obrigatoriedade definidos no Gerenciador. Texto aceita até 4.000 caracteres; Número aceita decimais; Moeda aceita até duas casas. Número/Moeda personalizados aceitam valores negativos e magnitude de até 999.999.999.999,99. Status do registro No formulário web: Ativo, Pendente ou Inativo, conforme a autorização. Controla aprovação/disponibilidade, separadamente da etapa. No app, a Tabela permite consultar/filtrar esse estado; Pendente aparece como Em aprovação. As datas aceitam anos de 2000 a 2100. Vínculos inativos já existentes podem continuar identificados na edição, sem ficarem disponíveis para novas atribuições. Um novo campo obrigatório pode precisar ser preenchido na próxima edição de oportunidades antigas. Campo oculto por configuração ou módulo não deve ser tratado como campo removido dos dados. A origem Venda do Gerenciador é uma integração futura, sem vínculo operacional disponível; consulte dependências das associações.","links":["/spm/manual/pipeline-operacao/#valor-da-oportunidade","/spm/manual/pipeline-configuracao/#dependencias-das-associacoes-e-integracao-com-vendas"],"url":"/spm/manual/pipeline-operacao/#criar-e-preencher","version":"1.4.0"},{"title":"Valor da oportunidade","anchor":"valor-da-oportunidade","text":"Valor é nativo e permanente: aparece no cadastro completo, cadastro rápido, edição, detalhes e tabela, sem depender de campo personalizado, Produto ou Venda. Seu preenchimento é opcional; vazio e zero são permitidos. Informe valor não negativo até R$ 9.999.999.999.999,99 e salve. O sistema grava centavos e apresenta moeda com duas casas. Na Tabela web, também permite filtro numérico e edição em lote. Web e aplicativo usam a mesma informação; Liberações permite revisá-la antes da aprovação. Editar outro dado preserva o Valor. Para retirá-lo, limpe o campo no formulário ou na edição da linha e salve. Cada versão conserva seu valor; consultas históricas não assumem o mais recente. Permissões, versão atual e fechamentos continuam sendo verificados. O Valor é usado no acompanhamento das oportunidades. Informá-lo não registra venda ou movimentação financeira.","links":[],"url":"/spm/manual/pipeline-operacao/#valor-da-oportunidade","version":"1.4.0"},{"title":"Valores anteriores à adoção do campo nativo","anchor":"valores-anteriores-a-adocao-do-campo-nativo","text":"Na atualização que introduz Valor, quando existe exatamente um campo personalizado Moeda ativo, seus valores válidos e não negativos são copiados para o nativo em cada oportunidade e versão histórica. Campos e valores personalizados são preservados. Sem campo elegível, com mais de um ou com valor inválido, o nativo permanece vazio; o sistema não escolhe uma origem por suposição. Se já existia um personalizado chamado Valor, ele recebe Valor (personalizado #...), com identificação e, se necessário, sufixo para evitar outro nome igual. Seus dados permanecem no mesmo campo. A cópia ocorre nessa atualização; alterações posteriores no personalizado e no nativo são independentes.","links":[],"url":"/spm/manual/pipeline-operacao/#valores-anteriores-a-adocao-do-campo-nativo","version":"1.4.0"},{"title":"Mudar etapa e encerrar","anchor":"mudar-etapa-e-encerrar","text":"No Kanban web, arraste o card para outra coluna ou use Alterar status; no aplicativo, use o atalho Alterar etapa. O menu mostra etapas ativas e identifica a atual. Também é possível editar o Status pelo formulário ou Tabela web. Etapas intermediárias não exigem sequência fixa; a ordem das colunas organiza a jornada, sem impedir saltos. Etapas do tipo Saída ganha ou Saída perdida encerram após confirmação, mesmo que tenham outro nome. Você pode editar uma oportunidade ganha ou perdida e reabri-la selecionando Entrada ou outra etapa intermediária. O histórico é preservado; permissões e fechamentos de períodos continuam válidos. Ganhar não gera venda automaticamente, e perder não apaga o registro. Etapas inativas preservam vínculos e histórico, mas não recebem novas atribuições. Na Tabela web, a ação da linha Encerrar como perdida não exclui o negócio. Com várias saídas perdidas ativas, ela abre a edição para escolher o Status. Para encerrar vários registros, selecione-os e altere Status em lote; a confirmação informa a quantidade. Registros pendentes continuam sujeitos à decisão em Liberações. As cores indicam a situação: Entrada amarela, Ganha verde, Perdida vermelha e outras etapas azuis. Em Tarefas, Aberta é amarela, Concluída verde e Cancelada vermelha. A aprovação do registro continua sendo uma indicação separada.","links":["/spm/manual/liberacoes/#efeitos-da-decisao"],"url":"/spm/manual/pipeline-operacao/#mudar-etapa-e-encerrar","version":"1.4.0"},{"title":"Checklist e histórico","anchor":"checklist-e-historico","text":"Na aba Checklist do cadastro completo, use Adicionar item. Cada item tem Nome obrigatório até 150 caracteres, Descrição opcional até 4.000 e Tipo: Marcação ou Contador. Há até 100 itens. O editor permite remover itens e paginar; salve o formulário para aplicar mudanças na lista. O cadastro rápido web não inclui esse editor. No card, expanda Ver checklist. Marcação alterna sim/não; Contador aumenta ou diminui uma quantidade inteira de zero a 999.999. Cada resultado no card é salvo imediatamente. Não há meta de contagem, mínimo obrigatório, responsável próprio por item ou encerramento automático do negócio. Oportunidades ganhas ou perdidas também permitem editar o checklist. Registros inativos, versões históricas e acessos sem permissão de edição têm os controles bloqueados. No aplicativo, alterações feitas no checklist dentro do formulário da oportunidade precisam de Salvar. No web, clique no corpo do card ou pressione Enter/Espaço para Ver detalhes; use Editar oportunidade quando disponível. A seção Histórico permite expandir data, etapa e versão para consultar seus dados e checklist. Responsável não é autoria da versão. Se outra sessão alterou o registro, recarregue e revise antes de salvar novamente. No aplicativo, tocar no card abre edição ou consulta, conforme o estado e a permissão.","links":[],"url":"/spm/manual/pipeline-operacao/#checklist-e-historico","version":"1.4.0"},{"title":"Datas e visualizações","anchor":"datas-e-visualizacoes","text":"Visualização O que aparece Tabela Situação Todas, Em andamento, Ganha ou Perdida; consulta atual sem recorte diário oculto. Começa em Em andamento. Kanban em qualquer dia Com Previsão, aparece apenas na data prevista. Sem Previsão, aparece em qualquer dia selecionado. O card mostra o estado atual e permite edição conforme sua permissão. Histórico nos detalhes Versões anteriores para consulta, sem alteração dos dados históricos. Calendário Semana ou Mês, totais e prévia de até oito registros do dia. Ver oportunidades do dia abre o Kanban para consultar todos, com paginação quando necessária. Use as setas para navegar dias ou períodos e selecione um dia no Calendário. O calendário operacional segue São Paulo. Uma oportunidade sem previsão mantém o mesmo ID ao navegar entre dias e conta uma vez no recorte selecionado; somar os totais diários não equivale a contar negócios únicos. Oportunidades não têm recorrência nem são recriadas diariamente. O resumo separa Aguardando aprovação dos totais ativos. Seu percentual é oportunidades ganhas dividido pelo total ativo do recorte; não é necessariamente a taxa de um ciclo de Performance. Filtrar combina Nome, Valor, Status, Responsável, Criação, Previsão, Status do registro e campos disponíveis, exceto Descrição. No web, texto usa Contém, número usa Igual a, seletores escolhem a opção e datas permitem início/fim; Limpar retira filtros. Filtros acompanham as visualizações. Organização/Suborganização também podem incluir registros sem aquele vínculo, dentro do alcance autorizado. Confira situação, data, filtros, aprovação e permissões quando um registro não aparecer; inativos saem da listagem operacional.","links":[],"url":"/spm/manual/pipeline-operacao/#datas-e-visualizacoes","version":"1.4.0"},{"title":"Arquivos e disponibilidade","anchor":"arquivos-e-disponibilidade","text":"Na Tabela web, o cadastro rápido cria linhas para preencher e salvar. Editar permite alterar a linha ou, com seleção múltipla, escolher Coluna e Preencher em lote. Selecionar todos abrange os registros editáveis de todas as páginas filtradas. Descrição e estrutura de Checklist são mantidas no formulário completo. Salve ou cancele rascunhos/edição antes de mudar a visualização. Duplicar prepara novos negócios na Entrada para revisar e salvar, sem transferir identidade, encerramento ou histórico. No web, usa os selecionados ou, sem seleção, os registros da página atual; copia os campos do formulário, sem checklist. Revise a Previsão copiada, que não pode ser anterior à nova abertura. No app, Duplicar na Tabela também copia os itens de checklist, zerando seus resultados. Exportar baixa JSON dos registros da visão filtrada, incluindo as outras páginas. Importar recebe uma lista JSON e cria novas oportunidades na Entrada após confirmação; não atualiza por ID nem restaura encerramentos, versões ou checklist. Confira vínculos e campos obrigatórios atuais. Cada envio tem até 500 registros e é transacional; seleções/importações maiores usam envios sequenciais, e uma falha posterior não desfaz os blocos já salvos. Não há upload de anexos em oportunidades. JSON é transferência de registros pela Tabela web, não um anexo do negócio.","links":[],"url":"/spm/manual/pipeline-operacao/#arquivos-e-disponibilidade","version":"1.4.0"},{"title":"Aprovação, acesso e períodos fechados","anchor":"aprovacao-acesso-e-periodos-fechados","text":"Além do módulo Pipeline ativo e da permissão de Operações, usuários que não são Master precisam da associação em Extensões → Pipeline → Responsáveis. A associação não concede permissões por si só. O usuário padrão trabalha com seus registros; administradores respeitam seu alcance de organizações e pessoas. Acesso ao Gerenciador ou Dashboard não substitui acesso à operação. Conforme a política do usuário, salvar deixa o registro Pendente, mesmo que tenha sido solicitada situação Ativo. Editar uma pendência não a aprova. A etapa comercial e o resultado do checklist não substituem a revisão; veja estados e alcance de Liberações. Fechamentos de Pipeline, Performance ou Pagamentos podem impedir criação, edição, alteração de etapa, checklist e aprovação. Criação e encerramento são referências protegidas; Criação vazia não garante liberação. Consulte datas protegidas e peça revisão do período ao responsável, sem tentar contornar pela Tabela ou importação.","links":["/spm/manual/liberacoes/#estados-e-alcance","/spm/manual/fechamentos/#datas-protegidas"],"url":"/spm/manual/pipeline-operacao/#aprovacao-acesso-e-periodos-fechados","version":"1.4.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"Web e aplicativo oferecem Kanban, Tabela, Calendário, campos e checklist autorizados. No app, navegue nas colunas por setas ou deslizando; a Tabela permite selecionar um registro para Editar/Consultar ou Duplicar. Importação, exportação e edição em lote da Tabela ficam no web. Status, Campos e Responsáveis são configurados no Gerenciador web.","links":[],"url":"/spm/manual/pipeline-operacao/#disponibilidade","version":"1.4.0"}]},{"id":"apuracao","title":"Apuração da Performance","summary":"Entenda quais resultados entram no cálculo, quando os pagamentos são reconhecidos e como revisar diferenças.","module":"Operações","version":"1.3.0","publication":"public","channels":["web","mobile"],"keywords":["apuração","reapuração","competência","resultado","pagamento","pipeline","valor"],"related":["metas","remuneracao-e-premios","performance-bases-de-calculo"],"url":"/spm/manual/apuracao/","markdownUrl":"/spm/manual/apuracao.md","sections":[{"title":"Introdução","anchor":"","text":"Em Operações → Pagamentos, o Master usa Atualizar apuração para atualizar obrigações elegíveis. A rotina também é executada diariamente. Para Performance, apurar reúne resultados do ciclo, aplica Comissão, Bônus e premiações em dinheiro e reconhece os valores devidos. É diferente de simular um cenário, consultar um dashboard ou registrar uma baixa bancária.","links":[],"url":"/spm/manual/apuracao/","version":"1.3.0"},{"title":"Pré-requisitos e momento","anchor":"pre-requisitos-e-momento","text":"O ciclo precisa estar pronto, ativo e encerrado: o fim deve ser anterior ao dia da apuração. Configure os tipos e a vigência de Pagamentos, seus destinatários e prazos. A atualização diária processa ciclos elegíveis; o Master também pode solicitar atualização pela interface. Períodos fechados, regras incompletas, referências indisponíveis e metas inválidas podem bloquear o processamento. Um erro em um ciclo é informado sem tornar corretos os demais por associação. Confira a última execução e as mensagens antes de usar o total para pagar.","links":[],"url":"/spm/manual/apuracao/#pre-requisitos-e-momento","version":"1.3.0"},{"title":"Atualizar apuração e interpretar o retorno","anchor":"atualizar-apuracao-e-interpretar-o-retorno","text":"Na tabela de Operações → Pagamentos, Atualizar apuração fica disponível ao Master com Pagamentos ativo. Não depende de selecionar linhas: atualiza o conjunto elegível de fixos mensais, ciclos de Performance e reembolsos da empresa. A tela informa Apuração atualizada, Apuração com pendências ou que nenhuma apuração foi executada. Se houver erros, leia qual Fixo, Performance ou Reembolso foi afetado antes de preparar lotes; a falha de uma origem não desfaz as demais já processadas. A rotina respeita a vigência e ignora origens protegidas por fechamento. Um ciclo que termina hoje ainda não está encerrado para apuração: o fim deve ser anterior ao dia do processamento. A existência de resultados no dashboard, sozinha, não significa que haja obrigação disponível em Pagamentos. Nenhum desses comandos confirma transferência ou dispensa a nota fiscal quando exigida.","links":[],"url":"/spm/manual/apuracao/#atualizar-apuracao-e-interpretar-o-retorno","version":"1.3.0"},{"title":"Fixos mensais e reembolsos","anchor":"fixos-mensais-e-reembolsos","text":"Fixo usa a Remuneração fixa atual em Pessoas, com modalidade/público habilitados e vigência válida. Para criar a obrigação do mês, a pessoa ativa precisa ter valor positivo e participação salva em uma Performance pronta/ativa que intercepte esse mês. Não precisa aguardar o fim do ciclo, não há multiplicação por participar de vários ciclos e não há rateio automático por dias. A geração automática abre o mês corrente e os seguintes, sem criar competências antigas ausentes. Obrigações sem baixa, reserva ou compensação acompanham o cadastro; valores já movimentados e períodos fechados são preservados. Reembolso exige documento aprovado do tipo Reembolsos, em aba ativa, com beneficiário elegível e pelo menos um anexo aprovado. Não depende de participação em Performance nem exige nota fiscal separada. Para uma nova obrigação, a Data do documento deve respeitar o Início da apuração. A primeira apuração elegível fixa sua referência; o vencimento deriva dessa referência e do prazo de Pagamentos, não da Previsão do documento. Mudanças posteriores na origem podem gerar revisão, sem duplicar a dívida. Para localizar essas obrigações, escolha Sem performance no período da operação de Pagamentos.","links":["/spm/manual/pagamentos-operacao/#conferir-valores-e-periodo"],"url":"/spm/manual/apuracao/#fixos-mensais-e-reembolsos","version":"1.3.0"},{"title":"Bases de cálculo","anchor":"bases-de-calculo","text":"Base Resultado considerado Data da venda Vendas ativas menos devoluções nas datas do ciclo, incluindo início e fim. Data de pagamento Valor integral das vendas ativas menos devoluções com Data de pagamento no intervalo. Vendas sem essa data não entram. Métricas Resultados dos indicadores e participantes do ciclo. Ausência ou aprovação pendente não equivale a zero informado. A base salva em cada Performance define a data usada: Data da venda considera saleDate; Data de pagamento considera paymentDate. Ambas usam o valor integral das vendas ativas menos devoluções. Vendas sem data de pagamento ficam fora dessa segunda base. Desligar a opção nas configurações não muda a base dos ciclos existentes. Metas individuais e compartilhadas são resolvidas no alcance da regra. Valores e quantidades compartilhados são somados; indicadores percentuais usam média. O cálculo remuneratório utiliza os vínculos e valores guardados no ciclo, que podem diferir do cadastro atual da pessoa. Vendas negativas após devoluções não produzem base remuneratória negativa. Essa proteção não significa que a devolução desapareça das consultas ou da avaliação do déficit de meta.","links":[],"url":"/spm/manual/apuracao/#bases-de-calculo","version":"1.3.0"},{"title":"Do cálculo ao pagamento","anchor":"do-calculo-ao-pagamento","text":"As regras habilitadas geram valores por beneficiário, origem e ciclo. Apenas premiações em dinheiro entram nesse reconhecimento. O vencimento segue o prazo do tipo de pagamento; apurar não executa uma transferência bancária. Os valores reconhecidos ficam em Operações → Pagamentos, com histórico de revisões, reservas, compensações e baixas.","links":[],"url":"/spm/manual/apuracao/#do-calculo-ao-pagamento","version":"1.3.0"},{"title":"Reapuração e diferenças","anchor":"reapuracao-e-diferencas","text":"Reapurar a mesma origem atualiza sua referência, evitando criar uma dívida duplicada. Antes de pagamentos, reservas ou compensações, a diferença pode atualizar o valor reconhecido. Depois desses movimentos, o novo cálculo fica registrado como revisão e a diferença exige análise explícita. Desligar um tipo de pagamento pausa a geração e preserva as obrigações e o histórico já registrados. Exemplo fictício: um bônus calculado em R$ 300 passa a R$ 350 depois de corrigir um resultado. Se já houve pagamento ou reserva, confira a diferença de R$ 50 e a revisão antes de liquidar qualquer saldo. Não registre outro bônus manual apenas porque o total mudou. O procedimento de Conferir ajuste e histórico explica como cancelar reservas, informar Motivo e aprovar o novo valor, preservando as baixas anteriores.","links":["/spm/manual/pagamentos-operacao/#conferir-ajuste-e-historico"],"url":"/spm/manual/apuracao/#reapuracao-e-diferencas","version":"1.3.0"},{"title":"Corrigir impedimentos","anchor":"corrigir-impedimentos","text":"Confira primeiro as datas e o estado do ciclo, depois metas e indicadores, participantes, aprovações e tipos habilitados. Revise a data escolhida na Performance e as datas preenchidas nas vendas. Se houver período fechado, o Master deve tratar a reabertura antes da correção.","links":[],"url":"/spm/manual/apuracao/#corrigir-impedimentos","version":"1.3.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"Configuração, atualização e revisão administrativa ficam no web. O aplicativo consulta os resultados disponíveis ao usuário; não oferece a operação nativa de Pagamentos. Permissão para consultar resultados não concede autorização para apurar ou baixar valores.","links":[],"url":"/spm/manual/apuracao/#disponibilidade","version":"1.3.0"}]},{"id":"pagamentos-operacao","title":"Conferir pagamentos e lotes","summary":"Confira obrigações, documentos, lotes, baixas externas, revisões e compensações por beneficiário.","module":"Operações","version":"1.2.1","publication":"public","channels":["web"],"keywords":["pagamento","lote","Excel","PDF","nota fiscal","compensação","crédito","baixa","situação","calendário","reembolso","fixo","comissão","bônus","revisão"],"related":["pagamentos-configuracao","apuracao","documentos-operacao","fechamentos"],"supportScope":["pagamento","pagar","pago","baixa","lote","reembolso","fixo","nota fiscal","cupom","recibo","comprovante","beneficiário","CNAB","split","vencimento","compensação"],"url":"/spm/manual/pagamentos-operacao/","markdownUrl":"/spm/manual/pagamentos-operacao.md","sections":[{"title":"Introdução","anchor":"","text":"Em Operações → Pagamentos, acompanhe obrigações de Fixo, Comissão, Bônus, Prêmio monetário e Reembolso. Elas vêm das origens configuradas; a página não oferece cadastro manual de uma dívida avulsa. A baixa declara um pagamento realizado fora do Askora: gerar arquivo ou marcar Pago não transfere dinheiro ao banco.","links":[],"url":"/spm/manual/pagamentos-operacao/","version":"1.2.1"},{"title":"Conferir valores e período","anchor":"conferir-valores-e-periodo","text":"A visualização Tabela possui as abas Pagamentos e Lotes. Em Pagamentos, cada linha mostra Beneficiário, Tipo, Referência, Vencimento, Apurado, Pago, Disponível e Situação. Use Abrir para conferir a composição e o histórico. As situações possíveis são Pendente, Aguardando NF, Em processamento, Parcial, Pago, Crédito e Cancelado; resultam dos valores e movimentos, não de um status livre do cadastro. Valor ou indicação Como interpretar Apurado Valor reconhecido na competência, incluindo a parte paga e a parte ainda devida. Disponível Saldo apto a entrar em novo lote após pagamentos, compensações, reservas e cobertura documental exigida. Aguardando NF Parte sem cobertura suficiente de nota válida, aprovada e anexada quando exigida. Não se aplica a Reembolso. Em processamento Valor reservado em lote ainda não confirmado; não significa pagamento bancário concluído. Pago Total de baixas externas registradas e não desfeitas. Crédito Excesso após revisão aprovada, que pode ser compensado explicitamente em outra obrigação elegível. Em Período dos pagamentos, Mês e Semana recortam pelo vencimento; Todos reúne o histórico autorizado; Sem performance mostra obrigações sem vínculo com um ciclo, como fixos mensais e reembolsos. Performance aparece quando há Comissão, Bônus ou Prêmio monetário habilitado com vencimento após o encerramento. Esse recorte oferece somente ciclos com obrigações visíveis ao usuário. Trocar recorte limpa a seleção; o botão Filtrar, no topo, permite restringir os resultados por campo. O Fixo é mensal: exige pessoa ativa, remuneração fixa positiva, modalidade/público/vigência elegíveis e participação salva em Performance pronta e ativa que intercepte o mês. Não precisa esperar o encerramento desse ciclo e não se multiplica por participar de vários ciclos. Novas competências surgem no mês corrente, sem preencher automaticamente meses antigos ausentes. Reembolso independe de participação em Performance: exige documento aprovado, anexo aprovado e vigência compatível.","links":[],"url":"/spm/manual/pagamentos-operacao/#conferir-valores-e-periodo","version":"1.2.1"},{"title":"Filtros de pagamentos e lotes","anchor":"filtros-de-pagamentos-e-lotes","text":"No topo de Pagamentos, Filtrar abre Filtrar tabela. Use Adicionar filtro para combinar condições e Aplicar para consultar; Limpar remove os filtros. Na aba Pagamentos e no Calendário, as colunas são Beneficiário, Lote de pagamento, Tipo, Referência, Vencimento e Situação. Tipo oferece Fixo, Comissão, Bônus, Prêmio monetário e Reembolso; Situação oferece Pendente, Aguardando NF, Em processamento, Parcial, Pago, Crédito e Cancelado. Na aba Lotes, os campos são Lote de pagamento, Valor total, Referência, Data do pagamento e Situação; as situações são Em processamento, Pago e Cancelado. Lote procura pelo número, valores numéricos usam igualdade, textos procuram conteúdo e datas aceitam limites de início/fim. Os filtros são combinados com o período e o alcance autorizado. Aplicar filtro limpa a seleção e volta à primeira página; trocar aba ou visualização também limpa os filtros.","links":[],"url":"/spm/manual/pagamentos-operacao/#filtros-de-pagamentos-e-lotes","version":"1.2.1"},{"title":"Calendário e consulta de lotes","anchor":"calendario-e-consulta-de-lotes","text":"No Calendário, escolha Semana ou Mês, navegue pelas datas e selecione um dia para abrir seus pagamentos. O posicionamento usa o vencimento, inclusive para valores já pagos; não usa a data da baixa. A pagar soma Disponível e Em processamento; Aguardando NF aparece separado quando houver bloqueio documental. Obrigações canceladas ou inativas não entram nessa visualização. Na aba Lotes, confira número do lote, beneficiários, total, data do pagamento e situação. O recorte mostra lotes integrais que contenham algum pagamento daquele período: seu total pode incluir outros pagamentos do mesmo lote. Abrir exibe Empresa, Data do pagamento, Comprovante ou referência e Pagamentos por beneficiário. Clique no beneficiário para expandir as origens que compõem seu valor; um beneficiário pode reunir Fixo, Comissão, Bônus e outras obrigações.","links":[],"url":"/spm/manual/pagamentos-operacao/#calendario-e-consulta-de-lotes","version":"1.2.1"},{"title":"Preparar e baixar um lote","anchor":"preparar-e-baixar-um-lote","text":"Na tabela, selecione obrigações e abra Pagar selecionados → Gerar Excel ou Gerar PDF. No detalhe individual, também existe Pagar saldo disponível. Em Lote de pagamento, confira os valores agrupados por beneficiário. Cada origem permite um valor parcial, de R$ 0,01 até seu saldo disponível; o valor inicial é o saldo inteiro. Confirme Gerar lote e Excel/PDF ou Gerar lote de pagamento. A confirmação cria o lote e reserva os valores: ficam Em processamento. Realize o pagamento externamente e abra o lote. Preencha Data do pagamento e Comprovante ou referência; então use Marcar lote como pago. Selecionar todos abrange o recorte inteiro, inclusive outras páginas e situações. Isso não libera saldo: apenas registros ativos, sem revisão pendente e com saldo disponível entram em Pagar selecionados. Separe lotes por empresa pagadora; a preparação rejeita empresas diferentes no mesmo lote. Pagamentos precisa estar ativo para gerar o lote. Beneficiário inativo, origem alterada, falta de comprovantes/cobertura, alcance insuficiente ou fechamento podem impedir preparar ou confirmar. Data do pagamento começa no dia atual, é obrigatória e não pode ser futura. Comprovante ou referência é um texto obrigatório de até 150 caracteres: informe a identificação da operação externa, não um arquivo anexado. A confirmação baixa todos os valores reservados no lote. Para pagar parcialmente, ajuste o valor na preparação; não altere o total já reservado no momento da confirmação. Repetir a confirmação com a mesma data/referência não duplica a baixa; dados divergentes ou versões antigas exigem nova conferência.","links":[],"url":"/spm/manual/pagamentos-operacao/#preparar-e-baixar-um-lote","version":"1.2.1"},{"title":"Arquivos Excel e PDF","anchor":"arquivos-excel-e-pdf","text":"Gerar Excel produz um arquivo .xlsx com Beneficiários (totais por pessoa) e Composição (origens e valores). Gerar PDF produz o relatório de conferência do lote. Os arquivos não são ordens bancárias e não incluem chaves PIX ou dados de recebimento. Não há importação de baixa por CSV nem execução de PIX nessa operação. Gerar CNAB e Gerar Split aparecem como Em breve e estão indisponíveis. Se o download falhar após criar o lote, a reserva já existe. Abra esse mesmo lote e use Baixar Excel ou Baixar PDF, em Arquivos do lote, para tentar novamente sem gerar outra reserva. Exportar exige permissão própria; baixar um lote não o marca como pago.","links":[],"url":"/spm/manual/pagamentos-operacao/#arquivos-excel-e-pdf","version":"1.2.1"},{"title":"Notas fiscais e ajustes","anchor":"notas-fiscais-e-ajustes","text":"No detalhe de Fixo, Comissão, Bônus e Prêmio monetário, Vincular nota fiscal oferece Nota fiscal aprovada e Valor de cobertura. A nota deve pertencer ao mesmo beneficiário, organização e suborganização, estar ativa/aprovada em uma aba ativa de Notas fiscais e ter anexo aprovado. O valor de cobertura precisa ser positivo e não pode superar o valor da nota ainda não alocado a pagamentos. A mesma versão da nota não pode ser vinculada duas vezes à mesma obrigação. A cobertura parcial libera somente a parte coberta, descontando valores já pagos, compensados ou reservados. Exemplo: para uma obrigação de R$ 1.000 com NF exigida, cobertura de R$ 600 libera até R$ 600; reservar R$ 400 deixa R$ 200 disponíveis e R$ 400 aguardando NF. Nota recebida depois mantém a competência original da obrigação. Sem exigência de NF, o vínculo é opcional; não altera o valor apurado. Não é possível alterar os vínculos enquanto houver reserva: cancele o lote preparado primeiro. Remover vínculo só está disponível sem baixa, reserva ou compensação recebida. Notas que já comprovam pagamento/compensação e seus anexos ficam protegidos, mesmo que se pretenda corrigir o cadastro. Se a lista estiver vazia, confira beneficiário/empresa, aprovação, aba e anexos em Documentos; cadastrar a nota não a vincula automaticamente. Reembolso mostra Comprovantes do reembolso, com o documento de origem, e não oferece Vincular nota fiscal. Usa os cupons e recibos aprovados da origem; retirar ou invalidar esses comprovantes pode impedir concluir o lote. Notas vinculadas anteriormente permanecem no histórico, sem criar nova exigência de NF.","links":[],"url":"/spm/manual/pagamentos-operacao/#notas-fiscais-e-ajustes","version":"1.2.1"},{"title":"Conferir ajuste e histórico","anchor":"conferir-ajuste-e-historico","text":"O detalhe reúne Informações do pagamento (identificação, vencimento, competência, compensado neste pagamento e crédito utilizado), Lotes de pagamento, Baixas realizadas, Revisões do valor e Compensações. As baixas desfeitas continuam identificadas no histórico. Para tratar uma alteração do valor apurado, siga Revisar diferença.","links":["/spm/manual/pagamentos-operacao/#revisar-diferenca"],"url":"/spm/manual/pagamentos-operacao/#conferir-ajuste-e-historico","version":"1.2.1"},{"title":"Revisar diferença","anchor":"revisar-diferenca","text":"Depois de uma mudança na origem, use a apuração autorizada. Se já houve movimentação, Conferir ajuste apresenta Apurado anteriormente, Nova apuração e Diferença. Cancele reservas antes de revisar. Em Revisar diferença, informe Motivo, obrigatório até 500 caracteres, e confirme Aprovar novo valor. Aumento aprovado libera complemento; redução pode gerar crédito, preservando baixas anteriores. Enquanto a revisão estiver pendente, o saldo não fica disponível para novo pagamento. O Fixo possui tratamento próprio: obrigações ainda sem pagamento, compensação ou reserva acompanham a remuneração fixa em Pessoas. Valores com movimentos são preservados; Conferir ajuste não é um comando para substituir um fixo movimentado. Atualizar apuração, disponível ao Master com Pagamentos ativo, processa fixos, ciclos elegíveis e reembolsos e informa eventuais pendências. Consulte Reapuração e diferenças antes de criar lançamentos para corrigir um total.","links":["/spm/manual/apuracao/#reapuracao-e-diferencas"],"url":"/spm/manual/pagamentos-operacao/#revisar-diferenca","version":"1.2.1"},{"title":"Compensar crédito","anchor":"compensar-credito","text":"Quando existir crédito disponível, abra o pagamento e use Compensar crédito. Preencha Pagamento de destino, Valor e Motivo (obrigatório, até 500 caracteres); depois confirme Confirmar compensação. O destino precisa ser outra obrigação do mesmo beneficiário, organização e suborganização, com saldo disponível. O valor deve ser positivo e não ultrapassar o crédito da origem nem o saldo do destino. Origem e destino não podem ter revisão pendente ou reserva. A elegibilidade documental e a origem do pagamento de destino também são reconferidas. A compensação reduz o saldo devido, registra sua origem e motivo; não realiza débito bancário na conta da pessoa. Crédito já utilizado pode impedir desfazer a baixa que lhe deu origem.","links":[],"url":"/spm/manual/pagamentos-operacao/#compensar-credito","version":"1.2.1"},{"title":"Cancelar, excluir e editar situação","anchor":"cancelar-excluir-e-editar-situacao","text":"Cancelar lote só vale para um lote Em processamento: informe Motivo de até 150 caracteres. Cancela a reserva e libera saldo, sem registrar baixa. Um lote já pago não admite esse cancelamento. Excluir lote exige autorização de exclusão e confirmação. Inativa o lote preparado ou liquidado, retira-o da tabela e desfaz sua reserva/baixa local, preservando o histórico e outros lotes válidos. Não estorna dinheiro no banco. A ação pode ser impedida se o crédito resultante daquela baixa já foi compensado em outra obrigação. Editar situação atua sobre os pagamentos selecionados. Escolha Pago, com Data do pagamento e Comprovante ou referência, ou Pendente, com Motivo até 500 caracteres e permissão de exclusão. Pago confirma os lotes preparados vinculados e prepara/baixa o saldo disponível restante dos selecionados, agrupando por empresa. Pendente exclui os lotes preparados e pagos vinculados. Não remove a obrigação original nem apaga compensações; a situação final é recalculada pelos movimentos restantes. Em processamento só surge ao gerar um lote. Clique em Conferir alteração e revise a prévia antes de confirmar: como cada lote é uma unidade, outros beneficiários ou pagamentos fora da seleção podem ser afetados. Se alguém alterar registros ou lotes após a prévia, é preciso conferi-la novamente.","links":[],"url":"/spm/manual/pagamentos-operacao/#cancelar-excluir-e-editar-situacao","version":"1.2.1"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"Pagamentos é uma operação web; o aplicativo não possui tela nativa equivalente. Master e Administrador com acesso completo podem executar comandos; Padrão pode receber somente leitura ou ficar sem acesso, e Visualizador depende do acesso de consulta/exportação. Consulta não concede aprovação, exclusão ou exportação. Configuração e apuração completa exigem Master. O alcance dos registros é revalidado em cada ação. Fechamento de Pagamentos protege a competência, inclusive vínculos de NF, lotes e baixas.. A proteção vale mesmo com data de pagamento fora do intervalo fechado. A mensagem informa o fechamento em Gerenciador → Fechamento; somente o Master pode tratar a reabertura autorizada.","links":[],"url":"/spm/manual/pagamentos-operacao/#disponibilidade","version":"1.2.1"}]},{"id":"documentos-operacao","title":"Documentos: cadastro e anexos","summary":"Cadastre, filtre, duplique e revise documentos e anexos, distinguindo aprovação, reembolso e cobertura de notas fiscais.","module":"Operações","version":"1.2.0","publication":"public","channels":["web","mobile"],"keywords":["documento","anexo","reembolso","nota fiscal","XML","duplicar","cadastro rápido","filtro","situação","previsão"],"related":["documentos-configuracao","pagamentos-operacao","fechamentos","liberacoes"],"url":"/spm/manual/documentos-operacao/","markdownUrl":"/spm/manual/documentos-operacao.md","sections":[{"title":"Introdução","anchor":"","text":"Em Operações → Documentos, escolha uma aba ativa criada no Gerenciador. Seu tipo define o comportamento: Documentos gerais guarda registros; Reembolsos pode originar obrigação em Pagamentos; Notas fiscais fornece cobertura para pagamentos que exigem NF. Renomear a aba não muda seu tipo. Se Documentos estiver desativado ou não houver aba ativa, a página orienta solicitar a configuração ao Master.","links":[],"url":"/spm/manual/documentos-operacao/","version":"1.2.0"},{"title":"Cadastrar e anexar","anchor":"cadastrar-e-anexar","text":"Escolha a aba e use Cadastro rápido na tabela, ou abra o cadastro completo pelo botão de criação da página. Preencha os campos de Informações principais. Confira o beneficiário e a empresa antes de anexar comprovantes de reembolso ou notas fiscais. No formulário completo, abra Anexos, acrescente os arquivos e use Salvar. Na tabela, Anexar inclui arquivos pendentes que serão enviados ao salvar a linha. Campo Finalidade e preenchimento Aba Define tipo e campos do documento. Obrigatória no cadastro completo; a tabela usa a aba aberta. Depois de salvo, o documento não pode mudar de aba. Doc Identificação que permite localizar o documento, até 150 caracteres, obrigatória. No aplicativo aparece como Documento. Não substitui o anexo nem significa validação fiscal do número. Colaborador Responsável pelo documento quando Colaboradores está habilitado. É obrigatório em Documentos gerais nessa condição. Parceiro Disponível em Reembolsos/Notas fiscais quando Parceiros está habilitado. Nessas abas, escolha Colaborador ou Parceiro como beneficiário, nunca ambos; selecionar um limpa o outro no formulário. Organização Empresa à qual o registro pertence, quando o recurso está habilitado. Determina o alcance e precisa coincidir com o pagamento quando a nota for vinculada. Suborganização Unidade, quando habilitada; deve pertencer à Organização selecionada. Trocar Organização limpa uma unidade incompatível. Data Data do documento, obrigatória; começa no dia atual. É referência para vigência do reembolso e fechamento de Documentos. Valor Valor informado no documento, obrigatório, não negativo, até 13 dígitos inteiros e dois decimais. Zero é permitido no cadastro, mas não gera saldo positivo a pagar. Descrição Explicação opcional, até 4.000 caracteres. Previsão Data opcional, disponível se a aba usa previsão. Organiza o acompanhamento; não define o vencimento de um reembolso em Pagamentos. Data de pagamento Data opcional, disponível somente em Documentos gerais com essa opção habilitada. Altera a situação documental; não é o comando para baixar lotes de Pagamentos. As datas aceitam o calendário de 2000 a 2100. Os campos de associação dependem dos recursos e do alcance disponíveis. Relações históricas podem continuar no registro, mesmo que não estejam disponíveis para um novo vínculo. Em reembolso já reconhecido em Pagamentos, beneficiário, organização e suborganização não podem ser trocados: preservar a origem evita transferir a dívida para outra pessoa/empresa.","links":[],"url":"/spm/manual/documentos-operacao/#cadastrar-e-anexar","version":"1.2.0"},{"title":"Tabela, filtros e edição em lote","anchor":"tabela-filtros-e-edicao-em-lote","text":"A tabela mostra os campos habilitados para a aba, Arquivo (quantidade de anexos e acesso a eles) e Status. Filtrar permite combinar as colunas disponíveis: Doc, Colaborador/Parceiro, Organização/Suborganização, Data, Valor, Descrição, Arquivo, Previsão, Data de pagamento, Situação e Status, conforme a aba. Texto procura conteúdo, números procuram valor igual, seletores escolhem uma opção e datas permitem limites de início/fim. Limpar retira os filtros. Os filtros de Organização/Suborganização também mantêm registros sem associação; use Sem preenchimento quando essa for a busca desejada. Por padrão, registros inativos ficam fora da lista. Filtre Status → Inativo para consultá-los. Ativo/Pendente/Inativo é o estado de aprovação/uso, separado de Em aberto/Previsto/Pago. Mudar de aba limpa filtros e seleção; não é permitido trocar de aba com edições ou rascunhos pendentes. Editar permite alterar células e depois Salvar; Cancelar descarta o que ainda não foi salvo. Com dois ou mais registros selecionados, Editar selecionados oferece Coluna e Preencher em lote: o mesmo valor é aplicado a todos os selecionados após Confirmar edição. Situação e quantidade de arquivos são calculadas, não campos editáveis em lote. Status depende da permissão de aprovação. Selecionar todos alcança as linhas filtradas de todas as páginas, não só as oito visíveis. A edição em lote não troca a aba nem envia o mesmo arquivo para todos. Para anexos use a linha ou o formulário de cada documento. Alterar Organização em lote limpa Suborganização; selecionar uma Suborganização em lote também define sua Organização. As validações de beneficiário, aprovação, origem do pagamento e fechamento continuam valendo. Não há importação/exportação de documentos por CSV/Excel nessa tabela.","links":[],"url":"/spm/manual/documentos-operacao/#tabela-filtros-e-edicao-em-lote","version":"1.2.0"},{"title":"Duplicar e excluir documentos","anchor":"duplicar-e-excluir-documentos","text":"Duplicar cria rascunhos a partir dos selecionados do filtro; sem seleção, usa os registros da página visível. Revise Doc, beneficiário, empresa, valor e datas e salve as cópias. A duplicação não copia anexos; não reaproveita uma origem fiscal já importada como nova validação. Novos reembolsos precisam dos próprios comprovantes aprovados para gerar saldo. Excluir um rascunho apenas o retira da edição. Para documento salvo, a ação pede confirmação e o torna Inativo, preservando histórico; exige permissão de exclusão. Retirar/inativar a origem de um reembolso pode eliminar saldo ainda não movimentado ou gerar revisão se já houve movimentos, sem apagar baixas existentes. Nota fiscal já utilizada, origem fiscal preservada ou período fechado podem impedir alterações e exclusão.","links":[],"url":"/spm/manual/documentos-operacao/#duplicar-e-excluir-documentos","version":"1.2.0"},{"title":"Situação e aprovação","anchor":"situacao-e-aprovacao","text":"Em Documentos gerais com Data de pagamento habilitada, Situação é automática: Em aberto sem datas aplicáveis, Previsto com Previsão e Pago com Data de pagamento. Pagamento tem prioridade quando ambas existem. Não se escolhe essa situação manualmente. Reembolsos e Notas fiscais não oferecem Data de pagamento; acompanhe a quitação da obrigação em Pagamentos. Status é diferente: Ativo está aprovado para uso, Pendente aguarda Liberações e Inativo foi retirado de uso. Um acesso Padrão configurado para aprovação envia suas inclusões/alterações como pendentes; editar um registro pendente não o aprova. Arquivos seguem a aprovação do documento. Somente preencher Data de pagamento, enviar XML ou salvar o cadastro não substitui a aprovação exigida. Reembolso aprovado, em aba ativa, com ao menos um anexo aprovado pode gerar obrigação conforme modalidade, beneficiários e vigência de Pagamentos. A Data do documento precisa estar na vigência para uma nova obrigação. A referência e o vencimento partem da primeira apuração elegível, normalmente quando aprovação/anexo se completam, conforme o prazo configurado; Previsão não substitui esse prazo. Reprocessar a mesma origem não duplica a obrigação. Reembolso usa seus cupons e recibos, sem exigir nota fiscal separada. Nota fiscal cadastrada não cria pagamento: precisa ser vinculada à obrigação apropriada para fornecer cobertura. Se já houver pagamento ou compensação comprovado pela nota, documento e anexos ficam protegidos. Consulte Notas fiscais e ajustes em Pagamentos para cobertura parcial e remoção de vínculo.","links":["/spm/manual/pagamentos-operacao/#notas-fiscais-e-ajustes"],"url":"/spm/manual/documentos-operacao/#situacao-e-aprovacao","version":"1.2.0"},{"title":"Relação com Pagamentos","anchor":"relacao-com-pagamentos","text":"Documentos gerais e Notas fiscais não geram obrigações por si só. Um reembolso elegível gera uma obrigação em Pagamentos, vinculada ao documento e aos comprovantes.","links":[],"url":"/spm/manual/documentos-operacao/#relacao-com-pagamentos","version":"1.2.0"},{"title":"Arquivos e falhas parciais","anchor":"arquivos-e-falhas-parciais","text":"Use até dez anexos por documento, cada um de 1 byte a 5 MB, com nome de até 150 caracteres. São aceitos PDF, PNG, JPEG, GIF e WebP válidos. XML seguro é aceito exclusivamente em Notas fiscais pelo formulário completo, aba Anexos; o cadastro rápido da tabela aceita PDF/imagens. Arquivo com extensão incompatível com seu conteúdo, vazio ou acima do limite é recusado. No formulário web, clique no nome do arquivo salvo para baixá-lo; download depende da autorização ao documento e de o arquivo existir. Remover exige permissão de exclusão, pede confirmação e aplica a remoção ao salvar; poder editar não concede essa permissão. XML que sustenta uma revisão fiscal não pode ser removido como anexo comum, e notas usadas em pagamentos/compensações protegem também os demais anexos. Documento inativo impede envio, download e remoção pela operação; aba inativa impede novos envios. Duplicar não copia arquivos. Antes do salvamento, Cancelar descarta a fila pendente. No envio comum, cadastro e arquivos são gravados em etapas: se parte falhar, a tela preserva o documento já salvo e os anexos ainda pendentes para tentar novamente, sem recriar o documento. Cancelar após salvamento parcial não desfaz o que foi concluído. Na tabela, não navegue ou abandone a página antes de conferir a mensagem de erro e os arquivos pendentes.","links":[],"url":"/spm/manual/documentos-operacao/#arquivos-e-falhas-parciais","version":"1.2.0"},{"title":"XML de nota fiscal","anchor":"xml-de-nota-fiscal","text":"Em Notas fiscais → Anexos, selecione um XML de até 5 MB. Em produção, o XML seguro pode ser guardado como anexo e os campos devem ser preenchidos manualmente. O preenchimento fiscal é experimental e restrito a desenvolvimento/sandbox, sem homologação universal de fornecedores ou municípios. Não é emissão de nota, OCR, cálculo tributário ou consulta fiscal oficial. Quando a prévia experimental estiver habilitada, uma única nota aplicável pode preencher um rascunho novo. Com várias ocorrências, selecione em Nota do XML qual servirá de origem; só uma nota pode fornecer os campos em cada salvamento. Manter apenas como anexo guarda o arquivo sem aplicar dados fiscais. Doc recebe número, Data recebe emissão, Valor recebe serviços brutos/total-base e Descrição recebe o texto reconhecido. Valor não é automaticamente convertido no líquido após tributos. Dados do XML permite conferir Nota, Tipo, Emissão, Competência, Prestador, Tomador, Serviços (bruto)/Total da nota, Líquido declarado e Retenções declaradas. Em Descrição integral, itens e avisos, confira identificação, texto completo, itens e tributos extraídos. Ausência de informação é mostrada como Não informado no XML, sem inventar valores. Descrição maior que 4.000 caracteres é resumida no campo principal, com original preservado na revisão. Alterações manuais, inclusive durante a leitura, são preservadas. Compare Atual e XML e use Usar dado do XML somente para os campos que deseja substituir. O botão Salvar aguarda o fim da leitura; a prévia não cadastra nem aprova a nota. É preciso salvar e cumprir a aprovação documental aplicável.","links":[],"url":"/spm/manual/documentos-operacao/#xml-de-nota-fiscal","version":"1.2.0"},{"title":"Revisão e impedimentos do XML","anchor":"revisao-e-impedimentos-do-xml","text":"Se prestador/tomador divergir do beneficiário/empresa selecionados, confira as associações ou mantenha o XML apenas como anexo. Revisão excepcional exige permissão de aprovação e Motivo da revisão de até 1.000 caracteres. Uma nova revisão de uma nota já importada também exige essa permissão e motivo. Isso preserva o original e as decisões; não altera o cadastro de Pessoas nem valida assinatura ou autorização fiscal. Uma identidade fiscal já cadastrada na mesma empresa não pode criar outra nota; uma revisão precisa manter a identidade do documento existente. A prévia pertence ao acesso que a enviou, expira em 24 horas e pode precisar ser reenviada. Há limite de 30 prévias pendentes por acesso. XML malformado/inseguro é recusado; formatos, versões, campos essenciais ou avisos fiscais incompatíveis podem impedir o preenchimento, mantendo a alternativa de anexo quando o arquivo for seguro. Os perfis experimentais incluem NFS-e nacional 1.00/1.01, ABRASF 2.04, São Paulo 1/2 e NF-e modelo 55 versão 4.00 base. Isso não promete suporte a toda prefeitura, NFC-e, RPS/DPS, eventos ou novos grupos tributários; NF-e com novos totais RTC pode ter o preenchimento bloqueado para conferência. Estrutura XSD, assinatura e situação na autoridade fiscal não são verificadas. Uma revisão fiscal preservada e a aprovação operacional do documento são controles distintos.","links":[],"url":"/spm/manual/documentos-operacao/#revisao-e-impedimentos-do-xml","version":"1.2.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"Web e aplicativo oferecem cadastro/edição individual, duplicação, anexos e seleção de XML conforme permissões e recursos ativos. Configurar abas, cadastro rápido na tabela e edição em lote ficam no web. O preenchimento XML experimental não está liberado em produção em nenhum canal. Master e Administrador com acesso completo podem aprovar/excluir; Padrão depende da modalidade de acesso direto ou sujeito à aprovação e não pode excluir documentos salvos. Visualizador consulta conforme autorização. Alcance e fechamentos são validados também no servidor: fechamento de Documentos protege sua Data e anexos; vínculos com Pagamentos podem acrescentar restrições. A mensagem indica o fechamento; o Master trata a reabertura em Gerenciador → Fechamento.","links":[],"url":"/spm/manual/documentos-operacao/#disponibilidade","version":"1.2.0"}]},{"id":"importacoes-operacionais","title":"Executar importações cadastradas","summary":"Escolha o mapeamento de entrada, confira formatos e identidades, valide o arquivo e retome lotes sem repetir linhas concluídas.","module":"Operações","version":"1.1.0","publication":"public","channels":["web"],"keywords":["importação","arquivo","mapeamento","CSV","Excel","JSON","lote","validar arquivo","código do lote","atualizar existentes","Baixar resultado","Importar registros"],"related":["permissoes-e-escopos","vendas","documentos-operacao"],"url":"/spm/manual/importacoes-operacionais/","markdownUrl":"/spm/manual/importacoes-operacionais.md","sections":[{"title":"Introdução","anchor":"","text":"Operações → Arquivos executa arquivos conforme mapeamentos de entrada já cadastrados. O mapeamento relaciona os nomes das colunas do arquivo aos campos do Askora; não é um registro comercial nem uma autorização para importar qualquer tipo de dado.","links":[],"url":"/spm/manual/importacoes-operacionais/","version":"1.1.0"},{"title":"Localizar o mapeamento","anchor":"localizar-o-mapeamento","text":"As abas Operações, Gerenciador, Extensões e Integrações separam os destinos. A tabela mostra Nome, Página, Tabela de destino e Campos mapeados, com oito registros por página e filtros desses quatro campos. Campos mapeados é a quantidade de correspondências configuradas, não a quantidade de linhas do arquivo. Ative Usar Arquivos em Integrações → Arquivos → Configurar para exibir esta página em Operações. Arquivos começa desativado. Use Importar na linha do mapeamento. A ação Editar abre sua configuração em Integrações → Arquivos. Não há criação, exclusão ou execução em lote de mapeamentos nessa tabela. Só aparecem mapeamentos de entrada de destinos compatíveis e disponíveis; mapeamentos de saída são utilizados na exportação em Integrações → Arquivos. Se a lista estiver vazia, confira a aba, os filtros, o destino e o cadastro do mapeamento.","links":[],"url":"/spm/manual/importacoes-operacionais/#localizar-o-mapeamento","version":"1.1.0"},{"title":"Selecionar e validar","anchor":"selecionar-e-validar","text":"Localize o mapeamento e use Importar. Em 1. Confira a importação, confirme nome, área e tabela. Abra Campos esperados no arquivo para ver cada coluna de origem, o campo correspondente e a indicação de obrigatório. Em 2. Envie e configure o arquivo, use Selecionar arquivo. A extensão reconhecida ajusta o formato; confira Formato do arquivo e, em CSV, Separador CSV. Escolha Comportamento e Quando uma linha falhar. Confira o Código do lote e use Validar arquivo. Corrija erros e valide novamente. Com pelo menos uma linha válida e nenhuma com erro, Importar registros fica disponível; confirme para gravar. A conferência valida sem persistir registros de negócio. O resultado mostra quantidades de linhas válidas/com erro e, por linha, Resultado e Detalhe. Alterar arquivo, formato, separador ou configuração antes da execução invalida a conferência anterior. Mesmo escolhendo gravar as demais linhas válidas, a tela exige uma prévia sem erros para liberar a execução; a política de falhas vale para problemas encontrados na gravação.","links":["/spm/manual/importacoes-operacionais/#localizar-o-mapeamento"],"url":"/spm/manual/importacoes-operacionais/#selecionar-e-validar","version":"1.1.0"},{"title":"Formato do arquivo e campos","anchor":"formato-do-arquivo-e-campos","text":"Campo ou formato Opções e condições Formato do arquivo CSV, Excel (.xlsx) ou JSON; começa em CSV. Não aceita XLS antigo, PDF, imagem ou arquivo compactado como planilha. Separador CSV Vírgula (padrão), Ponto e vírgula ou Tabulação. Só aparece para CSV e precisa corresponder ao arquivo. CSV Primeira linha contém os nomes dos campos. Aspas delimitam valores com separadores ou quebras de linha. Excel (.xlsx) Uma única planilha, com cabeçalhos; fórmulas e células de erro são recusadas, mesmo que mostrem um resultado calculado. Use valores. JSON Lista de objetos, um objeto por registro; não é um único objeto nem uma lista de valores soltos. Limites Até 2 MB, de 1 a 100 registros por lote e até 100 colunas na planilha. Divida arquivos maiores em lotes distintos. Preserve os nomes esperados pelo mapeamento; os cabeçalhos da planilha não podem estar vazios ou repetidos. As opções e os valores precisam corresponder ao destino ou às conversões configuradas no mapeamento: o sistema não adivinha o significado de uma coluna ou de uma sigla. Campos com os nomes do Askora só passam diretamente quando essa opção está habilitada no mapeamento. Relações, datas, valores obrigatórios e listas continuam sujeitos às validações do cadastro de destino.","links":[],"url":"/spm/manual/importacoes-operacionais/#formato-do-arquivo-e-campos","version":"1.1.0"},{"title":"Criar, atualizar e identificar","anchor":"criar-atualizar-e-identificar","text":"Comportamento Resultado Criar novos registros Padrão. Tenta cadastrar cada linha; não transforma um pedido repetido em atualização. Atualizar existentes Exige encontrar a identidade já cadastrada. Identidade ausente gera erro em vez de criar outro registro. Criar ou atualizar Atualiza quando encontra a identidade e cria quando ela não existe, respeitando o contrato do destino. Em Vendas, a identidade é o número de Pedido (orderNumber), inclusive para devoluções e pedidos inativos. Nas demais tabelas, use o código do sistema de origem com seu espaço de nomes (_external.key e _external.namespace), conforme o mapeamento. Exemplo: código 000123 no sistema ERP deve conservar seus zeros e o mesmo espaço de nomes nas atualizações. O nome da pessoa ou produto não substitui essa identidade. Não use IDs internos de outra empresa para atualizar registros. O Askora resolve identidade e versão, e cada vínculo precisa ser autorizado para o destino. Um erro de identidade não deve ser contornado com Criar novos registros sem conferir se isso produziria duplicação. Cada destino mantém suas regras, permissões, limites, aprovações e efeitos no domínio. Importar uma venda não dispensa Pedido, responsável e data válidos nem evita as proteções de fechamento. Métricas e lotes de Pagamentos não são destinos de criação por esse fluxo. A disponibilidade do mapeamento não amplia o acesso aos dados.","links":[],"url":"/spm/manual/importacoes-operacionais/#criar-atualizar-e-identificar","version":"1.1.0"},{"title":"Falhas, código do lote e retomada","anchor":"falhas-codigo-do-lote-e-retomada","text":"Quando uma linha falhar começa em Gravar as demais linhas válidas. Nessa opção, linhas concluídas permanecem salvas mesmo que outras falhem. Não gravar nenhuma linha desfaz o lote da execução quando uma linha falha. A execução revalida os dados e pode encontrar conflito, limite ou mudança de permissões depois da conferência. Em Identificação do lote e retomada, Código do lote já vem preenchido e admite até 100 caracteres. Guarde-o com o arquivo. Se houver interrupção, use Tentar novamente com o mesmo código, arquivo, ordem das linhas, mapeamento, comportamento e acesso. Linhas já concluídas retornam como Já processada, sem nova gravação; mudar o conteúdo/configuração de uma linha já processada com o mesmo código gera conflito. Não altere o mapeamento para tentar retomar aquele lote. Depois de iniciar a execução, arquivo e opções ficam bloqueados para preservar a retomada. Baixar resultado exporta o relatório JSON com o código, destino, quantidades e resultado por linha, inclusive da conferência; o relatório não é uma nova importação nem confirma sucesso integral. Se houve falhas, confira quais linhas já concluíram antes de preparar uma correção. Novo lote limpa arquivo e conferência, gera outro código e mantém o mapeamento escolhido. Use-o para um trabalho diferente ou um arquivo corrigido; em importação parcial, não reenvie inadvertidamente linhas já criadas como novas. Sair antes da execução descarta a conferência; depois de uma tentativa, preserve o código para retomar. A interface impede sair durante a requisição.","links":[],"url":"/spm/manual/importacoes-operacionais/#falhas-codigo-do-lote-e-retomada","version":"1.1.0"},{"title":"XML fiscal e exportação","anchor":"xml-fiscal-e-exportacao","text":"XML de nota fiscal deve seguir o fluxo de Documentos, na aba fiscal, para validar emitente, destinatário e valores. Não o envie como uma transferência genérica de Arquivos. Esta página executa mapeamentos de entrada. Para extrair dados, use Integrações → Arquivos → Exportar e seu mapeamento de saída; Baixar resultado nesta tela baixa somente o relatório da transferência.","links":[],"url":"/spm/manual/importacoes-operacionais/#xml-fiscal-e-exportacao","version":"1.1.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"A execução e a configuração dos mapeamentos ficam no web e são exclusivas do Master, com validação do destino. Um Administrador não recebe esse acesso apenas por seu perfil administrativo. O aplicativo não oferece tela nativa de Arquivos.","links":[],"url":"/spm/manual/importacoes-operacionais/#disponibilidade","version":"1.1.0"}]},{"id":"tarefas-operacao","title":"Executar tarefas","summary":"Crie tarefas avulsas, execute ocorrências de rotinas, preencha checklist e acompanhe datas, aprovação e conclusão.","module":"Operações","version":"1.2.2","publication":"public","channels":["web","mobile"],"keywords":["tarefas","concluir","cancelar","agenda","ocorrência","checklist","atrasada","previsão","categoria","responsável","duplicar","recorrência"],"related":["tarefas-configuracao","configuracoes-tarefas","pipeline-operacao","liberacoes","fechamentos","performance-bases-de-calculo","recorrencia"],"supportScope":["tarefa","rotina","recorrência","checklist","missão","atividade"],"url":"/spm/manual/tarefas-operacao/","markdownUrl":"/spm/manual/tarefas-operacao.md","sections":[{"title":"Introdução","anchor":"","text":"Operações → Tarefas reúne tarefas avulsas e ocorrências de rotinas em Kanban, Tabela e Calendário. Categorias organizam o Kanban; não são etapas de execução. Arrastar uma tarefa muda sua categoria, não a conclui.","links":[],"url":"/spm/manual/tarefas-operacao/","version":"1.2.2"},{"title":"Criar e executar","anchor":"criar-e-executar","text":"Escolha o cadastro conforme o objetivo: Extensões → Tarefas → Tarefas configura modelos com Recorrência; Operações → Tarefas cria avulsas e executa ocorrências. Para atividades diárias, mensais ou outras repetições, cadastre a rotina uma vez no Gerenciador. O Askora disponibiliza as ocorrências automaticamente conforme a agenda, para os vendedores acompanharem e concluírem pelo app. O cadastro da avulsa, descrito abaixo, está disponível tanto no web quanto no aplicativo; ele não configura repetição. No web, abra o cadastro completo pelo cabeçalho ou use o + de uma categoria ativa no Kanban de hoje. A Tabela também oferece cadastro rápido. No aplicativo, abra o cadastro de Tarefa. Preencha os campos obrigatórios Nome e Categoria. Responsável é opcional: selecione o colaborador ou deixe Sem responsável; confira datas e associações disponíveis. No cadastro completo, prepare a aba Checklist, se necessário, e salve. Cancelar descarta alterações ainda não salvas. No card, use Alterar status para concluir/cancelar ou Mover para categoria para reorganizar. No web, Ver detalhes → Concluir tarefa também encerra a execução. Não existe reabertura comum após conclusão ou cancelamento. Confira Status, atraso e encerramento antes de confirmar. Campo Para que serve e como preencher Nome Identifica o trabalho a executar; obrigatório, até 150 caracteres. Categoria Obrigatória; escolhe a coluna do Kanban. Novas atribuições exigem categoria ativa. Sem categorias, cadastre em Extensões → Tarefas → Categorias. Responsável Opcional. Colaborador que executará ou acompanhará a tarefa, ou Sem responsável. Não seleciona vários executores ou parceiros; deixar vazio não distribui a tarefa a todos. Organização e Suborganização Opcionais quando habilitadas globalmente; Todas significa sem vínculo específico. A suborganização exige sua organização pai; trocar a organização limpa um vínculo incompatível. Status Execução: Em aberto, Concluída ou Cancelada. No aplicativo, o campo se chama Situação. Criação Data informativa opcional; não retroage a abertura real da tarefa. Previsão Data esperada para executar a ocorrência, opcional. Mudar a previsão reagenda essa ocorrência, sem alterar a rotina nem a abertura real. Não há conclusão automática por data. Descrição Instruções e contexto da ocorrência, opcionais, até 4.000 caracteres; disponíveis no formulário completo, não no cadastro rápido. Status do registro No formulário web: Ativo, Pendente ou Inativo, conforme a autorização; controla aprovação/disponibilidade, separadamente da execução. No app, a Tabela permite consultar/filtrar esse estado; Pendente aparece como Em aprovação. Datas aceitam anos de 2000 a 2100. Uma Previsão anterior à abertura não retroage a existência da tarefa. Vínculos inativos já existentes podem permanecer identificados, sem habilitar novas atribuições. O cadastro completo web cria uma avulsa em aberto. No cadastro rápido do Kanban, Datas (opcional) expande Criação/Previsão; Organização/Suborganização também podem ficar recolhidas, e a categoria vem da coluna. Esse cadastro rápido, a edição da Tabela e o formulário do aplicativo oferecem o estado de execução: escolher Concluída/Cancelada pede confirmação e registra encerramento na data real.","links":["/spm/manual/tarefas-operacao/#status-atraso-e-encerramento"],"url":"/spm/manual/tarefas-operacao/#criar-e-executar","version":"1.2.2"},{"title":"Status, atraso e encerramento","anchor":"status-atraso-e-encerramento","text":"Atrasada é a indicação de uma tarefa aberta com previsão anterior a hoje. Não é uma opção de Status, nem depende somente da data Criação. Concluída e Cancelada são resultados da execução; Ativo/Pendente/Inativo é outra dimensão. Uma tarefa concluída mas pendente de aprovação não integra conclusões aprovadas. Conclusão e cancelamento pedem confirmação e são terminais. Não existe reabertura comum; mesmo no histórico de um dia em que estava aberta, uma tarefa já encerrada permanece protegida. A data da ação é a data real, sem conclusão retroativa ou futura. Cancelar conserva o registro e seu resultado de checklist; não é exclusão física. No web, o corpo do card abre os detalhes por clique ou Enter/Espaço. Use Editar tarefa e Salvar para corrigir a ocorrência aberta; Cancelar edição volta à consulta. Na Tabela, Cancelar tarefa encerra a linha como Cancelada. Para várias tarefas, selecione-as e altere Status em lote. No aplicativo, tocar no card abre edição ou consulta; os atalhos de status e categoria evitam abrir o formulário inteiro. Arrastar no web ou usar Mover para categoria altera somente a categoria da ocorrência, escolhendo uma ativa. Uma categoria inativa pode permanecer como coluna quando contém registros, sem permitir novos cadastros nela. Mudar a categoria de uma execução recorrente não altera a categoria das demais.","links":[],"url":"/spm/manual/tarefas-operacao/#status-atraso-e-encerramento","version":"1.2.2"},{"title":"Ocorrências recorrentes","anchor":"ocorrencias-recorrentes","text":"A rotina é configurada em Extensões → Tarefas → Tarefas; a operação executa cada ocorrência. Frequências Diária, Semanal, Mensal, Anual, Personalizada e X vezes por semana/mês seguem a recorrência da rotina. Não há seletor para transformar uma avulsa em rotina nesta tela. Previsões são calculadas a partir da rotina. Consultar o Calendário não cria todas as ocorrências como registros salvos. A primeira edição, reagendamento, resultado de checklist ou encerramento salva aquela ocorrência, preservando sua identidade. Previsões de ocorrências que ainda não chegaram ao dia de abertura são somente leitura; uma avulsa já criada pode ser editada mesmo com Previsão futura. Alterar uma ocorrência modifica apenas aquela execução. Alterar a rotina não modifica ocorrências já salvas. Inativar a rotina interrompe novas previsões, preservando pendências anteriores. Negar/inativar uma ocorrência registrada não faz o calendário recriar uma substituta para ela. Em X vezes por semana/mês, toda a quantidade fica disponível no começo do período, ou no começo da primeira vigência; não é distribuída automaticamente entre os dias. As ocorrências podem ser executadas no mesmo dia. Cada uma tem checklist e conclusão próprios. Mesmo que o nome e a identificação da rotina se repitam, não se trata da mesma execução duplicada.","links":["/spm/manual/tarefas-configuracao/#recorrencia"],"url":"/spm/manual/tarefas-operacao/#ocorrencias-recorrentes","version":"1.2.2"},{"title":"Checklist","anchor":"checklist","text":"No cadastro completo de avulsa, abra Checklist → Adicionar item. Cada item tem Nome obrigatório até 150 caracteres, Descrição opcional até 4.000 e Tipo, Marcação ou Contador. A lista aceita até 100 itens; o editor web oferece remoção e páginas de oito. Salvar aplica a estrutura. O cadastro rápido web não inclui o editor de checklist. No card, expanda Ver checklist. Marcação registra sim/não; Contador registra uma quantidade inteira de zero a 999.999, usando aumentar/diminuir. Cada alteração no card é salva imediatamente. Não há meta de quantidade, mínimo obrigatório de itens marcados ou conclusão automática da tarefa. Encerrar preserva resultados e bloqueia controles. Cada ocorrência recorrente recebe sua própria lista zerada. Nela, altere somente resultados; para adicionar, remover ou renomear itens do modelo, use o Checklist da rotina no Gerenciador. A mudança do modelo não reescreve listas de execuções já salvas. No aplicativo, resultados alterados no formulário de uma avulsa precisam de Salvar, junto com a estrutura da lista. Em uma ocorrência recorrente, os resultados são enviados imediatamente; salve primeiro outras edições pendentes. Se outra sessão mudou a versão, atualize a tarefa antes de tentar novamente.","links":["/spm/manual/tarefas-configuracao/#checklist-da-rotina"],"url":"/spm/manual/tarefas-operacao/#checklist","version":"1.2.2"},{"title":"Calendário, tabela e filtros","anchor":"calendario-tabela-e-filtros","text":"Visualização Recorte e ações Kanban de hoje Tarefas pertinentes ao dia, incluindo pendências anteriores e encerramentos de hoje, agrupadas por categoria. Dias passados Pendências existentes naquele dia e encerramentos daquele dia. Consultar o passado não muda a data real de uma ação feita agora. Dias futuros Somente previsões daquele dia, sem transportar antecipadamente todo o saldo de pendências. Tabela Todas, Aberta, Concluída ou Cancelada, começando em Aberta, sem recorte diário oculto. Previsões ainda não salvas são incluídas até hoje; registros já criados com Previsão futura também podem aparecer. Calendário Semana ou Mês, totais e prévia de até oito tarefas do dia. Ver tarefas do dia abre o Kanban completo, com paginação quando necessária. Uma avulsa sem Previsão aparece desde a abertura; com Previsão, a partir dessa data e nunca antes da abertura real. Se for encerrada antes da previsão, aparece no dia real do encerramento. O calendário usa São Paulo. A mesma pendência pode aparecer em vários dias; não some totais diários como tarefas únicas. No resumo web, Pendentes conta tarefas abertas aprovadas; Aguardando aprovação é separado. O percentual é concluídas dividido pelo total ativo do recorte, incluindo canceladas no total; não representa necessariamente a taxa de um ciclo de Performance. Use as setas para navegar dias/períodos e selecione o dia no Calendário. Uma consulta passada de Tarefas não é um histórico de versões de todos os campos: ela recompõe a situação de execução pela data, preservando o bloqueio de uma tarefa que já foi encerrada. Filtrar combina Nome, Categoria, Responsável, Status, Criação, Previsão, Status do registro e associações disponíveis. Descrição não é filtro. No web, texto usa Contém, seletores permitem opção ou Sem preenchimento, e datas permitem início/fim. Limpar retira filtros; eles acompanham as visualizações. Filtros de Organização/Suborganização também podem incluir registros sem aquele vínculo, dentro do alcance autorizado. Inativos ficam fora da listagem operacional. Confira data, situação, filtros e permissões antes de concluir que uma tarefa desapareceu.","links":[],"url":"/spm/manual/tarefas-operacao/#calendario-tabela-e-filtros","version":"1.2.2"},{"title":"Tabela, duplicação e arquivos","anchor":"tabela-duplicacao-e-arquivos","text":"Na Tabela web, o cadastro rápido prepara linhas para salvar. Editar altera a linha ou, com seleção múltipla, abre Coluna e Preencher em lote. Selecionar todos considera os registros editáveis de todas as páginas filtradas; não permite editar encerrados ou previsões futuras ainda indisponíveis. Descrição e estrutura do Checklist ficam no formulário completo. Salve ou cancele rascunhos/edição antes de trocar a visualização. Duplicar prepara novas avulsas em aberto para revisão e salvamento; não copia identidade da ocorrência, recorrência, encerramento ou histórico. No web, usa os selecionados ou, sem seleção, a página atual, sem transferir checklist. No app, Duplicar na Tabela copia os itens, zerando os resultados. Revise Categoria, Responsável, datas e aprovação da cópia. Exportar baixa JSON de todas as páginas da visão filtrada. Importar recebe uma lista JSON e cria avulsas abertas após confirmação; ignora IDs, recorrências, encerramentos e checklist do arquivo, sem atualizar tarefas existentes. Confira campos obrigatórios e vínculos atuais. Cada envio de até 500 registros é transacional; arquivos/seleções maiores usam blocos sequenciais, e falhas posteriores não desfazem blocos já salvos. Tarefas não oferecem upload de anexos. JSON transfere registros pela Tabela web; não anexa arquivos a uma tarefa.","links":[],"url":"/spm/manual/tarefas-operacao/#tabela-duplicacao-e-arquivos","version":"1.2.2"},{"title":"Aprovação, acesso, fechamentos e Performance","anchor":"aprovacao-acesso-fechamentos-e-performance","text":"O módulo Tarefas precisa estar ativo, com permissão para Operações. Usuários que não são Master também precisam da associação em Extensões → Tarefas → Responsáveis. Essa associação habilita acesso ao workflow, sem atribuir automaticamente todas as tarefas à pessoa. O usuário padrão trabalha com seus registros; administradores respeitam seu alcance de organizações e pessoas. Acesso ao Pipeline, Gerenciador ou Dashboard não concede acesso a esta operação. Conforme a política do usuário, salvar deixa a tarefa Pendente, mesmo que o formulário solicite Ativo. Editar ou concluir não substitui a aprovação. Confira a fila em Liberações; a decisão altera a situação de registro, sem executar a tarefa no lugar do responsável. Fechamentos de Tarefas, Performance ou Pagamentos podem bloquear cadastro, edição, checklist, encerramento e aprovação, inclusive agendas relacionadas. Criação e encerramento são referências protegidas; Criação vazia não garante liberação. Consulte datas protegidas.","links":["/spm/manual/liberacoes/#conferir-e-decidir","/spm/manual/fechamentos/#datas-protegidas"],"url":"/spm/manual/tarefas-operacao/#aprovacao-acesso-fechamentos-e-performance","version":"1.2.2"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"A configuração Usar Tarefas controla a disponibilidade do módulo. Desativá-la preserva o histórico e não conclui as tarefas. Web e aplicativo permitem cadastrar e editar tarefas avulsas, executar ocorrências recorrentes e usar Kanban, Tabela, Calendário e checklist conforme autorização. No app, as setas e o gesto de deslizar navegam entre colunas; a Tabela oferece Editar/Consultar e Duplicar para o registro selecionado. Edição em lote e importação/exportação JSON ficam no web. O aplicativo não possui o Gerenciador de modelos recorrentes, categorias e responsáveis; essa limitação não impede criar avulsas pelo app.","links":["/spm/manual/configuracoes-tarefas/#usar-tarefas"],"url":"/spm/manual/tarefas-operacao/#disponibilidade","version":"1.2.2"}]},{"id":"operacoes","title":"Operações do Askora","summary":"Encontre a operação adequada, seus vínculos e as diferenças entre aprovação, conclusão e pagamento.","module":"Operações","version":"1.0.1","publication":"public","channels":["web","mobile"],"keywords":["operações","rotina","aprovação","conclusão"],"related":["vendas","pipeline-operacao","tarefas-operacao","pagamentos-operacao","metricas-operacao","documentos-operacao","liberacoes","importacoes-operacionais","fechamentos","navegacao-e-recursos-comuns"],"url":"/spm/manual/operacoes/","markdownUrl":"/spm/manual/operacoes.md","sections":[{"title":"Introdução","anchor":"","text":"Operações reúne os registros do trabalho diário. Gerenciador prepara cadastros, regras e ciclos; Configurações define disponibilidade e comportamento dos módulos. As páginas aparecem conforme configuração, perfil e alcance dos dados.","links":[],"url":"/spm/manual/operacoes/","version":"1.0.1"},{"title":"Escolher a operação","anchor":"escolher-a-operacao","text":"Página Para que usar Vendas Registrar vendas e devoluções, produtos, pessoas e data de pagamento do pedido. Pipeline Acompanhar oportunidades, etapas, previsão, Valor, checklist e encerramento. Tarefas Executar tarefas avulsas ou ocorrências recorrentes, registrar resultados e conclusão. Pagamentos Apurar e acompanhar obrigações com beneficiários, ajustes, comprovação fiscal e lotes. Métricas Preencher resultados de métricas para participantes e ciclos autorizados. Documentos Enviar registros e anexos de documentos gerais, notas fiscais ou comprovantes de reembolso. Liberações Revisar, editar e aprovar/negar os registros enviados para aprovação. Arquivos Conferir e importar cadastros e operações dos tipos oferecidos por CSV/XLSX.","links":[],"url":"/spm/manual/operacoes/#escolher-a-operacao","version":"1.0.1"},{"title":"Quem recebe o registro","anchor":"quem-recebe-o-registro","text":"Se você usa acesso Padrão, inclusive por cargo, sua identificação já vem preenchida e bloqueada nas operações que permitem cadastro. Você não precisa selecionar a si mesmo. O comportamento também vale para cadastro rápido e edição na web e para a atualização do app que inclui esse ajuste. Consulte Perfis, permissões e alcance dos dados para entender os vínculos complementares e as diferenças por operação.","links":["/spm/manual/permissoes-e-escopos/#registrar-para-si-mesmo"],"url":"/spm/manual/operacoes/#quem-recebe-o-registro","version":"1.0.1"},{"title":"Aprovação, conclusão e pagamento","anchor":"aprovacao-conclusao-e-pagamento","text":"Ativo, Pendente e Inativo indicam disponibilidade ou aprovação quando o módulo usa esses estados. Não confundem a aprovação de uma oportunidade com Ganho, a aprovação de uma tarefa com Concluída ou a aprovação de um título com pagamento. Preencher uma data de pagamento registra uma baixa local. Conciliar compara essa baixa com o extrato bancário. Aprovar um documento permite sua utilização nos vínculos elegíveis, mas não garante por si só remuneração ou reembolso. Confira os requisitos da operação antes de interpretar um resultado.","links":[],"url":"/spm/manual/operacoes/#aprovacao-conclusao-e-pagamento","version":"1.0.1"},{"title":"Corrigir um período fechado","anchor":"corrigir-um-periodo-fechado","text":"Se uma operação for bloqueada por fechamento, identifique o módulo e a data informados na mensagem. Gerenciador → Fechamento é a tela administrativa do Master para conferir e reabrir os bloqueios; ela não fica no menu Operações. A restrição pode vir de outra origem relacionada: uma alteração em Documentos pode afetar Pagamentos, e uma baixa pode afetar Performance. Não troque datas para contornar o bloqueio. O Master precisa revisar as datas protegidas e consultar e reabrir os bloqueios que realmente abrangem a correção. Reabrir não corrige dados automaticamente.","links":["/spm/manual/fechamentos/#datas-protegidas","/spm/manual/fechamentos/#consultar-e-reabrir"],"url":"/spm/manual/operacoes/#corrigir-um-periodo-fechado","version":"1.0.1"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"Web e aplicativo têm recursos próprios. As páginas específicas deste manual informam formulários, visualizações e ações de cada canal. Importações por arquivo, Fechamentos, várias ações em lote pertencem ao web. Um campo ausente pode depender de configuração ou permissão; uma lista vazia também pode ser resultado do filtro.","links":[],"url":"/spm/manual/operacoes/#disponibilidade","version":"1.0.1"}]},{"id":"metricas-operacao","title":"Preencher resultados de Métricas","summary":"Localize os resultados gerados pela Performance, preencha a unidade correta e confira aprovação, histórico e edição em lote.","module":"Operações","version":"1.1.0","publication":"public","channels":["web","mobile"],"keywords":["métrica","resultado","indicador","quantidade","percentual","aprovação","vazio","zero","editar selecionados"],"related":["performance","performance-bases-de-calculo","metas","liberacoes","fechamentos","permissoes-e-escopos"],"url":"/spm/manual/metricas-operacao/","markdownUrl":"/spm/manual/metricas-operacao.md","sections":[{"title":"Introdução","anchor":"","text":"Em Operações → Métricas, preencha resultados dos indicadores de Quantidade, Valor e Percentual criados na Performance. Vendas e faturamento usam suas próprias fontes e não criam uma métrica manual equivalente.","links":[],"url":"/spm/manual/metricas-operacao/","version":"1.1.0"},{"title":"Como aparecem os registros","anchor":"como-aparecem-os-registros","text":"A Performance precisa estar ativa e pronta, com origem e grupo habilitados. Cada indicador elegível gera um resultado por participante aplicável, separado entre Comissão/Bônus e Colaboradores/Parceiros. Rascunhos não aparecem; ciclos futuros, atuais ou encerrados podem receber preenchimento, respeitando fechamentos. A tela não oferece criar, duplicar ou excluir uma métrica livremente. Organização, responsável, origem e unidade vêm do ciclo. Para acrescentar um objetivo, altere os indicadores no Gerenciador de Performance; para registrar uma venda, use Vendas. Métricas não são lançamentos diários: cada Resultado pertence ao indicador, participante e ciclo apresentados. Salvar novamente a Performance não duplica resultados nem zera os já preenchidos. Remover um participante/indicador ou desabilitar um grupo pode inativar seu resultado sem apagar o histórico. Recuperar a mesma associação e unidade pode restaurar esse histórico; alterar a unidade cria uma identidade inicialmente vazia, para não reinterpretar quantidade como dinheiro. Recusas de aprovação não são revertidas por essa sincronização.","links":[],"url":"/spm/manual/metricas-operacao/#como-aparecem-os-registros","version":"1.1.0"},{"title":"Localizar a métrica e conferir os campos","anchor":"localizar-a-metrica-e-conferir-os-campos","text":"No web, a aba Todas mostra oito linhas por página. Filtro combina os campos abaixo; Organização/Suborganização aparecem somente quando habilitadas. Confira o Responsável e a Origem quando houver indicadores de mesmo nome. Campo O que identifica Métrica Nome do indicador e identificador do resultado. Não é editável nesta operação. Performance Nome e identificador do ciclo ao qual o resultado pertence. Organização / Suborganização Vínculos do participante guardados no ciclo; não são campos para transferir o resultado a outra unidade. Responsável Colaborador ou Parceiro que terá esse resultado avaliado. O tipo aparece abaixo do nome. Origem Comissão ou Bônus; resultados das duas origens são independentes. Tipo Quantidade, Valor ou Percentual, conforme o indicador. Resultado Único valor editável; vazio aparece como traço. Status Ativo, Pendente ou Inativo; informa a situação do registro/aprovação, não o atingimento da meta. Sem filtro de inativos, a consulta apresenta resultados ativos/pendentes de ciclos elegíveis. Se não aparecer uma métrica, confira Performance habilitada, ciclo pronto/ativo, participante, indicador e grupo habilitados, filtros e alcance do acesso. A tela não possui Importar/Exportar de resultados por arquivo.","links":[],"url":"/spm/manual/metricas-operacao/#localizar-a-metrica-e-conferir-os-campos","version":"1.1.0"},{"title":"Editar Resultado","anchor":"editar-resultado","text":"Localize a linha por Métrica, Performance, Responsável e Origem. Use Editar e preencha somente Resultado. Confira a unidade e salve; Cancelar descarta a edição local. No web, Editar sem seleção libera a página atual; com uma seleção ou pela ação da linha, libera somente aquele resultado. Preencha e use Salvar; Cancelar restaura a consulta sem gravar. Paginação, seleção e outras ações ficam bloqueadas enquanto os campos estão em edição. Use a edição em lote quando quiser aplicar o mesmo resultado a várias linhas. Unidade Entrada Quantidade No editor web, informe inteiro não negativo. O aplicativo e o registro operacional admitem até quatro casas decimais, mas quantidade fracionária não é válida para a calculadora de remuneração. Valor Não negativo, até duas casas decimais. Percentual Não negativo, até quatro casas; 10 significa 10%, não 0,10. Pode ultrapassar 100%. O limite é de 11 dígitos inteiros, com as casas indicadas para cada unidade. Vazio é diferente de zero: limpar o campo significa não preenchido; zero é um resultado informado. O preenchimento substitui o Resultado anterior, não acrescenta uma movimentação ao acumulado. Metas e apuração podem exigir resultado aprovado e não vazio.","links":[],"url":"/spm/manual/metricas-operacao/#editar-resultado","version":"1.1.0"},{"title":"Aplicar Resultado em lote","anchor":"aplicar-resultado-em-lote","text":"Selecione as linhas e use Editar selecionados. O card permite escolher somente Resultado e aplicar o mesmo número aos selecionados. Selecionar todos abrange todo o filtro, inclusive outras páginas; clicar novamente com seleção a limpa. Alterar filtros limpa a seleção. Confira as unidades antes de aplicar um valor comum. Um lote que inclua Quantidade aceita inteiros; com Valor e Percentual juntos, a entrada usa até duas casas decimais. Um lote apenas de Percentual permite até quatro. Aplicar 10 significa dez unidades, R$ 10 ou 10%, conforme cada linha; não há conversão automática entre unidades. Cada bloco de até 500 resultados é validado e salvo integralmente. Em uma seleção maior, blocos são enviados em sequência; uma falha posterior não desfaz os anteriores. Leia a quantidade já salva antes de tentar novamente.","links":[],"url":"/spm/manual/metricas-operacao/#aplicar-resultado-em-lote","version":"1.1.0"},{"title":"Aprovação, histórico e erros","anchor":"aprovacao-historico-e-erros","text":"Quando a política exige aprovação, salvar deixa o resultado Pendente para Operações → Liberações. Ele ainda não conta no cálculo. Editar novamente um resultado pendente não o aprova, mesmo que o campo tenha sido corrigido. Salvar novamente a Performance também não aprova pendências nem restaura resultados recusados. Consulte os efeitos da aprovação e recusa. O filtro Status = Inativo consulta histórico, inclusive de ciclos inativados, somente para leitura. Não oferece reativação ou edição; limpar esse filtro volta à consulta corrente. Se a versão mudou, cancele e atualize antes de revisar. Métrica indisponível pode ter perdido a elegibilidade ou o alcance do seu acesso. A operação exige acesso a Métricas e Performance habilitada; permissões de consulta não permitem preencher. Usuários Padrão ficam limitados aos próprios resultados, e administradores respeitam seu alcance. Fechamentos podem impedir a gravação mesmo que o ciclo ainda apareça na consulta.","links":["/spm/manual/liberacoes/#efeitos-da-decisao","/spm/manual/fechamentos/#datas-protegidas"],"url":"/spm/manual/metricas-operacao/#aprovacao-historico-e-erros","version":"1.1.0"},{"title":"Consequências nos resultados da Performance","anchor":"consequencias-nos-resultados-da-performance","text":"Preencher Resultado não altera a meta nem paga uma comissão. A apuração compara os resultados elegíveis com a meta do indicador e aplica sua regra. Métricas de Quantidade e Valor somam os resultados do conjunto; Percentual usa média aritmética simples. Meta compartilhada não cria uma linha operacional coletiva em lugar das pessoas: os resultados continuam separados por participante. Cada participante necessário ao cálculo precisa de um resultado aprovado e preenchido. Zero informado participa do cálculo; vazio e pendência podem impedi-lo. Quantidade fracionária aceita no registro não atende à exigência de inteiros da calculadora. Veja as unidades e condições de Métricas na Performance.","links":["/spm/manual/performance-bases-de-calculo/"],"url":"/spm/manual/metricas-operacao/#consequencias-nos-resultados-da-performance","version":"1.1.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"Web e aplicativo oferecem consulta e preenchimento conforme permissões e alcance. No aplicativo, selecione uma linha e use Editar; sem permissão de edição ou no histórico inativo, a ação é Consultar. O formulário mantém os dados de referência somente para leitura e edita Resultado, identificado como Resultado (%) para percentuais. A seleção múltipla e a edição em lote descritas pertencem ao web. O aplicativo não oferece criar/duplicar métricas nem importar resultados; configuração de indicadores, participantes e metas fica no Gerenciador web.","links":[],"url":"/spm/manual/metricas-operacao/#disponibilidade","version":"1.1.0"}]},{"id":"recorrencia","title":"Recorrência e calendário","summary":"Entenda datas de repetição, quotas, meses curtos e os efeitos diferentes em Tarefas e Contas fixas.","module":"Operações","version":"1.1.0","publication":"public","channels":["web","mobile"],"keywords":["recorrência","diária","semanal","mensal","anual","quota"],"related":["tarefas-configuracao","tarefas-operacao"],"url":"/spm/manual/recorrencia/","markdownUrl":"/spm/manual/recorrencia.md","sections":[{"title":"Introdução","anchor":"","text":"Tarefas usa as opções de calendário para calcular previsões de execução e suas ocorrências.","links":[],"url":"/spm/manual/recorrencia/","version":"1.1.0"},{"title":"Escolher a regra","anchor":"escolher-a-regra","text":"Tipo O que informar Diária Nenhum complemento. Semanal Dia da semana. Mensal Dia do mês, de 1 a 31. Anual Segue a data de início ou referência da agenda. Personalizada Intervalo de 1 a 999 e unidade dias/semanas/meses/anos; em semanas, dia opcional. X vezes por semana/mês Quantidade de 1 a 999, somente em Tarefas. Os complementos mudam com o tipo. Confira a regra completa ao editar; parâmetros ocultos de outra opção não devem orientar a nova agenda. Início e término de Contas fixas são campos de vigência separados.","links":[],"url":"/spm/manual/recorrencia/#escolher-a-regra","version":"1.1.0"},{"title":"Meses curtos e primeiro dia","anchor":"meses-curtos-e-primeiro-dia","text":"A primeira ocorrência não antecede o início. Dias mensais acima do último dia do mês usam seu último dia, sem perder a referência original: dia 31 volta a 31 quando o mês permite. Uma recorrência anual iniciada em 29/fev volta a essa data nos anos bissextos. Término informado é inclusivo. Uma regra a cada duas semanas parte de sua referência de agenda; não significa necessariamente duas vezes em toda semana. Em personalizada semanal sem dia explícito, utiliza-se o dia de início.","links":[],"url":"/spm/manual/recorrencia/#meses-curtos-e-primeiro-dia","version":"1.1.0"},{"title":"Quotas de tarefas","anchor":"quotas-de-tarefas","text":"X vezes por semana/mês cria uma quantidade disponível no começo do período, ou a partir da ativação no primeiro período. Não distribui automaticamente as execuções entre dias. Pode haver várias no mesmo dia e pendências acumuladas. Essa opção não existe em Contas fixas, porque uma quantidade por período não determina por si só datas individuais de cobrança.","links":[],"url":"/spm/manual/recorrencia/#quotas-de-tarefas","version":"1.1.0"},{"title":"Alterar a agenda","anchor":"alterar-a-agenda","text":"Em Tarefas, revisões preservam a agenda anterior e ocorrências já materializadas. Em Contas fixas, apenas previsões automáticas futuras elegíveis acompanham o modelo; títulos pagos ou modificados permanecem protegidos. Inativação não apaga o histórico.","links":[],"url":"/spm/manual/recorrencia/#alterar-a-agenda","version":"1.1.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"A definição das rotinas de Tarefas fica no Gerenciador web. Contas fixas pode ser mantida no web e no aplicativo autorizado. O aplicativo consulta e executa ocorrências de Tarefas, sem editor nativo do modelo recorrente.","links":[],"url":"/spm/manual/recorrencia/#disponibilidade","version":"1.1.0"}]},{"id":"liberacoes","title":"Revisar Liberações","summary":"Confira, edite e aprove ou negue registros pendentes, respeitando a origem e seus efeitos.","module":"Operações","version":"1.2.0","publication":"public","channels":["web","mobile"],"keywords":["liberações","aprovar","negar","pendente","revisão","aprovar todos","negar todos"],"related":["permissoes-e-escopos","metricas-operacao","documentos-operacao","fechamentos"],"url":"/spm/manual/liberacoes/","markdownUrl":"/spm/manual/liberacoes.md","sections":[{"title":"Introdução","anchor":"","text":"Operações → Liberações reúne registros que aguardam decisão. Não é uma tela para criar solicitações separadas: a revisão atua sobre os próprios registros operacionais.","links":[],"url":"/spm/manual/liberacoes/","version":"1.2.0"},{"title":"Estados e alcance","anchor":"estados-e-alcance","text":"Ativo é elegível para resultados; Pendente aguarda decisão; Inativo permanece no histórico. Esses estados não substituem pagamento, etapa comercial ou conclusão de tarefa. Uma venda pode ter Data de pagamento preenchida e ainda estar pendente de aprovação. Consultar Liberações exige acesso à página e consulta ao módulo de origem, dentro do alcance dos registros. Editar e decidir exigem as capacidades correspondentes, inclusive aprovação na origem; a consulta pode estar disponível sem autorização para aprovar. Abrir a fila não concede acesso a todos os módulos. A política que permite registrar sem aprovação não libera automaticamente pendências anteriores. Responsáveis e permissões de Pipeline/Tarefas continuam independentes. Novas submissões pendentes geram a notificação Aprovação pendente para Master e Admin com permissão para decidir e alcance sobre o registro. O texto identifica a operação e direciona para esta página. Em documentos, identifica a aba. Editar uma pendência não repete o pedido; após a decisão, ele deixa de aparecer na caixa. Consulte Notificações para as regras de destinatários e envio.","links":["/spm/manual/notificacoes/"],"url":"/spm/manual/liberacoes/#estados-e-alcance","version":"1.2.0"},{"title":"Conferir e decidir","anchor":"conferir-e-decidir","text":"Abra a aba com pendências: Pipeline, Tarefas, Vendas, Documentos ou Métricas. Revise os dados e anexos. Edite apenas os campos oferecidos e salve a revisão, se necessário. Use Aprovar ou Negar e confira quantidade/origem na confirmação. No web, Aprovar todos/Negar todos considera o filtro do tipo atual; com seleção, considera os selecionados. Não abrange silenciosamente outras abas. A seleção pode alcançar outras páginas da mesma tabela. A confirmação identifica a origem, a quantidade e a decisão. Cancelar mantém os registros pendentes. Salve ou cancele a edição antes de decidir; editar os dados não equivale a aprová-los. Após a decisão, os registros saem da fila e abas vazias desaparecem. Se não houver pendências, a tela mostra o estado vazio. Pendências podem continuar revisáveis depois da desativação do módulo, conforme autorização.","links":[],"url":"/spm/manual/liberacoes/#conferir-e-decidir","version":"1.2.0"},{"title":"Campos, filtros e anexos","anchor":"campos-filtros-e-anexos","text":"A tabela web mostra oito registros por página. Filtrar combina os campos da origem; o filtro e a seleção valem para a aba e o tipo de registro atuais. Origem O que conferir na fila Pipeline Nome, Criação, Previsão, Status comercial, Valor, Responsável, vínculos e campos personalizados oferecidos. Aprovação não significa oportunidade ganha. Tarefas Nome, Criação, Previsão, Situação, Categoria, Responsável e vínculos oferecidos, distinguindo ocorrência recorrente de tarefa avulsa. Vendas Pedido, Venda/Devolução, data, data de pagamento, valor e vínculos disponíveis. Documentos Aba e campos configurados, incluindo data, valor, pessoas e quantidade de anexos. Aba é informativa e não pode ser trocada pela fila. Métricas Performance, Métrica, participante e Resultado. Somente Resultado pode ser editado, com a unidade da métrica. Em Documentos, abra a quantidade de anexos para consultar/baixar os arquivos autorizados. Essa revisão não oferece adicionar ou excluir arquivos; faça a manutenção na operação de origem, quando permitida. As colunas reúnem os campos das abas com pendências, e um campo pode não se aplicar a determinado documento. Editar permite alterar os campos oferecidos na tabela; sem seleção, a edição trabalha na página visível. A edição em lote da seleção considera campos compatíveis entre os registros. Salvar mantém o estado Pendente, aguardando Aprovar/Negar. Campos protegidos pela origem, como títulos pagos ou vínculos agrupados antigos, não se tornam editáveis por estarem em Liberações. Não há cadastro de novas solicitações, importação ou exportação própria em Liberações. Um registro precisa primeiro ter sido enviado para aprovação pelo fluxo de origem. Criação de Pipeline e Criação/Previsão de Tarefas não são aceitas como alterações pela revisão. No aplicativo ficam somente para consulta. A tabela web ainda pode oferecer esses controles e recusar o salvamento por campos não editáveis; revise essas datas na operação de origem, conforme permissão, e atualize a fila.","links":[],"url":"/spm/manual/liberacoes/#campos-filtros-e-anexos","version":"1.2.0"},{"title":"Efeitos da decisão","anchor":"efeitos-da-decisao","text":"Aprovar ativa o registro; negar o inativa. Filhos e vínculos acompanham as regras da origem, sem reativar itens anteriormente removidos. Vendas propagam a decisão aos filhos elegíveis. Em Documentos, uma nota aprovada pode passar a comprovar os pagamentos vinculados, se atender às validações fiscais. Um comprovante de reembolso aprovado pode compor a apuração conforme configuração, vigência e anexos exigidos. Documentos gerais e Notas fiscais não geram obrigação por si só. Métricas permite editar somente Resultado. Uma ocorrência recorrente recusada não é recriada pelo calendário. Decidir uma oportunidade registra nova versão sem substituir automaticamente sua etapa comercial.","links":[],"url":"/spm/manual/liberacoes/#efeitos-da-decisao","version":"1.2.0"},{"title":"Conflitos e lotes","anchor":"conflitos-e-lotes","text":"Cada decisão confere versão e estado pendente. Se outro usuário já decidiu ou alterou o registro, atualize a fila e revise novamente. Fechamentos também podem bloquear a ação. Cada lote de até 500 é transacional. Seleções maiores no web usam envios sequenciais: uma falha informa o que já foi processado, sem garantir reversão de blocos anteriores. Editar a fila não dispensa a decisão posterior.","links":[],"url":"/spm/manual/liberacoes/#conflitos-e-lotes","version":"1.2.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"Web e aplicativo oferecem revisão conforme autorização. No aplicativo, abra um registro, confira seus campos/anexos, edite os campos permitidos e salve antes de aprovar ou negar, com confirmação individual. Seleção entre páginas e edição/decisão em lote pertencem à tabela web. Fechamentos e permissões da origem continuam válidos nos dois canais.","links":[],"url":"/spm/manual/liberacoes/#disponibilidade","version":"1.2.0"}]},{"id":"vendas","title":"Vendas e devoluções","summary":"Registre vendas e devoluções, associe clientes e produtos e acompanhe a data de pagamento e seus efeitos na Performance.","module":"Operações","version":"1.2.0","publication":"public","channels":["web","mobile"],"keywords":["venda","devolução","pedido","cliente","duplicar venda","cadastro rápido","produtos","aprovação"],"related":["produtos","performance-bases-de-calculo","liberacoes","importacoes-operacionais","fechamentos"],"url":"/spm/manual/vendas/","markdownUrl":"/spm/manual/vendas.md","sections":[{"title":"Introdução","anchor":"","text":"Em Operações → Vendas, registre o valor comercial e os responsáveis por cada pedido. As abas Todos, Vendas e Devoluções organizam a consulta. Uma devolução é um registro próprio, com valor positivo e Tipo = Devolução; a dedução nos resultados decorre do tipo, não de digitar um valor negativo.","links":[],"url":"/spm/manual/vendas/","version":"1.2.0"},{"title":"Cadastrar o pedido","anchor":"cadastrar-o-pedido","text":"No cabeçalho, use Vendas; na aba Devoluções, a ação aparece como Devolução e inicia esse tipo. Preencha Informações principais. Confira Cliente e Produtos, quando essas abas estiverem disponíveis. Revise o Valor comercial e as datas e use Salvar. Trocar de aba do cadastro mantém os dados em edição. Campo Como preencher e efeito Tipo Venda ou Devolução. O novo cadastro começa em Venda, exceto quando aberto pela aba Devoluções. Pedido Obrigatório, até 100 caracteres e único na empresa, incluindo devoluções e registros inativos. Data Data da venda/devolução; começa na data atual. Obrigatória e utilizada na contabilização por Data da venda. Data de pagamento Opcional, exibida à direita de Data quando habilitada em Performance → Configurar. Uma data preenchida indica pagamento integral nessa data. Valor Valor comercial total, monetário e não negativo; começa em zero. Não é preenchido automaticamente pela soma dos produtos no formulário web. Colaborador Responsável pela venda, obrigatório quando Colaboradores está habilitado. Participação nos resultados depende também do vínculo desse colaborador com a Performance. Parceiro Opcional, quando Parceiros está habilitado em Pessoas. É distinto do Cliente e do Colaborador; pode participar dos resultados conforme o ciclo. Organização / Suborganização Associações disponíveis conforme configurações e alcance do acesso. A Suborganização precisa pertencer à Organização selecionada. Detalhes Texto opcional, até 4.000 caracteres. O gerador junto a Pedido sugere PED- para venda e DEV- para devolução, seguidos de seis letras/números. A sugestão não reserva o número. Se outro registro usar o mesmo pedido antes de salvar, altere-o ou gere outro. O cadastro não exige vínculo com um pedido anterior para registrar uma devolução.","links":[],"url":"/spm/manual/vendas/#cadastrar-o-pedido","version":"1.2.0"},{"title":"Cliente e produtos","anchor":"cliente-e-produtos","text":"A venda pode ter um Cliente e até 500 itens de produto. As abas dependem de Clientes e Produtos habilitados; não são obrigatórias para um pedido básico. No web, Buscar cliente/produto → Busca localiza pelo nome ou documento e apresenta até oito correspondências. Em Cliente, selecionar um cadastro o vincula à venda e mostra Nome, Documento, Responsável, Organização e Suborganização, conforme os recursos habilitados. O Responsável desse cadastro é quem acompanha o cliente; não substitui automaticamente o Colaborador da venda. Editar libera os campos; Cadastrar e vincular salva a pessoa e mantém o vínculo. + Novo cliente prepara outro cadastro. Em Produtos, selecionar um cadastro mostra Nome, Valor, Organização e Suborganização. Use + Adicionar produto para incluí-lo na coleção da venda. Editar e Cadastrar e adicionar alteram o produto de origem; + Novo produto prepara um novo cadastro. Essas gravações no Gerenciador são imediatas e exigem suas permissões próprias: cancelar depois a venda não desfaz um cliente/produto já criado ou alterado. Em Produtos vinculados à venda, cada item possui Produto, Quantidade, Valor unitário e Remover. A inclusão sugere quantidade 1 e o preço do produto. Quantidade e valor unitário pertencem à venda; alterá-los não altera o preço do catálogo. Quantidade deve ser positiva, com até quatro casas decimais; valor unitário admite zero e usa centavos. O total do item é arredondado: 0,1 × R$ 10,05 resulta em R$ 1,01. Remover retira o item da venda ao salvar, sem excluir o produto. Confira separadamente o Valor total da venda. Não há controle de estoque nem cálculo tributário nessa operação.","links":[],"url":"/spm/manual/vendas/#cliente-e-produtos","version":"1.2.0"},{"title":"Data de pagamento","anchor":"data-de-pagamento","text":"Ative Gerenciador → Performance → Configurar → Usar data de pagamento nas vendas para exibir Data de pagamento imediatamente à direita de Data na tabela e no cadastro. A opção começa desativada. Uma venda com data de pagamento é considerada paga nessa data, pelo seu valor integral. Sem data, ela não participa dos cálculos por pagamento. É possível corrigir ou limpar essa data, respeitando os fechamentos. A venda continua disponível para edição; o pagamento não bloqueia o cadastro. A configuração libera o preenchimento e a escolha da base nos novos ciclos. Os cálculos seguem a Base de cálculo para resultados salva em cada Performance. Desativar a opção não apaga datas nem muda ciclos existentes.","links":[],"url":"/spm/manual/vendas/#data-de-pagamento","version":"1.2.0"},{"title":"Exclusão e proteção","anchor":"exclusao-e-protecao","text":"Excluir pede confirmação e inativa a venda e seus produtos. Alterações usam a versão atual do registro; recarregue se outra sessão gravou antes. Os fechamentos protegem as datas da venda e do pagamento. Ter Data de pagamento preenchida não bloqueia o cadastro para edição.","links":[],"url":"/spm/manual/vendas/#exclusao-e-protecao","version":"1.2.0"},{"title":"Status, aprovação e permissões","anchor":"status-aprovacao-e-permissoes","text":"Status → Ativo, Pendente ou Inativo é o estado do registro, não informa se a venda foi recebida. Quando seu acesso exige aprovação, o pedido salvo fica Pendente e segue para Operações → Liberações. Editar um pedido pendente não substitui a aprovação. Registros pendentes ou inativos não entram nos cálculos que exigem vendas ativas/aprovadas. Acesso à operação, criação, edição, exclusão e aprovação dependem das permissões. Um usuário Padrão consulta seus próprios registros de colaborador ou parceiro; permissões de edição não liberam vendas de outras pessoas. Administradores respeitam o alcance organizacional configurado. Novos vínculos precisam estar ativos e acessíveis. Catálogos desabilitados preservam os vínculos existentes, mas podem ocultar seus campos ou impedir novos vínculos. Confira a decisão e seus efeitos em Liberações. Limites contratados, pedido repetido, referências indisponíveis e fechamento podem recusar o salvamento; erro em um item do pedido não grava apenas parte desse pedido.","links":["/spm/manual/liberacoes/#efeitos-da-decisao"],"url":"/spm/manual/vendas/#status-aprovacao-e-permissoes","version":"1.2.0"},{"title":"Tabela e disponibilidade","anchor":"tabela-e-disponibilidade","text":"No web, a tabela tem oito registros por página. Filtro combina os campos das colunas visíveis: Tipo, Pedido, Colaborador, Parceiro, Organização, Suborganização, Data, Data de pagamento, Valor, Detalhes e Status, conforme recursos habilitados. Cliente e Produtos não são filtros dessa tabela. Sem escolher Inativo, a consulta oculta registros inativos. Alterar aba ou filtro limpa a seleção. Cadastro rápido adiciona linhas temporárias para os dados básicos, sem Cliente ou Produtos. Confira o Colaborador sugerido. Cada clique acrescenta outra linha; Cancelar descarta os rascunhos locais. A ação Editar da linha abre o cadastro completo. Selecionar todos abrange a aba filtrada inteira, inclusive outras páginas; clicar com alguma seleção a limpa. Editar no topo, sem seleção, libera os campos básicos da página; uma seleção delimita aquele registro. Com várias, Editar selecionados aplica um mesmo campo/valor aos selecionados. Pedido não pode ser alterado por esse lote. Cliente, produtos e demais campos não selecionados são preservados; mudar Organização limpa a Suborganização incompatível. Salvar conclui a edição local; Cancelar a descarta. Os lotes são processados em blocos de até 500 registros: um erro desfaz o bloco, mas blocos anteriores podem já estar salvos. Leia a quantidade confirmada antes de tentar novamente.","links":[],"url":"/spm/manual/vendas/#tabela-e-disponibilidade","version":"1.2.0"},{"title":"Duplicar vendas","anchor":"duplicar-vendas","text":"Duplicar, sem seleção, prepara cópias dos dados básicos da página visível. Com seleção, copia os selecionados da aba filtrada, inclusive outras páginas. A cópia vem sem Pedido, Cliente ou Produtos; preencha um novo Pedido e revise os demais dados. Ela só é criada ao salvar. Não é uma cópia integral do pedido.","links":[],"url":"/spm/manual/vendas/#duplicar-vendas","version":"1.2.0"},{"title":"Importar e exportar vendas","anchor":"importar-e-exportar-vendas","text":"Os botões Importar e Exportar exibidos na tabela de Vendas ainda não executam transferência nesta versão. Para importar pedidos por arquivo, use um mapeamento em Operações → Arquivos. O cadastro de Vendas não recebe XML fiscal nem possui anexo de nota: esse fluxo fica em Documentos → XML de nota fiscal.","links":["/spm/manual/importacoes-operacionais/#selecionar-e-validar","/spm/manual/documentos-operacao/#xml-de-nota-fiscal"],"url":"/spm/manual/vendas/#importar-e-exportar-vendas","version":"1.2.0"},{"title":"Como a venda entra na Performance","anchor":"como-a-venda-entra-na-performance","text":"Registrar uma venda não cria comissão ou pagamento automaticamente. O pedido precisa estar ativo/aprovado e ligado a um colaborador ou parceiro participante do ciclo; as regras do indicador determinam como o resultado remunera. A base salva no ciclo considera Data da venda ou Data de pagamento, usando o valor integral das vendas ativas menos devoluções. Sem data de pagamento, a venda não entra na segunda base. O colaborador e o parceiro são os da venda/devolução. Pagamentos de comissão, bônus, prêmio, fixo e reembolso não alteram essa base. Uma venda de R$ 3.000 paga em agosto contribui R$ 3.000 no ciclo que usa Data de pagamento de agosto. Consulte bases e datas da Performance. Não existe seletor de Performance no pedido: a associação decorre dos participantes, datas e base do ciclo.","links":["/spm/manual/performance-bases-de-calculo/#data-da-venda-e-data-de-pagamento"],"url":"/spm/manual/vendas/#como-a-venda-entra-na-performance","version":"1.2.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"Web e aplicativo oferecem consulta, cadastro, edição e duplicação de vendas/devoluções conforme permissões, aprovação e fechamentos. O aplicativo trabalha com um registro selecionado; não oferece o cadastro rápido, a edição em lote nem a transferência de arquivos da tabela web. No aplicativo, Cliente e Produto são escolhidos entre cadastros existentes; o espelho para criar/editar esses catálogos pertence ao web. Nos produtos, Usar este total na venda copia explicitamente a soma dos itens para Valor. Configurações dos catálogos ficam no web.","links":[],"url":"/spm/manual/vendas/#disponibilidade","version":"1.2.0"}]},{"id":"performance-bases-de-calculo","title":"Bases de cálculo e datas da Performance","summary":"Identifique as fontes de Vendas, Faturamento e Métricas e quais datas e participantes entram no resultado.","module":"Performance","version":"1.2.0","publication":"public","channels":["web","mobile"],"keywords":["Pipeline","Tarefas","comissão","bônus","base de cálculo","faturamento","métricas","Valor"],"related":["performance","performance-participantes","performance-regras-de-calculo","metas","apuracao","pipeline-operacao"],"url":"/spm/manual/performance-bases-de-calculo/","markdownUrl":"/spm/manual/performance-bases-de-calculo.md","sections":[{"title":"Introdução","anchor":"","text":"Em Gerenciador → Performance, Base de cálculo para resultados escolhe a data usada para incluir vendas e devoluções no ciclo. Cada indicador de comissão ou bônus escolhe a base Vendas, Faturamento ou Métricas.","links":[],"url":"/spm/manual/performance-bases-de-calculo/","version":"1.2.0"},{"title":"Data da venda e Data de pagamento","anchor":"data-da-venda-e-data-de-pagamento","text":"Data da venda considera vendas e devoluções ativas cuja Data esteja entre o início e o fim do ciclo, inclusive. Data de pagamento considera as mesmas operações pela Data de pagamento gravada na venda. Uma venda sem essa data não entra nessa base. O valor integral entra uma vez; o colaborador e o parceiro são os da operação comercial. A Data original pode estar fora do ciclo. Em Performance → Configurar, Usar data de pagamento nas vendas começa desativado. Ao ativar, o seletor aparece nos novos cadastros com Data de pagamento pré-selecionada. Pode escolher Data da venda. Desativar a configuração preserva a base dos ciclos existentes, suas datas e cálculos; um ciclo já baseado em pagamento continua exibindo sua escolha para edição.","links":[],"url":"/spm/manual/performance-bases-de-calculo/#data-da-venda-e-data-de-pagamento","version":"1.2.0"},{"title":"Valores e devoluções","anchor":"valores-e-devolucoes","text":"Uma venda de R$ 3.000 paga em agosto contribui R$ 3.000 para o ciclo que usa a data de pagamento de agosto. Uma devolução de R$ 200 no mesmo critério reduz o resultado para R$ 2.800. Não há parcelas ou pagamentos parciais nas vendas. Para remuneração e ranking, o resultado líquido tem piso zero. A referência das metas pode conservar valores negativos. Pagamentos de fixo, comissão, bônus, prêmio e reembolso não alteram os valores das vendas.","links":[],"url":"/spm/manual/performance-bases-de-calculo/#valores-e-devolucoes","version":"1.2.0"},{"title":"Vendas individuais e Faturamento total","anchor":"vendas-individuais-e-faturamento-total","text":"Base de cálculo Alcance do resultado Vendas individuais do colaborador Vendas/devoluções do colaborador selecionado no ciclo; pela data escolhida na Performance. Vendas individuais do parceiro Vendas/devoluções do parceiro selecionado no ciclo; pela data escolhida na Performance. Faturamento total da performance União das operações elegíveis de todos os colaboradores e parceiros selecionados no ciclo. Faturamento total da performance não significa todas as operações da empresa: participantes que não estão no ciclo não ampliam essa base. Uma operação vinculada simultaneamente a colaborador e parceiro é contada uma vez no total. A base de Faturamento continua sendo o total do ciclo quando usada na regra de uma pessoa ou grupo; não é automaticamente reduzida às vendas pessoais. A Data da venda ou Data de pagamento escolhida em Dados Gerais determina as datas dessas três opções. As atribuições por organização, suborganização ou cargo organizam as regras e os participantes do ciclo; não criam uma segunda contabilização da mesma operação.","links":[],"url":"/spm/manual/performance-bases-de-calculo/#vendas-individuais-e-faturamento-total","version":"1.2.0"},{"title":"Métricas de quantidade, valor e percentual","anchor":"metricas-de-quantidade-valor-e-percentual","text":"Métricas utiliza os resultados registrados e aprovados em Operações → Métricas, para o indicador, a Performance e cada participante correspondente. Esses resultados pertencem ao ciclo informado; não são relidos por data de venda ou recebimento. Tipo de métrica Unidade e agregação Métrica de quantidade Contagem; soma os resultados do conjunto considerado. Para apuração remuneratória, resultado e meta devem ser inteiros. Métrica de valor Valor monetário; soma os resultados do conjunto. O resultado operacional aceita até duas casas decimais. Métrica de percentual Percentual; usa média aritmética simples dos resultados do conjunto, sem ponderação automática. Informe 10 para 10%, não 0,10. O conjunto é a pessoa na meta individual ou os participantes abrangidos pela regra e meta compartilhada. Um percentual de pagamento só pode usar Métrica de valor como base; quantidade e taxa não são valores monetários. Cada participante considerado precisa de um resultado aprovado e não vazio. Vazio não equivale a zero: falta de preenchimento ou aprovação pode bloquear o cálculo. Salvar uma quantidade fracionária na operação não a torna válida para a calculadora de remuneração, que exige inteiros. Métricas não possuem distribuição diária automática do resultado total do ciclo; consultas que dependem desse histórico podem ficar indisponíveis.","links":[],"url":"/spm/manual/performance-bases-de-calculo/#metricas-de-quantidade-valor-e-percentual","version":"1.2.0"},{"title":"Relação entre base pessoal e meta compartilhada","anchor":"relacao-entre-base-pessoal-e-meta-compartilhada","text":"Uma meta compartilhada agrega o resultado dos participantes do mesmo público abrangidos pelo grupo da meta e da regra. Colaboradores e parceiros não compartilham a mesma linha de meta. Valores e quantidades são somados; métricas percentuais usam média. Esse resultado coletivo serve ao atingimento. A remuneração continua calculada por pessoa: o percentual usa a base pessoal escolhida, e o valor definido ou variável é aplicado individualmente. Se a base escolhida for Faturamento total da performance, ela continua sendo o total do ciclo por definição da própria base. Exemplo: duas pessoas vendem R$ 700 e R$ 400, com meta compartilhada de R$ 1.000. Ambas usam 110% de atingimento; uma faixa de 5% sobre Vendas individuais paga R$ 35 e R$ 20. A comissão não é dividida igualmente nem calculada sobre R$ 1.100 para cada pessoa.","links":[],"url":"/spm/manual/performance-bases-de-calculo/#relacao-entre-base-pessoal-e-meta-compartilhada","version":"1.2.0"},{"title":"Extensões e remuneração","anchor":"extensoes-e-remuneracao","text":"Pipeline e Tarefas são extensões operacionais. Não são bases de cálculo de comissão ou bônus, nem no simulador. Valor das oportunidades ganhas, taxa de conversão do Pipeline, quantidade de tarefas concluídas e taxa de conclusão de Tarefas não alimentam automaticamente a Performance. Escolha Vendas individuais, Faturamento total ou Métricas para a remuneração. Os registros e dashboards dessas extensões continuam disponíveis conforme suas configurações de acesso e ativação.","links":[],"url":"/spm/manual/performance-bases-de-calculo/#extensoes-e-remuneracao","version":"1.2.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"Configure as bases no web, com acesso autorizado ao Gerenciador de Performance. Web e aplicativo apresentam os resultados nas telas permitidas. Dados ausentes ou pendentes de aprovação devem ser corrigidos na operação de origem, sem tratar erro de cálculo como resultado zero.","links":[],"url":"/spm/manual/performance-bases-de-calculo/#disponibilidade","version":"1.2.0"}]},{"id":"performance-regras-de-calculo","title":"Calculadora de comissão e bônus: Padrão, OTE e Score","summary":"Entenda as seis regras Padrão, limites, excelência, faixas OTE, pesos do Score e o efeito das metas compartilhadas.","module":"Performance","version":"1.0.1","publication":"public","channels":["web","mobile"],"keywords":["calculadora","regra de pagamento","Padrão","OTE","Score","progressão","limite","excelência","faixa","peso","percentual","remuneração variável"],"related":["remuneracao-e-premios","performance-bases-de-calculo","metas","competicoes-e-premiacoes","apuracao"],"url":"/spm/manual/performance-regras-de-calculo/","markdownUrl":"/spm/manual/performance-regras-de-calculo.md","sections":[{"title":"Introdução","anchor":"","text":"Em Gerenciador → Performance → Comissionamento ou Bônus, cada indicador combina uma base de resultados com uma forma de pagamento. Comissão e Bônus usam a mesma calculadora, mantendo regras, metas e pagamentos separados. A calculadora também atende à simulação dos cenários compatíveis; o cadastro da regra não registra uma baixa nem transfere dinheiro.","links":[],"url":"/spm/manual/performance-regras-de-calculo/","version":"1.0.1"},{"title":"Formas de pagamento e referência utilizada","anchor":"formas-de-pagamento-e-referencia-utilizada","text":"Tipo de pagamento Referência do cálculo Percentual sobre base de cálculo Aplica um percentual à base monetária da pessoa: o campo do indicador no Padrão ou o percentual da faixa no OTE. Definir valor de pagamento O campo Valor do pagamento (R$) define o pagamento-base, que será multiplicado pelo fator da regra ou faixa. Remuneração variável Usa como pagamento-base o valor variável guardado para o colaborador na Performance. Não usa a remuneração fixa nem acompanha alterações em Pessoas automaticamente. Score Disponível em OTE; combina o atingimento dos indicadores e aplica um único pagamento-base e conjunto de faixas ao grupo. Percentual sobre base exige Vendas, Faturamento, Métrica de valor ou Valor de oportunidades. Não se aplica diretamente a quantidade ou taxa. Na base Faturamento, a referência é o total da Performance por escolha explícita dessa base. Parceiros podem usar valor definido e percentuais de bases compatíveis, mas não Remuneração variável; no Score de parceiros, o pagamento-base é um valor definido. Valores de pagamento e percentuais não podem ser negativos. Selecionar Remuneração variável dispensa o campo local de valor; use os dados guardados do participante. Campos de progressão ocultos ao escolher percentual ou OTE não continuam alterando o cálculo.","links":[],"url":"/spm/manual/performance-regras-de-calculo/#formas-de-pagamento-e-referencia-utilizada","version":"1.0.1"},{"title":"Meta e condições para calcular","anchor":"meta-e-condicoes-para-calcular","text":"O atingimento é resultado ÷ meta, apresentado em percentual. Resultado de R$ 1.200 e meta de R$ 1.000 significam 120%. Para um indicador percentual, resultado de 30% e meta de 20% significam 150% de atingimento. OTE, Score e pagamento Padrão com valor definido ou variável exigem uma meta ativa, positiva e única, correspondente ao indicador e à pessoa ou grupo. As metas precisam estar habilitadas na Performance. Em OTE/Score, a aba Metas não pode ser removida e seus alvos não podem ser desabilitados. Concluir o cadastro exige metas positivas; zero é permitido apenas em rascunhos de OTE ou em outros tipos de regra, sem permitir dividir o resultado pela meta na apuração. Em quantidade, resultado e meta devem ser inteiros. Padrão percentual sobre base não exige meta para remunerar. Uma meta opcional indisponível não transforma esse pagamento em zero. Nas demais formas, desabilitar a meta não desabilita o indicador: o cálculo fica impedido até haver uma meta válida. Resultados manuais ausentes ou pendentes de aprovação também podem impedir a apuração. O limite de cada entrada numérica da calculadora é 99.999.999.999,9999. Esse limite também se aplica ao resultado operacional agregado entregue ao cálculo. O campo Valor da oportunidade aceita um valor maior no cadastro, mas uma base acima do limite da calculadora impede a remuneração; não é automaticamente reduzida ao máximo nem convertida em pagamento zero.","links":[],"url":"/spm/manual/performance-regras-de-calculo/#meta-e-condicoes-para-calcular","version":"1.0.1"},{"title":"Padrão: percentual sobre a base","anchor":"padrao-percentual-sobre-a-base","text":"Com Tipo de comissão/bônus → Padrão e Tipo de pagamento → Percentual sobre base de cálculo, preencha Percentual sobre a base de cálculo (%). O pagamento é base monetária × percentual ÷ 100. Não há condição de atingimento, faixa, progressão ou teto de meta nesse cálculo. Exemplo: 5% sobre R$ 10.000 de Vendas individuais produz R$ 500. Um percentual de 2,5% sobre R$ 40.000 de Faturamento total da performance produz R$ 1.000 para a pessoa à qual a regra se aplica. Uma meta compartilhada não muda a base escolhida por esse pagamento.","links":[],"url":"/spm/manual/performance-regras-de-calculo/#padrao-percentual-sobre-a-base","version":"1.0.1"},{"title":"Regras Padrão","anchor":"regras-padrao","text":"Com Padrão e pagamento Definir valor de pagamento ou Remuneração variável, escolha Regra de pagamento. Cada opção multiplica o pagamento-base por um fator. A tabela utiliza a razão A = resultado ÷ meta, com meta positiva. Regra de pagamento Fator aplicado ao pagamento-base Fixo ao atingir a meta 1 ao atingir ou superar a meta; 0 abaixo dela. Fixo na meta + adicional acima A ao atingir ou superar a meta; 0 abaixo dela. Fixo ao atingir limite inferior 1 ao atingir a meta ou ficar abaixo dela; 0 acima dela. Fixo no limite + adicional abaixo 2 − A ao atingir a meta ou ficar abaixo dela; 0 acima dela. Proporcional até a meta A até atingir a meta; acima dela, permanece em 1. Proporcional sem limite na meta A, inclusive abaixo ou acima da meta. Exemplo com pagamento-base de R$ 100 e meta 100: resultado 150 paga R$ 100 em Fixo ao atingir a meta, R$ 150 em Fixo na meta + adicional acima e R$ 100 em Proporcional até a meta. Resultado 50 paga R$ 150 em Fixo no limite + adicional abaixo e R$ 50 em Proporcional sem limite na meta. As opções com adicional e Proporcional sem limite na meta são progressivas. Na regra inferior progressiva, sem excelência, resultado zero chega a fator 2; isso não significa progressão ilimitada abaixo de zero, pois resultados de entrada não podem ser negativos. Limite e excelência, quando habilitados, ajustam o adicional conforme a seção seguinte.","links":[],"url":"/spm/manual/performance-regras-de-calculo/#regras-padrao","version":"1.0.1"},{"title":"Limitar progressão e Resultado de excelência","anchor":"limitar-progressao-e-resultado-de-excelencia","text":"Limitar progressão aparece nas regras Padrão progressivas com pagamento definido ou variável. Não mantém o fator próprio da regra. Sim revela Limite de pagamento e Resultado de excelência (opcional). Limite de pagamento é um multiplicador maior que 1: limite 2 significa pagar no máximo duas vezes o pagamento-base. Não é um valor em reais nem um percentual digitado como 200. Sem excelência, o fator calculado pela regra apenas para no limite. Com excelência, o adicional cresce proporcionalmente entre a meta, onde o fator é 1, e a excelência, onde alcança o limite. A excelência deve ser maior que a meta nas regras superiores/proporcionais e menor que a meta na regra inferior. Ela usa a mesma unidade da base: quantidade, valor ou percentual. Para resultado no trecho favorável, o fator é 1 + distância da meta ÷ distância entre meta e excelência × (limite − 1), limitado ao teto. Essa fórmula ajusta somente o adicional acima de 1; não libera pagamento abaixo de uma condição mínima que a regra ainda exige. Exemplo: pagamento-base R$ 100, meta 100, excelência 150 e limite 3. Resultado 125 chega à metade do trecho adicional e paga R$ 200; resultado 180 fica no teto de R$ 300. Na regra inferior, com excelência 50 e os mesmos meta e limite, resultado 75 também paga R$ 200. Limite e excelência não se aplicam ao Padrão percentual nem às faixas OTE.","links":[],"url":"/spm/manual/performance-regras-de-calculo/#limitar-progressao-e-resultado-de-excelencia","version":"1.0.1"},{"title":"OTE: faixas de progresso","anchor":"ote-faixas-de-progresso","text":"OTE (On Target Earnings) utiliza Faixas de progresso. Cada faixa separa quando liberar de quanto pagar. No modo Meta, com pagamento percentual, aparecem dois campos percentuais no mesmo card: Campo da faixa O que preencher Progresso de meta da faixa (%) Percentual da meta necessário para liberar a faixa: resultado ÷ meta × 100. Com meta de R$ 100.000, vendas de R$ 50.000 correspondem a 50; vendas de R$ 100.000 correspondem a 100. Não digite 50.000 ou 100.000 neste campo percentual. Percentual de comissão da faixa (%) ou Percentual de bônus da faixa (%) Taxa de pagamento aplicada à base monetária ao atingir a faixa: digite 1 para pagar 1% ou 2 para pagar 2%. Não é progresso da meta. O botão Meta/Valor altera apenas o preenchimento do limite que libera a faixa. Para informar vendas em reais, mude para Valor e preencha Valor da faixa (R$); o percentual equivalente aparece ao lado. O campo de pagamento continua separado. A unidade do indicador e as metas correspondentes determinam a conversão; metas diferentes exigem o preenchimento por Meta. Com Definir valor de pagamento ou Remuneração variável, o segundo campo é Multiplicador de pagamento da faixa, não uma taxa sobre vendas: 1 significa uma vez o pagamento-base; 0,5 significa metade. OTE também permite pagamentos definidos em reais por meio desse valor-base e dos multiplicadores. No cálculo Integral, vale a faixa de maior progresso que tenha sido atingida. A ordem visual de cadastro não altera essa escolha. Não há interpolação entre faixas: entre 80% e 100%, vale a faixa de 80%; abaixo da primeira faixa, o pagamento é zero; acima da última, permanece o pagamento definido por ela. Forma no OTE Cálculo depois de escolher a faixa Valor definido ou Remuneração variável Pagamento-base × multiplicador da faixa. Percentual sobre base de cálculo Base monetária individual × percentual da faixa ÷ 100. O percentual é informado na faixa, não em um campo global do indicador. Exemplo: pagamento-base R$ 100, faixa 80% com multiplicador 0,5 e faixa 100% com multiplicador 1. Atingimento 79% paga zero; 80% ou 90% pagam R$ 50; 100% ou 200% pagam R$ 100. Uma faixa de percentual 5% aplicada a R$ 2.000 de base paga R$ 100. Para pagar R$ 500 ao atingir uma faixa, por exemplo, escolha Definir valor de pagamento, informe R$ 500 no indicador e multiplicador 1 na faixa; não é necessário mudar para Padrão. Consulte também cadastro e limites das faixas. O ícone de informação dentro dos seletores Meta/Valor e Integral/Progressivo, à direita do texto, explica as opções sem alterá-las. Meta/Valor muda o preenchimento, mantendo a mesma lógica; Integral/Progressivo muda como o percentual remunera o resultado. A ajuda inclui um exemplo comparando os pagamentos.","links":["/spm/manual/performance-regras-de-calculo/#cadastrar-adicionar-e-remover-faixas"],"url":"/spm/manual/performance-regras-de-calculo/#ote-faixas-de-progresso","version":"1.0.1"},{"title":"OTE percentual: Integral ou Progressivo","anchor":"ote-percentual-integral-ou-progressivo","text":"Somente em OTE → Percentual sobre base de cálculo, o botão da faixa 1 alterna entre Integral e Progressivo. As demais faixas mostram a escolha bloqueada; novas faixas seguem o mesmo cálculo. Salve a Performance para persistir. Cadastros anteriores continuam em Integral. Integral mantém a regra da última faixa atingida: a taxa incide sobre a base monetária completa. Abaixo da primeira faixa, paga zero. Progressivo soma os trechos: a taxa da faixa 1 vale de zero até seu limite; a taxa da faixa 2 vale sobre o excedente do primeiro limite até o segundo, e assim por diante. A última taxa continua sobre o excedente final. Os limites são ordenados pelo progresso, independentemente da ordem visual. Uma faixa de limite zero não tem trecho; taxa zero deixa seu trecho sem pagamento. Uma única faixa progressiva aplica a mesma taxa desde zero.","links":[],"url":"/spm/manual/performance-regras-de-calculo/#ote-percentual-integral-ou-progressivo","version":"1.0.1"},{"title":"Exemplo de OTE progressivo","anchor":"exemplo-de-ote-progressivo","text":"Exemplo com meta de R$ 100.000: faixa de 50% paga 1%, de 75% paga 2% e de 100% paga 3%. Resultado de R$ 50.000 paga R$ 500. Resultado de R$ 60.000 paga R$ 700: R$ 50.000 × 1% + R$ 10.000 × 2%. Resultado de R$ 75.000 paga R$ 1.000; R$ 100.000 paga R$ 1.750; R$ 150.000 paga R$ 3.250. Não há lacunas entre limites: centavos também entram no trecho seguinte. O arredondamento monetário ocorre apenas no total do indicador.","links":[],"url":"/spm/manual/performance-regras-de-calculo/#exemplo-de-ote-progressivo","version":"1.0.1"},{"title":"OTE progressivo com meta compartilhada","anchor":"ote-progressivo-com-meta-compartilhada","text":"Com meta compartilhada, os trechos usam resultado e meta do grupo; a taxa média resultante é aplicada à base própria de cada participante. Por exemplo, duas pessoas com R$ 30.000 cada, resultado coletivo R$ 60.000 e meta R$ 100.000 recebem R$ 350 cada no exemplo acima. Bases de faturamento continuam usando o faturamento configurado. Comissão e bônus têm escolhas independentes; Score e pagamentos por multiplicador mantêm suas regras. Em Simular resultados, confira os trechos em Detalhamento do cálculo. No dashboard, Regra de cálculo identifica Progressivo e mostra o percentual efetivo; a taxa da faixa atual se refere somente ao trecho atual. Meta/Valor muda a forma de preencher o limite e não o modo de cálculo. Mudar para Padrão, Score ou pagamento por valor remove a opção progressiva.","links":[],"url":"/spm/manual/performance-regras-de-calculo/#ote-progressivo-com-meta-compartilhada","version":"1.0.1"},{"title":"Comissão mensal de 1% a partir de 50 mil e 2% a partir de 100 mil","anchor":"comissao-mensal-de-1-a-partir-de-50-mil-e-2-a-partir-de-100-mil","text":"Em Gerenciador → Performance, crie ou edite o ciclo do mês, selecione os vendedores em Dados Gerais e habilite Comissionamento. Na aba Comissionamento, selecione o grupo de Colaboradores, nomeie o indicador e escolha Tipo de comissão → OTE, Tipo de pagamento → Percentual sobre base de cálculo e Base de cálculo → Vendas individuais do colaborador. Para avaliar cada vendedor por suas próprias vendas, use metas Individuais. Mantenha Integral na faixa 1. Este exemplo considera a taxa da faixa sobre todo o valor vendido pelo vendedor, não somente sobre a parcela que excedeu o limite. Com meta individual de R$ 100.000 para esse indicador, preencha as duas faixas assim: Faixa Progresso de meta da faixa (%) — modo Meta Percentual de comissão da faixa (%) A partir de R$ 50.000 50 1 A partir de R$ 100.000 100 2 São dois percentuais por faixa com funções diferentes: 50% de progresso libera 1% de comissão, e 100% de progresso libera 2% de comissão. Alternativamente, mude para Valor no cabeçalho principal de Faixas de progresso, aplicando a escolha a todas as faixas, e informe R$ 50.000 e R$ 100.000 em Valor da faixa (R$), mantendo 1 e 2 no campo de comissão. Sem metas preenchidas, a maior faixa preenche R$ 100.000 como alvo individual; uma meta manual existente tem prioridade. Não coloque reais em Progresso de meta da faixa (%). As condições de conversão estão em Preencher faixas por Meta ou Valor. Abaixo de R$ 50.000, o pagamento é zero. De R$ 50.000 até antes de R$ 100.000, aplica 1% ao total da base individual: R$ 50.000 pagam R$ 500 e R$ 75.000 pagam R$ 750. A partir de R$ 100.000, aplica 2%: R$ 100.000 pagam R$ 2.000. As faixas não são somadas nem calculadas progressivamente por parcelas. Confira o período mensal, o critério Data da venda/Data de pagamento que fornece os resultados, as metas e as faixas, salve a Performance e use Pré-visualizar resultados → Simular resultados para conferir o exemplo individual.","links":["/spm/manual/performance-regras-de-calculo/#preencher-faixas-por-meta-ou-valor"],"url":"/spm/manual/performance-regras-de-calculo/#comissao-mensal-de-1-a-partir-de-50-mil-e-2-a-partir-de-100-mil","version":"1.0.1"},{"title":"Cadastrar, adicionar e remover faixas","anchor":"cadastrar-adicionar-e-remover-faixas","text":"OTE precisa de pelo menos uma faixa para concluir o cadastro. Cada conjunto admite até 100 faixas, com progressos distintos e valores não negativos. A primeira faixa sugerida começa em 100% e pagamento 1; confira se esse 1 representa 1× ou 1%, conforme o tipo de pagamento escolhido. + Adicionar faixa sugere progresso dez pontos percentuais acima do maior existente e pagamento 1; os campos podem ser editados. O botão de remoção pede confirmação e não permite retirar a última faixa. Progressos repetidos são recusados. As mudanças só são persistidas ao salvar a Performance. Sem Score, as faixas pertencem ao indicador OTE. Com Score, há um único conjunto no grupo, aplicado ao Score final; os indicadores fornecem atingimento e peso, sem faixas próprias.","links":[],"url":"/spm/manual/performance-regras-de-calculo/#cadastrar-adicionar-e-remover-faixas","version":"1.0.1"},{"title":"Preencher faixas por Meta ou Valor","anchor":"preencher-faixas-por-meta-ou-valor","text":"O botão Meta/Valor fica à direita do título Faixas de progresso, no card principal. A escolha vale para todas as faixas do indicador, inclusive novas faixas e após remover a primeira. As orientações ficam no ícone de informação. Meta é o padrão: informe Progresso de meta da faixa (%). Em Valor, o campo acompanha a unidade do indicador: Valor da faixa (R$), Quantidade da faixa ou Valor da faixa (%). O percentual equivalente da meta aparece à direita; percentual do indicador e progresso da meta são medidas diferentes. Exemplo: taxa de conclusão de 40% para uma meta de 80% equivale a 50% de progresso. Sem metas preenchidas, a maior faixa em Valor preenche a meta desse indicador na distribuição escolhida. Faixas de R$ 100 mil, R$ 150 mil e R$ 200 mil geram meta de R$ 200 mil e progressos de 50%, 75% e 100%. Em Individual, cada participante abrangido recebe esse alvo; em Compartilhada, cada grupo abrangido recebe uma única meta. Não preenche indicadores de outra comissão, bônus ou público. Enquanto a meta continua automática nesta edição, alterar ou remover a maior faixa em Valor atualiza o alvo e os percentuais das outras faixas em Valor. A meta fica visível na tabela Metas. Use Editar para definir outro alvo. Durante a edição em Valor, uma meta comum de R$ 250 mil passa a converter aquelas mesmas faixas em 40%, 60% e 80%; os R$ 200 mil da maior faixa não substituem a meta manual. Metas positivas já cadastradas também têm prioridade. A distribuição individual ou compartilhada não é alterada automaticamente. Com metas diferentes para o mesmo indicador, use Meta: um único valor não corresponde ao mesmo percentual para todos. Se a edição das metas criar essa diferença, as faixas voltam para Meta, preservando os percentuais e avisando sobre a mudança. Cada participante ou grupo passa a aplicar esses percentuais à sua própria meta. Valor é uma facilidade de preenchimento. Ao salvar, ficam gravadas as metas e os percentuais das faixas, preservando a proporção exata das conversões em Valor. Reabrir o cadastro começa em Meta; alterações posteriores das metas aplicam os percentuais salvos aos novos alvos. Para manter os valores absolutos ao alterar uma meta comum durante a edição, primeiro alterne o cabeçalho de Faixas de progresso para Valor, aplicando o modo a todas as faixas do indicador. Quantidades devem ser inteiras e valores monetários aceitam centavos. O percentual equivalente é exibido com até quatro casas decimais; ≈ indica uma aproximação visual. A apuração conserva a proporção exata: R$ 100 mil sobre meta de R$ 150 mil aparece como aproximadamente 66,6667%, mas libera exatamente em R$ 100 mil, nunca um centavo antes ou depois. Editar diretamente Progresso de meta substitui essa proporção pelo percentual informado. Se um percentual não puder ser convertido em uma entrada válida na unidade do indicador, como 110% de uma tarefa, o campo Valor começa vazio para você preencher, sem arredondar a quantidade. Entradas inválidas em Valor impedem salvar ou simular, inclusive após trocar de aba. Alternar de volta para Meta descarta a entrada inválida e mantém o último percentual válido. Faixas de Score continuam por Meta: combinam atingimentos de indicadores que podem ter unidades diferentes. Em OTE, incluindo Score, Metas e os alvos correspondentes permanecem ativos; para concluir a Performance, cada participante ou grupo precisa de meta maior que zero. Um rascunho pode manter metas ainda sem valor para conclusão posterior.","links":[],"url":"/spm/manual/performance-regras-de-calculo/#preencher-faixas-por-meta-ou-valor","version":"1.0.1"},{"title":"Score ponderado","anchor":"score-ponderado","text":"No OTE com Score, configure Peso do indicador (%) para cada indicador. Os pesos devem estar entre 0% e 100% e somar 100%. O Score é a soma do atingimento de cada indicador multiplicado pelo seu peso; não limita automaticamente um indicador a 100% de atingimento. Exemplo: indicador com peso 60% atinge 200%; outro com peso 40% atinge 50%. O Score é 200% × 60% + 50% × 40% = 140%. Uma faixa de Score em 120% com multiplicador 1,5 aplica 1,5 ao pagamento-base do grupo. Em Pagamento e faixas de progresso do Score, Pagamento do Score oferece Definir valor de pagamento ou, para colaboradores, Remuneração variável. Preencha Valor do pagamento (R$) quando definir um valor. A última faixa de Score alcançada determina o multiplicador; abaixo da primeira, o pagamento é zero. Com pagamento-base de R$ 1.000 e fator 1,5, o total é R$ 1.500. O grupo gera um único pagamento, não um pagamento por indicador somado ao Score. Comissão e Bônus permanecem origens separadas, mesmo quando ambas utilizam Score. Uma meta compartilhada pode fornecer o atingimento comum, mas a remuneração variável continua sendo a de cada colaborador.","links":[],"url":"/spm/manual/performance-regras-de-calculo/#score-ponderado","version":"1.0.1"},{"title":"Conversões entre indicadores OTE e Score","anchor":"conversoes-entre-indicadores-ote-e-score","text":"Cada grupo admite até 50 indicadores. OTE com mais de um indicador exige Score. Ao adicionar outro indicador ao OTE, a interface pede confirmação para converter todos para OTE/Score. Escolher Score também reorganiza o grupo, substituindo as faixas individuais por faixas do Score; revise o pagamento e as faixas após confirmar. Ao adicionar ou remover indicadores em Score, os pesos são redistribuídos igualmente, com o ajuste de arredondamento no último indicador para totalizar 100%. Seus pesos anteriores precisam ser revistos. Se restar apenas um indicador, ele volta a OTE individual, conservando o pagamento e as faixas que estavam no grupo. Com múltiplos indicadores, o primeiro controla a mudança de tipo do grupo. Para sair do Score, altere o primeiro para Padrão e confira a confirmação e as novas regras; faixas não continuam agindo como configurações ocultas. Remover um indicador também remove suas metas relacionadas do cadastro em edição, sem salvar a Performance automaticamente.","links":[],"url":"/spm/manual/performance-regras-de-calculo/#conversoes-entre-indicadores-ote-e-score","version":"1.0.1"},{"title":"Meta compartilhada e pagamento individual","anchor":"meta-compartilhada-e-pagamento-individual","text":"Nas regras que dependem de meta, uma meta compartilhada fornece resultado e alvo comuns ao grupo. O fator, a faixa ou o Score podem ser comuns, mas cada pessoa recebe seu cálculo. Valor definido não é dividido automaticamente; Remuneração variável usa o valor próprio do colaborador; percentual sobre Vendas individuais usa as vendas da pessoa. Exemplo: duas pessoas vendem R$ 700 e R$ 400 para uma meta compartilhada de R$ 1.000. Ambas têm 110% de atingimento. Com OTE e faixa de 5% sobre Vendas individuais, recebem R$ 35 e R$ 20, respectivamente. Não recebem R$ 55 cada nem metade de uma comissão coletiva. Quando a base escolhida for Faturamento total da performance, o percentual usa esse total por definição da base, e não por causa da meta compartilhada. Esse comportamento também se aplica às regras de Bônus.","links":[],"url":"/spm/manual/performance-regras-de-calculo/#meta-compartilhada-e-pagamento-individual","version":"1.0.1"},{"title":"Arredondamento e conferência do simulador","anchor":"arredondamento-e-conferencia-do-simulador","text":"Valores monetários de cada indicador Padrão são arredondados para centavos antes da soma. Score produz um pagamento único arredondado. As faixas são comparadas com o atingimento calculado, sem arredondá-lo primeiro ao percentual exibido; estar visualmente perto de 100% não garante que a faixa de 100% foi alcançada. Pré-visualizar resultados → Simular resultados aceita valores de teste e mostra Configuração aplicada e Detalhamento do cálculo. Não consulta nem grava resultados operacionais ou pagamentos. A simulação informa apenas um Resultado por indicador. Ela não permite informar simultaneamente o resultado coletivo e a base pessoal exigidos pelo OTE percentual com meta compartilhada; nesse caso, não interprete o total simulado com a base coletiva como comissão individual definitiva. Cadastros antigos com % da remuneração fixa ou Regressivo até a meta precisam ser revistos quando o cálculo indicar regra não suportada; erro não significa pagamento zero.","links":[],"url":"/spm/manual/performance-regras-de-calculo/#arredondamento-e-conferencia-do-simulador","version":"1.0.1"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"Configure e simule regras no web, com permissão para Gerenciador de Performance. O web e o aplicativo exibem resultados autorizados, sem editor nativo da Performance no aplicativo. Apuração utiliza as regras salvas e as fontes elegíveis; campos e metas incompletos podem ser aceitos no cadastro e ainda impedir o cálculo. Parceiros não utilizam Remuneração variável.","links":[],"url":"/spm/manual/performance-regras-de-calculo/#disponibilidade","version":"1.0.1"}]},{"id":"competicoes-e-premiacoes","title":"Competições e premiações da Performance","summary":"Configure Ranking ou Geral, critérios, prêmios e imagens; entenda empates, liberação e valores por participante.","module":"Performance","version":"1.0.0","publication":"public","channels":["web","mobile"],"keywords":["competição","ranking","Geral","prêmio","premiação","empate","Score","divisão","imagem"],"related":["performance","metas","performance-regras-de-calculo","performance-bases-de-calculo","dashboard-competicao","pagamentos-operacao","apuracao"],"url":"/spm/manual/competicoes-e-premiacoes/","markdownUrl":"/spm/manual/competicoes-e-premiacoes.md","sections":[{"title":"Introdução","anchor":"","text":"Em Gerenciador → Performance → Competição, configure como acompanhar os participantes e reconhecer os resultados do ciclo. A aba é opcional. As Operações fornecem os resultados, o Dashboard de Competição apresenta a classificação ou o atingimento, e Pagamentos administra os valores monetários elegíveis. Cadastrar um prêmio não significa que ele foi pago.","links":[],"url":"/spm/manual/competicoes-e-premiacoes/","version":"1.0.0"},{"title":"Público, atribuição e ativação da competição","anchor":"publico-atribuicao-e-ativacao-da-competicao","text":"Selecione Colaboradores ou Parceiros e o grupo. Cada público mantém sua própria competição. A Atribuição de Dados Gerais organiza os grupos por Única, Organização, Suborganização ou Cargo. Com Personalizada, o campo Atribuição da competição permite escolher a organização local, respeitando os recursos habilitados e os vínculos dos participantes. Quando disponível, o controle Competição do grupo ativa ou desativa aquele grupo, preservando seus critérios e prêmios. Abas ou controles de grupo podem não aparecer quando existe somente uma opção. Uma competição ativa precisa abranger os participantes de seu público e atribuição. O cadastro sugere Ranking ordenado por Vendas, sem prêmios ativos. É possível manter Ranking sem prêmio para acompanhar posições; Geral ativo exige pelo menos um prêmio. Alterar tipo ou critério exige conferir as configurações relacionadas e salvar a Performance completa.","links":[],"url":"/spm/manual/competicoes-e-premiacoes/#publico-atribuicao-e-ativacao-da-competicao","version":"1.0.0"},{"title":"Tipos e critérios","anchor":"tipos-e-criterios","text":"Campo Opções e efeito Tipo de competição Ranking classifica os resultados; Geral libera prêmios pelo atingimento coletivo da origem escolhida. Ordenar ranking por No Ranking: Vendas, Meta individual de comissão, Meta individual de bônus ou Score. Liberação do prêmio No Geral: Meta de comissão ou Meta de bônus; a sugestão inicial é Meta de comissão. Divisão do prêmio No Geral: Dividir entre participantes ou Prêmio integral para cada participante; a sugestão inicial é dividir. Não há um seletor para escolher somente um indicador da Comissão ou do Bônus como critério de competição. Os critérios de meta consideram os indicadores aplicáveis da origem; o Score considera os grupos com Score calculado. Critérios antigos sinalizados como Selecione um novo critério precisam ser substituídos por uma opção atual.","links":[],"url":"/spm/manual/competicoes-e-premiacoes/#tipos-e-criterios","version":"1.0.0"},{"title":"Ranking por Vendas, metas ou Score","anchor":"ranking-por-vendas-metas-ou-score","text":"Ordenar ranking por Como o resultado da pessoa é calculado Vendas Resultado individual elegível: vendas ativas menos devoluções, pela Data da venda ou Data de pagamento salva na Performance. Meta individual de comissão Média aritmética dos atingimentos dos indicadores de Comissão ativos e aplicáveis à pessoa. Meta individual de bônus Média aritmética dos atingimentos dos indicadores de Bônus ativos e aplicáveis à pessoa. Score Média dos Scores dos grupos de remuneração aplicáveis à pessoa que tenham Score calculado; pode incluir Comissão e Bônus. Ranking por meta exige Distribuição de metas → Individual, metas ativas e positivas da origem e a respectiva Comissão ou Bônus habilitada. Não basta haver uma meta de outra origem ou grupo. Cada atingimento é resultado pessoal dividido pela meta; a média não é ponderada pelo valor monetário nem pelos pesos do Score. Ranking por Score exige remuneração OTE/Score ativa e cálculo disponível para os participantes. O Score de cada grupo combina atingimentos e pesos; as faixas definem o pagamento desse grupo. A classificação utiliza o Score, não o valor pago. Consulte o cálculo em Score ponderado. Os maiores resultados ficam primeiro. Não há condição automática de resultado positivo para ocupar uma posição: participantes com zero calculado podem empatar. Isso é diferente de resultado ausente, que fica pendente. As fontes operacionais e a base temporal seguem o ciclo, sem se tornarem disponíveis apenas porque a competição está ativa.","links":["/spm/manual/performance-regras-de-calculo/#score-ponderado"],"url":"/spm/manual/competicoes-e-premiacoes/#ranking-por-vendas-metas-ou-score","version":"1.0.0"},{"title":"Empates e posições premiadas","anchor":"empates-e-posicoes-premiadas","text":"Participantes com o mesmo resultado ficam na mesma posição. As posições seguintes respeitam os lugares ocupados: dois empatados em primeiro aparecem em 1º, 1º, 3º. A ordem de exibição entre empatados não escolhe um vencedor exclusivo. No Ranking, os prêmios em dinheiro das posições ocupadas pelo empate são divididos entre os empatados. Exemplo: duas pessoas empatam nas posições de primeiro e segundo, com prêmios de R$ 100 e R$ 50. Cada uma recebe R$ 75. Se houver somente o prêmio de primeiro de R$ 100, cada uma recebe R$ 50. A divisão conserva o total em centavos; quando não houver divisão exata, algumas parcelas diferem em um centavo, segundo a ordem estável dos participantes. A opção Divisão do prêmio do Geral não altera o tratamento de empate no Ranking. Prêmios padrão identificam o reconhecimento das posições; o sistema não cria um valor financeiro nem uma logística automática de entrega para eles.","links":[],"url":"/spm/manual/competicoes-e-premiacoes/#empates-e-posicoes-premiadas","version":"1.0.0"},{"title":"Geral: quando a meta libera os prêmios","anchor":"geral-quando-a-meta-libera-os-premios","text":"No tipo Geral, Liberação do prêmio escolhe Meta de comissão ou Meta de bônus. As Metas e a origem escolhida precisam estar ativas e possuir metas válidas para o grupo. Todos os indicadores considerados dessa origem precisam atingir o alvo agregado; não basta um indicador compensar outro. Com metas individuais, resultados e alvos são somados por indicador. O desempenho maior de uma pessoa pode compensar o menor de outra na liberação Geral. Exemplo: resultados de R$ 700 e R$ 400, com metas individuais de R$ 550 para cada, totalizam R$ 1.100 de resultado e de meta: o indicador atinge o alvo, embora a segunda pessoa não o alcance isoladamente. Metas compartilhadas são contadas uma vez, sem multiplicar seu resultado ou alvo pelo número de participantes. Na base Faturamento total da performance, o resultado do ciclo também é contado uma vez por indicador, enquanto os alvos de metas distintas são somados. Isso evita multiplicar o mesmo faturamento pela quantidade de pessoas. Ao satisfazer os indicadores da origem escolhida, os participantes abrangidos pelo grupo recebem os prêmios ativos segundo a divisão configurada. As referências 1º prêmio, 2º prêmio e 3º prêmio são uma sequência de prêmios, não uma ordem de classificação individual.","links":[],"url":"/spm/manual/competicoes-e-premiacoes/#geral-quando-a-meta-libera-os-premios","version":"1.0.0"},{"title":"Geral: prêmio dividido ou integral","anchor":"geral-premio-dividido-ou-integral","text":"Divisão do prêmio Valor devido a cada participante elegível Dividir entre participantes Divide o valor de cada prêmio em dinheiro entre os participantes abrangidos. R$ 100 com duas pessoas resulta em R$ 50 para cada. Prêmio integral para cada participante Cada pessoa recebe o valor completo de cada prêmio em dinheiro. R$ 100 com duas pessoas resulta em R$ 100 para cada, totalizando R$ 200. A divisão é aplicada depois da liberação pelas metas e separadamente a cada prêmio ativo. Não divide a meta cadastrada nem muda a forma de calcular Comissão ou Bônus. Prêmio padrão não adquire valor monetário por escolher uma dessas opções.","links":[],"url":"/spm/manual/competicoes-e-premiacoes/#geral-premio-dividido-ou-integral","version":"1.0.0"},{"title":"Adicionar, preencher e remover prêmios","anchor":"adicionar-preencher-e-remover-premios","text":"Há até três prêmios em sequência. Use Adicionar prêmio no primeiro espaço; os seguintes são liberados na ordem. No Ranking, cada cartão corresponde ao 1º, 2º ou 3º lugar. No Geral, corresponde ao 1º, 2º ou 3º prêmio. Campo ou ação Preenchimento e comportamento Tipo do prêmio Prêmio padrão, sugerido inicialmente, ou Prêmio em dinheiro. Nome do prêmio No Prêmio padrão, nome obrigatório de até 150 caracteres; por exemplo, troféu ou experiência. Valor do prêmio (R$) No Prêmio em dinheiro, valor positivo, a partir de R$ 0,01 e até R$ 9.999.999.999.999,99, com centavos. Adicionar imagem / Trocar imagem Imagem opcional de identificação, com recorte antes de aplicar. Remover imagem Retira somente a imagem do prêmio. Remover prêmio Retira o prêmio e desloca os seguintes para manter a sequência sem intervalos. Trocar para Prêmio em dinheiro inicia o valor em zero: informe um valor positivo antes de concluir o cadastro. O nome de um prêmio padrão não substitui o valor monetário. Rascunhos podem conservar preenchimento incompleto; isso não torna o prêmio válido para conclusão ou apuração. Os prêmios e imagens permanecem alterações locais até salvar a Performance. A remoção de um cartão não permite manter o terceiro lugar como único prêmio ativo: a sequência precisa começar no primeiro.","links":[],"url":"/spm/manual/competicoes-e-premiacoes/#adicionar-preencher-e-remover-premios","version":"1.0.0"},{"title":"Imagem do prêmio e recorte","anchor":"imagem-do-premio-e-recorte","text":"Adicionar imagem e Trocar imagem aceitam PNG, JPEG ou WebP de até 5 MB e 40 megapixels. O envio abre Ajustar imagem do prêmio, com uma prévia de recorte quadrado. Arraste a imagem ou use Zoom, Posição horizontal e Posição vertical. O Zoom vai de 1 a 4; os controles de posição ajustam a parte que excede o quadrado e podem ficar desabilitados quando não houver espaço para deslocamento naquela direção. Use Usar imagem para aplicar o recorte ou Cancelar para abandoná-lo. O Askora prepara a miniatura do recorte, sem exigir que o arquivo original já tenha tamanho de miniatura. Aguarde a preparação antes de salvar a Performance. Trocar ou remover a imagem não altera a meta, o critério, a posição ou o valor do prêmio.","links":[],"url":"/spm/manual/competicoes-e-premiacoes/#imagem-do-premio-e-recorte","version":"1.0.0"},{"title":"Resultados pendentes e reconhecimento em Pagamentos","anchor":"resultados-pendentes-e-reconhecimento-em-pagamentos","text":"Métrica não preenchida, aprovação pendente, meta inválida ou Score indisponível não equivalem a zero. No Dashboard de Competição, participantes sem resultado calculável ficam sem posição definitiva; enquanto houver pendência no grupo, a indicação de contemplados pode ficar suspensa. Corrija a origem e confira novamente, sem interpretar uma classificação parcial como apuração final. Somente Prêmio em dinheiro participa da apuração monetária. Para reconhecer o valor em Operações → Pagamentos, o ciclo deve estar pronto, ativo e encerrado, com resultados e metas válidos; Pagamentos deve estar habilitado, dentro da vigência e com o tipo Prêmio e o público correspondente ativos. Prazos e demais condições seguem a configuração de Pagamentos. O valor definido no Gerenciador, o resultado exibido no dashboard e o pagamento efetivamente baixado são etapas distintas. Apurar reconhece valores devidos; não executa transferência bancária. Prêmio padrão ou imagem não gera dinheiro automaticamente. Alterar resultados depois da apuração pode exigir revisão das diferenças e dos pagamentos existentes.","links":[],"url":"/spm/manual/competicoes-e-premiacoes/#resultados-pendentes-e-reconhecimento-em-pagamentos","version":"1.0.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"Cadastre competições, prêmios e imagens no web, com permissão para Gerenciador de Performance. Web e aplicativo exibem as competições autorizadas; o aplicativo não possui o editor do Gerenciador nem a operação nativa de Pagamentos. Consultar uma competição não concede acesso aos registros operacionais privados de outros participantes. Bases de Pipeline/Tarefas não são apuradas para parceiros, mesmo quando oferecidas pelo editor.","links":[],"url":"/spm/manual/competicoes-e-premiacoes/#disponibilidade","version":"1.0.0"}]},{"id":"metas","title":"Metas da Performance","summary":"Configure metas individuais ou compartilhadas, disponibilidade dos grupos e importação CSV, preservando a relação com indicadores e cálculos.","module":"Performance","version":"1.4.0","publication":"public","channels":["web","mobile"],"keywords":["meta","objetivo","compartilhada","individual","CSV","meta diária","metas do grupo","importação","CSV de metas","meta zero"],"related":["pessoas-cargos-e-acessos","permissoes-e-escopos","configuracoes-do-produto","configuracoes-performance","performance","remuneracao-e-premios","performance-regras-de-calculo","competicoes-e-premiacoes"],"url":"/spm/manual/metas/","markdownUrl":"/spm/manual/metas.md","sections":[{"title":"Introdução","anchor":"","text":"As metas são objetivos do ciclo de Performance. O indicador define como medir e remunerar; a meta informa o resultado esperado. Configure-as em Gerenciador → Performance → cadastro → Metas, depois de selecionar os participantes e definir Comissionamento/Bônus.","links":[],"url":"/spm/manual/metas/","version":"1.4.0"},{"title":"Distribuição e atribuição","anchor":"distribuicao-e-atribuicao","text":"Campo ou contexto Como funciona Colaboradores / Parceiros Metas separadas por público, conforme os participantes selecionados. A faixa pode ficar oculta se houver apenas um tipo. Comissionamento / Bônus Origens separadas, conforme as abas habilitadas. Uma meta de comissão não substitui automaticamente a de bônus. Distribuição de metas → Individual Padrão inicial; um alvo por participante e objetivo. Distribuição de metas → Compartilhada Um alvo para o conjunto correspondente; não multiplica esse alvo pela quantidade de pessoas. Atribuição das metas A escolha central de Dados Gerais orienta os grupos. Com Personalizada e metas compartilhadas, escolha a atribuição local: Única, Organização, Suborganização ou Cargo, conforme os recursos habilitados. Metas do grupo Ativa/desativa todos os objetivos do grupo exibido; aparece quando há múltiplos grupos/públicos ou metas históricas desabilitadas. Não há um interruptor independente por indicador nessa tabela. Esse comando não unifica os valores das metas nem seus atingimentos. Atribuição organiza o alcance das regras; distribuição define de quem é o alvo. Uma meta individual agrupada por cargo continua individual. Os grupos individuais acompanham a atribuição da remuneração; os compartilhados acompanham a atribuição das metas. Com apenas um grupo, a respectiva faixa de abas pode ficar oculta. Desabilitar um grupo conserva os valores; abrir ou duplicar o ciclo não o reativa, exceto pela exigência de manter ativos os objetivos de OTE. Se houver indicador OTE ativo no contexto, o controle de desativação fica bloqueado. Alterar distribuição ou atribuição pode pedir confirmação e reconstruir as metas do público afetado. Confira os alvos novamente antes de salvar.","links":[],"url":"/spm/manual/metas/#distribuicao-e-atribuicao","version":"1.4.0"},{"title":"Metas e atingimentos por indicador","anchor":"metas-e-atingimentos-por-indicador","text":"Cada indicador tem sua própria meta e seu próprio atingimento, tanto em Comissionamento quanto em Bônus. As abas de origem e os grupos organizam o cadastro; não transformam indicadores diferentes em uma meta única. Por exemplo, Vendas pode ter meta de R$ 10.000 e Visitas meta de 20 visitas. Com R$ 12.000 em vendas e 10 visitas, os atingimentos são, respectivamente, 120% e 50%. A apuração utiliza a meta correspondente a cada indicador, sem somar reais com visitas e sem usar a meta de um como substituta da outra. Em Individual, cada participante possui seu alvo para cada indicador. Em Compartilhada, cada indicador possui um alvo para as pessoas abrangidas: compartilha-se a meta de Vendas entre essas pessoas e, separadamente, a meta de Visitas. A atribuição Única/geral também mantém essa separação. Os detalhes de indicadores do dashboard seguem essas metas distintas. O controle Metas do grupo apenas liga/desliga conjuntamente as metas exibidas naquele contexto. Seus valores continuam independentes. No Score, cada atingimento é calculado primeiro e depois combinado pelos pesos definidos; na competição Geral, cada indicador precisa alcançar seu próprio alvo agregado. Superar Vendas não compensa Visitas abaixo da meta para liberar esse prêmio. Para configurar esses alvos, escolha a Distribuição de metas e atribuição.","links":["#distribuicao-e-atribuicao"],"url":"/spm/manual/metas/#metas-e-atingimentos-por-indicador","version":"1.4.0"},{"title":"Preencher e salvar","anchor":"preencher-e-salvar","text":"Habilite Metas e escolha público, origem e grupo. Confira os objetivos derivados dos indicadores; sem indicadores, pode aparecer o objetivo básico de Vendas. Selecione linhas, se quiser limitar a edição, e use Editar. Sem seleção, a edição abrange a tabela correspondente. Preencha os valores e use Salvar na tabela. Depois use Salvar performance ou Salvar rascunho no rodapé do cadastro. Em Individual, as linhas representam pessoas e as colunas Meta de… representam objetivos. Em Compartilhada, a tabela apresenta Objetivo e Meta do grupo. Nomes, IDs e vínculos são referências: não renomeiam pessoas nem permitem incluí-las. Desmarcar uma linha não retira o participante da Performance. A paginação apresenta oito linhas; a seleção no cabeçalho atua sobre a página exibida. Durante a edição, os controles de contexto, navegação e importação/exportação ficam bloqueados. Cancelar restaura a edição local; salvar a tabela ainda não grava todo o ciclo. Novas metas começam com valor zero, exceto pelo preenchimento automático das faixas OTE em Valor. Nesse modo, sem meta preenchida, a maior faixa preenche o alvo de cada participante (Individual) ou de cada grupo (Compartilhada) daquele indicador. Metas positivas já cadastradas têm prioridade. Use Editar para substituir o alvo automático; confira a conversão de faixas por Meta ou Valor. Os valores devem ser finitos, não negativos e de até 99.999.999.999,9999, com até quatro casas decimais. A unidade acompanha o indicador: valor monetário, quantidade ou percentual. Indicadores de quantidade exigem números inteiros na calculadora. O ciclo aceita até 5.000 metas.","links":["/spm/manual/performance-regras-de-calculo/#preencher-faixas-por-meta-ou-valor"],"url":"/spm/manual/metas/#preencher-e-salvar","version":"1.4.0"},{"title":"Meta zero e metas desabilitadas","anchor":"meta-zero-e-metas-desabilitadas","text":"Zero pode ser salvo em rascunhos de OTE ou em outros tipos de regra, mas não é uma meta positiva válida para uma fórmula de atingimento. Concluir uma Performance com OTE exige metas positivas para todos os participantes ou grupos abrangidos. Meta ausente, zero, desabilitada, duplicada ou incompatível com participante, indicador, origem e grupo pode impedir a apuração dependente desse objetivo. A meta não é completada automaticamente com resultado zero. OTE e Score dependem de metas positivas: a aba Metas não pode ser removida enquanto esses tipos estiverem ativos, e suas metas não podem ser desabilitadas. A tela ativa Metas ao selecionar OTE; a API também valida essa exigência. Regras Padrão de valor fixo ou remuneração variável também usam meta; Padrão percentual simples não depende de meta para aplicar sua porcentagem à base. Desabilitar metas não transforma automaticamente o modelo em uma regra sem meta. Revise as condições das regras de cálculo.","links":["/spm/manual/performance-regras-de-calculo/#regras-padrao"],"url":"/spm/manual/metas/#meta-zero-e-metas-desabilitadas","version":"1.4.0"},{"title":"Metas compartilhadas e remuneração","anchor":"metas-compartilhadas-e-remuneracao","text":"A meta compartilhada compara o resultado do conjunto elegível com um alvo único. Isso não implica repetir o valor total das vendas como base de pagamento de cada pessoa. Em pagamento percentual, a apuração mantém a base pessoal do participante; Faturamento utiliza sua base agregada própria. Exemplo: duas pessoas vendem R$ 700 e R$ 400 e compartilham meta de R$ 1.000. O atingimento coletivo é 110%. Se essa faixa OTE Integral paga 5% sobre vendas pessoais, os valores são R$ 35 e R$ 20, respectivamente. Não são R$ 55 para cada pessoa. O ranking por Meta individual de comissão/bônus exige metas individuais. Já uma competição Geral pode avaliar o atingimento agregado para liberar o prêmio ao grupo, conforme seu critério. Confira tipos e critérios de competição.","links":["/spm/manual/competicoes-e-premiacoes/#tipos-e-criterios"],"url":"/spm/manual/metas/#metas-compartilhadas-e-remuneracao","version":"1.4.0"},{"title":"Importar e exportar metas","anchor":"importar-e-exportar-metas","text":"Na aba Metas, use Exportar para obter o modelo CSV do público, origem e grupo atuais. A exportação inclui todas as páginas daquele contexto; não reúne os demais grupos. O arquivo usa ponto e vírgula como separador, com cabeçalhos ID, Nome e os nomes exatos dos objetivos. Os números exportados usam ponto decimal, sem separador de milhar. Regra de importação Comportamento Formato e tamanho CSV de até 2.000.000 bytes; uma planilha XLSX não substitui o CSV. Cabeçalhos Preserve exatamente os do modelo, inclusive os objetivos. Cabeçalhos incompatíveis impedem a aplicação. ID Identifica a pessoa ou grupo existente. IDs desconhecidos ou repetidos invalidam o arquivo; não é possível incluir participantes por CSV de metas. Nome É uma referência; a importação usa o ID e não renomeia pessoas/grupos pelo texto de Nome. Valores Aceitam ponto ou vírgula decimal, sem separador de milhar; devem ser finitos e não negativos, até 99.999.999.999,9999. Célula vazia representa zero. Linhas É possível importar somente parte dos IDs do contexto; os demais mantêm os valores. Em Compartilhada, uma linha representa o grupo e as colunas seus objetivos. Todas as linhas são validadas antes de aplicar os valores ao formulário. Um arquivo inválido não aplica parcialmente as linhas anteriores. Depois da importação, confira o resultado e salve a Performance; importar não persiste o cadastro sozinho. Não altere IDs para tentar criar pessoas ou metas de outro grupo.","links":[],"url":"/spm/manual/metas/#importar-e-exportar-metas","version":"1.4.0"},{"title":"Referência diária","anchor":"referencia-diaria","text":"A meta diária é uma referência dinâmica do que falta realizar por dia, sem substituir a meta total cadastrada. O Master define sua exibição e os dias considerados nas Configurações de Performance. Em metas de quantidade ou valor, o saldo restante é dividido pelos dias elegíveis restantes, contando hoje apenas quando o calendário o inclui. Feriados, domingos e outras exclusões dependem da Forma de cálculo escolhida. Para o cálculo, percentuais e situações sem referência, consulte Saldo restante e situações sem meta diária.","links":["/spm/manual/configuracoes-performance/#computar-meta-diaria-e-forma-de-calculo","/spm/manual/configuracoes-performance/#saldo-calendario-e-ausencia-de-meta-diaria"],"url":"/spm/manual/metas/#referencia-diaria","version":"1.4.0"},{"title":"Erros e permissões","anchor":"erros-e-permissoes","text":"Confira participante, origem Comissão/Bônus, indicador, grupo, unidade e distribuição antes de apenas aumentar a meta. Resultados pendentes de aprovação ou fontes ainda sem informação podem impedir a apuração, mesmo com o alvo preenchido. A manutenção exige acesso autorizado à Performance; visualizar um dashboard não concede permissão para editar metas. Os resultados respeitam o alcance da pessoa e a tela consultada.","links":[],"url":"/spm/manual/metas/#erros-e-permissoes","version":"1.4.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"Configuração, edição e CSV ficam no web. O web e o aplicativo apresentam metas nos dashboards e resultados disponíveis ao usuário. O aplicativo não oferece o editor nativo do Gerenciador. No OTE percentual Progressivo, o grupo determina a proporção dos trechos; a taxa média é aplicada à base própria de cada participante. A meta compartilhada não multiplica o pagamento coletivo pelo número de pessoas. Consulte Integral ou Progressivo.","links":["/spm/manual/performance-regras-de-calculo/#ote-percentual-integral-ou-progressivo"],"url":"/spm/manual/metas/#disponibilidade","version":"1.4.0"}]},{"id":"glossario","title":"Glossário","summary":"Consulte os principais termos usados nas telas e regras do Askora.","module":"Primeiros passos","version":"1.0.0","publication":"public","channels":["web","mobile"],"keywords":["conceitos","termos","empresa","perfil","apuração","situação"],"related":["permissoes-e-escopos","performance","manual-e-suporte"],"url":"/spm/manual/glossario/","markdownUrl":"/spm/manual/glossario.md","sections":[{"title":"Introdução","anchor":"","text":"Os termos abaixo seguem as funções disponíveis no produto. Uma definição não concede permissão nem indica que a mesma tela existe em todos os canais.","links":[],"url":"/spm/manual/glossario/","version":"1.0.0"},{"title":"Empresa, pessoas e acesso","anchor":"empresa-pessoas-e-acesso","text":"Termo Significado Conta ativa Acesso à empresa selecionada na sessão. Trocar a conta muda o contexto dos dados e permissões. Organização e suborganização Divisões cadastradas dentro da empresa, usadas em vínculos, filtros e restrições. Não são contas de login. Pessoa Cadastro como administrador, colaborador, parceiro, cliente ou fornecedor. Cadastro e concessão de login são coisas distintas. Perfil de acesso Master, Admin, Padrão ou Visualizador; determina possibilidades de acesso em conjunto com permissões, vínculos e escopo. Cargo Cadastro que pode reunir permissões para colaboradores. Não substitui o perfil da sessão. Escopo Conjunto de organizações, suborganizações, pessoas e registros que a sessão pode consultar ou alterar. Gerenciador Área de configuração e cadastros. Não é um quinto perfil de acesso. Participante acompanhado Pessoa que ocupa capacidade do plano pelas condições de remuneração e Performance. Não é sinônimo de todos os logins. Consulte permissões e escopos, pessoas e assinatura e uso.","links":["/spm/manual/permissoes-e-escopos/","/spm/manual/pessoas-cargos-e-acessos/","/spm/manual/assinatura-e-uso/"],"url":"/spm/manual/glossario/#empresa-pessoas-e-acesso","version":"1.0.0"},{"title":"Performance e resultados","anchor":"performance-e-resultados","text":"Termo Significado Performance ou ciclo Configuração com período, participantes e regras de acompanhamento/remuneração. Rascunho e pronto têm efeitos diferentes. Meta Objetivo configurado para uma pessoa ou grupo, conforme o indicador e o período. Meta ausente não deve ser inventada como zero. Métrica Indicador que pode receber resultado numérico, percentual ou monetário e participar de cálculos conforme a configuração. Comissão e bônus Componentes de remuneração calculados pelas regras configuradas, bases e metas aplicáveis. Prêmio Premiação monetária ou física configurada na Performance; reconhecimento de direito não comprova pagamento ou entrega. Apuração Cálculo dos resultados a partir dos dados e regras aplicáveis. Consultar um resultado não significa registrar pagamento. Liberação Revisão posterior de uma operação sujeita a aprovação. Não é a confirmação antecipada de uma ação de IA. Conquista Reconhecimento pessoal de um critério atingido; não gera pagamento por si só. Consulte Performance, metas, remuneração, apuração e liberações.","links":["/spm/manual/performance/","/spm/manual/metas/","/spm/manual/remuneracao-e-premios/","/spm/manual/apuracao/","/spm/manual/liberacoes/"],"url":"/spm/manual/glossario/#performance-e-resultados","version":"1.0.0"},{"title":"Operação e datas","anchor":"operacao-e-datas","text":"Termo Significado Situação Estado do registro no seu domínio, como ativo/inativo ou aprovado/pendente. Não tem significado único em todas as telas. Etapa de Pipeline Posição da oportunidade no fluxo; Entrada, Ganha e Perdida têm papéis próprios, mesmo com nomes personalizados. Categoria de Tarefa Organização do trabalho; mudar categoria não conclui a tarefa. Ocorrência Instância de uma série recorrente. Uma previsão virtual pode aparecer antes de existir um registro operacional próprio. Data comercial Data informada na venda, usada em análises comerciais. Difere da data em que o registro foi criado. Vencimento Data em que a obrigação vence. Baixa Registro do pagamento ou recebimento no sistema. Não comprova automaticamente liquidação em um banco externo. Lote de pagamento Conjunto preparado para tratamento de pagamentos, com reserva e estados próprios. Fechamento Bloqueio de alterações em um intervalo por regra configurada, com histórico próprio.","links":[],"url":"/spm/manual/glossario/#operacao-e-datas","version":"1.0.0"},{"title":"Integrações e canais","anchor":"integracoes-e-canais","text":"Termo Significado Identificador externo Código usado para reconhecer um cadastro em outro sistema, respeitando seu contexto. Não equivale ao nome exibido. API Interface de integração com permissões e limites próprios. Não é uma sessão pessoal de um colaborador. Conector Configuração para consultar um destino externo e processar seus dados conforme o mapeamento. Webhook Recebimento ou envio de eventos entre sistemas; pode exigir assinatura, tratamento de repetição e novas tentativas. Mapeamento Associação entre campos da origem e campos aceitos no destino. Não dispensa as validações do módulo. Prévia ou simulação Conferência anterior à aplicação, com alcance descrito em cada tela. Não confirma gravação nem reserva de um identificador. Web e aplicativo Interfaces distintas do produto. Usar o site no celular continua sendo web. Visualizada e lida Estados distintos de uma notificação: exibição da novidade e marcação explícita de leitura. Consulte API e conectores, webhooks e notificações.","links":["/spm/manual/integracao-api/","/spm/manual/integracao-webhook/","/spm/manual/notificacoes/"],"url":"/spm/manual/glossario/#integracoes-e-canais","version":"1.0.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"Este glossário é comum ao web e ao aplicativo. Consulte a seção Disponibilidade da página vinculada para saber onde a ação existe e quais condições exige.","links":[],"url":"/spm/manual/glossario/#disponibilidade","version":"1.0.0"}]},{"id":"manual-e-suporte","title":"Manual e suporte","summary":"Encontre instruções do produto e os canais de ajuda, com a mesma referência no web e no aplicativo.","module":"Primeiros passos","version":"1.2.0","publication":"public","channels":["web","mobile"],"keywords":["ajuda","SPM","manual","suporte","busca","Kora"],"related":["home","navegacao-e-recursos-comuns","glossario"],"url":"/spm/manual/manual-e-suporte/","markdownUrl":"/spm/manual/manual-e-suporte.md","sections":[{"title":"Introdução","anchor":"","text":"O SPM do Askora reúne a entrada para o manual e os materiais públicos. No web, Ajuda → Manuais abre essa área. Ajuda → Suporte leva à página de contato. Ajuda → Feedback abre a página de feedback do site. A Home também oferece acesso aos materiais de ajuda.","links":[],"url":"/spm/manual/manual-e-suporte/","version":"1.2.0"},{"title":"Encontrar uma instrução","anchor":"encontrar-uma-instrucao","text":"Abra o índice do manual. Busque pelo nome da tela, ação ou conceito, ou navegue pelos assuntos. Abra o resultado e use o sumário para chegar à seção desejada. Confira a seção Disponibilidade para distinguir web e aplicativo. A busca aceita termos com ou sem acentos. Se não encontrar, tente o nome usado na interface ou consulte o glossário. Sem conexão suficiente para carregar a busca, a lista de assuntos continua disponível na página já carregada. A navegação por assuntos também funciona sem JavaScript; abrir outra página ainda exige acesso ao site.","links":["/spm/manual/glossario/"],"url":"/spm/manual/manual-e-suporte/#encontrar-uma-instrucao","version":"1.2.0"},{"title":"Compartilhar e guardar","anchor":"compartilhar-e-guardar","text":"Cada página tem endereço próprio, versão editorial e links para suas seções. Você pode copiar um link de seção para compartilhar o trecho específico. A opção Markdown oferece o conteúdo textual da mesma versão para consulta em ferramentas compatíveis ou para guardar uma cópia. A versão indica a revisão do texto, não a versão do aplicativo instalado. Uma cópia baixada não recebe atualizações automaticamente. Se houver diferença, confira o manual atual e a disponibilidade da função na conta.","links":[],"url":"/spm/manual/manual-e-suporte/#compartilhar-e-guardar","version":"1.2.0"},{"title":"Solicitar ajuda","anchor":"solicitar-ajuda","text":"No contato do Askora, descreva a tela, a ação tentada, o resultado esperado e a mensagem de erro. Informe se usa web ou aplicativo e qual conta estava ativa, com apenas os dados necessários para localizar o atendimento. Não envie senha, código de autenticação ou segredo de integração. O manual explica as funções, mas não muda permissões nem executa operações da sua empresa. Se faltar acesso, consulte a pessoa responsável pelos acessos da conta. Para uma função ausente, verifique também as configurações do produto e sua disponibilidade por canal.","links":[],"url":"/spm/manual/manual-e-suporte/#solicitar-ajuda","version":"1.2.0"},{"title":"Tirar dúvidas com a Kora","anchor":"tirar-duvidas-com-a-kora","text":"A Kora orienta você a usar o Askora com base neste manual. Abra a Kora e descreva sua dúvida, por exemplo: “Como cadastro uma performance?” ou “Como crio uma tarefa?”. Os links junto à resposta abrem os trechos consultados para você conferir as instruções. No chat web, os dois ícones à esquerda do cabeçalho abrem o histórico pesquisável e as ações Nova conversa e Excluir conversa. À direita ficam fechar e minimizar. Pressione Enter para enviar ou Shift+Enter para quebrar a linha. Sua mensagem sai do campo e aparece na conversa imediatamente. Enquanto aguarda, a Kora mostra Pensando com uma animação suave; depois, a resposta aparece progressivamente. Você pode escrever a próxima dúvida durante a espera e enviá-la quando a resposta terminar. A preferência de movimento reduzido do navegador desativa essas animações. Você pode iniciar uma nova conversa, retomar seu histórico pessoal ou excluir uma conversa. A Kora não consulta os registros da empresa, não informa resultados reais da conta e não cadastra, altera ou exclui dados. Quando você pedir uma operação, ela pode explicar como realizá-la na tela correspondente. Não é necessário conectar uma conta de IA nem fornecer uma chave: o suporte utiliza a conexão do Askora. Não há opções de ativação de ações ou de outras conexões nesta versão. Evite enviar senhas, chaves de API e dados sensíveis na conversa. Se a resposta não resolver sua dúvida, consulte a fonte indicada ou entre em contato com o suporte. Caso o chat esteja temporariamente indisponível, Ajuda → Manuais continua permitindo consultar as instruções. Ler o manual não depende do serviço de IA.","links":[],"url":"/spm/manual/manual-e-suporte/#tirar-duvidas-com-a-kora","version":"1.2.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"O manual é público e pode ser aberto no navegador do computador ou celular, inclusive pelos links do aplicativo. O conteúdo é o mesmo para os dois canais; diferenças funcionais são descritas na página de cada assunto. O site público não mostra os registros privados da sua conta.","links":[],"url":"/spm/manual/manual-e-suporte/#disponibilidade","version":"1.2.0"}]},{"id":"navegacao-e-recursos-comuns","title":"Navegação e recursos comuns","summary":"Use menus, filtros, tabelas e seleções respeitando o contexto de cada página.","module":"Primeiros passos","version":"1.1.0","publication":"public","channels":["web","mobile"],"keywords":["menu","filtro","tabela","seleção","favorita","erro","tema"],"related":["permissoes-e-escopos","configuracoes-do-produto","conta-e-perfil","manual-e-suporte","operacoes"],"url":"/spm/manual/navegacao-e-recursos-comuns/","markdownUrl":"/spm/manual/navegacao-e-recursos-comuns.md","sections":[{"title":"Introdução","anchor":"","text":"O menu reúne Dashboards, Gerenciador, Operações, Integrações e Ajuda, conforme seu acesso. Conta reúne informações pessoais. Estar em uma empresa, organização ou página não concede automaticamente permissão para todos os seus registros.","links":[],"url":"/spm/manual/navegacao-e-recursos-comuns/","version":"1.1.0"},{"title":"Escolher a página e a conta","anchor":"escolher-a-pagina-e-a-conta","text":"Confirme a conta ativa antes de trabalhar. Use as abas para escolher os cadastros, estados ou visualizações oferecidos pela página. Pipeline e Tarefas são módulos independentes, mesmo quando usam controles parecidos. No aplicativo, é possível escolher favoritas de Dashboards e Operações entre as páginas disponíveis. As preferências pertencem à conta; uma favorita que perde disponibilidade é substituída por uma opção permitida. As favoritas do aplicativo não são um cadastro de novas páginas no web.","links":[],"url":"/spm/manual/navegacao-e-recursos-comuns/#escolher-a-pagina-e-a-conta","version":"1.1.0"},{"title":"Filtrar e consultar","anchor":"filtrar-e-consultar","text":"Filtros de organização, pessoa, período, situação ou outros campos dependem da página. Confira o filtro antes de interpretar um total ou exportar. As opções já respeitam seu acesso; um campo vazio não significa permissão para consultar qualquer pessoa. Nas tabelas web com Filtrar, use + Adicionar filtro, escolha Coluna e preencha o valor; Aplicar atualiza a consulta, Limpar remove as condições e Cancelar descarta a edição do filtro. Texto procura conteúdo, número procura igualdade, seletores oferecem opções e Sem preenchimento quando admitido; datas aceitam limites inicial/final. Nos filtros organizacionais desse componente, registros sem vínculo também podem permanecer visíveis. Isso não amplia a permissão de acesso. Paginação limita o que aparece de uma vez. Totais gerais, dados da página e seleções podem ter alcances diferentes. Em dashboards, leia a definição do indicador: a mesma data pode representar venda, vencimento, provisão ou pagamento em telas diferentes. Quando houver tabela, calendário e Kanban, use a visualização adequada à tarefa. Arrastar um cartão segue as transições permitidas pelo módulo; mover a categoria de uma tarefa não equivale a concluí-la.","links":[],"url":"/spm/manual/navegacao-e-recursos-comuns/#filtrar-e-consultar","version":"1.1.0"},{"title":"Selecionar e editar em lote","anchor":"selecionar-e-editar-em-lote","text":"Use as caixas de seleção e confira os registros antes de aplicar uma ação. Conforme a tela, a seleção geral pode buscar todo o resultado filtrado, além da página visível. Seleção de notificações tem regra própria: marcar a página como lida alcança somente os avisos exibidos. Ações em lote dependem de permissão e elegibilidade de cada registro. Registros pagos, fechados ou controlados por outro módulo podem impedir a alteração. Uma seleção desatualizada exige atualizar a tabela e selecionar novamente. Algumas telas enviam conjuntos grandes em partes. Se a mensagem informar que uma quantidade já foi salva, essas gravações estão confirmadas; os demais registros precisam de conferência. Não trate falha posterior como cancelamento automático de tudo. Consulte a página do módulo para saber quais ações e limites existem. Cadastro rápido cria novas linhas para preencher e salvar. Duplicar normalmente prepara novos registros para conferência; cada módulo define quais vínculos e estados são copiados. A presença de um controle genérico Importar/Exportar não garante um fluxo ativo naquela página: use o procedimento documentado para a operação.","links":[],"url":"/spm/manual/navegacao-e-recursos-comuns/#selecionar-e-editar-em-lote","version":"1.1.0"},{"title":"Vazio, bloqueio e falha","anchor":"vazio-bloqueio-e-falha","text":"Uma lista vazia pode significar ausência de dados no filtro, falta de vínculos ou restrição de acesso. Revise período, situação e conta ativa. Um módulo desativado não apaga seu histórico; sua disponibilidade é controlada pelas configurações do produto. Se aparecer conflito ou alteração de acesso, atualize os dados antes de repetir. Erro de campo exige corrigir a entrada indicada. Em uma falha de comunicação após salvar, confira o registro antes de criar outro. Mensagem de sucesso e estado retornado pelo sistema são a referência para a conclusão da ação.","links":[],"url":"/spm/manual/navegacao-e-recursos-comuns/#vazio-bloqueio-e-falha","version":"1.1.0"},{"title":"Aparência e disponibilidade","anchor":"aparencia-e-disponibilidade","text":"No web, o seletor alterna os temas claro e escuro e mantém a preferência no navegador. No aplicativo, Aparência também oferece seguir o sistema. Essas preferências não alteram os dados da empresa.","links":[],"url":"/spm/manual/navegacao-e-recursos-comuns/#aparencia-e-disponibilidade","version":"1.1.0"},{"title":"Disponibilidade","anchor":"disponibilidade","text":"Web e aplicativo compartilham as regras de acesso dos recursos disponíveis. O aplicativo oferece navegação e formulários próprios; não reproduz todas as tabelas, ações em lote, exportações ou telas de Gerenciador/Integrações do web. Cada página deste manual informa suas diferenças. Abrir o web no navegador do celular continua sendo uso da interface web.","links":[],"url":"/spm/manual/navegacao-e-recursos-comuns/#disponibilidade","version":"1.1.0"}]}]}