# Cadastro de Convênios

Os convênios permitem criar acordos de desconto com empresas parceiras, oferecendo descontos por valor fixo, percentual ou de forma progressiva.

**Caminho:** Menu lateral → Convênios → Cadastrar convênio

---

## Campos principais

| Campo | Tipo | Obrigatório | Descrição |
|-------|------|:-----------:|-----------|
| Status | Seleção | Sim | Ativo ou Inativo |
| Nome | Texto | Sim | Nome do convênio |
| Visibilidade | Seleção | Sim | App e Administrativo, ou apenas Administrativo |
| Tipo | Seleção | Sim | Valor, Percentual ou Progressivo |

---

## Tipos de desconto

### Tipo: Valor fixo

| Campo | Tipo | Descrição |
|-------|------|-----------|
| Valor | Moeda | Valor do desconto em reais |
| Tolerância | Hora (HH:MM) | Tempo de tolerância após aplicação |

### Tipo: Percentual

| Campo | Tipo | Descrição |
|-------|------|-----------|
| Percentual | Numérico | Porcentagem de desconto (0 a 100) |
| Tolerância | Hora (HH:MM) | Tempo de tolerância após aplicação |

### Tipo: Progressivo

O desconto progressivo permite definir faixas de valor com descontos diferentes:

| Campo | Tipo | Descrição |
|-------|------|-----------|
| Tolerância | Texto | Tempo de tolerância |
| Valor de cobrança | Moeda | Valor limite da faixa |
| Tipo do desconto | Seleção | Valor fixo ou Percentual |
| Valor do desconto | Moeda | Se tipo for Valor |
| Percentual | Numérico | Se tipo for Percentual |

Cada faixa é adicionada à tabela de regras progressivas, onde é possível visualizar e excluir regras individualmente.

---

## Configurações online

Quando o convênio é habilitado para uso online:

| Campo | Tipo | Obrigatório | Descrição |
|-------|------|:-----------:|-----------|
| Habilitar online | Checkbox | Não | Permitir uso online |
| Valor unitário | Moeda | Sim | Preço por unidade |
| Quantidade mínima | Numérico | Sim | Mínimo de unidades |
| Quantidade máxima | Numérico | Sim | Máximo de unidades |
| Multiplicador | Numérico | Sim | Incremento de quantidade |

---

## Ações disponíveis

- **Cadastrar convênio**: Criar novo convênio
- **Atualizar convênio**: Modificar convênio existente
- **Duplicar**: Copiar configurações para um novo convênio
- **Excluir**: Remover convênio

> **Exemplo de uso progressivo:** Até R$ 20,00 de cobrança aplica 50% de desconto; acima de R$ 20,00 aplica desconto fixo de R$ 10,00.