> ## 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.

# faturamento-e-faturas

> Aprenda a consultar a lista de cobranças da sua assinatura, filtrar faturas por status e visualizar os detalhes completos do faturamento.

# Gerenciamento de Faturamento e Faturas

No menu **Painel > Configurações > Faturas**, você consulta o histórico completo de cobranças da sua assinatura Tourizou, visualiza o status de cada fatura e acessa os detalhes fiscais das transações.

## Visão Geral

A aba de **Lista de cobranças** exibe todas as faturas geradas para o seu tenant, com suporte a ordenação por valor ou data, busca rápida por número do pedido e exibição em detalhes.

***

## Estrutura da Tabela de Faturas

A tabela de cobranças organiza o histórico com as seguintes informações:

* **Plano**: Nome do plano correspondente à fatura (Ex: `Plano PRO`).
* **Valor**: Valor monetário faturado no ciclo, formatado via `formatCurrency`.
* **Status**: Badge indicativo do estado atual do pagamento:
  * `CONFIRMED` / `RECEIVED`: Exibe **Confirmado** / **Recebido** (Badge Verde `default`).
  * `PENDING`: Exibe **Pendente** (Badge Cinza `secondary`). Caso o tenant esteja no período de avaliação gratuita (`trial`), o badge exibe o texto **Período de teste**.
  * `OVERDUE`: Exibe **Vencido** (Badge Vermelho `destructive`).
  * `REFUNDED`: Exibe **Estornado** (Badge `outline`).
* **Data**: Data de emissão da fatura no formato `DD/MM/AAAA`.
* **Ações**: Ícone de Olho (`Eye`) para abrir os detalhes da cobrança.

***

## Como Visualizar Detalhes de uma Cobrança

Ao clicar em uma linha da tabela ou no ícone de Olho, o sistema exibe a página **Detalhes da cobrança** com as informações divididas em dois blocos:

### Bloco Esquerdo

* **Status**: Status atual do pagamento (ou *Período de teste* se estiver em trial).
* **Plano**: Nome completo do plano associado à fatura.
* **Valor**: Valor da cobrança formatado em reais.

### Bloco Direito

* **Data do Faturamento**: Data em que a cobrança foi gerada.
* **ID do Pedido**: Código identificador único do pedido (`order_id`) exibido em fonte monoespaçada.
* **ID da Cobrança**: Código de identificação interna do registro financeiro (`id`).

> Para retornar à listagem principal, clique no botão **"Voltar"** (`ArrowLeft`).

***

## Recursos de Busca e Filtros

* **Busca Rápida**: Digite no campo de pesquisa para buscar faturas por `order_id`, `description` ou pela data formatada.
* **Filtro de Status**: No menu **Status**, escolha entre `Todos`, `Pendente`, `Recebido`, `Confirmado`, `Vencido` ou `Estornado`.
* **Ordenação**: No menu **Ordenar por**, escolha ordenar por **Data**, **Valor** ou **Status** (alternando entre ordem crescente `↑` ou decrescente `↓`).
* **Paginação**: A tabela exibe 10 itens por página.