Essa funcionalidade permite definir regras que obrigam o cliente a incluir itens de uma determinada categoria no carrinho ao comprar um produto específico. Essa funcionalidade foi criada para garantir combinações obrigatórias de produtos, evitando compras incompletas ou inconsistentes. Com ela, você pode exigir que determinados itens estejam presentes no carrinho (em quantidades mínimas ou máximas) antes de permitir a finalização da compra.

1. Como ativar a funcionalidade

Para começar a utilizar as regras, é necessário habilitar a funcionalidade no sistema.

Caminho no sistema

Configurações → Carrinho

Passos

1. Acesse o painel administrativo.

2. Vá até Configurações.

3. Abra a aba Carrinho.

4. Localize a seção Regras de categorias obrigatórias por produto.

5. Marque a opção: ✔ Habilitar validação de categorias obrigatórias no carrinho e checkout

6. Clique em Salvar.

2. Como cadastrar uma regra em um produto

Depois de habilitar a funcionalidade, você pode configurar regras específicas por produto.

Caminho no sistema

Produtos → Listagem → Ações (ícone de lista “Regras de carrinho”)

Passos

1. Acesse o menu Produtos.

2. Localize o produto desejado.

3. Clique no ícone Regras de carrinho (ícone de lista).

4. Na tela exibida, selecione a categoria desejada.

5. Preencha os campos:

   • Quantidade Mínima (opcional)

   • Quantidade Máxima (opcional)

6. Ao sair do campo, a regra será salva automaticamente.

✔ Uma mensagem será exibida: "Regra salva com sucesso."

Como remover uma regra

• Apague os valores dos campos Mínimo e Máximo.

• Ao sair do campo, a regra será removida automaticamente.

Como localizar uma categoria

• Utilize o campo de Pesquisa no canto superior direito.

• Busque pelo nome ou código da categoria.

• Clique no X para limpar a busca.

3. Como o sistema se comporta após a ativação

Após configurar as regras, o sistema passa a validar automaticamente o carrinho.

No carrinho

• O cliente verá mensagens de erro caso não cumpra as regras.

Exemplo:

• Mínimo: "Para comprar Painel Solar 400W (x2) você precisa de no mínimo 8 item(s) da categoria 'Kit Fixação'."

• Máximo: "Para comprar Painel Solar 400W (x2) o máximo permitido da categoria 'Kit Fixação' é 12 item(s)."

No checkout

• Se a regra não for atendida:
  ❗ O cliente é impedido de avançar.
  ❗ Ele é redirecionado automaticamente para o carrinho.

✔ A compra só poderá ser finalizada quando todas as regras forem atendidas.

4. Regras e validações do sistema

O sistema aplica automaticamente algumas validações para garantir consistência:

• Campo mínimo em branco → considerado como zero

• Campo máximo em branco → considerado como sem limite

• Mínimo = 0 e máximo em branco → regra removida

• Valores negativos → corrigidos automaticamente

• Máximo menor ou igual a zero → tratado como sem limite

❗ Importante:  Se o valor mínimo for maior que o máximo, a regra não será salva e será exibido erro.

5. Cenários em que o comportamento não muda

• Se a funcionalidade estiver desativada, nenhuma regra é aplicada

• Regras já cadastradas continuam salvas mesmo com a funcionalidade desligada

• A validação considera o total de itens da categoria no carrinho, independentemente da origem

• Produtos em diferentes lojas seguem regras independentes

6. Como o sistema valida a regra

Cada regra é multiplicada pela quantidade do produto no carrinho. Esse é o comportamento mais importante de entender.

Exemplo

Você cadastrou no produto Painel Solar 400W a seguinte regra:

Comportamento no carrinho do cliente:

• Se o cliente adicionar 1 painel, ele precisa de 4 a 6 itens da categoria Kit Fixação.

• Se o cliente adicionar 2 painéis, ele precisa de 8 a 12 itens (4×2 a 6×2).

• Se o cliente adicionar 3 painéis, ele precisa de 12 a 18 itens, e assim por diante.

Soma de regras de produtos diferentes

Quando o carrinho tem mais de um produto com regras para a mesma categoria, o sistema soma os mínimos:

• Produto A exige no mínimo 2 itens da categoria "Cabos".

• Produto B exige no mínimo 3 itens da categoria "Cabos".

• Se o cliente comprar uma unidade de cada, precisará de 5 itens de Cabos no total.

Para o máximo, vale a regra mais permissiva: se qualquer produto envolvido tiver máximo em branco, o carrinho fica sem limite máximo para aquela categoria.

7. O que o cliente vê na loja

No carrinho

Sempre que uma regra não estiver sendo atendida, uma mensagem aparece dentro do carrinho do cliente:

Exemplo de mínimo não atingido:

Para comprar Painel Solar 400W (x2) você precisa de no mínimo 8 item(s) da categoria 'Kit Fixação'.

Exemplo de máximo ultrapassado:

Para comprar Painel Solar 400W (x2) o máximo permitido da categoria 'Kit Fixação' é 12 item(s).

A mensagem mostra a lista de produtos que estão gerando a exigência (com a quantidade de cada um), a categoria envolvida e a quantidade esperada.

No checkout

Se o cliente tentar avançar para o checkout sem cumprir as regras:

• A finalização é bloqueada.

• O cliente é redirecionado automaticamente para o carrinho.

• As mensagens de erro são exibidas para que ele entenda o que precisa ajustar.

A compra só é finalizada quando todas as regras estão atendidas.

8. Regras automáticas de preenchimento

Para evitar configurações inconsistentes, o sistema aplica algumas correções automaticamente ao salvar:

A mensagem de erro nesse último caso é:

O valor mínimo não pode ser maior que o máximo.

9. Multi-loja

Para contas com mais de uma loja:

• Cada loja tem suas próprias regras independentes.

• Cadastrar uma regra em uma loja não afeta as demais.

• A configuração de habilitação também é por loja.

Ao cadastrar regras, certifique-se de estar logado na loja correta.

10. Melhores práticas

Antes de habilitar

• Liste primeiro os produtos críticos que dependem de itens complementares (ex.: painéis solares, kits de instalação, equipamentos com acessórios obrigatórios).

• Combine com sua equipe técnica/comercial quais categorias são realmente obrigatórias e em que quantidade. Lembre que a quantidade definida será multiplicada pela quantidade do produto no carrinho.

• Cadastre as regras antes de habilitar a funcionalidade para evitar bloquear vendas em andamento.

Definição de quantidades

• Use o campo Mínima para garantir que o cliente leve o necessário para usar/instalar o produto.

• Use o campo Máxima apenas quando houver limite técnico real (ex.: número máximo de acessórios que funciona com o produto). Se não houver limite, deixe em branco.

• Pense sempre em quantidade por unidade do produto, não em quantidade total. O sistema cuida da multiplicação.

Manutenção

• Revise periodicamente as regras quando a sua linha de produtos mudar (novos produtos, descontinuações, mudanças de categoria).

• Ao renomear ou mover categorias, confirme se as regras associadas ainda fazem sentido.

• Quando uma campanha exigir flexibilidade (ex.: liquidação), você pode desabilitar a funcionalidade temporariamente sem perder as regras cadastradas.

11. Perguntas frequentes

O cliente pode comprar o produto avulso, sem os itens obrigatórios? Não. Enquanto houver uma regra ativa para o produto, o carrinho não permite finalizar a compra sem atender ao mínimo (ou respeitar o máximo) definido.

Se eu cadastrar uma regra hoje, ela afeta carrinhos que já estão abertos? Sim. A regra passa a valer imediatamente. Carrinhos que já estavam montados com o produto serão validados na próxima vez que o cliente acessar o carrinho ou tentar avançar para o checkout.

O cliente pode burlar a validação acessando o checkout direto pela URL? Não. Mesmo acessando o checkout diretamente, o sistema verifica as regras e redireciona o cliente de volta ao carrinho com a mensagem de erro.

Posso definir só o mínimo, só o máximo, ou ambos? Pode. Cada campo é independente:

• Apenas mínimo: garante a quantidade mínima, sem limite superior.

• Apenas máximo: limita a quantidade, sem exigência mínima.

• Ambos: define uma faixa entre mínimo e máximo.

E se dois produtos diferentes apontarem para a mesma categoria? As exigências são somadas. Se o produto A exige no mínimo 2 itens da categoria "Cabos" e o produto B exige no mínimo 3, comprar um de cada exige no mínimo 5 itens de Cabos no carrinho.

A regra vale para qualquer produto da categoria, ou só os escolhidos? A regra avalia a categoria como um todo. Qualquer produto pertencente àquela categoria conta para atender a quantidade exigida.

O que acontece com as regras se eu desabilitar a funcionalidade? As regras ficam preservadas no sistema, apenas deixam de ser validadas. Ao reativar a funcionalidade, todas voltam a funcionar normalmente, sem necessidade de recadastrar.

Existe alguma permissão específica para gerenciar as regras? Sim. O ícone de Regras de carrinho só aparece para usuários administradores que possuem a permissão correspondente. Se algum usuário não enxergar o ícone, verifique o perfil de acesso dele.0