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

# Busca global

> Encontre objetos da organização sem depender do que já está carregado na tela.

A busca global ajuda você a encontrar rapidamente objetos importantes da
organização sem precisar navegar menu por menu.

Ela fica centralizada no header do Dashboard e funciona a partir do contexto da
organização atual. Você pode estar em Produtos, Faturas ou Analytics e ainda
assim buscar um cliente, uma transação, uma assinatura, uma fatura, um request,
um webhook, um payment link ou um preço.

Use quando você já tem alguma pista do que procura: um e-mail de cliente, parte
de um nome, um CPF/CNPJ, um número de fatura, uma URL de webhook ou um ID como
`cus_*`, `prod_*`, `price_*`, `inv_*`, `txn_*` ou `req_*`.

<Info>
  A busca respeita o ambiente selecionado no Dashboard. Em Sandbox, os
  resultados vêm de dados de teste; em produção, vêm de dados live.
</Info>

## Por que usar

A busca global reduz o tempo entre saber o que você procura e abrir o objeto
certo.

Ela é útil para:

* Encontrar um cliente pelo e-mail durante um atendimento.
* Abrir rapidamente uma fatura, transação ou assinatura a partir de um ID.
* Localizar um produto ou preço sem passar pela listagem.
* Investigar requests e webhooks ao depurar uma integração.
* Navegar pelo Dashboard sem depender da página aberta agora.

## Como abrir

No Console de Organização, clique no campo `Pesquisar` no header. Você também pode
abrir a busca pelo teclado com `⌘K` no macOS, `Ctrl K` no Windows/Linux ou `/`
quando nenhum campo de formulário estiver em foco.

Digite pelo menos dois caracteres. A busca começa automaticamente enquanto você
digita; não é necessário pressionar Enter. Os resultados aparecem em uma lista
com o tipo do objeto, informação principal, status ou valor quando disponível.

## O que você pode encontrar

| Quero encontrar | Posso buscar por                                         | Para onde vou         |
| --------------- | -------------------------------------------------------- | --------------------- |
| Cliente         | ID, e-mail, nome ou CPF/CNPJ                             | Página de Clientes    |
| Produto         | ID ou nome                                               | Detalhe do produto    |
| Preço           | ID ou nome                                               | Produto relacionado   |
| Assinatura      | ID, cliente, fatura mais recente ou checkout de origem   | Detalhe da assinatura |
| Fatura          | ID, número, cliente, payment intent ou transação         | Detalhe da fatura     |
| Transação       | ID, identificador externo, número da fatura ou descrição | Detalhe da transação  |
| Request         | ID, método, path ou status code                          | Log do request        |
| Webhook         | ID ou URL do endpoint                                    | Endpoint de webhook   |
| Payment Link    | ID, label ou secret do link                              | Link de pagamento     |

## Como os resultados aparecem

Quando você cola um ID completo, o objeto correspondente aparece no topo. Em
buscas por texto, a Chargefy prioriza sinais mais diretos, como e-mail de
cliente, número de fatura, nome de cliente, nome de produto e nome de preço.

Quando vários resultados são parecidos, os mais recentes aparecem antes. Isso
ajuda em operações comuns, como procurar o cliente que acabou de pagar ou abrir
uma cobrança recém-criada.

## Escopo e permissões

A busca só retorna objetos da organização atual e só mostra dados que o seu papel
tem permissão para ler. Se uma função da equipe não tem acesso a dados de negócio,
esses objetos não aparecem nos resultados.

Hoje a busca global está disponível no Console de Organização. O Console de
Plataforma continua usando suas páginas próprias para navegar entre organizações
conectadas.

## Boas práticas

* Cole o ID completo quando tiver (`inv_*`, `txn_*`, `req_*`) para abrir o objeto
  mais rápido.
* Use e-mail, nome ou CPF/CNPJ quando estiver procurando um cliente.
* Use o nome do produto ou do preço quando estiver navegando pelo catálogo.
* Use número da fatura ou ID de payment intent quando estiver conciliando uma
  cobrança.
* Use path ou status code quando estiver investigando requests de API.