# Cadastro de Mensalistas

O cadastro de mensalistas permite registrar clientes com assinatura mensal de estabelecimento, vinculando veículos, planos e informações de cobrança.

**Caminho:** Menu lateral → Mensalistas → Cadastrar mensalista

---

## Campos principais

| Campo | Tipo | Obrigatório | Descrição |
|-------|------|:-----------:|-----------|
| Status | Seleção | Sim | Ativo ou Inativo |
| Plano | Seleção | Sim | Plano de mensalidade vinculado |
| Nome do cliente | Texto | Sim | Nome completo do mensalista |
| Celular/WhatsApp | Texto | Não | Número para contato via WhatsApp |
| Vagas | Seleção | Sim | Quantidade de vagas contratadas (1 a 31) |
| Cartão de acesso | Texto | Não | Número do cartão de acesso (quando habilitado nos parâmetros) |
| Placa do veículo | Texto | Sim | Placa do veículo no formato válido |

## Cobrança

| Campo | Tipo | Obrigatório | Descrição |
|-------|------|:-----------:|-----------|
| Data da primeira fatura | Data | Sim | Data de início da cobrança |
| Quantidade de cobranças | Seleção | Sim | Número de faturas a gerar (1 a 23) |
| Dia de vencimento | Seleção | Sim | Dia do mês para vencimento (1 a 31) |
| Tipo de alteração | Seleção | Sim | Por plano ou por vagas |
| Tipo da primeira cobrança | Seleção | Sim | Proporcional ou valor cheio |

## Campos opcionais

Ao clicar em **"Mostrar campos opcionais"**, são exibidos campos adicionais:

- **Documento**: CPF ou CNPJ com máscara
- **Telefone**: Telefone comercial
- **E-mail**: Endereço de e-mail

### Dados do veículo

- Cartão de acesso (opcional)
- Placa (obrigatório)
- Modelo
- Marca
- Cor (seleção com 14 opções: Branco, Prata, Preto, Cinza, Vermelho, Azul, Amarelo, Verde, Vinho, Marrom, Bege, Laranja, Outros)

### Endereço

- CEP (com busca automática)
- Logradouro
- Número
- Bairro
- Cidade
- Estado
- Complemento

---

## Ações disponíveis

- **Cadastrar e criar outro**: Salva o registro e abre formulário para novo cadastro
- **Cadastrar e visualizar detalhes**: Salva e redireciona para a tela de detalhes
- **Atualizar informações**: Disponível ao editar um mensalista existente
- **Cadastro via portal**: Link externo para cadastro pelo cliente
- **Enviar link via WhatsApp**: Envia link de cadastro por WhatsApp
- **Importar**: Importação em massa via arquivo Excel

---

## Importação em massa

É possível importar vários mensalistas de uma vez utilizando um arquivo Excel. O sistema valida os dados antes de importar e exibe uma prévia com os registros encontrados, incluindo alertas de duplicidade.

> **Dica:** Ao preencher o CEP, os campos de endereço são preenchidos automaticamente.