> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Solución de problemas cuando Upcart no se abre o redirige a la página del carrito

> Guía de solución de problemas del cajón del carrito en Upcart, incluyendo el cajón que no se abre, la redirección a la página del carrito, dos carritos que aparecen al mismo tiempo, el carrito que no carga o Upcart que no responde al agregar artículos al carrito.

Si Upcart no se abre cuando los clientes agregan artículos a su carrito, se abre y luego redirige a la página del carrito, aparece un carrito doble o no aparece ninguno, esta guía te ayudará a identificar y solucionar el problema.

<div id="what-are-you-experiencing">
  ## ¿Qué estás experimentando?
</div>

Comienza aquí para ir directamente a la solución correcta:

* [**Upcart se abre brevemente y luego redirige a la página del carrito**](#issue-1--2-upcart-redirecting-to-the-cart-page)
* [**Los clientes son llevados directamente a la página del carrito en lugar de ver Upcart**](#issue-1--2-upcart-redirecting-to-the-cart-page)
* [**Aparecen dos carritos al mismo tiempo (Upcart y el carrito del tema)**](#3-change-theme-cart-type-to-page)
* [**Upcart no se abre en absoluto**](#issue-4-upcart-is-not-opening-at-all)

¿No estás seguro de cuál aplica? Comienza con el [Paso 1](#step-1-make-sure-upcart-is-fully-active) para confirmar que Upcart está completamente habilitado antes de profundizar en un problema específico.

La mayoría de los problemas del cajón del carrito de Upcart son causados por:

* Upcart no estar completamente habilitado
* La configuración del carrito del tema en conflicto con Upcart
* La configuración de Enhanced AJAX API Compatibility
* Apps de terceros que anulan el comportamiento del carrito
* Cajones de carrito del tema en conflicto con Upcart

Sigue los pasos a continuación en orden y prueba después de cada cambio.

***

<div id="step-1-make-sure-upcart-is-fully-active">
  ## Paso 1: Asegúrate de que Upcart esté completamente activo
</div>

Antes de solucionar cualquier otra cosa, confirma que Upcart esté correctamente habilitado.

<div id="1-ensure-the-cart-is-activated">
  ### 1. Asegúrate de que el carrito esté activado
</div>

Si el carrito está desactivado dentro del editor de Upcart, no aparecerá en tu tienda.

* Abre Upcart
* Ve a **Manage all carts**
* Confirma que el carrito esté publicado

<div id="2-enable-the-app-embed">
  ### 2. Habilita el app embed
</div>

Si el app embed está desactivado, Upcart no cargará.

* Ve a **Shopify Admin > Online Store > Themes > Customize**
* Abre **App Embeds**
* Activa **Upcart ON**
* Guarda

Prueba tu carrito después de habilitar estas configuraciones.

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-not-opening-activate-cart-app-embed.gif?s=244802191623615202cc95d61431de84" alt="Activando el carrito de Upcart y habilitando su app embed en el panel de administración de Shopify" width="2044" height="1080" data-path="images/upcart/cart-not-opening-activate-cart-app-embed.gif" />

***

<div id="issue-1--2-upcart-redirecting-to-the-cart-page">
  ## Problemas 1 y 2: Upcart redirige a la página del carrito
</div>

Si Upcart se abre brevemente y luego redirige, o los clientes son llevados directamente a la página del carrito, esto suele ser causado por uno de los siguientes puntos. Sigue cada paso y prueba después de cada cambio.

<div id="1-check-checkout-button-setting-in-upcart">
  ### 1. Verifica la configuración del botón de checkout en Upcart
</div>

Si los clientes hacen clic en Checkout y son enviados de vuelta a la página del carrito:

1. Ve a **Upcart > Cart Editor > Settings > Cart settings**
2. Ubica **"Go to cart page when pressing checkout button"**
3. Desactiva esta opción (**OFF**)
4. Guarda y prueba

Cuando está habilitada, esta opción obliga al botón de checkout a redirigir a la página del carrito en lugar de proceder al checkout.

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-not-opening-go-to-cart-page-setting.gif?s=96670b4dedac961d37c1e39b80caea4a" alt="Configuración del carrito de Upcart resaltando la opción Go to cart page when pressing checkout" width="1180" height="1080" data-path="images/upcart/cart-not-opening-go-to-cart-page-setting.gif" />

<div id="2-check-enhanced-ajax-api-compatibility">
  ### 2. Verifica Enhanced AJAX API Compatibility
</div>

Ve a **Upcart > Cart Editor > Settings > Cart settings**, expande **Advanced Settings** y ubica **Enhanced AJAX API Compatibility**.

Esta configuración cambia cómo Upcart maneja los eventos de Add to Cart:

* **Desactivada (recomendada para la mayoría de las tiendas)** - Upcart intercepta las llamadas de Add to Cart y evita las redirecciones
* **Activada** - Upcart deja de interceptar las llamadas de Add to Cart, permitiendo que otras apps controlen el comportamiento del carrito, incluidas las redirecciones

Esta configuración está **desactivada de forma predeterminada**. Actívala SOLO si tu tienda usa una API AJAX de carrito no estándar y Upcart no está interceptando los eventos de agregar al carrito. Si activar esta configuración causa redirecciones, desactívala y usa la API manual de Upcart (`upcartRegisterAddToCart`) en su lugar.

Para una guía completa, consulta [Enhanced AJAX API Compatibility](/es/upcart/enhanced_ajax_api_compatibility).

<img src="https://mintcdn.com/aftersell/Dz_83h-jRD2tmZWk/images/upcart/cart-not-opening-enhanced-ajax-api-compatibility.gif?s=7c3a3fc600bca7b421d57241bb740a78" alt="La configuración Enhanced Ajax API compatibility y su descripción en Upcart" width="2084" height="1080" data-path="images/upcart/cart-not-opening-enhanced-ajax-api-compatibility.gif" />

<div id="3-change-theme-cart-type-to-page">
  ### 3. Cambia el tipo de carrito del tema a "Page"
</div>

El cajón o ventana emergente del carrito de tu tema puede estar anulando a Upcart.

1. Ve a **Shopify Admin > Online Store > Themes**
2. Haz clic en **Customize**
3. Abre **Theme Settings > Cart**
4. Cambia **Cart Type** a **Page**
5. Guarda y prueba

Configurar el carrito como "Page" evita que el cajón nativo del tema se abra en lugar de Upcart.

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-type-theme-editor-settings-option.gif?s=81eef4e6af5190720b3eb86be578c605" alt="Configurando el Cart type del tema como Page en la configuración del tema de Shopify" width="644" height="1080" data-path="images/upcart/cart-type-theme-editor-settings-option.gif" />

<Note>
  Si tu tema no incluye una configuración de "Cart Type" (o equivalente), contacta al desarrollador de tu tema para ubicar o agregar la opción correcta. Upcart no puede modificar la configuración del tema directamente.
</Note>

<div id="4-disable-theme-cart-redirect-settings">
  ### 4. Desactiva las configuraciones de redirección del carrito del tema
</div>

Algunos temas redirigen automáticamente a los clientes a la página del carrito después de agregar un producto, evitando Upcart por completo.

1. Ve a **Shopify Admin > Online Store > Themes > Customize**
2. Abre **Theme Settings > Products** (o Cart)
3. Busca configuraciones como:
   * Enable cart redirection
   * Redirect to cart after add
   * Go to cart after add
4. Desactívalas (**OFF**), guarda y prueba

<div id="5-check-for-conflicts-with-other-apps">
  ### 5. Verifica si hay conflictos con otras apps
</div>

Muchas apps de terceros anulan el comportamiento del carrito. Abre la configuración de cualquier app relacionada con el carrito y busca opciones como:

* Redirect to cart
* Go to cart after add
* Automatically open cart page
* Action after product is added

Cámbialas a **Stay on page** o **Do nothing** y prueba después de cada ajuste.

**Soluciones comunes específicas de apps:**

* **Globo Product Options** - Desactiva "Redirect to the shopping cart page after adding a product"
* **Zepto Product Personalizer** - Ve a Zepto > Settings > Add to Cart Settings y cambia "Action after a product is added to the cart" a "Stay on the product page and show a success message"
* **PageFly** - Desactiva cualquier regla de redirección del carrito en la configuración de PageFly
* **Replo** - Ajusta las configuraciones de "go to page" para permitir que el cajón del carrito se abra

Si no estás seguro de qué app está causando el conflicto, desactiva las apps relacionadas con el carrito una a la vez y prueba después de cada una hasta que Upcart comience a funcionar.

***

<div id="issue-4-upcart-is-not-opening-at-all">
  ## Problema 4: Upcart no se abre en absoluto
</div>

Si no pasa nada cuando los clientes agregan al carrito o hacen clic en el icono del carrito, esto suele ser causado por un conflicto de tema o porque Upcart no detecta los botones correctos.

<div id="disable-themes-native-cart-drawer">
  ### Desactiva el cajón de carrito nativo del tema
</div>

1. Ve a **Shopify Admin > Online Store > Themes > Customize**
2. Abre **Theme Settings > Cart**
3. Establece el tipo de carrito en **Page**
4. Guarda

Asegúrate de que los modos Drawer o Popup estén desactivados.

<div id="upcart-not-detecting-your-buttons">
  ### ¿Upcart no detecta tus botones?
</div>

Algunos temas usan código personalizado que impide que Upcart detecte automáticamente el botón de Add to Cart o el icono del carrito. Si ese es el caso, puedes especificar manualmente los selectores de los botones.

**Paso 1: Encuentra el nombre de la clase**

1. Abre tu tienda en **Google Chrome**
2. Haz clic derecho en el **botón de Add to Cart** o en el **icono del carrito**
3. Haz clic en **Inspect**
4. En el código resaltado, busca algo como:

```text theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
class="icon icon-cart"
```

o

```text theme={"theme":{"light":"snazzy-light","dark":"github-dark"}}
class="product-form__submit button"
```

Copia solo **un nombre de clase** (por ejemplo: `icon-cart`). No copies `class=` ni las comillas.

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-not-opening-devtools-find-class.gif?s=1899e34961f704c4e9919620e3159376" alt="Inspeccionando el icono del carrito en Chrome DevTools para encontrar su nombre de clase" width="1600" height="1080" data-path="images/upcart/cart-not-opening-devtools-find-class.gif" />

**Paso 2: Agrégalo en Upcart**

Debes agregar un **punto (.)** antes del nombre de la clase al ingresarlo en Upcart. Por ejemplo: `.icon-cart`

1. Abre **Upcart**
2. Ve a **Cart Editor > Settings > Cart settings** y luego expande **Advanced Settings**
3. Encuentra el grupo de selectores que necesitas:
   * **Open cart button selector** — para el icono del carrito
   * **Add to cart button selector** — para el botón de agregar al carrito
4. En el menú desplegable **Options** de ese grupo, elige **Add additional selector** (mantiene la detección propia de Upcart y agrega la tuya) o **Use custom selector** (solo la tuya). El campo **Custom selector** permanece deshabilitado mientras esté seleccionado **Use default selector**.
5. Pega `.icon-cart` en **Custom selector** y guarda

<img src="https://mintcdn.com/aftersell/uxKAdY-e0h16xa48/images/upcart/cart-not-opening-custom-open-selector.gif?s=d437f6359066a7aa26467f85611f13d2" alt="Ingresando un selector personalizado de Open cart button en la configuración avanzada de Upcart" width="1064" height="1080" data-path="images/upcart/cart-not-opening-custom-open-selector.gif" />

***

<div id="additional-troubleshooting">
  ## Solución de problemas adicional
</div>

Si el problema persiste después de seguir los pasos anteriores, prueba lo siguiente una cosa a la vez, probando después de cada cambio.

<div id="toggle-shadow-dom-onoff">
  ### Alterna Shadow DOM (ON/OFF)
</div>

En algunos temas, la configuración de Shadow DOM afecta cómo Upcart detecta los botones y los eventos del carrito.

1. Ve a **Upcart > Cart Editor > Settings > Cart settings** y luego expande **Advanced Settings**
2. Ubica **Render cart in shadow DOM**
3. Actívala (**ON**), guarda y prueba
4. Desactívala (**OFF**), guarda y prueba de nuevo

Usa la configuración que produzca un comportamiento consistente.

<div id="toggle-ajax-setting-onoff">
  ### Alterna la configuración de AJAX (ON/OFF)
</div>

Algunas tiendas se comportan mejor con el manejo de AJAX cambiado, según la configuración del tema y las apps.

1. Ve a **Upcart > Cart Editor > Settings > Cart settings** y luego expande **Advanced Settings**
2. Ubica **Enhanced Ajax API compatibility**
3. Actívala (**ON**), guarda y prueba
4. Desactívala (**OFF**), guarda y prueba de nuevo

Ten en cuenta que esta configuración también desactiva el manejo propio de Add to Cart de Upcart, así que si activarla soluciona la redirección, vale la pena confirmar que agregar al carrito siga comportándose como esperas. Consulta [Enhanced Ajax API compatibility](/es/upcart/enhanced_ajax_api_compatibility).

<div id="clear-browser-cache">
  ### Borra la caché del navegador
</div>

Los scripts antiguos en caché pueden retener el comportamiento anterior del carrito e impedir que Upcart cargue correctamente.

1. Abre la configuración del navegador
2. Ve a **Privacy & Security**
3. Selecciona **Clear Browsing Data**
4. Borra las imágenes, los archivos y las cookies en caché
5. Actualiza y prueba

<div id="test-with-a-default-shopify-theme">
  ### Prueba con un tema predeterminado de Shopify
</div>

1. Ve a **Shopify Admin > Online Store > Themes**
2. Agrega un tema gratuito como Dawn
3. Habilítalo temporalmente
4. Prueba Upcart

Si Upcart funciona con Dawn, el problema es específico de tu tema personalizado. Contacta al desarrollador de tu tema para obtener ayuda.

<div id="disable-apps-one-by-one">
  ### Desactiva las apps una por una
</div>

1. Ve a **Shopify Admin > Apps**
2. Desactiva una app relacionada con el carrito a la vez
3. Prueba después de cada una

Cuando Upcart comience a funcionar, habrás identificado la app en conflicto.

<div id="check-browser-console-for-errors">
  ### Revisa la consola del navegador en busca de errores
</div>

1. Abre tu tienda
2. Presiona **F12** (o haz clic derecho > Inspect)
3. Abre la pestaña **Console**
4. Agrega un producto al carrito
5. Busca errores, especialmente cualquier cosa relacionada con add.js o eventos del carrito
6. Toma capturas de pantalla de cualquier error para compartirlas con soporte

***

<div id="when-to-contact-support">
  ## Cuándo contactar a soporte
</div>

Si has completado todos los pasos y Upcart todavía no funciona, comunícate con soporte con:

* Nombre y versión del tema
* Lista de apps relacionadas con el carrito instaladas
* Capturas de pantalla de los errores de la consola
* Pasos que ya has intentado

Puedes contactar al soporte de Upcart a través del chat de la app o enviando un correo a [support@upcart.app](mailto:support@upcart.app).
