Produtos exclusivos do POS
Alguns produtos são vendidos apenas no caixa, outros apenas online. Ative Habilitar produtos exclusivos do POS para que cada produto tenha uma configuração de Visibilidade no POS com três opções:
| Visibilidade no POS | Seu site | O POS |
|---|---|---|
| POS e online (opção inicial de todos os produtos) | Visível | Visível |
| Somente POS | Oculto | Visível |
| Somente online | Visível | Oculto |
Você define a visibilidade no POS pelo WP Admin. O POS apenas segue essa configuração: não há um controle para ela no caixa. Está faltando um produto no caixa? Veja Se algo der errado.
Ativar o recurso
No WP Admin, acesse POS > Configurações > Geral. Em Produtos, ative Habilitar produtos exclusivos do POS. A configuração é salva assim que você a altera. Agora cada produto tem uma Visibilidade no POS: POS e online para produtos que você ainda não configurou, ou a opção salva anteriormente para os que já configurou, caso tenha ativado o recurso antes.
Se todos os produtos são vendidos nos dois lugares, deixe o recurso desativado. Quando desativado, a visibilidade no POS não oculta nada; as configurações de visibilidade do próprio WooCommerce continuam valendo.
Desativar o recurso novamente, ou desativar o WCPOS, permite que seus produtos Somente POS voltem a aparecer no site, conforme permitido pela visibilidade deles no WooCommerce. Veja Desativar o recurso.
Definir a visibilidade de um produto
Um produto
- No WP Admin, acesse Produtos e abra o produto.
- Na caixa Publicar, pressione Editar ao lado de Visibilidade no POS.
- Escolha POS e online, Somente POS ou Somente online e pressione OK.
- Pressione Atualizar.

A Visibilidade no POS fica na caixa Publicar, abaixo de Visibilidade do catálogo. Nesta captura de tela antiga, Visibilidade do catálogo ainda tem um link Editar; atualmente, esse link não aparece enquanto o produto está definido como Somente POS.
Na lista de Produtos, a Edição rápida de um produto tem a mesma opção de Visibilidade no POS.
Vários produtos de uma vez
- No WP Admin, acesse Produtos e marque os produtos.
- Escolha Editar em Ações em massa e pressione Aplicar.
- Selecione uma opção em Visibilidade no POS. Se deixar em — Nenhuma alteração —, cada produto mantém sua própria configuração.
- Pressione Atualizar.

Visibilidade no POS na edição em massa
Variações
Cada variação tem sua própria Visibilidade no POS, no painel dela em Variações. Pressione Salvar alterações ao terminar. Você pode vender todas as cores online e apenas algumas no caixa, ou reservar um tamanho para a loja física. Para mudar um produto variável inteiro, defina a Visibilidade no POS do próprio produto: um produto Somente online não tem cartão no caixa, e um produto Somente POS fica fora da loja online com todas as suas variações.

Visibilidade no POS de uma variação
Encontrá-los novamente
A lista de Produtos ganha duas visualizações acima da tabela, ao lado de Publicados: Somente POS e Somente online, cada uma com sua contagem. Clique em uma delas para listar apenas esses produtos.
No POS
Um produto Somente online não aparece no caixa de forma alguma. Ele não aparece no Painel de produtos, a busca não o encontra e escanear seu código de barras mostra Código de barras não encontrado. Produtos Somente POS e POS e online são vendidos normalmente.
Quando você altera a visibilidade de um produto, o POS recebe a alteração na próxima vez que verifica a loja: um produto Somente online desaparece e volta quando você reverte a configuração. Para verificar agora, pressione a seta ao lado da contagem de produtos.

- Buscar produtos — também consulta sua loja, mas nunca retorna um produto Somente online. Veja Busca e filtros.
- Configurações — inclui Mostrar produtos fora de estoque. Veja Configurações de exibição.
- Em estoque — oculta produtos fora de estoque. Pressione o X desse filtro antes de concluir que um produto está faltando. Veja Status do estoque.
- Um cartão de produto — produtos Somente POS e POS e online aparecem aqui.
- A contagem de produtos — quantos produtos neste dispositivo correspondem aos critérios: 1 produto aqui, Mostrando 20 de 259 em uma lista completa. Pressione a seta ao lado para verificar alterações agora; pressione e segure para abrir o menu mostrado aqui: Sincronizar ou Limpar e atualizar, que limpa a busca e os filtros e baixa os produtos novamente. Veja Rodapé do painel.
No seu site
Um produto Somente POS fica oculto para os compradores:
- Ele não é listado: nem na loja, nas páginas de categorias, na busca, nos produtos relacionados, nos blocos de produtos, nos feeds ou nos sitemaps.
- Ele não pode ser adicionado ao carrinho nem comprado online. Um link direto ainda abre a página do produto, como acontece com a opção Oculto do próprio WooCommerce, mas ele não pode ser adicionado ao carrinho por lá.
- Uma variação Somente POS não aparece entre as opções na página do produto. O produto continua online com suas outras variações.
Visibilidade do catálogo e onde os produtos Somente POS ainda aparecem
O WCPOS oculta um produto Somente POS definindo sua Visibilidade do catálogo no WooCommerce como Oculto. Enquanto o produto está como Somente POS, a Visibilidade do catálogo na caixa Publicar fica bloqueada em Oculto, com a mensagem Produtos Somente POS nunca são exibidos no catálogo online nem na busca. Altere novamente para POS e online ou Somente online e o WCPOS restaura a visibilidade do catálogo anterior; a caixa Publicar informa qual será ela antes de você pressionar Atualizar. Um produto que sempre esteve visível volta para Loja e resultados de pesquisa. Para usar outra visibilidade do catálogo, altere-a após a atualização. As variações não têm visibilidade do catálogo própria no WooCommerce, por isso nada fica bloqueado para elas.
A regra de ocultação vale apenas para compradores. Um produto Somente POS continua visível nos locais onde você gerencia a loja:
- WP Admin, incluindo a lista de Produtos e o editor de produtos.
- WooCommerce Analytics, para que um relatório filtrado por uma categoria de produtos Somente POS mostre suas vendas.
- O POS em si.
Desativar o recurso
Desative Habilitar produtos exclusivos do POS e a visibilidade no POS deixa de ocultar qualquer item; as configurações de visibilidade do próprio WooCommerce continuam valendo. Produtos Somente online voltam ao POS na próxima verificação de alterações, e produtos Somente POS recuperam a visibilidade do catálogo anterior: um produto que você havia ocultado manualmente continua oculto. A escolha de cada produto é mantida, então reativar o recurso usa as opções salvas e oculta os mesmos produtos novamente.
Desativar o WCPOS também restaura a visibilidade do catálogo anterior de todos os produtos Somente POS, permitindo que voltem a aparecer no seu site.
Quando usar
- Cartões-presente vendidos no balcão — cartões físicos ativados no caixa. Defina-os como Somente POS.
- Pré-vendas online — produtos que ainda não estão em estoque e que os clientes encomendam online. Defina-os como Somente online para não sobrecarregar a lista do caixa.
- Atacado e varejo em uma só loja — produtos exclusivos de atacado como Somente online para seus clientes comerciais, exclusivos da loja física como Somente POS e todo o restante como POS e online.
- Downloads e ofertas exclusivas online — produtos digitais e ofertas exclusivas do site que você não vende no balcão. Defina-os como Somente online.
- Promoções na loja física — itens promocionais vendidos apenas no caixa. Defina-os como Somente POS.
Se algo der errado
Um produto Somente online ainda aparece no POS. Pressione a seta ao lado da contagem de produtos para verificar alterações. Se ele continuar lá, pressione e segure a seta e escolha Limpar e atualizar.
Um produto está faltando no POS. Limpe a busca e confira a barra de filtros, incluindo Em estoque. Depois abra o produto no WP Admin e confira sua Visibilidade no POS e, no caso de uma variação, também a configuração do próprio produto.
Um produto aparece em um dispositivo, mas não em outro. Cada dispositivo mantém sua própria busca e seus filtros e só recebe alterações enquanto está online: veja Sincronização de produtos.
Um produto Somente POS ainda aparece na loja, nas categorias ou na busca. É esperado que ele abra por um link direto; estas instruções são para um produto que os compradores ainda conseguem encontrar.
- Abra o produto e veja a Visibilidade do catálogo na caixa Publicar. Para um produto Somente POS, ela mostra Oculto.
- Se mostrar outra opção, pressione Atualizar uma vez e o WCPOS definirá Oculto novamente. Se isso não acontecer, um plugin ou código personalizado está alterando o valor: veja Para desenvolvedores.
- Se mostrar Oculto, provavelmente a página está em cache. Limpe o cache do seu plugin ou CDN.
Os produtos não têm Visibilidade no POS. Habilitar produtos exclusivos do POS está desativado. Ative em POS > Configurações > Geral.
Para desenvolvedores
Filtros para produtos Somente POS
Produtos Somente POS são excluídos da Store API do WooCommerce, usada pelos blocos de carrinho e finalização de compra, e das listas de produtos e variações da REST API do WooCommerce (/wc/v1 a /wc/v3). Comandos do WP-CLI, como wp wc product list, ainda os encontram.
wcpos_hide_pos_only_products decide se uma consulta de produtos exclui os produtos Somente POS. Ele recebe a decisão padrão e a WP_Query prestes a ser executada: true na loja online, false no WP Admin, no WP-CLI, no WooCommerce Analytics e no POS. Retorne false para permitir que um contexto próprio veja produtos Somente POS.
add_filter( 'wcpos_hide_pos_only_products', function ( $hide, $query ) {
if ( defined( 'MY_PLUGIN_EXPORTING' ) ) {
return false;
}
return $hide;
}, 10, 2 );
wcpos_pos_only_catalog_visibility define a visibilidade do catálogo que o WCPOS grava para um produto Somente POS. Ele recebe hidden e o produto. Retorne uma das chaves de visibilidade do catálogo do WooCommerce (visible, catalog, search ou hidden) para aplicá-la no lugar da padrão, ou null para gerenciar você mesmo a visibilidade do catálogo do produto. Ele altera apenas o que o WCPOS grava em Visibilidade do catálogo: a regra da loja online acima continua valendo, então combine-o com wcpos_hide_pos_only_products se um produto Somente POS precisar aparecer em algum lugar online.
add_filter( 'wcpos_pos_only_catalog_visibility', function ( $visibility, $product ) {
if ( has_term( 'club-stock', 'product_cat', $product->get_id() ) ) {
return null; // I manage catalog visibility for these myself.
}
return $visibility;
}, 10, 2 );
wcpos_default_product_visibility define a Visibilidade no POS inicial de um novo produto no editor. Ele recebe '' (POS e online) e o post; retorne pos_only ou online_only para que novos produtos comecem com uma dessas opções.
Antes do WCPOS 2.0, esses filtros se chamavam woocommerce_pos_hide_pos_only_products, woocommerce_pos_pos_only_catalog_visibility e woocommerce_pos_default_product_visibility. Os nomes antigos ainda funcionam, mas estão obsoletos desde a versão 2.0 e serão removidos na versão 2.2 ou posterior. Veja Nomenclatura dos hooks.