Definir preços por função de usuário no WooCommerce exige um plugin de role-based pricing, regras por papel e exclusão das páginas de produto do cache. O WooCommerce não traz esse recurso nativo, então a regra de preço por papel depende de plugins como Wholesale Suite ou B2BKing. Cache mal configurado vaza preço de atacado para anônimo. Configure por papel e valide logado.

Definir preços por função de usuário no WooCommerce é exibir valores diferentes conforme o papel (role) de quem está logado: varejo paga um preço, atacado paga outro, revenda um terceiro. O WooCommerce padrão não traz esse recurso nativo, então a configuração depende de um plugin de role-based pricing somado a regras por papel. O ponto que quase ninguém cobre é a interação com cache: uma loja com cache de página servindo HTML do primeiro visitante mostra o preço errado para todo mundo. Este tutorial mostra os 5 passos, do papel de usuário ao schema, e como a central de conteúdos de WooCommerce da FULL trata o assunto.

Primeiros passos: Como funcionam os preços por função de usuário no WooCommerce

Preços por função de usuário no WooCommerce se apoiam em 3 camadas: o papel (role) do WordPress, a regra de preço por papel e o filtro de exibição. Um WooCommerce 9.x limpo tem 5 papéis padrão (administrador, editor, autor, colaborador, assinante) mais o customer que o checkout cria. Nenhum deles altera preço sozinho. A tabela abaixo resume as três camadas que você vai configurar nos próximos passos.

Sem as três camadas alinhadas, o preço aparece inconsistente. Veja o panorama no guia de como gerenciar uma loja WooCommerce.

Passo a passo: Configurar preços por função de usuário no WooCommerce

Configurar preços por função de usuário no WooCommerce leva 5 passos, do papel à validação logado. Em uma loja WooCommerce 9.x com PHP 8.2, o fluxo roda em cerca de 30 minutos quando o plugin já está instalado. Siga na ordem: o cache (passo 5) só funciona depois que as regras de preço existem.

Crie as funções de usuário (roles) de atacado e revenda

Crie primeiro os papéis que vão receber preço diferenciado. Use um plugin de gestão de papéis como o User Role Editor ou registre via código com add_role(). Defina papéis claros como atacado e revenda, herdando as capabilities de customer. Sem papéis dedicados, todo cliente logado cai no mesmo grupo e a regra de preço por função de usuário no WooCommerce não tem como diferenciar. Nomeie os papéis em slug sem acento (atacado, revenda) para evitar conflito no banco.

Instale um plugin de role-based pricing

Instale o plugin que aplica o preço por papel. O Wholesale Suite e o B2BKing são os dois mais usados para preços por função de usuário no WooCommerce; o primeiro foca atacado, o segundo cobre B2B completo com cotação. Após ativar, o plugin adiciona campos de preço por papel na aba de dados de cada produto. A versão gratuita do Wholesale Suite cobre um papel de atacado; múltiplos papéis exigem a licença paga. Veja o passo a passo de cotação em plugin de cotação para WooCommerce.

Defina as regras de preço por papel

Defina o preço de cada papel no produto ou em lote. No editor de produto, a aba do plugin mostra um campo por papel: digite o valor de atacado e o de revenda, ou um percentual de desconto global. Para catálogos acima de 1.000 produtos, use a edição em massa para não travar no produto a produto. Um desconto de 20% para o papel atacado sobre 500 SKUs aplica em segundos via regra global, contra horas no modo manual. Combine com cupons do WooCommerce quando precisar de promoção temporária por papel.

Oculte preço de quem não tem papel (modo catálogo)

Oculte o preço e o botão de compra para visitantes sem papel autorizado quando a loja é B2B fechada. Esse é o modo catálogo: o ELEX Catalog Mode ou o próprio B2BKing escondem o valor até o login. Em lojas de revenda, mostrar o preço de atacado para o público anônimo derruba a margem e irrita o cliente final. O modo catálogo resolve isso mantendo a vitrine visível e o preço protegido. O tutorial dedicado está em modo catálogo no WooCommerce, com a configuração por papel.

Exclua as páginas de produto do cache para usuários logados

Exclua produto, carrinho e checkout do cache de página para quem está logado. Esse passo evita o erro mais comum em preços por função de usuário no WooCommerce: o cache servir o preço de um papel para outro. No WP Rocket, ative a opção de não cachear para usuários logados; em servidores LiteSpeed, use a exclusão por cookie de role. Sem isso, o preço de atacado cacheado vaza para o visitante anônimo. Confirme sempre logando com cada papel e comparando o valor exibido.

Por que o cache quebra os preços por função de usuário no WooCommerce

O cache de página é a causa nº 1 de preço errado em preços por função de usuário no WooCommerce, e poucos tutoriais avisam. O WP Rocket gera um HTML estático da página de produto no primeiro acesso e serve esse mesmo HTML a todos. Se um cliente de atacado abre a página antes, o preço com desconto fica cacheado e o próximo anônimo o recebe.

A relação causal é esta: WooCommerce com regra de preço por papel + cache de página ativo sem exclusão para logados = anônimo vendo preço de atacado servido do cache HTML. A correção tem dois caminhos. O primeiro é excluir produto, carrinho e checkout do cache para usuários logados, o que sacrifica um pouco de performance nessas rotas. O segundo é o fragment cache por papel, que cacheia o layout e recalcula só o bloco de preço por role. Em lojas com WP Rocket, a gente vê no suporte da FULL que a maioria dos chamados de “preço errado” some com essa exclusão.

Validação e schema: Confirmar o preço certo por papel

Validar preços por função de usuário no WooCommerce significa logar com cada papel e conferir o valor, além de marcar o preço público com schema. O schema Product com offers correto ajuda o Google a ler o preço base sem ambiguidade. Para o preço protegido por papel, não exponha o valor de atacado no markup público.

A validação tem dois passos práticos que poucos tutoriais detalham. O primeiro é o teste cruzado: entre como anônimo, como cliente logado sem papel e como cliente de atacado, na mesma sessão de navegação, e compare o valor exibido na página de produto, no carrinho e no checkout. O preço só está correto quando cada papel vê o seu valor e nenhum outro. O segundo é o schema: o Rank Math gera o bloco Product com offers a partir do preço de varejo, então confirme que o markup público traz o preço base e nunca o de atacado, que é restrito por papel. Use o schema markup apenas no preço de vitrine pública. O WooCommerce não bloqueia nada disso, mas calcula o preço por papel no servidor, o que exige o teste logado para garantir que o valor diferenciado nunca chega ao markup nem ao cache anônimo.

Risco técnico: Preço de atacado exposto via REST API

A maior falha silenciosa em preços por função de usuário no WooCommerce não está na vitrine, está na API. Quando o plugin altera o preço via woocommerce_product_get_price sem checar current_user_can, o endpoint REST /wp-json/wc/v3/products pode retornar o preço de revenda para qualquer chamada autenticada com chave de leitura. Em uma loja com 3 papéis e API aberta a integrações, isso significa um parceiro de varejo enxergando a margem de atacado.

A correção exige checar a capability dentro do filtro de preço, retornando o valor padrão quando o usuário não tem o papel. A relação é clara: hook woocommerce_product_get_price sem checagem de role + REST API exposta = preço diferenciado vazando para terceiro. Em VPS abaixo de 2 GB de RAM com catálogo acima de 1.000 produtos, recalcular o preço por papel a cada chamada de API tende a gerar picos de CPU; nesses casos, cacheie o preço em transient de expiração curta. Esse é o tipo de detalhe ausente na documentação do plugin.

Quando vale usar plugin pago para preços por função de usuário no WooCommerce

Um plugin pago de preços por função de usuário no WooCommerce compensa a partir de 2 papéis ou catálogos acima de 200 produtos, onde a regra global de desconto economiza horas de edição manual. Abaixo de 50 produtos com um único papel, o código no filtro de preço resolve sem custo. A árvore abaixo resume a decisão por cenário de loja.

• Se você tem só 1 papel de atacado e poucos produtos → o Wholesale Suite gratuito resolve sem custo.
• Se você precisa de 2+ papéis com regras distintas → use a versão paga do Wholesale Suite ou o B2BKing.
• Se a loja é B2B fechada e o preço não pode aparecer para anônimo → combine plugin de role com modo catálogo.
• Se você integra a loja via REST API com parceiros → exija checagem de capability no filtro de preço antes de subir.

Para escolher o plugin certo, vale comparar com a abordagem de loja privada no WooCommerce, que parte de premissa semelhante de acesso restrito.

Ative tudo no plano certo com a FULL

Montar preços por função de usuário no WooCommerce com plugin de role, cache configurado e Rank Math PRO para o schema fica mais simples num plano único. O plano PRO da FULL custa R$849,90 e inclui 17 plugins premium ativáveis em um clique, entre eles o Rank Math PRO que gera o schema do produto. Dividido pelos sites que você gerencia, isso dá cerca de R$85 por site, contra a soma de licenças avulsas. Conheça os planos da FULL e ative o ecossistema sem comprar plugin a plugin.

Legenda: a aba de dados do produto mostra um campo de preço por papel, comprovando que a regra é atribuída por role e não global.

Perguntas frequentes sobre preços por função de usuário no WooCommerce

Próximos passos para precificar por papel sem erro

Configurar preços por função de usuário no WooCommerce é uma cadeia: papel, regra de preço, modo catálogo, cache e validação logado. O ponto que separa uma loja sólida de uma com bug intermitente é tratar o cache e a REST API como parte da configuração, não como detalhe. Logue com cada papel, compare o preço exibido e confirme que o valor de atacado não aparece para anônimo nem vaza pela API. Para continuar aprendendo, o FULL Academy reúne os tutoriais de WooCommerce em um só lugar, e o guia de loja online com WordPress cobre a montagem completa. Um detalhe de configuração no usuário do WordPress evita a maior parte dos chamados de preço errado.