Requisitos y limitaciones de Shopify Scripts
Hay ciertas limitaciones de Shopify Scripts para mejorar la seguridad y garantizar que los scripts puedan ejecutarse sin importar cuántos clientes usen tu tienda en un momento dado. Ten en cuenta las siguientes restricciones si estás desarrollando scripts para tu tienda de Shopify.
En esta página
- Tienda online y la API de página principal de la tienda.
- Scripts publicados
- Cantidad máxima de Shopify Scripts
- Pedidos preliminares
- Metacampos
- Atributos de carrito/pantalla de pago
- Códigos de descuento
- Líneas de artículo
- Tarifas de envío
- Múltiples monedas
- Expresiones regulares
- Temas
- Recursos
- Entrada/salida
- Tiempo y aleatoriedad
- Límite de caracteres del script
- Pedidos por suscripción
- Pagos simplificados
- Shopify Point of Sale (POS)
- Cambiar el nombre de pasarelas de pago
Tienda online y la API de página principal de la tienda.
Cuando creas o editas un script, seleccionas si se ejecutará solo en tu tienda online o también en las siguientes aplicaciones:
- Aplicaciones personalizadas creadas con la API Storefront, el SDK de JavaScript Buy o los SDK de Mobile Buy (Android e iOS)
- Aplicaciones personalizadas que generan pagos
- Constructores de aplicaciones móviles Tapcart y Plobal Apps
Para que funcionen los scripts, tu sitio web debe tener una funcionalidad integrada del carrito, por lo que no puedes usar scripts con botones de compra o el canal de ventas Facebook e Instagram de Meta.
Scripts publicados
Solo se puede publicar un script por tipo de script a la vez. Por ejemplo, puedes publicar un script de línea de artículos y un script de tarifas de envío, pero no puedes publicar dos scripts de línea de artículos al mismo tiempo.
Cantidad máxima de Shopify Scripts
Puedes crear hasta 100 Shopify Scripts.
Pedidos preliminares
Los scripts de líneas de artículo, de tarifas de envío y de pago no funcionan con los pedidos preliminares o la pantalla de pago de los pedidos preliminares.
Metacampos
Los Shopify Scripts no pueden acceder a los metacampos.
Atributos de carrito/pantalla de pago
Los Shopify Scripts no pueden acceder a los Atributos liquid del carrito de Shopify. Puedes agregar estos atributos a tus páginas del carrito para recopilar información adicional de tus clientes, pero no puedes crear un script que los utilice.
Códigos de descuento
Los scripts pueden acceder a datos sobre si se aplica un código de descuento, el monto de descuento y su tipo, como monto fijo, porcentaje o envío. Los scripts no pueden acceder a la forma en que se aplica el código de descuento, por ejemplo, si es específico del carrito o de la línea de artículo. Esto significa que los scripts no pueden acceder a los totales posteriores a los descuentos o a los descuentos automáticos.
Los scripts de líneas de artículo y de envío que acceden a descuentos aplicados a un carrito no son compatibles con las combinaciones de descuentos. El método .discount_code
solo puede devolver un único código de descuento. No se admiten los carritos que incluyen varios códigos de descuento empleando combinaciones de descuentos.
Líneas de artículo
Los scripts no pueden agregar artículos al carrito ni aumentar el precio de un artículo.
Tarifas de envío
Los scripts no pueden aumentar el precio de una tarifa de envío.
Múltiples monedas
Es posible que tus scripts no funcionen con múltiples monedas como se esperaba. Para asegurarte de que tus scripts funcionen para carritos o pantallas de pago que estén en cualquier moneda que no sea la moneda principal de tu tienda, debes migrar tus scripts a Shopify Functions.
Expresiones regulares
No se admiten las coincidencias de expresiones regulares. Si estás creando un script de línea de artículo, podrías usar uno de los siguientes métodos como solución alternativa:
-
split
método -
start_with
yend_with
(métodos) -
include
método
Temas
Es posible que debas actualizar tu tema de Liquid para que sea compatible con tus scripts y para no confundir a tus clientes. Por ejemplo, no todos los temas muestran descuentos de línea de artículo en el carrito. Si este es tu caso, deberás editar tu tema para que muestre los descuentos de líneas de artículo en el carrito. Obtén más información sobre los tipos de modificaciones que puedes hacer a tus temas de Liquid.
Recursos
La cantidad del CPU y memoria disponibles para un script es limitada. Los recursos reservados para un script dependen del tamaño del carrito y de la cantidad de cálculos que requiera el script. Shopify hace un seguimiento detallado de estos límites de recursos para asegurarse de que no impidan que tu script funcione según lo esperado.
Cuando pruebas un script, la consola de Script Editor imprime el porcentaje de recursos asignados que utiliza el script.
Entrada/salida
Con algunas excepciones, los Shopify Scripts no admiten la entrada ni la salida. Esto significa que los scripts no pueden ejecutar solicitudes web ni llamadas a bases de datos, así como tampoco obtener información de un usuario.
El método puts
se puede usar para imprimir texto en la consola en la aplicación Script Editor.
Tiempo y aleatoriedad
Los scripts no pueden implicar cálculos aleatorios o basados en el tiempo. Los Shopify Scripts no puede acceder al objeto Time
ni al método rand
.
Debido a que los scripts se ejecutan cada vez que se recalcula el total de un carrito, los scripts basados en tiempo o en la generación de números aleatorios podrían tener resultados impredecibles o confusos si un cliente cambia su carrito con frecuencia. Sin embargo, puedes programar scripts para que se ejecuten durante los eventos usando la aplicación Launchpad.
Límite de caracteres del script
Puedes crear scripts de hasta 40.960 caracteres como máximo.
Pedidos por suscripción
Si tus scripts de línea de artículo y de envío crean un descuento para un producto de suscripción, el descuento se aplica a los siguientes pagos:
- Solo al primer pago de un pago por entrega. Esta opción no es aplicable a los pedidos programados.
- El monto total de un pedido de suscripción prepagada.
Más información sobre suscripciones y scripts.
Pagos simplificados
Cuando usas Shopify Scripts con los procesos de pago acelerado, se aplican descuentos de envío luego de que tu cliente seleccione una forma de pago acelerado. Por este motivo, los cambios en el precio del pedido no se reflejan en el dispositivo o navegador del cliente. Los clientes ven el precio original en su proceso de pago acelerado, pero se les cobrará el precio con descuento correcto.
Shopify Point of Sale (POS)
Los Shopify Scripts no funcionan con Shopify Point of Sale (POS).
Cambiar el nombre de pasarelas de pago
No puedes cambiar el nombre de las pasarelas de pago que tengan imágenes o logos que se muestren como el nombre de la pasarela. Se puede cambiar el nombre de las pasarelas de pago que tengan imágenes de logo junto a sus nombres.