Cómo funciona añadir un paquete al carrito

Cuando un comprador elige una oferta y hace clic en el botón Añadir al carrito de la página del producto, Bundlex añade los productos, las cantidades y los extras aptos seleccionados. La adición habitual los incluye juntos y el pago comprueba el carrito resultante para calcular el descuento.

Lo que debería ver el comprador

Para un paquete que contiene una crema facial y un sérum, una cantidad de Bundlex de 2 significa dos conjuntos completos: dos cremas y dos sérums. En esta demostración, un Daily Glow Duo cuesta $54 y dos conjuntos cuestan $108 antes del envío.

Después de añadir al carrito, comprueba cada producto y cantidad. Este carrito contiene dos cremas por $50.40 y dos sérums por $57.60, con un total de $108. Ambas filas muestran el descuento Daily Glow Duo. Tu tema puede mostrar un cajón, una página del carrito u otra confirmación; lo importante es el contenido del carrito y el subtotal del pago.

Continúa hasta el pago para confirmar los mismos productos y el descuento antes de realizar el pedido. El envío, los impuestos y otros descuentos aptos pueden afectar al total final. Si falta un extra, no des por hecho que un mensaje de adición correcta significa que llegó el paquete completo.

Cómo reconoce Bundlex el formulario del producto

El widget añade un marcador oculto bx-product-form al formulario del producto y supervisa las solicitudes al endpoint /cart/add de Shopify. El marcador es la forma habitual de reconocer el envío de un paquete.

Algunos temas reconstruyen una solicitud y eliminan los campos ocultos. Bundlex también dispone de una vía de recuperación limitada para una acción reciente de añadir al carrito en el formulario marcado, cuando la variante solicitada y la selección actual siguen coincidiendo. La ausencia del marcador es una pista de diagnóstico útil, pero por sí sola no significa que el paquete no pueda añadirse.

Esta recuperación no se aplica a todas las solicitudes personalizadas. En el modo de solo complementos, cuando un tema o un script de una aplicación añade únicamente el producto principal justo después del clic del comprador, Bundlex puede añadir los complementos marcados cuando esa adición se completa. Algunas configuraciones aún pueden omitirlos, por lo que, si faltan complementos marcados, contacta con soporte e incluye el enlace de la página del producto para que lo revisemos. Si una oferta visible añade artículos incorrectos, consulta solución de problemas de Añadir al carrito.

Añadir los productos seleccionados

Bundlex lee las variantes, cantidades y extras opcionales seleccionados por el comprador y, después, crea la carga útil del paquete. Los artículos se añaden juntos, no mediante una secuencia de clics independientes del comprador.

Si Shopify rechaza una adición anidada, Bundlex puede volver a intentarlo sin relaciones principales. Si un extra sigue sin estar disponible, la recuperación puede volver a intentar añadir los productos principales conservando la información del descuento. Una adición rechazada no siempre da como resultado un producto a precio completo; el resultado depende del intento que funcione y de si el carrito restante cumple los requisitos.

Cómo reconoce el pago la oferta

Las líneas del carrito incluyen una propiedad privada _bundlex que identifica el descuento, la oferta y cualquier extra. Esto distingue las ofertas con la misma cantidad, mantiene identificables los extras configurados por separado y aísla las líneas etiquetadas de otros descuentos de Bundlex.

El checkout usa el contenido real del carrito para comprobar las cantidades, los productos obligatorios y la elegibilidad. La etiqueta también admite la atribución de ingresos. Shopify oculta las propiedades privadas de las líneas en el checkout; el tema y el código de las plantillas personalizadas deben filtrarlas en otro lugar. Consulta códigos de pedido de Bundlex.

Propiedades personalizadas y suscripciones

La integración gestiona solicitudes comunes para añadir productos en formato JSON, FormData y codificado en URL. Las propiedades de texto, como los mensajes de grabado, se copian en la primera línea del producto principal; no se duplican automáticamente en cada componente del paquete. Los valores de planes de venta compatibles se gestionan por separado según el plan elegible de cada producto.

Las cargas de archivos requieren una comprobación de compatibilidad. La reconstrucción normal de la solicitud del paquete no conserva los valores File cargados como archivos, así que no des por hecho que una aplicación de carga de archivos o personalización funcionará solo porque sus campos de texto sí lo hagan. Prueba el flujo completo y contacta con soporte indicando la URL del producto.

Botones de compra personalizados y Comprar ahora

Una aplicación independiente de compra o de pago contra reembolso puede omitir el formulario de producto estándar y la solicitud del carrito de Shopify. Bundlex no puede garantizar que los productos obligatorios del paquete, los regalos o las Upsells sigan esa ruta. Mantén disponible el botón Añadir al carrito del tema y prueba el botón alternativo con tu oferta completa.

Comprar ahora también sigue una ruta diferente a Añadir al carrito. No des por hecho que incluye todos los componentes del paquete solo porque el carrito normal funciona. Si quieres que la adición estándar vaya directamente al checkout, usa Omitir el carrito e ir al checkout y verifica el checkout resultante.

Qué cantidad llega al carrito

• Selector de cantidad de Bundlex activo: los controles del selector ajustan la cantidad y el campo de cantidad del tema refleja el resultado.
• Configuración habitual de navegación por niveles: una cantidad nativa exacta puede seleccionar un nivel coincidente. Un valor intermedio puede dejar seleccionada la oferta anterior, por lo que se puede añadir la cantidad configurada en esa oferta.
• Cantidad nativa habilitada por soporte para niveles simples: algunas tiendas usan una configuración independiente que conserva la cantidad escrita por el cliente.

Con la selección opcional activada y sin ninguna oferta seleccionada, los controles del tema funcionan con normalidad y no se añaden regalos ni extras de la oferta. Los descuentos simples por cantidad aún pueden aplicarse en el checkout si el carrito cumple los requisitos. Deseleccionar una oferta no significa excluirse de todos los descuentos.

Consulta el comportamiento de la cantidad del tema y el selector de cantidad de Bundlex para elegir la configuración que necesitas.