# Busca e Filtragem Encontrar os produtos certos rapidamente é essencial para operações eficientes no ponto de venda. O WCPOS oferece recursos avançados de busca e filtragem para ajudar você a localizar produtos instantaneamente, mesmo com grandes inventários. ![Interface de busca e filtragem de produtos](/img/product-search-and-filtering.png) Interface de busca e filtragem de produtos no WCPOS ## Busca de Produtos[​](#product-search "Link direto para Busca de Produtos") ### Campo de Busca Unificado[​](#unified-search-field "Link direto para Campo de Busca Unificado") O WCPOS possui um campo de busca único que pesquisa simultaneamente em vários atributos do produto: * **Nome do Produto** - Pesquisa no título e na descrição do produto * **SKU** - Corresponde ao campo postmeta `_sku` do produto * **Código de Barras** - Pesquisa no campo de código de barras configurado, que pode ser qualquer campo postmeta. A configuração legada é `_sku`, mas será alterada para `_global_unique_id` no futuro. Basta digitar o termo de busca no campo "Pesquisar Produtos", e o POS filtrará instantaneamente os resultados em todos esses campos. ### Tecnologia de Busca Tokenizada[​](#tokenized-search-technology "Link direto para Tecnologia de Busca Tokenizada") A funcionalidade de busca utiliza a [biblioteca FlexSearch](https://github.com/nextapps-de/flexsearch) com recursos avançados de tokenização: * **Tokenização Progressiva** - Corresponde palavras parciais a partir do início (por exemplo, pesquisar "blue" encontrará "blueberry") * **Otimizado para Desempenho** - Utiliza uma configuração de desempenho para resultados de busca rápidos * **Reconhecimento de Idioma** - Adapta-se ao idioma configurado da sua loja * **Inicialização Sob Demanda** - Otimiza o uso de memória carregando os índices de busca somente quando necessário A busca corresponde ao início das palavras Como a correspondência é baseada em prefixo (progressiva), a busca encontra o **início** de uma palavra ou token, não o meio — pesquisar "berry" não encontrará "blueberry", e um hífen inicia um novo token (então "ABC-XYZ" é encontrado por "ABC" ou "XYZ", mas não por "BCX"). Para idiomas que não separam palavras com espaços (por exemplo, chinês, japonês), a tokenização não é confiável — pesquise por **código de barras ou SKU**. ### Como a Busca Funciona[​](#how-search-works "Link direto para Como a Busca Funciona") Ao digitar no campo de busca, o POS: 1. **Tokeniza** sua entrada em termos pesquisáveis 2. **Pesquisa localmente** os dados de produtos armazenados primeiro para resultados instantâneos 3. **Consulta o servidor** se nenhuma correspondência local for encontrada, então baixa e armazena novos produtos para pesquisas futuras 4. **Atualiza os resultados** em tempo real conforme você digita Essa abordagem garante um desempenho de pesquisa rápido enquanto constrói progressivamente um banco de dados local completo de produtos. ## Filtragem de Produtos[​](#product-filtering "Link direto para Filtragem de Produtos") ### Barra de Filtros[​](#filter-bar "Link direto para Barra de Filtros") Abaixo do campo de pesquisa, você encontrará botões de filtro interativos e menus suspensos que permitem refinar os produtos por critérios específicos. ### Filtros Disponíveis[​](#available-filters "Link direto para Filtros Disponíveis") #### Status do Estoque[​](#stock-status "Link direto para Status do Estoque") Filtre produtos com base no status do inventário: * **Em Estoque** - Produtos com inventário disponível * **Fora de estoque** - Produtos com estoque zerado * **Sob encomenda** - Produtos disponíveis para pedido em espera #### Produtos em destaque[​](#featured-products "Link direto para Produtos em destaque") Ative para exibir apenas os produtos marcados como "Em destaque" na sua loja WooCommerce. #### Produtos em promoção[​](#on-sale-products "Link direto para Produtos em promoção") Filtre para exibir apenas os produtos atualmente em promoção ou com descontos ativos. #### Categoria[​](#category "Link direto para Categoria") Use o menu suspenso de categorias para filtrar produtos por suas categorias atribuídas. Isso ajuda a encontrar rapidamente produtos em departamentos ou linhas de produtos específicos. #### Tag[​](#tag "Link direto para Tag") Filtre por tags de produtos para encontrar itens com atributos ou características específicas que você definiu na sua loja WooCommerce. ### Usando filtros[​](#using-filters "Link direto para Usando filtros") * **Alternar filtros** - Clique em qualquer botão de filtro para ativá-lo (os filtros ativos aparecem destacados) * **Filtros múltiplos** - Você pode combinar vários filtros para refinar ainda mais sua busca * **Limpar filtros** - Clique novamente em um filtro ativo para desativá-lo * **Busca + Filtro** - Use filtros junto com o campo de busca para localizar produtos com precisão ## Configuração de código de barras[​](#barcode-configuration "Link direto para Configuração de código de barras") ### Campos de busca[​](#search-fields "Link direto para Campos de busca") A funcionalidade de busca inclui automaticamente o campo de código de barras configurado. O campo de código de barras utilizado na busca depende da configuração nas definições do POS. ## Perguntas frequentes[​](#faq "Link direto para Perguntas frequentes") Para que serve o campo \_global\_unique\_id para códigos de barras? O campo `_global_unique_id` é um novo campo de código de barras que o WooCommerce adicionou recentemente para oferecer melhor padronização de códigos de barras entre lojas. **Pontos principais:** * **Padrão moderno**: Este campo foi projetado especificamente para identificação global de códigos de barras * **Configuração do POS**: Você pode configurar o POS para usar `_global_unique_id` como campo de código de barras nas configurações do POS * **Legado vs. Novo**: A configuração legada de código de barras usa o campo `_sku`, mas isso será alterado para `_global_unique_id` em versões futuras * **Flexibilidade**: É possível configurar qualquer campo meta de produto como campo de código de barras ao utilizar plugins de código de barras de terceiros * **Um campo por produto**: O POS pesquisa um único campo de código de barras configurado, e o WooCommerce armazena um valor de código de barras por produto (ou por variação). Se for necessário múltiplos códigos em um produto, armazene-os em um campo personalizado e aponte a configuração de código de barras para ele * **Padrão futuro**: `_global_unique_id` se tornará o campo de código de barras padrão em futuras atualizações do POS Para configurar qual campo o POS usa para códigos de barras, acesse as configurações do POS na área de administração do WordPress. Por que não vejo todos os meus produtos ao pesquisar? O WCPOS utiliza download progressivo de produtos para manter o desempenho. Se um produto não aparecer: 1. **Tente pesquisá-lo** - Isso fará o POS buscá-lo no servidor 2. **Aguarde o download** - O POS fará o download do produto e de outros em pequenos lotes 3. **Pesquise novamente** - Após o download, o produto aparecerá nas pesquisas futuras Esse processo garante que o POS permaneça rápido e responsivo mesmo com milhares de produtos. Saiba mais sobre isso no guia de [Sincronização de Produtos](/pt-BR/products/sync.md). É possível pesquisar por nomes parciais de produtos ou SKUs? Sim! A busca tokenizada usa correspondência progressiva, o que significa que: * Pesquisar "blue" encontrará produtos com "blueberry", "blue shirt", etc. * Pesquisar "ABC" encontrará SKUs como "ABC123", "ABC-XYZ", etc. * Não é necessário digitar palavras ou códigos completos A busca foi projetada para encontrar produtos rapidamente com o mínimo de digitação.