Skip to main content

​
Descripción general

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?

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.

​
¿Cómo uso el Custom HTML de Upcart?

  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

​
💡 Ejemplo: Ocultar el botón fijo del carrito cuando el carrito está vacío

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.

​
¿Necesito ser desarrollador para usar la API de Upcart?

¡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 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— pueden ayudarte a empezar.

​
¿La API de Upcart puede integrarse con otras aplicaciones de terceros?

¡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 para el seguimiento, deberás agregar el siguiente script para asegurarte de que registre correctamente la actividad del carrito:
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.
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.

​
¿Cómo pruebo si mis cambios de API están funcionando?

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.

​
¿Qué debo hacer si un script de API no funciona?

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í.
  • 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 puede ayudarte.
¡Estos pasos deberían ayudarte a identificar y resolver la mayoría de los problemas con scripts!

​
¿Cómo deshago los cambios si agrego un script que rompe algo?

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 y comparte con él nuestra documentación de la API para recibir asistencia