> ## 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.

# Preguntas frecuentes sobre la API de Upcart

> Encuentra respuestas a preguntas comunes sobre el uso de la API de Upcart, incluyendo configuración, solución de problemas e integraciones de terceros.

<div id="overview">
  # Descripción general
</div>

Aquí tienes respuestas a algunas de las preguntas más comunes sobre el uso de la API de Upcart.

* **[¿Dónde agregar los scripts de la API de Upcart?](#where-to-add-upcart-api-scripts)**
* **[¿Necesito ser desarrollador para usar la API de Upcart?](#do-i-need-to-be-a-developer-to-use-upcarts-api)**
* **[¿La API de Upcart puede integrarse con otras aplicaciones de terceros?](#can-upcarts-api-integrate-with-other-third-party-apps)**
* **[¿Cómo pruebo si mis cambios de API están funcionando?](#how-do-i-test-if-my-api-changes-are-working)**
* **[¿Qué debo hacer si un script de API no funciona?](#what-should-i-do-if-an-api-script-isnt-working)**
* **[¿Cómo deshago los cambios si agrego un script que rompe algo?](#how-do-i-undo-changes-if-i-add-a-script-that-breaks-something)**

***

<div id="where-to-add-upcart-api-scripts">
  ## **¿Dónde agregar los scripts de la API de Upcart?**
</div>

Puedes agregar scripts en la configuración de Custom HTML de Upcart o directamente en el código de tu tema de Shopify. La mejor opción depende de tus necesidades de personalización.

<div id="how-do-i-use-upcarts-custom-html">
  ## ¿Cómo uso el Custom HTML de Upcart?
</div>

1. Ve a **Upcart → Settings → Custom HTML**
2. Usa scripts de API para modificar el comportamiento del carrito, como el momento de apertura o la visualización de upsells
3. Ajusta elementos fuera de Upcart, como ocultar botones de la página de producto

<div id="example-hide-the-sticky-cart-button-when-the-cart-is-empty">
  #### 💡 *Ejemplo: Ocultar el botón fijo del carrito cuando el carrito está vacío*
</div>

```
<script>  
  window.upcartSubscribeCartLoaded((event) => {  
    const itemCount = event.cart.items.reduce((total, item) => total + item.quantity, 0);  
    document.querySelector("#upCartStickyButton").style.display = itemCount === 0 ? "none" : "block";  
    console.log("Sticky Cart is hiding!");  
  });  
</script>
```

<Note>
  **Nota sobre versiones anteriores:** los callbacks `window.upcartOnCartLoaded` todavía funcionan, pero están obsoletos y registran advertencias en la consola. Usa `upcartSubscribeCartLoaded` para todos los scripts nuevos. Ten en cuenta que `event.cart` no tiene una propiedad `item_count`: usa `event.cart.items.reduce((total, item) => total + item.quantity, 0)` para calcular el número total de artículos.
</Note>

***

<div id="do-i-need-to-be-a-developer-to-use-upcarts-api">
  # **¿Necesito ser desarrollador para usar la API de Upcart?**
</div>

¡No! La API de Upcart es fácil de usar, incluso sin conocimientos de programación. Muchas funciones vienen integradas, y nuestros [documentos de personalización](/es/upcart/add_a_mandatory_terms_and_conditions_checkbox_to_your_cart) incluyen scripts ya escritos que puedes copiar en la configuración de Custom HTML de Upcart, ¡sin necesidad de programar!

Si quieres escribir scripts personalizados, tener conocimientos básicos de JavaScript ayuda. Si eres nuevo en JavaScript, ¡no te preocupes! Estos recursos para principiantes —**W3Schools** y **[MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/JavaScript)**— pueden ayudarte a empezar.

***

<div id="can-upcarts-api-integrate-with-other-third-party-apps">
  # ¿La API de Upcart puede integrarse con otras aplicaciones de terceros?
</div>

¡Sí! La API de Upcart funciona con aplicaciones de traducciones, analítica, upsells y más. Algunas se integran automáticamente, mientras que otras pueden necesitar un pequeño script.

Por ejemplo, si usas **[TripleWhale](https://kb.triplewhale.com/en/articles/6610178-adding-the-triple-pixel-to-third-party-checkouts#h_eccf979512)** para el seguimiento, deberás agregar el siguiente script para asegurarte de que registre correctamente la actividad del carrito:

```
<script>  
window.upcartSubscribeAddedToCart((event) => {  
	window.TriplePixel('AddToCart', {item: event.item.variantId, q: event.item.quantityAdded});  
});  
</script>
```

<Note>
  **Nota sobre versiones anteriores:** los callbacks `window.upcartOnAddToCart` todavía funcionan, pero están obsoletos y registran advertencias en la consola. Usa `upcartSubscribeAddedToCart` para todos los scripts nuevos. Ten en cuenta que las propiedades del evento están en `event.item` (con `variantId` y `quantityAdded`), y no se pasan como parámetros separados.
</Note>

Como cada aplicación es diferente, consulta con el equipo de soporte de tu aplicación para saber si se necesita código adicional. Upcart no ofrece soporte de scripts para aplicaciones de terceros, pero tu proveedor de aplicaciones puede tener una guía de integración.

***

<div id="how-do-i-test-if-my-api-changes-are-working">
  # ¿Cómo pruebo si mis cambios de API están funcionando?
</div>

Después de agregar un script en la configuración de Custom HTML de Upcart, sigue estos pasos para asegurarte de que funciona:

1. **Actualiza tu tienda** y agrega un artículo al carrito.

2. **Borra tu caché** e inténtalo de nuevo para ver los cambios más recientes.

3. **Agrega un mensaje de prueba**: inserta `console.log("The script works!");` antes de `</script>` para comprobar si tu script se ejecuta.

4. Revisa la consola de tu navegador:

   * Abre las **Dev Tools** (`F12` o `Ctrl + Shift + J` en Windows, `Cmd + Option + J` en Mac).
   * Ve a la pestaña **Console** y busca **"The script works!"**
   * Si ves el mensaje, ¡tu script se está ejecutando! Si no, puede que el script no se esté ejecutando correctamente.

5. **Prueba diferentes acciones** (p. ej., eliminar un artículo) para asegurarte de que el comportamiento sea el esperado.

**Soluciona los problemas** revisando errores tipográficos o errores en la consola y ajustando el código según sea necesario.

***

<div id="what-should-i-do-if-an-api-script-isnt-working">
  # ¿Qué debo hacer si un script de API no funciona?
</div>

Si tu script de API no funciona, prueba estos pasos de solución de problemas:

* **Revisa los errores tipográficos** – Incluso los errores pequeños pueden romper un script. Busca caracteres faltantes o sintaxis incorrecta.

* **Verifica la ubicación del script** – Asegúrate de que el script esté en la sección correcta en Upcart → Settings → Custom HTML. Upcart tiene diez secciones de scripts (nueve puntos de inyección de HTML más una sección Scripts-before-load) — [Revisa estas secciones aquí.](/es/upcart/custom_html)

* **Revisa la consola del navegador** – Sigue los pasos anteriores para buscar errores.

* **Prueba un script diferente** – Prueba otro script de la API de Upcart ya escrito para ver si el problema está en tu código.

* **¿Sigues atascado?** – Si estás modificando tu tema de Shopify o integrando aplicaciones de terceros, un Shopify Expert del [Shopify Partner Directory](https://www.shopify.com/partners/directory) puede ayudarte.

¡Estos pasos deberían ayudarte a identificar y resolver la mayoría de los problemas con scripts!

***

<div id="how-do-i-undo-changes-if-i-add-a-script-that-breaks-something">
  # ¿Cómo deshago los cambios si agrego un script que rompe algo?
</div>

Si agregas un script que no funciona como esperabas, puedes **eliminarlo o desactivarlo fácilmente**:

* **Ve a la configuración de Custom HTML de Upcart** donde se agregó el script.

* **Elimina el script** o desactívalo temporalmente agregando `//` al inicio de cada línea (esto lo convierte en un comentario y evita que se ejecute).

* **Guarda los cambios y actualiza tu tienda** para comprobar si el problema se resolvió.

Si el problema persiste, intenta borrar tu caché o revertir los cambios recientes del tema; esto suele resolver conflictos ocultos.

***

🚧 **¿Buscas personalizaciones avanzadas?**

¿Necesitas personalizaciones para toda la tienda o integraciones con aplicaciones de terceros? Es posible que necesites un desarrollador para agregar la API de Upcart a tu tema de Shopify.

Considera contratar a un Shopify Expert a través del **[Shopify Partner Directory](https://www.shopify.com/partners/directory)** y comparte con él nuestra [documentación de la API](/es/upcart/introduction_to_upcarts_public_api) para recibir asistencia