Pular para o conteúdo principal
Versão: 1.x

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

Interface de busca e filtragem de produtos no WCPOS

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

A funcionalidade de busca utiliza a biblioteca FlexSearch com recursos avançados de tokenização:

  • Correspondência de Substring - Encontra seu termo em qualquer posição dentro de uma palavra (por exemplo, pesquisar "berry" encontra "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
Os termos de busca precisam de pelo menos 3 caracteres

A partir da versão 1.10.0, a busca corresponde a substrings dentro das palavras — "berry" encontra "blueberry", e "saippua" encontra "Kuorintasaippua". O contrapeso é um comprimento mínimo de termo: consultas com menos de 3 caracteres não são comparadas com o índice de texto. Códigos curtos continuam funcionando por meio das buscas por código de barras e SKU.

Antes da versão 1.10.0, a correspondência era apenas por prefixo (a busca encontrava o início de uma palavra, nunca o meio).

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 em busca dos produtos correspondentes caso ainda não estejam locais, e os armazena para que a mesma busca seja instantânea da próxima vez
  4. Atualiza os resultados em tempo real conforme você digita

A busca traz aquilo que você pesquisou — o restante do seu catálogo é baixado pela carga inicial em segundo plano (veja Sincronização de Produtos), de modo que a busca continua rápida sem trazer dados não relacionados.

Filtragem de Produtos

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

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

Ative para exibir apenas os produtos marcados como "Em destaque" na sua loja WooCommerce.

Produtos em promoção

Filtre para exibir apenas os produtos atualmente em promoção ou com descontos ativos.

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

Filtre por tags de produtos para encontrar itens com atributos ou características específicas que você definiu na sua loja WooCommerce.

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

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

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?

A carga inicial do catálogo em segundo plano pode ainda não ter terminado. Se um produto não aparecer:

  1. Pesquise por ele - Isso busca os produtos correspondentes diretamente no seu servidor caso ainda não estejam locais
  2. Verifique o progresso do download - Saúde da loja → Banco de dados mostra quanto do seu catálogo já está neste dispositivo
  3. Verifique a visibilidade dele - Produtos sem estoque ficam ocultos por padrão, e apenas os tipos de produto padrão do WooCommerce são compatíveis

Saiba mais no nosso guia de Sincronização de Produtos.

É possível pesquisar por nomes parciais de produtos ou SKUs?

Sim! A busca tokenizada corresponde a substrings, o que significa que:

  • Pesquisar "blue" encontrará produtos com "blueberry", "blue shirt", etc.
  • Pesquisar "berry" também encontrará "blueberry" — o termo pode aparecer em qualquer posição da palavra
  • Pesquisar "ABC" encontrará SKUs como "ABC123", "ABC-XYZ", etc.
  • Não é necessário digitar palavras ou códigos completos (mas termos com menos de 3 caracteres não são correspondidos)

A busca foi projetada para encontrar produtos rapidamente com o mínimo de digitação.