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

# plano-e-assinatura

> Aprenda a consultar os planos disponíveis, alternar entre os ciclos mensal e anual, realizar upgrades e consultar o histórico de cobranças.

# Gerenciamento de Assinatura e Planos

No menu **Painel > Configurações > Assinatura**, você pode visualizar os detalhes do plano contratado da sua loja, alternar o ciclo de cobrança, realizar upgrades ou downgrades e consultar o histórico de pagamentos.

## Visão Geral

A aba de **Assinatura** exibe a listagem dos planos Tourizou disponíveis (`planTypes`), indicando qual deles é o **Plano Atual** da sua loja. O painel inclui a opção de alternar entre o faturamento **Mensal** e **Anual** (que concede 20% de desconto no valor final).

***

## Como Alterar ou Contratar um Plano

### 1. Seleção do Ciclo de Cobrança

No canto superior direito, utilize os botões de alternância:

* **Mensal**: Exibe o valor do plano cobrado mês a mês.
* **Anual**: Exibe o valor total anual e adiciona o badge de **20% OFF** na exibição de preços.

### 2. Ações dos Cards de Planos

Cada card de plano exibe o ícone ilustrativo (`Zap`, `Rocket`, `Crown`), o nome do plano, o preço no ciclo selecionado, o limite de usuários (`max_users`) e a lista de recursos inclusos (`PLAN_FEATURES`).

O botão de ação no canto inferior de cada card se comporta dinamicamente dependendo da sua assinatura ativa:

* **Plano Atual**: Se você já está no plano (no ciclo anual), o botão fica desabilitado indicando *"Plano Atual"*.
* **Mudar para Anual**: Se você está no plano atual no ciclo mensal e seleciona a visualização Anual, o botão exibe *"Mudar para Anual"*.
* **Fazer Upgrade**: Exibido quando você seleciona um plano superior ao atual (calculado via `calculateUpgradeDowngrade`).
* **Fazer Downgrade**: Exibido quando você seleciona um plano inferior.
* **Assinar**: Exibido para contratações iniciais.

Ao clicar em qualquer ação habilitada, o sistema redireciona para a página de checkout (`/checkout?planId=X&billing=Y`) com as informações de crédito proporcional (`proportionalValue`) e transição de ciclo calculadas.

***

## Histórico de Cobranças

Abaixo da seção de planos, a tabela de **Histórico de Cobranças** exibe todas as faturas emitidas da sua assinatura com as seguintes colunas:

* **Plano**: Nome do plano faturado.
* **Valor**: Valor pago ou a pagar formatado em moeda nacional (R\$).
* **Status**: Badge indicativo do estado da cobrança:
  * `CONFIRMED` / `RECEIVED`: Badge Padrão de sucesso (**Confirmado** / **Recebido**).
  * `PENDING`: Badge Secundário (**Pendente**).
  * `OVERDUE` / `REFUNDED`: Badge Destrutivo (**Vencido** / **Estornado**).
* **Data**: Data de criação da cobrança em formato nacional `DD/MM/AAAA`.
* **Ações**: Ícone de Olho (`Eye`) para abrir o modal com os **Detalhes da Cobrança** (exibindo Plano, Valor, Status e Data).

***

## Recursos de Paginação

Se houver mais de 10 cobranças no histórico, utilize os botões **Anterior** e **Próximo** no rodapé da tabela para navegar entre as páginas de cobrança.