Shopify

Gestiona productos, pedidos, clientes e inventario en tu tienda Shopify

Shopify es una plataforma líder de comercio electrónico diseñada para ayudar a los comerciantes a construir, administrar y hacer crecer sus tiendas en línea. Shopify facilita la gestión de todos los aspectos de tu tienda, desde productos e inventario hasta pedidos y clientes.

Con Shopify en Cadense, tus agentes pueden:

Crear y gestionar productos: Añadir nuevos productos, actualizar detalles de productos y eliminar productos de tu tienda.
Listar y recuperar pedidos: Obtener información sobre los pedidos de los clientes, incluyendo filtrado y gestión de pedidos.
Gestionar clientes: Acceder y actualizar detalles de clientes, o añadir nuevos clientes a tu tienda.
Ajustar niveles de inventario: Cambiar programáticamente los niveles de stock de productos para mantener tu inventario preciso.

Utiliza la integración de Shopify en Cadense para automatizar flujos de trabajo comunes de gestión de tiendas, como sincronizar inventario, cumplir pedidos o gestionar listados, directamente desde tus automatizaciones. Permite a tus agentes acceder, actualizar y organizar todos los datos de tu tienda utilizando herramientas simples y programáticas.

Instrucciones de uso

Integra Shopify en tu flujo de trabajo. Gestiona productos, pedidos, clientes e inventario. Crea, lee, actualiza y elimina productos. Lista y gestiona pedidos. Maneja datos de clientes y ajusta niveles de inventario.

Herramientas

`shopify_create_product`

Crear un nuevo producto en tu tienda Shopify

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`shopDomain`	string	Sí	El dominio de tu tienda Shopify (ej., mitienda.myshopify.com)
`title`	string	Sí	Título del producto
`descriptionHtml`	string	No	Descripción del producto (HTML)
`vendor`	string	No	Proveedor/marca del producto
`productType`	string	No	Tipo/categoría del producto
`tags`	array	No	Etiquetas del producto
`status`	string	No	Estado del producto (ACTIVE, DRAFT, ARCHIVED)

Salida

Parámetro	Tipo	Descripción
`product`	object	El producto creado

`shopify_get_product`

Obtener un solo producto por ID de tu tienda Shopify

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`shopDomain`	string	Sí	El dominio de tu tienda Shopify (p. ej., mitienda.myshopify.com)
`productId`	string	Sí	ID del producto (gid://shopify/Product/123456789)

Salida

Parámetro	Tipo	Descripción
`product`	object	Los detalles del producto

`shopify_list_products`

Listar productos de tu tienda Shopify con filtrado opcional

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`shopDomain`	string	Sí	El dominio de tu tienda Shopify (p. ej., mitienda.myshopify.com)
`first`	number	No	Número de productos a devolver (predeterminado: 50, máximo: 250)
`query`	string	No	Consulta de búsqueda para filtrar productos (p. ej., "title:camisa" o "vendor:Nike" o "status:active")

Salida

Parámetro	Tipo	Descripción
`products`	array	Lista de productos
`pageInfo`	object	Información de paginación

`shopify_update_product`

Actualizar un producto existente en tu tienda Shopify

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`shopDomain`	string	Sí	El dominio de tu tienda Shopify (p. ej., mitienda.myshopify.com)
`productId`	string	Sí	ID del producto a actualizar (gid://shopify/Product/123456789)
`title`	string	No	Nuevo título del producto
`descriptionHtml`	string	No	Nueva descripción del producto (HTML)
`vendor`	string	No	Nuevo proveedor/marca del producto
`productType`	string	No	Nuevo tipo/categoría del producto
`tags`	array	No	Nuevas etiquetas del producto
`status`	string	No	Nuevo estado del producto (ACTIVE, DRAFT, ARCHIVED)

Salida

Parámetro	Tipo	Descripción
`product`	objeto	El producto actualizado

`shopify_delete_product`

Eliminar un producto de tu tienda Shopify

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`shopDomain`	string	Sí	El dominio de tu tienda Shopify (p. ej., mitienda.myshopify.com)
`productId`	string	Sí	ID del producto a eliminar (gid://shopify/Product/123456789)

Salida

Parámetro	Tipo	Descripción
`deletedId`	string	El ID del producto eliminado

`shopify_get_order`

Obtener un pedido individual por ID de tu tienda Shopify

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`shopDomain`	string	Sí	El dominio de tu tienda Shopify (p. ej., mitienda.myshopify.com)
`orderId`	string	Sí	ID del pedido (gid://shopify/Order/123456789)

Salida

Parámetro	Tipo	Descripción
`order`	objeto	Los detalles del pedido

`shopify_list_orders`

Listar pedidos de tu tienda Shopify con filtrado opcional

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`shopDomain`	string	Sí	El dominio de tu tienda Shopify (p. ej., mitienda.myshopify.com)
`first`	number	No	Número de pedidos a devolver (predeterminado: 50, máximo: 250)
`status`	string	No	Filtrar por estado del pedido (abierto, cerrado, cancelado, cualquiera)
`query`	string	No	Consulta de búsqueda para filtrar pedidos (p. ej., "financial_status:paid" o "fulfillment_status:unfulfilled" o "email:[email protected]")

Salida

Parámetro	Tipo	Descripción
`orders`	array	Lista de pedidos
`pageInfo`	object	Información de paginación

`shopify_update_order`

Actualizar un pedido existente en tu tienda Shopify (nota, etiquetas, correo electrónico)

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`shopDomain`	string	Sí	El dominio de tu tienda Shopify (p. ej., mitienda.myshopify.com)
`orderId`	string	Sí	ID del pedido a actualizar (gid://shopify/Order/123456789)
`note`	string	No	Nueva nota del pedido
`tags`	array	No	Nuevas etiquetas del pedido
`email`	string	No	Nuevo correo electrónico del cliente para el pedido

Salida

Parámetro	Tipo	Descripción
`order`	object	El pedido actualizado

`shopify_cancel_order`

Cancelar un pedido en tu tienda Shopify

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`shopDomain`	string	Sí	El dominio de tu tienda Shopify (p. ej., mitienda.myshopify.com)
`orderId`	string	Sí	ID del pedido a cancelar (gid://shopify/Order/123456789)
`reason`	string	Sí	Motivo de cancelación (CUSTOMER, DECLINED, FRAUD, INVENTORY, STAFF, OTHER)
`notifyCustomer`	boolean	No	Si se debe notificar al cliente sobre la cancelación
`refund`	boolean	No	Si se debe reembolsar el pedido
`restock`	boolean	No	Si se debe reponer el inventario
`staffNote`	string	No	Una nota sobre la cancelación para referencia del personal

Salida

Parámetro	Tipo	Descripción
`order`	object	El resultado de la cancelación

`shopify_create_customer`

Crear un nuevo cliente en tu tienda Shopify

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`shopDomain`	string	Sí	El dominio de tu tienda Shopify (p. ej., mitienda.myshopify.com)
`email`	string	No	Dirección de correo electrónico del cliente
`firstName`	string	No	Nombre del cliente
`lastName`	string	No	Apellido del cliente
`phone`	string	No	Número de teléfono del cliente
`note`	string	No	Nota sobre el cliente
`tags`	array	No	Etiquetas del cliente
`addresses`	array	No	Direcciones del cliente

Salida

Parámetro	Tipo	Descripción
`customer`	object	El cliente creado

`shopify_get_customer`

Obtener un solo cliente por ID de tu tienda Shopify

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`shopDomain`	string	Sí	El dominio de tu tienda Shopify (p. ej., mitienda.myshopify.com)
`customerId`	string	Sí	ID del cliente (gid://shopify/Customer/123456789)

Salida

Parámetro	Tipo	Descripción
`customer`	object	Los detalles del cliente

`shopify_list_customers`

Lista los clientes de tu tienda Shopify con filtrado opcional

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`shopDomain`	string	Sí	El dominio de tu tienda Shopify (ej., mitienda.myshopify.com)
`first`	number	No	Número de clientes a devolver (predeterminado: 50, máximo: 250)
`query`	string	No	Consulta de búsqueda para filtrar clientes (ej., "first_name:John" o "last_name:Smith" o "email:*@gmail.com" o "tag:vip")

Salida

Parámetro	Tipo	Descripción
`customers`	array	Lista de clientes
`pageInfo`	object	Información de paginación

`shopify_update_customer`

Actualiza un cliente existente en tu tienda Shopify

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`shopDomain`	string	Sí	El dominio de tu tienda Shopify (ej., mitienda.myshopify.com)
`customerId`	string	Sí	ID del cliente a actualizar (gid://shopify/Customer/123456789)
`email`	string	No	Nueva dirección de correo electrónico del cliente
`firstName`	string	No	Nuevo nombre del cliente
`lastName`	string	No	Nuevo apellido del cliente
`phone`	string	No	Nuevo número de teléfono del cliente
`note`	string	No	Nueva nota sobre el cliente
`tags`	array	No	Nuevas etiquetas del cliente

Salida

Parámetro	Tipo	Descripción
`customer`	object	El cliente actualizado

`shopify_delete_customer`

Eliminar un cliente de tu tienda Shopify

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`shopDomain`	string	Sí	El dominio de tu tienda Shopify (ej., mitienda.myshopify.com)
`customerId`	string	Sí	ID del cliente a eliminar (gid://shopify/Customer/123456789)

Salida

Parámetro	Tipo	Descripción
`deletedId`	string	El ID del cliente eliminado

`shopify_list_inventory_items`

Listar artículos de inventario de tu tienda Shopify. Utiliza esto para encontrar IDs de artículos de inventario por SKU.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`shopDomain`	string	Sí	El dominio de tu tienda Shopify (ej., mitienda.myshopify.com)
`first`	number	No	Número de artículos de inventario a devolver (predeterminado: 50, máximo: 250)
`query`	string	No	Consulta de búsqueda para filtrar artículos de inventario (ej., "sku:ABC123")

Salida

Parámetro	Tipo	Descripción
`inventoryItems`	array	Lista de artículos de inventario con sus IDs, SKUs y niveles de stock
`pageInfo`	object	Información de paginación

`shopify_get_inventory_level`

Obtener nivel de inventario para una variante de producto en una ubicación específica

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`shopDomain`	string	Sí	El dominio de tu tienda Shopify (ej., mitienda.myshopify.com)
`inventoryItemId`	string	Sí	ID del artículo de inventario (gid://shopify/InventoryItem/123456789)
`locationId`	string	No	ID de ubicación para filtrar (opcional)

Salida

Parámetro	Tipo	Descripción
`inventoryLevel`	object	Los detalles del nivel de inventario

`shopify_adjust_inventory`

Ajustar la cantidad de inventario para una variante de producto en una ubicación específica

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`shopDomain`	string	Sí	El dominio de tu tienda Shopify (p. ej., mitienda.myshopify.com)
`inventoryItemId`	string	Sí	ID del artículo de inventario (gid://shopify/InventoryItem/123456789)
`locationId`	string	Sí	ID de ubicación (gid://shopify/Location/123456789)
`delta`	number	Sí	Cantidad a ajustar (positivo para aumentar, negativo para disminuir)

Salida

Parámetro	Tipo	Descripción
`inventoryLevel`	object	El resultado del ajuste de inventario

`shopify_list_locations`

Listar ubicaciones de inventario de tu tienda Shopify. Utiliza esto para encontrar los IDs de ubicación necesarios para operaciones de inventario.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`shopDomain`	string	Sí	El dominio de tu tienda Shopify (p. ej., mitienda.myshopify.com)
`first`	number	No	Número de ubicaciones a devolver (predeterminado: 50, máximo: 250)
`includeInactive`	boolean	No	Si se deben incluir ubicaciones desactivadas (predeterminado: false)

Salida

Parámetro	Tipo	Descripción
`locations`	array	Lista de ubicaciones con sus IDs, nombres y direcciones
`pageInfo`	object	Información de paginación

`shopify_create_fulfillment`

Crea un envío para marcar los artículos del pedido como enviados. Requiere un ID de orden de envío (obtén esto desde los detalles del pedido).

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`shopDomain`	string	Sí	El dominio de tu tienda Shopify (ej., mitienda.myshopify.com)
`fulfillmentOrderId`	string	Sí	El ID de la orden de envío (ej., gid://shopify/FulfillmentOrder/123456789)
`trackingNumber`	string	No	Número de seguimiento para el envío
`trackingCompany`	string	No	Nombre del transportista (ej., UPS, FedEx, USPS, DHL)
`trackingUrl`	string	No	URL para rastrear el envío
`notifyCustomer`	boolean	No	Si se debe enviar un correo electrónico de confirmación de envío al cliente (predeterminado: true)

Salida

Parámetro	Tipo	Descripción
`fulfillment`	object	El envío creado con información de seguimiento y artículos enviados

`shopify_list_collections`

Lista las colecciones de productos de tu tienda Shopify. Filtra por título, tipo (personalizada/inteligente) o identificador.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`shopDomain`	string	Sí	El dominio de tu tienda Shopify (ej., mitienda.myshopify.com)
`first`	number	No	Número de colecciones a devolver (predeterminado: 50, máx: 250)
`query`	string	No	Consulta de búsqueda para filtrar colecciones (ej., "title:Verano" o "collection_type:smart")

Salida

Parámetro	Tipo	Descripción
`collections`	array	Lista de colecciones con sus IDs, títulos y recuentos de productos
`pageInfo`	object	Información de paginación

`shopify_get_collection`

Obtén una colección específica por ID, incluyendo sus productos. Usa esto para recuperar productos dentro de una colección.

Entrada

Parámetro	Tipo	Obligatorio	Descripción
`shopDomain`	string	Sí	El dominio de tu tienda Shopify (p. ej., mitienda.myshopify.com)
`collectionId`	string	Sí	El ID de la colección (p. ej., gid://shopify/Collection/123456789)
`productsFirst`	number	No	Número de productos a devolver de esta colección (predeterminado: 50, máx: 250)

Salida

Parámetro	Tipo	Descripción
`collection`	object	Los detalles de la colección incluyendo sus productos