Shopify

Shopify conecta tu flujo con tu tienda Shopify. Con un mismo componente puedes consultar productos, pedidos, clientes, transacciones y envíos; dar de alta productos, pedidos y clientes; modificarlos o borrarlos; y marcar un pedido como enviado con su número de seguimiento.

Eliges qué hacer con dos campos: Operation (la acción) y Entity (sobre qué). El componente muestra solo los campos que necesita esa combinación.

Cuándo usarlo

• Preparar cada mañana un resumen de los pedidos del día anterior.
• Dar de alta en la tienda los productos que llegan en el catálogo de un proveedor.
• Actualizar los datos de un cliente cuando los cambia en otra herramienta.
• Marcar un pedido como enviado y avisar al cliente con el número de seguimiento.
• Dar a un agente de atención al cliente acceso a los pedidos para que responda dónde está un envío.

Configuración

El componente necesita una credencial Shopify API con la dirección de tu tienda, el identificador y la clave secreta de la aplicación de Shopify y la versión de la API. Ver Credenciales.

Campo	Qué hace
Credential (obligatorio)	La credencial de tu tienda Shopify.
Operation	La acción: Get (consultar), Create (crear), Update (actualizar) o Delete (borrar). Por defecto, Get.
Entity	Sobre qué se actúa: Product (producto), Order (pedido), Customer (cliente), Transaction (transacción de pago) o Fulfillment (envío). Por defecto, Product.
Entity ID	El identificador del elemento en Shopify. No aparece al crear. Es obligatorio para actualizar y borrar. Para Transaction y Fulfillment, es el identificador del pedido.

Qué puedes hacer con cada entidad

Entidad	Get	Create	Update	Delete
Product	Sí	Sí	Sí	Sí
Order	Sí	Sí	Sí	Sí
Customer	Sí	Sí	Sí	Sí
Transaction	Sí, las de un pedido	No	No	No
Fulfillment	Sí, los de un pedido	Sí: marca como enviados los artículos pendientes del pedido	No	No

Consultar (Get)

Campo	Qué hace
Entity ID	Si lo rellenas, se consulta solo ese elemento. Si lo dejas vacío, se devuelve una lista.
Search	Opcional. Un texto para filtrar la lista: solo aparecen los elementos que lo contienen.
Limit	Opción avanzada. Cuántos elementos devuelve la lista como máximo. Por defecto, 10.
Order By	Opción avanzada. El campo por el que se ordena la lista. Antepón un guion para el orden inverso, por ejemplo -created_at. Por defecto, created_at (fecha de creación).

Crear o actualizar un producto

Campo	Qué hace
Product Title	El nombre del producto. Obligatorio al crear.
Include Additional Fields	Opción avanzada. Actívala para añadir más datos del producto.
Additional Fields	Qué datos adicionales quieres rellenar. Cada uno muestra su propio campo: Body HTML (descripción, admite formato), Product Type (tipo), Vendor (fabricante), Tags (etiquetas), Image (imagen), Price (precio), Handle (dirección del producto en la tienda), Options (opciones como talla o color), Published At, Published Scope y Template Suffix.

Con Options indicas cuántas opciones tiene el producto y, para cada una, su nombre (Option Name) y sus valores separados por comas (Option Value). Shopify crea una variante por cada combinación. En Product Price puedes dar un precio para todas las variantes o uno por variante, separados por comas.

Crear o actualizar un pedido

Campo	Qué hace
Customer ID	El cliente del pedido. Obligatorio al crear.
Number of Line Items	Cuántas líneas tiene el pedido. Para cada una aparecen Product ID, Variant ID, Quantity y Grams. Por defecto, 1.
Include Additional Fields	Opción avanzada. Actívala para añadir más datos del pedido.
Select Additional Fields	Qué datos adicionales quieres rellenar: Billing Address (dirección de facturación), Discount Codes (códigos de descuento), Email, Fulfillment Status (estado del envío), Inventory Behavior (cómo afecta al inventario), Note (nota), Send Fulfillment Receipt y Send Receipt (enviar confirmaciones al cliente), Shipping Address (dirección de envío), Source Name (origen del pedido), Tags (etiquetas) y Test (pedido de prueba).

Crear o actualizar un cliente

First Name, Last Name, Customer Email, Customer Phone, Customer Tags (etiquetas separadas por comas) y Customer Note. Al crear, rellena al menos uno.

Registrar un envío (Create con Fulfillment)

Campo	Qué hace
Entity ID	El identificador del pedido que se envía.
Tracking Number	Opcional. El número de seguimiento del envío.
Tracking Company	Opcional. La empresa de transporte.
Notify Customer	Envía al cliente el aviso de envío de Shopify. Por defecto, desactivado.

Resultado

La salida Result entrega lo que devuelve Shopify: los elementos consultados, o el elemento creado o actualizado con todos sus datos. Al borrar, entrega un mensaje de confirmación. Si el elemento pedido no existe, no devuelve nada.

Conéctala a un agente, a Parse Data o a una hoja de cálculo. El componente también puede usarse como herramienta de un agente, que decide qué consultar o modificar según la conversación.

Ejemplo

Una tienda quiere avisar a sus clientes cuando sale su pedido:

1. El almacén registra en una hoja de cálculo el pedido y el número de seguimiento de cada envío.
2. Añade Shopify, elige Create en Operation y Fulfillment en Entity.
3. Conecta el identificador del pedido a Entity ID y el número a Tracking Number, escribe la empresa de transporte en Tracking Company y activa Notify Customer.
4. Shopify marca el pedido como enviado y el cliente recibe el aviso con su número de seguimiento.

Buenas prácticas

• Prueba las operaciones que crean, cambian o borran con un producto o un cliente de prueba antes de usarlas con datos reales.
• Borrar en Shopify no se puede deshacer desde NappAI.

Componentes relacionados

• Shopify Webhook: pone en marcha el flujo cuando ocurre algo en tu tienda Shopify.
• WooCommerce: la misma idea para tiendas WooCommerce.