> For the complete documentation index, see [llms.txt](https://guia-de-uso.tiflux.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guia-de-uso.tiflux.com/sistema/contratos/visualizando-contratos/horas-cumulativas.md).

# Horas Cumulativas

O contrato de horas cumulativas é utilizado para que as horas contratadas não utilizadas possam ser aproveitadas em outro período conforme o ciclo de acúmulo de contrato.

## 📘 Horas Cumulativas no Menu Contratos

```
📍 Localização:
📂 Menu > Contratos
📂 Menu > Clientes > Contratos > + Contratos
```

***

### 🎯 Introdução

O modelo de Horas Cumulativas no menu Contratos do Tiflux é projetado para gerenciar operações em que as horas franqueadas contratadas e não utilizadas pelo cliente em um determinado período podem ser reaproveitadas em ciclos futuros.

Este guia explica detalhadamente o funcionamento dos ciclos de faturamento, fechamento e acúmulo, além de apresentar a memória de cálculo das horas excedentes/acumuladas e instruir a consulta dos relatórios do sistema.

***

### 📚 Sumário

1. 🔧 Pré-requisitos
2. 🧭 Passo a Passo e Lógica de Funcionamento
3. 🧮 Exemplo Prático e Memória de Cálculo
4. 📊 Como Consultar as Horas Acumuladas
5. 🛠️ Troubleshooting (Erros Comuns)
6. ⚠️ Avisos importantes
7. 🧾 Resumo
8. ❓ Perguntas Frequentes (FAQ)

***

### 🔧 Pré-requisitos

* Permissão de acesso e edição ao módulo de Contratos do Tiflux.
* Ter conhecimento prévio sobre as regras comerciais acordadas com o cliente (franquia de horas, valor mensal, ciclo de fechamento e valor da hora excedente).

### 🧭 Passo a Passo e Lógica de Funcionamento

#### 1. Entendendo os Parâmetros Comerciais

Para configurar ou interpretar um contrato de horas cumulativas, é necessário compreender três conceitos de ciclos fundamentais:

* Valor Mensal: O valor fixo cobrado do cliente em todo vencimento do ciclo de faturamento (ex: R$ 1.000,00).
* Ciclo de Faturamento: A frequência com que a cobrança recorrente base é gerada (ex: Mensal).
* Ciclo de Fechamento: O período em que o Tiflux apura o consumo total e calcula se houve horas excedentes a cobrar ou saldo de horas a acumular (ex: Bimestral).
* Ciclo de Acúmulo de Horas: O número de ciclos de fechamento durante os quais as horas remanescentes continuarão válidas para uso até a data de expiração.

***

### 🧮 Exemplo Prático e Memória de Cálculo

Considere a seguinte configuração de contrato tomada como base:

| **Parâmetro**           | **Valor de Exemplo** |
| ----------------------- | -------------------- |
| Ciclo de Faturamento    | Mensal               |
| Ciclo de Fechamento     | Bimestral            |
| Ciclo de Acúmulo        | 2                    |
| Valor Mensal            | R$ 1.000,00          |
| Valor da Hora Excedente | R$ 100,00            |
| Franquia de Horas/Ciclo | 10 horas             |
| Início do Contrato      | Janeiro/2024         |
| Dia de Vencimento       | Dia 15               |

#### Cenário A: Consumo Acima da Franquia (Horas Excedentes)

* Em 15 de Fevereiro, o cliente paga a mensalidade normal de R$ 1.000,00 (ciclo mensal).
* No final do 1º bimestre, apura-se que o cliente consumiu 11 horas (1 hora acima da franquia de 10h).
* Em 15 de Março, no fechamento do bimestre, o cálculo da fatura será:

$$\text{Valor Total} = \text{Valor Mensal} + (\text{Horas Excedentes} \times \text{Valor por Hora})$$$$\text{Valor Total} = \text{R\\$ 1000,00} + (1 \times \text{R\\$ 100,00}) = \mathbf{R\\$\ 1100,00}$$

#### Cenário B: Consumo Abaixo da Franquia (Horas Acumuladas)

* Se durante o bimestre o cliente utilizar apenas 8 horas, as 2 horas não utilizadas serão acumuladas para o próximo ciclo de fechamento.
* Em 15 de Março, o cliente paga apenas o valor mensal normal (R$ 1.000,00).
* Regra de Expiração: Como o *Ciclo de Acúmulo* é 2 (considerando o ciclo de fechamento bimestral), as 2 horas acumuladas poderão ser consumidas até o final de Junho, expirando em 01/07.

***

### 📊 Como Consultar as Horas Acumuladas

Existem dois caminhos principais no Tiflux para monitorar o saldo de horas acumuladas dos seus contratos:

#### Método 1: Relatório Gráfico Consumo Contrato

1. Acesse Relatórios > Gráfico Consumo Contrato.
2. Filtre pelo contrato do cliente desejado.
3. Observe o gráfico de consumo: caso não haja utilização total, o sistema adiciona o saldo não consumido à franquia do bimestre subsequente (ex: somando +10h a cada ciclo de fechamento sem consumo).

#### Método 2: Relatório Faturamentos Pendentes

1. Navegue até Relatórios > Faturamentos Pendentes.
2. Localize o contrato e clique no botão Download detalhado com apontamento.
3. O relatório exportado exibirá o saldo de horas remanescentes de cada ciclo de fechamento acompanhado da sua respectiva data de expiração.

***

### 🛠️ Troubleshooting (Erros Comuns)

🔹 Erro: As horas que sobraram sumiram antes do cliente conseguir utilizar

* ✅ Solução: Verifique o parâmetro Ciclo de acúmulo de contrato. Se o ciclo estiver configurado com um valor baixo, a data limite de expiração (como demonstrado na apuração dos relatórios) pode ter sido atingida, zerando o saldo acumulado antigo.

🔹 Erro: O cliente foi cobrado por hora excedente mesmo tendo saldo acumulado

* ✅ Solução: Confira se os apontamentos de horas foram lançados dentro da janela do ciclo de fechamento vigente. Lançamentos fora do período correto ou em mesas não cobertas pelo contrato não consomem a franquia acumulada.

### ⚠️ Avisos importantes

> Atente-se ao Ciclo de Fechamento: As horas excedentes e a virada do saldo acumulado só são processadas no encerramento do Ciclo de Fechamento (ex: bimestral), e não a cada vencimento mensal de fatura.
>
> Prazo de Expiração Exato: A data de expiração das horas acumuladas é contada rigorosamente com base no *Ciclo de Acúmulo*. No exemplo bimestral com acúmulo 2, as horas geradas no 1º bimestre vencem impreterivelmente no primeiro dia após o término do ciclo limite (01/07).

***

### 🧾 Resumo

A modalidade de Horas Cumulativas garante flexibilidade comercial aos clientes do Tiflux, permitindo o reaproveitamento de franquias não utilizadas e garantindo transparência financeira. Através dos relatórios de *Gráfico Consumo Contrato* e *Faturamentos Pendentes*, tanto a equipe financeira quanto o cliente conseguem acompanhar com clareza a evolução dos saldos, excedentes e prazos de expiração.

***

### ❓ Perguntas Frequentes (FAQ)

🔹 Como o valor mensal é cobrado nos meses intermediários do ciclo de fechamento?

Nos meses em que não ocorre o fechamento do ciclo (ex: no 1º mês de um bimestre), o cliente paga estritamente o valor mensal contratado via fatura recorrente.

🔹 O que acontece com as horas acumuladas quando atinge a data de expiração?

Caso as horas acumuladas não sejam consumidas dentro do prazo estipulado pelo ciclo de acúmulo de contrato, elas expiram automaticamente e são desconsideradas dos relatórios de saldo.

🔹 O valor da hora excedente é cobrado no mês a mês ou no fechamento?

A cobrança das horas excedentes é calculada e adicionada à fatura no encerramento do Ciclo de Fechamento.

🔹 Onde posso exportar a memória de cálculo detalhada das horas para enviar ao cliente?

No relatório de Faturamentos Pendentes, utilize a opção *"Download detalhado com apontamento"* para obter o detalhamento completo de saldo e datas de expiração.

🔹 Se o cliente não utilizar nenhuma hora no ciclo, o saldo acumula integralmente?

Sim. Se a franquia for de 10h e não houver consumo, as 10h integrais serão somadas ao saldo disponível do ciclo seguinte, respeitando a regra do ciclo de acúmulo.

***

### 🔍 Palavras-chave para IA, indexação e busca

```
horas cumulativas
contrato de horas acumuladas
ciclo de fechamento
ciclo de faturamento
ciclo de acúmulo de contrato
calculo hora excedente
expiração de horas acumuladas
gráfico consumo contrato tiflux
faturamentos pendentes download detalhado
```
