Cupons
A tela de Cupons e a capacidade de aplicar cupons no caixa requerem o WCPOS Pro. Usuários gratuitos visualizam uma prévia desfocada da tela de Cupons, mas não podem ver detalhes dos cupons nem aplicar códigos no carrinho.
A tela de Cupons permite navegar e consultar seus cupons do WooCommerce diretamente no POS, e o botão Adicionar Cupom no carrinho os aplica ao pedido atual. Os cupons continuam sendo criados e gerenciados no WooCommerce — o POS os sincroniza e valida localmente para feedback instantâneo no caixa.
Visão Geral da Interface
Ações do Cabeçalho
No topo da tela:
- Barra de pesquisa — Encontre um cupom pelo código
- Configurações de exibição () — Configurar colunas visíveis
Tabela de Cupons
A área principal exibe os cupons sincronizados com:
- Código — O código do cupom que os clientes inserem
- Descrição — Descrição interna (também usada como rótulo no recibo quando definida)
- Tipo de Desconto — Porcentagem, valor fixo no carrinho ou valor fixo no produto
- Valor — O valor do desconto
- Usado / Limite — Vezes utilizado e limite total de uso
- Expira — Data de expiração, ou em branco se não houver
- Ações — Menu de três pontos
Rodapé
- Contagem de cupons com botão de sincronização (). Pressione e segure para as opções Limpar e Atualizar.
Tipos de Cupom
O WCPOS suporta os três tipos padrão de cupom do WooCommerce:
| Tipo | O que faz | Exemplo |
|---|---|---|
| Desconto percentual | Reduz o subtotal do carrinho por uma porcentagem | 10% de desconto no pedido |
| Desconto fixo no carrinho | Reduz o total do carrinho por um valor fixo | $5 de desconto no pedido |
| Desconto fixo no produto | Reduz os itens de produto correspondentes por um valor fixo por unidade | $2 de desconto em cada camiseta |
Os três tipos respeitam as mesmas regras de validação (validade, limites de uso, restrições de produto/categoria, etc.).
Criando Cupons
Os cupons são criados no WooCommerce, não no POS. Acesse WP Admin → Marketing → Cupons → Adicionar cupom:
- Código do cupom — o que os operadores de caixa digitam no registro. Os códigos não diferenciam maiúsculas de minúsculas.
- Descrição — nota interna. O WCPOS utiliza este campo como rótulo do desconto nos recibos quando preenchido, portanto prefira uma frase amigável ao cliente, como "Desconto Gerente 10%", em vez de um código interno.
- Tipo de desconto — porcentagem, valor fixo no carrinho ou valor fixo no produto.
- Valor do cupom — o valor do desconto.
- Data de expiração — opcional. Após essa data, o cupom será rejeitado.
Restrição de uso
- Gasto mínimo / máximo — o cupom só é aplicado acima/abaixo de um limite de subtotal.
- Uso individual apenas — impede que este cupom seja combinado com qualquer outro cupom.
- Excluir itens em promoção — ignora itens que já estão em promoção (e qualquer linha em que o operador de caixa tenha reduzido o preço no ponto de venda — consulte Substituições de preço no POS).
- Produtos / Excluir produtos — restringe o cupom a (ou exclui de) produtos específicos.
- Categorias de produtos / Excluir categorias — restringe por categoria. Produtos diversos/personalizados criados no POS também respeitam as categorias atribuídas pelo POS.
- E-mails permitidos — limita o cupom a endereços de e-mail de clientes específicos (suporta curingas
*).
Limites de uso
- Limite de uso por cupom — número total de vezes que este código pode ser utilizado por todos os clientes.
- Limite de uso por usuário — número de vezes que um cliente pode utilizá-lo.
- Limitar uso a X itens — para cupons de produto fixo, limita o número de itens qualificados com desconto por uso.
Dicas para uso no POS
- Crie um cupom "Gerente 10%" (10% de desconto, sem valor mínimo de compra, sem data de expiração, restrição de uso único desativada) e forneça o código aos gerentes — a equipe pode aplicá-lo no caixa para ajustes pontuais e você mantém um desconto rastreável nos relatórios.
- Crie um cupom "Fidelidade R$5" para recompensas de clientes recorrentes.
- Para promoções pontuais, defina uma data de expiração curta para que o código não seja reutilizado por engano posteriormente.
- Definir a Descrição com a frase que deseja imprimir nos recibos é a forma mais rápida de personalizar seus descontos.
Aplicando um cupom no caixa
No painel do carrinho:
- Clique em Adicionar cupom
- Insira o código do cupom
- Pressione Enter
O POS valida o cupom com base nos dados sincronizados instantaneamente — sem necessidade de comunicação com o servidor — e aplica o desconto ao carrinho. Se o conteúdo do carrinho for alterado posteriormente, o desconto é recalculado automaticamente.
Para remover um cupom aplicado, clique no × ao lado dele no carrinho.
Como a Validação Funciona
Quando um código é inserido, o POS verifica todas as mesmas regras que o WooCommerce verificaria no servidor:
- O cupom existe e não está expirado
- Os limites de uso não foram excedidos (geral e por usuário)
- O valor mínimo/máximo de compra é atendido
- Cupons de "uso individual" não entram em conflito com cupons já aplicados
- As restrições de produto/categoria correspondem ao conteúdo do carrinho
- Restrições de e-mail correspondem ao cliente selecionado (ou são ignoradas em pedidos de convidado)
- Itens em promoção são excluídos se Excluir itens em promoção estiver ativado
Se alguma verificação falhar, o operador de caixa vê uma mensagem de erro específica (ex.: "Este cupom expirou" ou "Valor mínimo não atingido"). As mesmas verificações são executadas novamente no servidor quando o pedido é enviado — a validação local existe para agilidade, não para confiança.
Comportamento de Sincronização
Os cupons são sincronizados do WooCommerce para o dispositivo por meio do pipeline de replicação padrão do WCPOS:
- Novos cupons criados no WP Admin aparecem no POS na próxima sincronização.
- Atualizações em cupons existentes (contagem de uso, alterações de validade, etc.) são sincronizadas automaticamente.
- Os cupons são armazenados localmente no IndexedDB para que permaneçam disponíveis offline.
Se você acabou de criar um cupom no WP Admin e ainda não o vê, a sincronização pode não ter sido executada. No rodapé da tela de Cupons, toque no ícone de sincronização () para atualizar — mantenha pressionado para Limpar e atualizar se precisar de uma busca completa.
Conectividade
- Aplicar cupons funciona offline porque a validação é feita no lado do cliente a partir dos dados sincronizados.
- Finalizar o checkout ainda requer uma conexão com o servidor — o servidor revalida e é a fonte autoritativa para o total final do pedido.
- Criar ou editar cupons é feito no WP Admin e requer uma conexão com o seu site WordPress.
Como os Cupons Interagem com os Descontos do POS
Quando um operador de caixa reduz o preço de um item no ponto de venda e um cupom é então aplicado, o cupom calcula sobre o preço reduzido, não sobre o original. Itens com preço reduzido no POS são tratados como "em promoção" — cupons com Excluir itens em promoção ativado irão ignorá-los. Consulte Descontos para mais detalhes.