# Definir prazo de resposta de tarefas

## Definir o prazo de resposta

Cada responsável de uma tarefa humana obrigatoriamente tem um prazo limite (SLA) para sua execução.  Esse é o prazo máximo esperado de resposta.&#x20;

{% hint style="info" %}
Dica: dificilmente esse prazo será um prazo curto, em minutos. Pessoas trabalham de maneira dispersa, podendo levar até mesmo horas para tomar ciência da existência da tarefa.&#x20;
{% endhint %}

Esse prazo pode ser em horas corridas ou horas úteis, e pode ser fixo ou dinâmico. Os Prazos / SLA podem ser definidos das seguintes formas:

1. **Prazo fixo:** nessa configuração, você irá informar o prazo das tarefas por um valor numérico fixo, em horas. Para configurar um prazo em minutos, utilize valores decimais. Por exemplo, 0,5 representa 30 minutos e 1,5 representa 1h30min.

{% hint style="info" %}
Dica: é muito difícil definir prazos corretos na primeira versão do aplicativo de processo. Defina prazos estimados, rode o aplicativo, aprenda, acompanhe relatórios e, com o tempo, otimize os prazos e SLAs.&#x20;
{% endhint %}

2. **Campo do formulário com horas** (número de horas `hh`)**:** aqui o campo do formulário determina quantas horas de SLA estão disponíveis para a conclusão da tarefa. Por exemplo: numa solicitação de suporte, pode-se automatizar o SLA segundo a urgência do caso e um campo recebe quantas horas cada complexidade tem (alta urgência - 2h / baixa urgência - 8h).
3. **Campo do formulário com data e hora** (`dd/mm/aaaa hh:mi` ou `dd/mm/aaaa hh:mi:ss`): onde uma data e horário armazenados em um campo do formulário da solicitação são o SLA do processo.
4. **Campo do formulário com data** (`dd/mm/aaaa` ): nesta configuração, uma data armazenada em um campo do formulário da solicitação, com horário de conclusão da tarefa **no início do dia**, às 00:00:01.
5. **Campo do formulário com data - final do dia** (`dd/mm/aaaa` ): ao selecionar esta configuração, uma data armazenada em um campo do formulário da solicitação, com horário de conclusão da tarefa **no final do dia**, às 23:59:59.
6. **Meta de marco:** onde temos um prazo associado a definição de meta em horas, úteis ou corridas, de um [elemento de marco](/zeev/como-construir-processos/como-desenhar-processos/como-usar-eventos/evento-de-marco.md) prévio existente no processo.
7. **Regras de negócio:** nesta configuração o SLA está atrelado a uma regra de negócio que pode retornar:
   1. ***Um número inteiro ou decimal***, que contará como um prazo em horas, corridas ou úteis, definidas no retorno da execução de uma regra de negócio
   2. ***Regra de negócio que retorne data***, onde o SLA será uma data, definida no retorno da execução de uma regra de negócio, com horário de conclusão da tarefa **no início do dia**, às 00:00:01.
   3. ***Regra de negócio que retorne data e hora***, onde temos como prazo uma data e horário definidos no retorno da execução de uma regra de negócio.

#### Cálculo de horas em número decimal

Para saber o valor decimal, basta dividir os minutos por 60:&#x20;

* Ex: 70 (minutos que representam 1 hora e 10 min) / 60 = 1,16
* Ex: 18 (minutos) / 60 = 0,3

{% hint style="info" %}
Dica: se você possui um campo do tipo data no formato dd/mm/aaaa e deseja definir um horário, utilize uma [tarefa de regra de negócio](/zeev/como-construir-processos/como-desenhar-processos/o-que-sao-atividades/o-que-e-atividade-de-regra-de-negocio.md#modificar-o-valor-de-campo-do-formulario) que modifica o valor do campo do formulário, utilizando um conjunto de dados fixos e dinâmicos. Por exemplo, se o identificador do seu campo data é "dataLimite", configure a tarefa de regra de negócio para mudar o valor do campo dataLimite para a seguinte expressão:

`{Form.dataLimite} 23:59`
{% endhint %}

### Horas corridas

Ao não habilitar "Respeitar horas úteis", essa será a configuração adotada e o prazo calculado considerará as horas corridas. Se, por exemplo, uma tarefa possui um prazo de 8 horas corridas, se a tarefa for criada às 14h, seu prazo vencerá às 22h.

### Horas úteis

Ao habilitar "Respeitar horas úteis" na configuração da tarefa humana, o prazo calculado considerará as horas úteis de trabalho do responsável. Se, por exemplo, uma tarefa possui um prazo de 8 horas corridas, se a tarefa for criada às 14h, de sexta-feira, pode ser que seu prazo irá vencer somente na segunda-feira às 12h.

Para realizar o cálculo de horas úteis, é preciso determinar o esquema de turno de trabalho associado à pessoa. Esse esquema será definido com base nas seguintes regras:

* O [turno de trabalho](/zeev/outras-configuracoes-avancadas/como-cadastrar-turnos-de-trabalho.md) associado diretamente à pessoa;
* Caso não seja encontrado, o [turno de trabalho](/zeev/outras-configuracoes-avancadas/como-cadastrar-turnos-de-trabalho.md) associado à [função](/zeev/usuarios-e-permissoes/como-criar-funcoes.md) que foi utilizada como regra de alocação na tarefa;
* Caso não seja encontrado, o [turno de trabalho](/zeev/outras-configuracoes-avancadas/como-cadastrar-turnos-de-trabalho.md) associado ao [time](/zeev/usuarios-e-permissoes/como-criar-times.md) que foi utilizado como regra de alocação na tarefa;
* Caso não seja encontrado, o [turno de trabalho](/zeev/outras-configuracoes-avancadas/como-cadastrar-turnos-de-trabalho.md) padrão do sistema;

Caso não seja encontrado nenhum turno de trabalho, o cálculo será realizado com horas corridas;

Para realizar o cálculo de horas úteis, é utilizado o país, estado e cidade da pessoa. Essa informação é utilizada para definir os feriados que impactam na pessoa. Essas informações serão definidas com base nas seguintes regras:

* A cidade, Estado e país associados diretamente à pessoa em seu cadastro;
* Caso não sejam encontradas, a cidade, Estado e país vinculados ao [time](/zeev/usuarios-e-permissoes/como-criar-times.md) que foi utilizado como regra de alocação na tarefa;

O cálculo de horas úteis é realizado alocando o volume de horas configurado na tarefa ao longo do esquema de turnos de trabalho da pessoa, excluindo feriados nacionais, estaduais ou municipais, se for o caso;

O cálculo de horas úteis permite calcular prazos até o ano de 2049

{% hint style="info" %}
**Dica:** nos exemplos acima, trabalhamos com os prazos em horas. Para trabalhar com prazos em dias, multiplique por 24. Assim, 2 dias corridos é igual a 48 horas corridas configuradas. Já 2 dias úteis será igual a 16 horas úteis configuradas, se o seu dia útil é de 8 horas.
{% endhint %}

## O prazo estourou... e agora?

O que vai acontecer após estourado o "Prazo / SLA" será definido por você nas configurações da tarefa?

Pode simplesmente não acontecer nada e a tarefa permanecer com os responsáveis originais, com status de atrasada, ou pode haver algum tipo de [alerta](/zeev/como-construir-processos/como-desenhar-processos/o-que-sao-atividades/como-configurar-atividades-humanas/como-configurar-notificacoes-aos-responsaveis-pela-tarefa.md), ou [escalonamento](/zeev/como-construir-processos/como-desenhar-processos/o-que-sao-atividades/como-configurar-atividades-humanas/como-configurar-responsaveis-e-prazos/regras-para-definir-responsaveis-por-tarefas.md#escalonamento-de-tarefas) para outro responsável.&#x20;

Esses alertas e escalonamentos podem ser configurados de duas maneiras:

* Dentro das configurações da própria tarefa humana, usando o [escalonamento](/zeev/como-construir-processos/como-desenhar-processos/o-que-sao-atividades/como-configurar-atividades-humanas/como-configurar-responsaveis-e-prazos/regras-para-definir-responsaveis-por-tarefas.md#escalonamento-de-tarefas);
* Utilizando um evento de [timer vinculado na borda na tarefa humana](/zeev/como-construir-processos/como-desenhar-processos/como-usar-eventos/como-configurar-timers.md#na-borda-da-tarefa);

Além disso, é possível alertar o próprio responsável da tarefa quando o prazo da tarefa expirar, habilitando o alerta "[Enviar notificação ao expirar o prazo](/zeev/como-construir-processos/como-desenhar-processos/o-que-sao-atividades/como-configurar-atividades-humanas/como-configurar-notificacoes-aos-responsaveis-pela-tarefa.md#notificacao-de-prazo-expirado)".

{% hint style="info" %}
**Dica**: utilizar o evento de timer na borda dá mais flexibilidade e torna explícito no desenho do processo o escalonamento.
{% endhint %}

{% hint style="danger" %}
Cálculos de prazos que resultem em datas inferiores a 01/01/1753 e superiores a 31/12/9999 serão ignoradas; valores abaixo ou acima desses intervalos serão ignorados, e essas referências serão usadas.&#x20;
{% endhint %}

#### Recálculo de prazos

Uma vez que uma tarefa foi criada e foi calculado um prazo, mesmo que as configurações da tarefa sejam modificadas, mesmo que a tarefa esteja ativo, não haverá recálculo de prazos.&#x20;

{% hint style="info" %}
**Exemplo:** na modelagem, você atribuiu a uma ***T01 - Solicitar suporte*** um SLA de 8h e um chamado foi aberto, ou seja, uma tarefa foi iniciada com esse SLA de 8h. Ao verificar uma necessidade do seu contexto, retornou à modelagem e optou por reduzir o SLA para 6h. A tarefa que já estava aberta, seguirá contando com 8h de SLA e somente as novas tarefas, após a atualização do aplicativo, passarão a contar com 6h de SLA.
{% endhint %}

Contudo, ao haver transferência de atores da tarefa, um novo prazo é calculado - o SLA é resetado.&#x20;

{% hint style="info" %}
Exemplo: a tarefa humana ***T01 - Solicitar suporte*** foi aberto com um SLA de 8h para a pessoa "Ator 1". Faltando 2h para a conclusão do SLA, ele transfere a tarefa para a pessoa "Ator 2". O SLA será reiniciado, para que a pessoa "Ator 2" tenha as mesmas 8h para realizar a atividade.
{% endhint %}

Ou seja, podemos concluir que o SLA está atrelado ao ator da tarefa e não à tarefa em si.

#### Exemplo prático:

Considerando a configuração de SLA definida em conjunto com o turno de trabalho configurado, temos que há um determinado SLA da tarefa configurado para 48 horas úteis, e **seu cálculo considera exclusivamente o turno de trabalho definido para o time responsável**, que funciona de segunda a sexta-feira, das 09:00 às 12:00 e das 13:00 às 18:00, totalizando 8 horas úteis por dia.

Se uma tarefa foi aberta no dia 21/01 às 17:40, temos que, nesse momento, restavam apenas 20 minutos úteis até o encerramento do expediente (às 18:00), e esse tempo já foi contabilizado no SLA.

Com isso, após o primeiro dia, ainda restavam 47 horas e 40 minutos de SLA a serem consumidas:

Então temos que o SLA restante e a definição da tarefa se dará da seguinte forma:

| Data                            | Tempo contabilizado | SLA restante |
| ------------------------------- | ------------------- | ------------ |
| Qua - 21/01                     | 0h20                | 47h40        |
| Qui - 22/01                     | 8h                  | 39h40        |
| Sex - 23/01                     | 8h                  | 31h40        |
| Sab - 24/01 (não há expediente) | -                   | 31h40        |
| Dom - 25/01 (não há expediente) | -                   | 31h40        |
| Seg - 26/01                     | 8h                  | 23h40        |
| Ter - 27/01                     | 8h                  | 15h40        |
| Qua - 28/01                     | 8h                  | 7h40         |
| Qui - 29/01                     | 7h40                | 0h           |

Nos dias úteis seguintes, o sistema continua a contagem considerando apenas os horários dentro do turno configurado, **desconsiderando períodos fora do expediente e o final de semana**.

Dessa forma, o SLA é consumido progressivamente até ser completamente finalizado no dia 29/01 às 17:40, quando as 48 horas úteis são efetivamente atingidas.&#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kb.stoque.com.br/zeev/como-construir-processos/como-desenhar-processos/o-que-sao-atividades/como-configurar-atividades-humanas/como-configurar-responsaveis-e-prazos/definir-prazo-de-resposta-de-tarefas.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
