# Executar tarefas

Crie tarefas avulsas, execute ocorrências de rotinas, preencha checklist e acompanhe datas, aprovação e conclusão.

Versão 1.2.2

**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.

## Criar e executar

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.

1. 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.
2. 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.
3. No cadastro completo, prepare a aba **Checklist**, se necessário, e salve. **Cancelar** descarta alterações ainda não salvas.
4. 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](/spm/manual/tarefas-operacao/#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.

## Status, atraso e encerramento

**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.

## Ocorrências recorrentes

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](/spm/manual/tarefas-configuracao/#recorrencia). 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.

## Checklist

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](/spm/manual/tarefas-configuracao/#checklist-da-rotina). 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.

## Calendário, tabela e filtros

| 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.

## Tabela, duplicação e arquivos

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.

## Aprovação, acesso, fechamentos e Performance

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](/spm/manual/liberacoes/#conferir-e-decidir); 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](/spm/manual/fechamentos/#datas-protegidas).


## Disponibilidade

A [configuração Usar Tarefas](/spm/manual/configuracoes-tarefas/#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.