> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gennia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Clientes

> Gerencie clientes, assinaturas, créditos, usuários e faturas

A página de **Clientes** (`Hub > Clientes`) centraliza todos os clientes do seu hub. Você pode ver a lista geral, adicionar novos clientes manualmente e gerenciar cada um em detalhes.

## Lista de clientes

A lista mostra todos os clientes do seu hub com informações rápidas:

* **Nome do workspace**
* **Plano atual**
* **Status da assinatura** (ativa, atrasada, cancelada, em trial, pendente, suspensa)
* **Saldo de créditos**
* **Usuários ativos** vs. limite de seats

## Adicionando um cliente manualmente

Em vez de esperar o cliente se cadastrar, você pode adicioná-lo diretamente. Use o botão **Adicionar Cliente** e informe:

* **Nome do workspace**
* **Plano** — selecione um dos planos ativos
* **Overrides iniciais** (opcional) — créditos customizados, seats customizados

O cliente é criado com status **Pending Onboarding** e recebe um convite por e-mail para criar a senha.

## Detalhes do cliente

Clicando em um cliente, você acessa a página de detalhes com 5 abas:

### Visão geral

Resumo completo do cliente:

* **Informações da assinatura** — plano, preço, intervalo, status
* **Créditos** — saldo atual, usado no período, créditos extras, próxima renovação, limite
* **Usuários** — ativos, total, limite de seats
* **Mudanças pendentes** — se há alteração de plano agendada e quando entra em vigor

### Usuários

Lista de usuários do workspace do cliente:

* Nome, e-mail, papel
* Convites pendentes
* Ações: adicionar, editar, remover usuário, reenviar convite

Você vê o contador atual vs. limite de seats do plano.

### Gerenciar plano

Controles principais da assinatura:

* **Plano atual** e suas informações
* **Plano pendente** — se há mudança agendada, data em que entra em vigor
* **Overrides customizados** — personalizações específicas para esse cliente:
  * Créditos customizados (diferentes do plano padrão)
  * Seats customizados
  * Créditos ilimitados (toggle independente do plano)
  * Créditos extras customizados
* **Ações**:
  * **Mudar plano** — agenda uma mudança de plano com data de vigência
  * **Cancelar mudanças agendadas** — reverte mudanças programadas
  * **Suspender** — suspende a assinatura (pede motivo)
  * **Reativar** — restaura assinatura suspensa

### Faturas

Histórico completo de faturas do cliente:

* Valor, status (paga, em aberto, cancelada, incobrável)
* Datas (emissão, vencimento, pagamento)
* PDF para download
* Link para a fatura hospedada no Stripe
* Método de pagamento usado

### Histórico

Transações do cliente — assinaturas, reembolsos, saques, compras de créditos extras:

* Tipo de transação
* Valor bruto, taxa da plataforma, valor líquido
* Status (pendente, completo, falhou)
* Data

## Estados da assinatura

| Status                 | Significado                                       |
| ---------------------- | ------------------------------------------------- |
| **Pending Onboarding** | Criado mas ainda não completou cadastro/pagamento |
| **Trialing**           | Em período de teste                               |
| **Active**             | Assinatura ativa                                  |
| **Past Due**           | Pagamento falhou, em período de tolerância        |
| **Suspended**          | Suspenso (manualmente ou por inadimplência)       |
| **Canceled**           | Assinatura cancelada                              |

## Overrides customizados

Overrides permitem configurações específicas para clientes especiais — por exemplo, um cliente enterprise que precisa de mais seats ou créditos do que o plano padrão oferece. Em vez de criar um plano exclusivo, você aplica um override direto no cliente.

<Tip>
  Use overrides com moderação. Se vários clientes precisam da mesma customização, pode ser hora de criar um novo plano.
</Tip>