Como funciona a adição de um pacote ao carrinho

Quando um cliente escolhe uma oferta e clica no botão Adicionar ao carrinho da página do produto, o Bundlex adiciona os produtos, as quantidades e os extras elegíveis selecionados. A adição normal inclui todos eles juntos, e o checkout verifica o carrinho resultante para calcular o desconto.

O que o cliente deve ver

Para um pacote que contém um creme facial e um sérum, uma quantidade do Bundlex de 2 significa dois conjuntos completos: dois cremes e dois séruns. Nesta demonstração, um Daily Glow Duo custa $54, e dois conjuntos custam $108 antes do frete.

Depois de clicar em Adicionar ao carrinho, verifique cada produto e quantidade. Este carrinho contém dois cremes por $50.40 e dois séruns por $57.60, totalizando $108. As duas linhas mostram o desconto do Daily Glow Duo. Seu tema pode exibir um carrinho lateral, uma página de carrinho ou outra confirmação, mas o que importa é o conteúdo do carrinho e o subtotal no checkout.

Continue até o checkout para confirmar os mesmos produtos e o desconto antes de fazer o pedido. Frete, impostos e outros descontos elegíveis podem afetar o total final. Se algum extra estiver faltando, não presuma que uma mensagem de adição bem-sucedida significa que o pacote completo chegou.

Como o Bundlex reconhece o formulário do produto

O widget adiciona um marcador oculto bx-product-form ao formulário do produto e monitora as solicitações para o endpoint /cart/add da Shopify. O marcador é a forma habitual de reconhecer o envio de um pacote.

Alguns temas recriam uma solicitação e removem campos ocultos. O Bundlex também tem um caminho limitado de recuperação para uma ação recente de adicionar ao carrinho no formulário marcado, quando a variante solicitada e a seleção atual ainda correspondem. A ausência do marcador é uma pista útil para diagnóstico, mas, por si só, não significa que o pacote não possa ser adicionado.

Essa recuperação não se aplica a todas as solicitações personalizadas. No modo somente complementos, quando um tema ou script de app adiciona apenas o produto principal logo após o clique do cliente, o Bundlex pode adicionar os complementos marcados assim que essa adição for concluída. Algumas configurações ainda os removem. Portanto, se os complementos marcados desaparecerem, entre em contato com o suporte informando o link da página do produto, e nós verificaremos o caso. Se uma oferta visível adicionar os itens errados, consulte a solução de problemas de adicionar ao carrinho.

Adicionando os produtos selecionados

O Bundlex lê as variantes, as quantidades e os extras opcionais selecionados pelo cliente e, em seguida, cria os dados do pacote. Os itens são adicionados juntos, e não por meio de uma sequência de cliques separados do cliente.

Se a Shopify rejeitar uma adição aninhada, o Bundlex poderá tentar novamente sem as relações de item principal. Se um extra ainda estiver indisponível, a recuperação poderá tentar novamente os produtos principais, preservando as informações do desconto. Uma adição rejeitada nem sempre resulta em um único produto pelo preço integral. O resultado depende de qual tentativa é bem-sucedida e de o carrinho restante atender aos requisitos.

Como o checkout reconhece a oferta

As linhas do carrinho contêm uma propriedade privada _bundlex que identifica o desconto, a oferta e qualquer extra. Isso diferencia ofertas com a mesma quantidade, mantém identificáveis os extras configurados separadamente e isola as linhas identificadas de outros descontos do Bundlex.

O checkout usa o conteúdo real do carrinho para verificar quantidades, produtos obrigatórios e elegibilidade. A tag também é compatível com a atribuição de receita. A Shopify oculta propriedades privadas de linha no checkout; o código do tema e de templates personalizados deve filtrá-las em outro local. Consulte códigos de pedido do Bundlex.

Propriedades personalizadas e assinaturas

A integração processa solicitações comuns de adição usando JSON, FormData e URL codificada. Propriedades de texto, como mensagens de gravação, são copiadas para a primeira linha do produto principal; elas não são duplicadas automaticamente em cada componente do pacote. Os valores de plano de venda compatíveis são processados separadamente, de acordo com o plano elegível de cada produto.

O upload de arquivos exige uma verificação de compatibilidade. A reconstrução normal da solicitação do pacote não preserva valores File enviados como uploads, portanto, não presuma que um app de upload de arquivos ou de personalização funcionará apenas porque os campos de texto funcionam. Teste o fluxo completo e entre em contato com o suporte informando a URL do produto.

Botões de compra personalizados e Comprar agora

Um app separado de compra ou pagamento na entrega pode ignorar o formulário padrão do produto e a solicitação de carrinho da Shopify. O Bundlex não pode garantir que produtos obrigatórios do pacote, brindes ou upsells seguirão por esse caminho. Mantenha o botão Adicionar ao carrinho do tema disponível e teste o botão alternativo com sua oferta completa.

Comprar agora também segue um caminho diferente de Adicionar ao carrinho. Não presuma que ele levará todos os componentes do pacote apenas porque o carrinho normal funciona. Se quiser que a adição padrão vá diretamente para o checkout, use Pular carrinho e ir para o checkout e verifique o checkout resultante.

Qual quantidade chega ao carrinho

• Seletor de quantidade do Bundlex ativo: os controles de incremento e decremento do widget controlam a quantidade, e o campo de quantidade do tema reflete o resultado.
• Configuração usual de navegação entre faixas: uma quantidade nativa exata pode selecionar uma faixa correspondente. Um valor intermediário pode manter a oferta anterior selecionada, fazendo com que a quantidade configurada da oferta seja adicionada.
• Quantidade nativa ativada pelo suporte para faixas simples: algumas lojas usam uma configuração separada que preserva a quantidade digitada pelo cliente.

Com a seleção opcional ativada e nenhuma oferta selecionada, os controles do tema funcionam normalmente, e brindes ou extras da oferta não são adicionados. Descontos simples por quantidade ainda podem ser aplicados no checkout se o carrinho atender aos critérios. Desmarcar uma oferta não significa optar por não receber todos os descontos.

Consulte comportamento da quantidade no tema e seletor de quantidade do Bundlex para escolher a configuração necessária.