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

# Clientes Cadastrados

> Aprenda a visualizar a lista de clientes da sua loja, cadastrar novos contatos, editar dados cadastrais e iniciar conversas diretas no WhatsApp.

# Gerenciamento de Clientes Cadastrados

No menu **Painel > Clientes > Clientes Cadastrados**, você gerencia a base de contatos da sua loja, consulta o histórico cadastral de compradores e inicia atendimentos diretos no WhatsApp.

## Visão Geral

A aba de **Clientes Cadastrados** centraliza as informações de identificação dos seus compradores (Nome, CPF/CNPJ, E-mail, Telefone, Endereço com busca automática por CEP). O painel facilita o relacionamento com o cliente e a localização rápida de registros para emissão de novos pedidos.

***

## Tabela de Clientes

A tela principal exibe a listagem de clientes organizados em uma tabela com suporte a máscaras de dados sensíveis.

### Colunas da Tabela

* **Nome**: Nome completo do cliente ou razão social da empresa.
* **Documento**: Número de CPF ou CNPJ formatado com máscara automática (`XXX.XXX.XXX-XX` ou `XX.XXX.XXX/XXXX-XX`).
* **Telefone**: Número de celular/telefone formatado com código de área (`(XX) XXXXX-XXXX`).
* **Status**:
  * **Ativo** (Badge Verde): Cliente habilitado no sistema.
  * **Inativo** (Badge Vermelho): Cliente desativado no painel.
* **Ações**:
  * **WhatsApp** (Ícone verde): Botão de ação rápida que abre a conversa direta com o cliente no WhatsApp Web/App (`wa.me/55...`) pré-preenchendo a saudação. *Fica desabilitado caso o número seja inválido ou não cadastrado.*
  * **Editar** (Ícone de lápis `Pencil`): Abre a janela com o formulário completo do cliente para alteração de dados.

***

## Recursos de Filtro, Ordenação e Pesquisa

* **Buscar**: Digite o nome do cliente no campo de pesquisa para filtrar a lista instantaneamente.
* **Ordenar por**: Alterne a ordenação da tabela entre:
  * **Nome** (A-Z / Z-A)
  * **Documento** (CPF/CNPJ)
  * **Data de criação** (Cadastros mais recentes primeiro)
* **Filtro de Status**: Exiba **Todos**, apenas **Ativos** ou apenas **Inativos**.

***

## Como Cadastrar ou Editar um Cliente

Para registrar um novo comprador no sistema:

1. Clique no botão **"+ Adicionar"** no canto superior direito.
2. Preencha as informações do formulário:
   * **Nome completo \*** (Obrigatório)
   * **Documento (CPF ou CNPJ)**: Digite os números (o sistema aplica a máscara automaticamente).
   * **Telefone / Celular (WhatsApp)**: Digite o número com DDD.
   * **E-mail**: Endereço de e-mail do cliente.
   * **Endereço**: Digite o CEP no campo de busca para preenchimento automático do Logradouro, Bairro, Cidade e Estado via consulta integrada.
   * **Status**: Defina como **Ativo** ou **Inativo**.
3. Clique em **"Salvar"**.

Para editar um cliente existente, clique na linha correspondente na tabela ou no botão de lápis (`Pencil`).

***

## Paginação

Utilize os botões **Anterior** e **Próximo** no rodapé da tabela para navegar entre as páginas da sua base de clientes.