Shopify es una plataforma líder de comercio electrónico que te permite crear, gestionar y escalar tu tienda online con herramientas intuitivas y soluciones integrales para vender en cualquier lugar.

📌 ¿Qué es este módulo?

Este módulo permite conectar Saturn Studio con Shopify, una de las plataformas de comercio electrónico más utilizadas a nivel mundial. Con esta integración, puedes crear productos, consultar inventario, gestionar variantes y registrar pedidos de manera automatizada y eficiente.

📚 Descripción de los comandos

📄 Create a Product

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Shopify necesaria para crear el producto.	credential
Título	Título del producto.	T-shirt with logo
Descripción	Descripción del producto.	T-shirt with logo extra large
Proveedor	Marca o proveedor del producto.	Nike
Etiquetas	Etiquetas asociadas al producto.	[ “t-shirt”, “logo”, “nike” ]
Asignar resultado a variable	Variable donde se almacenará el resultado.	{ “data”: { “productCreate”: { “product”: { “id”: “…”, “title”: “MacBook” } } } }

Crea un nuevo producto en tu tienda Shopify con título, descripción, proveedor y etiquetas.

📄 Get a Product

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Shopify necesaria para obtener el producto.	credential
ID del Producto	ID del producto a recuperar.	gid://shopify/Product/9828974166304
Asignar resultado a variable	Variable donde se almacenará el resultado.	{ “product”: { “id”: “…”, “title”: “MacBook” } }

Obtiene la información completa de un producto mediante su ID.

📄 Search Products

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Shopify necesaria para buscar productos.	credential
Título	Título del producto.	T-shirt with logo
Proveedor	Marca o proveedor del producto.	Nike
Límite	Número máximo de resultados.	10
Estado	Estado del producto (ACTIVE, ARCHIVED o DRAFT).	ACTIVE
Asignar resultado a variable	Variable donde se almacenará el resultado.	{ “products”: { “edges”: […] } }

Realiza una búsqueda de productos en tu tienda por título, proveedor y estado.

📄 Create Variant

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Shopify necesaria para crear la variante.	credential
ID del Producto	ID del producto al que se añadirá la variante.	gid://shopify/Product/9828914757920
Precio	Precio de la variante.	11.99
SKU	Código único de la variante.	KS42E22TSW
Opción	Opción de la variante (por ejemplo: color, talla).
Valor	Valor de la opción (por ejemplo: red, XL).	red
Peso	Peso del producto.	0.5
Asignar resultado a variable	Variable donde se almacenará el resultado.	{ “products”: { “edges”: […] } }

Crea una variante de un producto existente, definiendo precio, SKU, opciones y peso.

📄 Create Order

Parámetro	Descripción	Ejemplo
Credencial	Credencial de Shopify necesaria para crear el pedido.	credential
ID del Producto	Producto relacionado al pedido.	gid://shopify/Product/9828914757920
Variante	Selección de la variante del producto.
Cantidad	Número de unidades a pedir.	5
Precio Unitario	Precio por unidad del producto.	99.99
Moneda	Moneda del pedido.	USD
¿Fue pagado?	Indica si el pedido ya fue pagado.	True
Nota	Nota adicional del pedido.	Urge order, send today
Asignar resultado a variable	Variable donde se almacenará el resultado.	{ “products”: { “edges”: […] } }

Crea una orden en tu tienda Shopify, incluyendo producto, variante, cantidad y estado de pago.

🧪 Ejemplos de uso

• Create a Product: Publicar automáticamente un nuevo producto con descripción y etiquetas desde una planilla de carga.
• Get a Product: Consultar los detalles de un producto mediante su ID para mostrarlos en un panel de control.
• Create Order: Generar un pedido con una variante específica luego de que un cliente complete un formulario de compra.

🧩 Requisitos

1. Contar con una credencial válida de Shopify configurada en Saturn Studio.
2. Tener acceso a los IDs de producto o variantes existentes en la tienda.
3. Disponer de permisos para crear productos, variantes y órdenes en el entorno Shopify.
4. Las etiquetas deben enviarse como un arreglo y las monedas deben coincidir con las configuradas en la tienda.