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

# Busca e ordenação do catálogo

> Encontre produtos rapidamente usando busca, filtros e ordenação.

# Busca e ordenação do catálogo

A listagem de produtos (`/produtos`) oferece busca, filtro por categoria e ordenação para facilitar a gestão de catálogos grandes.

## Pré-requisitos

* Permissão `products` com ação `list`.
* Produtos cadastrados no locatário.

## Passo a passo

1. Acesse **Produtos** no painel (`/produtos`).
2. Use a barra de busca para procurar por **nome ou SKU**. A busca é aplicada 300 ms após parar de digitar.
3. Selecione uma categoria no dropdown **Todas as categorias** para restringir os resultados.
4. Clique no cabeçalho da coluna **Nome** para ordenar por nome de A–Z ou Z–A.
5. A coluna padrão de ordenação é a data de criação, do mais recente para o mais antigo.
6. Navegue pelas páginas usando os controles de paginação.

## Opções

* **Busca**: filtra por nome ou SKU.
* **Filtro por categoria**: mostra apenas produtos de uma categoria.
* **Ordenação por nome**: altera a ordem alfabética.
* **Ordenação por criação**: exibe os produtos mais recentes primeiro (padrão).
* **Paginação**: 10 produtos por página.

## Erros comuns

* Digitar termos muito genéricos e receber muitos resultados.
* Esquecer de limpar o filtro de categoria ao buscar um produto de outra categoria.
* Esperar que a busca seja instantânea; ela tem pequeno atraso para evitar requisições excessivas.

## Solução de problemas

| Problema                         | Causa provável                               | Solução                                                 |
| -------------------------------- | -------------------------------------------- | ------------------------------------------------------- |
| "Nenhum produto cadastrado"      | O catálogo está vazio                        | Cadastre um produto manual ou sincronize um fornecedor. |
| Busca não retorna resultado      | Filtro de categoria ativo ou termo incorreto | Limpe a categoria e verifique o termo digitado.         |
| Produto recém-criado não aparece | A lista atualiza a cada 30 segundos          | Recarregue a página ou aguarde o próximo refresh.       |

## Artigos relacionados

* [Criando produtos manualmente](./creating-products)
* [Importando produtos de fornecedores](./importing-supplier-products)
* [Organizando produtos em categorias](../categories/organizing-products)