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.