Activadores de pedidos, paso a paso

Activadores de pedidos, paso a paso

Copiar página

Tutoriales paso a paso de Shopify Flow sobre etiquetas de pedidos, notas, atributos, artículos, preparación de pedidos y activadores de cambios de estado.

Shopify Flow cuenta con buenos activadores para los momentos clave de un pedido: creación, pago, preparación y cancelación. Lo que le falta es todo lo que ocurre entre medias. Estos diez activadores se activan ante las modificaciones que se producen en un pedido una vez creado, y cada uno de ellos incluye detalles sobre lo que ha cambiado.

En esta página: Actualización del pedido, Etiquetas añadidas al pedido, Etiquetas eliminadas del pedido, Nota del pedido modificada, Atributos del pedido modificados, Artículos del pedido modificados, Preparación del pedido modificada, Estado de visualización del pedido modificado, Estado financiero del pedido modificado, Dirección de envío del pedido modificada

Shopify Flow
Dónde encontrarlas: en Shopify Flow, seleccione «Seleccionar un activador», abra Workflow Trigger Extensions y busque «Pedido».

Actualización del pedido

Se activa cada vez que se actualiza un pedido. Incluye changes: los campos objeto de seguimiento que han cambiado (estado financiero, estado de preparación, etiquetas, notas, artículos, atributos personalizados) con el valor anterior y el posterior.

Incendios provocados por Webhook de Shopify y detección de cambios
Autorización Acceso a los datos de los pedidos
Encendido Al activar un flujo de trabajo de Flow que lo utilice, este se activa. Su propio interruptor se encuentra en la página Activadores de la aplicación.

Úselo para

  • Un flujo de trabajo que responde a varios tipos de modificaciones en los pedidos.
  • Un registro de cambios de los pedidos para el servicio de atención al cliente.

Lo que «Actualización de pedido» envía a su flujo de trabajo

Variable en Shopify Flow Tipo Qué contiene
order Pedido (Shopify) El pedido que se ha actualizado. Se trata de un pedido completo de Shopify, por lo que están disponibles todos sus campos y las acciones propias de Shopify Flow relacionadas con el pedido.
payload Texto Objeto JSON que contiene el GID del pedido que se ha actualizado (por ejemplo, {"id":"gid://shopify/Pedido/123"})
changes Objeto ¿Qué campos objeto de seguimiento han cambiado (situación financiera, estado de preparación, etiquetas, nota, artículos, atributos personalizados), indicando el valor anterior y el nuevo de cada uno?
changes.fields Lista de textos Nombres de los campos objeto de seguimiento que han cambiado
changes.items Lista de objetos Valor anterior y nuevo por cada campo modificado
changes.items (each).field Texto El campo que ha cambiado: financialStatus, fulfillmentStatus, etiquetas, nota, lineItems o customAttributes.
changes.items (each).oldValue Texto El valor antes de la actualización. Los valores largos se acortan.
changes.items (each).newValue Texto El valor tras la actualización. Los valores largos se acortan.
eventId Texto El identificador de este evento. Búsquelo en el «Historial de eventos» de la aplicación para ver exactamente qué se envió.

Ejemplo: Registre los cambios realizados en un pedido en el historial del mismo a través de su servicio de atención al cliente

  1. Seleccione «Actualización del pedido de recogida» como activador.
  2. Añada una condición: changes.fields no esté vacío y exista.
  3. Añada Enviar solicitud HTTP a su servicio de asistencia con {{order.name}} en el cuerpo del mensaje. Los campos de texto de Shopify Flow admiten Liquid, por lo que un bucle for sobre changes.items añade una línea por cada cambio con sus campos field, oldValue y newValue.
  4. Active el flujo de trabajo.

Se han añadido etiquetas de pedido

Se activa cuando se añade al menos una etiqueta a un pedido.

Incendios provocados por Webhook de Shopify y detección de cambios
Autorización Acceso a los datos de los pedidos
Encendido Al activar un flujo de trabajo de Flow que lo utilice, este se activa. Su propio interruptor se encuentra en la página Activadores de la aplicación.

Úselo para

  • Permita que el personal inicie un proceso añadiendo las etiquetas: gift-wrap, hold, priority.
  • Responda a las etiquetas procedentes de aplicaciones de prevención del fraude, de suscripción o de preparación de pedidos.

Qué envía la función «Etiquetas de pedido añadidas» a su flujo de trabajo

Variable en Shopify Flow Tipo Qué contiene
order Pedido (Shopify) El pedido cuyas etiquetas han cambiado. Se trata de un pedido completo de Shopify, por lo que están disponibles todos sus campos y las acciones propias de Shopify Flow relacionadas con el pedido.
addedTags Texto Lista de etiquetas, separadas por comas, que se han añadido al pedido
removedTags Texto Lista separada por comas de las etiquetas que se han eliminado del pedido en la misma actualización (puede estar vacía)
currentTags Texto Lista, separada por comas, de todas las etiquetas actuales del pedido
previousTags Texto Lista, separada por comas, de todas las etiquetas anteriores de este pedido antes de esta actualización
eventId Texto El identificador de este evento. Búsquelo en el «Historial de eventos» de la aplicación para ver exactamente qué se envió.

Ejemplo: Retener la preparación de un pedido cuando se le asigne la etiqueta «retener»

  1. Se han añadido las etiquetas de pedido como activador.
  2. Añadir una condición: addedTags incluye hold.
  3. Añada un bucle For each sobre order.fulfillmentOrders con la acción Retener pedido de preparación.
  4. Active el flujo de trabajo. Cree la imagen especular con la opción Eliminar etiquetas de pedido y Desbloquear la retención del pedido de preparación.

Se han eliminado las etiquetas de pedido

Se activa cuando se elimina al menos una etiqueta de un pedido.

Incendios provocados por Webhook de Shopify y detección de cambios
Autorización Acceso a los datos de los pedidos
Encendido Al activar un flujo de trabajo de Shopify Flow que lo utilice, este se activa. Su propio interruptor se encuentra en la página Activadores de la aplicación.

Úselo para

  • Libere lo que una etiqueta estaba frenando.
  • Cierre una tarea cuando se elimine la etiqueta needs-review.

Qué envía la función «Etiquetas de pedido eliminadas» a su flujo de trabajo

Variable en Shopify Flow Tipo Qué contiene
order Pedido (Shopify) El pedido cuyas etiquetas han cambiado. Se trata de un pedido completo de Shopify, por lo que están disponibles todos sus campos y las acciones propias de Shopify Flow relacionadas con el pedido.
removedTags Texto Lista, separada por comas, de las etiquetas que se han eliminado del pedido
addedTags Texto Lista separada por comas de las etiquetas que se añadieron al pedido en la misma actualización (puede estar vacía)
currentTags Texto Lista, separada por comas, de todas las etiquetas actuales del pedido
previousTags Texto Lista, separada por comas, de todas las etiquetas anteriores de este pedido antes de esta actualización
eventId Texto El identificador de este evento. Búsquelo en el «Historial de eventos» de la aplicación para ver exactamente qué se envió.

Ejemplo: Suelte el bloqueo cuando se retire la etiqueta

  1. Se han eliminado las etiquetas de pedido como activador.
  2. Añadir una condición: removedTags incluye hold.
  3. Añada un bucle For each sobre order.fulfillmentOrders con la opción Liberar la retención del pedido de preparación.
  4. Active el flujo de trabajo.

Se ha modificado la nota del pedido

Se activa cuando se añade, modifica o elimina un concepto de un pedido, ya sea por parte del personal o del cliente en la pantalla de pago.

Incendios provocados por Webhook de Shopify y detección de cambios
Autorización Acceso a los datos de los pedidos
Encendido Al activar un flujo de trabajo de Flow que lo utilice, este se activa. Su propio interruptor se encuentra en la página Activadores de la aplicación.

Úselo para

  • Notifique al almacén las notas añadidas tras la realización del pedido.
  • Analice las instrucciones de entrega.

Qué envía la nota «Pedido modificado» a su flujo de trabajo

Variable en Shopify Flow Tipo Qué contiene
order Pedido (Shopify) El pedido cuya nota ha cambiado. Se trata de un pedido completo de Shopify, por lo que están disponibles todos sus campos y las acciones propias de Shopify Flow relacionadas con el pedido.
oldNote Texto La nota anterior sobre el pedido (vacía si no se había establecido ninguna nota anteriormente)
newNote Texto La nueva nota del pedido (vacía si se ha borrado la nota)
eventId Texto El identificador de este evento. Búsquelo en el «Historial de eventos» de la aplicación para ver exactamente qué se envió.

Ejemplo: Notificar al almacén un retraso

  1. Se ha modificado la nota del pedido de recogida como activador.
  2. Añada una condición: order.displayFulfillmentStatus no es igual a FULFILLED.
  3. Añada Enviar correo electrónico interno: {{order.name}} note changed from "{{oldNote}}" to "{{newNote}}".
  4. Active el flujo de trabajo.

Se han modificado los atributos del pedido

Se activa cuando se añaden, eliminan o modifican los atributos personalizados de un pedido (atributos del carrito, atributos de las notas). Cada elemento de changes.items incluye un changeType, el key y ambos valores.

Incendios provocados por Webhook de Shopify y detección de cambios
Autorización Acceso a los datos de los pedidos
Encendido Al activar un flujo de trabajo de Flow que lo utilice, este se activa. Su propio interruptor se encuentra en la página Activadores de la aplicación.

Úselo para

  • Reaccione ante los atributos introducidos mediante un selector de fecha de entrega, una opción de regalo o un formulario B2B.
  • Detectar cuándo el personal corrige un atributo tras la realización del pedido.

Qué envía «Atributos del pedido modificados» a su flujo de trabajo

Variable en Shopify Flow Tipo Qué contiene
order Pedido (Shopify) El pedido cuyos atributos personalizados han cambiado. Se trata de un pedido completo de Shopify, por lo que están disponibles todos sus campos y las acciones propias de Shopify Flow relacionadas con el pedido.
changes Objeto Se han detectado cambios en los atributos. Cada elemento incluye un «changeType» (añadido, eliminado o modificado), la clave y los valores anterior y actual.
changes.items Lista de objetos Lista de cambios detectados en los atributos
changes.items (each).changeType Texto Tipo de modificación: añadido, eliminado, modificado
changes.items (each).key Texto La clave del atributo (también conocida como nombre de «note_attribute»)
changes.items (each).oldValue Texto El valor anterior (cadena vacía cuando changeType es «added»)
changes.items (each).newValue Texto El nuevo valor (cadena vacía cuando changeType es «removed»)
eventId Texto El identificador de este evento. Búsquelo en el «Historial de eventos» de la aplicación para ver exactamente qué se envió.

Ejemplo: Cómo reaccionar ante un cambio en la fecha de entrega

  1. Se ha establecido «Atributos del pedido de recogida modificados» como activador.
  2. Añada una condición: al menos uno de los elementos de changes.items tiene key igual a delivery_date.
  3. Añada Enviar correo electrónico interno. Los campos de texto de Shopify Flow admiten Liquid, por lo que un bucle for sobre changes.items muestra la key de cada entrada junto con su oldValue y newValue.
  4. Active el flujo de trabajo.

Se han modificado los artículos del pedido

Se activa cuando se modifica un pedido: al añadir o eliminar un artículo, o al cambiar la cantidad, el precio o la variante. Cada entrada de changes.items indica el tipo de cambio (added, removed, quantity_changed, price_changed, variant_changed) junto con los valores anteriores y los nuevos.

Incendios provocados por Webhook de Shopify y detección de cambios
Autorización Acceso a los datos de los pedidos
Encendido Al activar un flujo de trabajo de Flow que lo utilice, este se activa. Su propio interruptor se encuentra en la página Activadores de la aplicación.

Úselo para

  • Comunique al almacén que se ha producido un cambio en un pedido ya preparado.
  • Vuelva a ejecutar las comprobaciones de fraude o de margen tras realizar una modificación.
  • Sincronizar las modificaciones de los pedidos con un sistema ERP, algo que resulta complicado debido a los webhooks de pedidos propios de Shopify.

Lo que el artículo «Partidas de pedido modificadas» envía a su flujo de trabajo

Variable en Shopify Flow Tipo Qué contiene
order Pedido (Shopify) El pedido que se ha actualizado. Se trata de un pedido completo de Shopify, por lo que están disponibles todos sus campos y las acciones propias de Shopify Flow relacionadas con el pedido.
changes Objeto Se han detectado modificaciones en los artículos con los valores anteriores y los nuevos
changes.items Lista de objetos Lista de cambios detectados
changes.items (each).changeType Texto Tipo de modificación: añadido, eliminado, cantidad modificada, precio modificado, variante modificada
changes.items (each).lineItemId ID ID del artículo (si está disponible)
changes.items (each).productTitle Texto Título del producto
changes.items (each).variantTitle Texto Variante del título
changes.items (each).oldVariantId ID Antigua variante GID (para «removed» o «variant_changed»)
changes.items (each).newVariantId ID Nueva variante GID (para «added» o «variant_changed»)
changes.items (each).oldProductId ID GID del producto anterior (en caso de eliminación o cambio de variante)
changes.items (each).newProductId ID N.º de identificación del nuevo producto (para «añadido» o «variante modificada»)
changes.items (each).oldQuantity Número Cantidad anterior (para «quantity_changed»)
changes.items (each).newQuantity Número Nueva cantidad (para «quantity_changed»)
changes.items (each).oldPrice Texto Precio anterior (para «price_changed»)
changes.items (each).newPrice Texto Nuevo precio (para «price_changed»)
changes.items (each).lineItemData Texto Datos completos de los artículos en formato JSON
eventId Texto El identificador de este evento. Búsquelo en el «Historial de eventos» de la aplicación para ver exactamente qué se envió.

Ejemplo: Detener el almacén cuando se retira un artículo

  1. Seleccione Artículos de pedido modificados como activador.
  2. Añadir una condición: Al menos uno de los elementos de changes.items tiene changeType igual a removed.
  3. Añada las etiquetas de pedido edited-recheck y envíe un correo electrónico interno en el que se incluyan el productTitle y el variantTitle de cada entrada de changes.items (mediante un bucle Liquid for en el cuerpo del correo electrónico).
  4. Active el flujo de trabajo.

Se ha modificado la preparación de los pedidos

Incendios provocados por Webhook de Shopify y detección de cambios
Autorización Acceso a los datos de los pedidos
Encendido Al activar un flujo de trabajo de Flow que lo utilice, este se activa. Su propio interruptor se encuentra en la página Activadores de la aplicación.

Úselo para

  • Envíe su propia notificación de envío con número de seguimiento.
  • Detectar preparaciones canceladas.
  • Actualice el sistema ERP por envío, en lugar de por pedido.

Lo que «Order Fulfillment Changed» envía a su flujo de trabajo

Variable en Shopify Flow Tipo Qué contiene
order Pedido (Shopify) El pedido cuyo estado de preparación ha cambiado. Se trata de un pedido completo de Shopify, por lo que están disponibles todos sus campos y las acciones propias de Shopify Flow relacionadas con el pedido.
oldFulfillmentStatus Texto La preparación REST anterior (nulo, parcial, cumplido, repuesto)
newFulfillmentStatus Texto El nuevo estado de preparación de REST (nulo, parcial, cumplido, repuesto)
changes Objeto Se han detectado cambios en la preparación de pedidos, con los detalles correspondientes
changes.items Lista de objetos Lista de cambios detectados
changes.items (each).changeType Texto Tipo de cambio: status_changed, line_item_fulfilled, line_item_unfulfilled, tracking_updated
changes.items (each).lineItemId ID ID de partida (para artículo_fulfilled/unfulfilled)
changes.items (each).productTitle Texto Título del producto
changes.items (each).variantTitle Texto Variante del título
changes.items (each).oldFulfillmentStatus Texto Estado de preparación anterior (p. ej., nulo, parcial, cumplido, repuesto)
changes.items (each).newFulfillmentStatus Texto Nuevo estado de preparación (p. ej., nulo, parcial, cumplido, repuesto)
changes.items (each).fulfillmentId ID ID de preparación del pedido (para tracking_updated)
changes.items (each).trackingNumber Texto Número de seguimiento
changes.items (each).trackingUrl Texto URL de seguimiento
changes.items (each).trackingCompany Texto Empresa de seguimiento
eventId Texto El identificador de este evento. Búsquelo en el «Historial de eventos» de la aplicación para ver exactamente qué se envió.

Ejemplo: Reenviar los nuevos números de seguimiento

  1. Se ha cambiado la preparación del pedido de recogida como activador.
  2. Añada un bucle For each sobre changes.items.
  3. Dentro del bucle, añada una condición: que el campo trackingNumber del elemento del bucle no esté vacío y exista.
  4. Añada Enviar solicitud HTTP con {{order.name}}, así como el trackingNumber y el trackingUrl del elemento del bucle. Selecciónelos mediante Añadir variable: Shopify Flow muestra el elemento del bucle junto a los datos del activador.
  5. Active el flujo de trabajo.

Se ha modificado el estado de visualización del pedido

Se activa cuando cambia el estado de cumplimiento tal y como lo muestra el administrador: unfulfilled, in_progress, on_hold, scheduled, partially_fulfilled, fulfilled. Shopify no envía ningún webhook para estos casos, por lo que la aplicación realiza comprobaciones de forma periódica.

Incendios provocados por Se comprueba de forma periódica, ya que Shopify no envía ningún webhook para ello
Autorización Acceso a los datos de los pedidos
Encendido Al activar un flujo de trabajo de Flow que lo utilice, este se activa. Su propio interruptor se encuentra en la página Activadores de la aplicación.

Úselo para

  • Actúe cuando un servicio de preparación de pedidos o un punto de venta marque un pedido como «En curso».
  • Elevad a un nivel superior los pedidos que se encuentren en espera.

Qué envía el evento «Cambio en el estado de visualización del pedido» a su flujo de trabajo

Variable en Shopify Flow Tipo Qué contiene
order Pedido (Shopify) El pedido cuyo estado de preparación de visualización ha cambiado. Se trata de un pedido completo de Shopify, por lo que están disponibles todos sus campos y las acciones propias de Shopify Flow relacionadas con el pedido.
oldDisplayFulfillmentStatus Texto El estado anterior de preparación de la visualización (por ejemplo: «sin preparar», «en curso», «parcialmente preparado», «preparado», «en espera», «programado»)
newDisplayFulfillmentStatus Texto Los nuevos estados de preparación de los pedidos (por ejemplo: «sin preparar», «en curso», «parcialmente preparado», «preparado», «en espera», «programado»)
fulfillmentStatus Texto El estado actual de la preparación de pedidos (pendiente, parcial, completado, repuesto)
changes Objeto Cambios detectados en el estado de la pantalla, con detalles
changes.items Lista de objetos Lista de cambios detectados
changes.items (each).changeType Texto Tipo de cambio: order_status_changed, fulfillment_display_status_changed
changes.items (each).fulfillmentId ID ID de preparación (para los cambios de estado de visualización por cada gestión de preparación)
changes.items (each).oldDisplayStatus Texto Estado anterior de la pantalla
changes.items (each).newDisplayStatus Texto Nuevo estado de visualización
eventId Texto El identificador de este evento. Búsquelo en el «Historial de eventos» de la aplicación para ver exactamente qué se envió.

Ejemplo: Derivar los pedidos que quedan en espera

  1. Se ha establecido como activador el cambio de estado de visualización del pedido de preparación.
  2. Añada una condición: newDisplayFulfillmentStatus igual a on_hold.
  3. Añada «Enviar un correo electrónico interno al servicio de atención al cliente con {{order.name}}».
  4. Active el flujo de trabajo.

Se ha modificado el estado financiero del pedido

paid to partially_refunded or refunded, authorized to voided.

Incendios provocados por Webhook de Shopify y detección de cambios
Autorización Acceso a los datos de los pedidos
Encendido Al activar un flujo de trabajo de Shopify Flow que lo utilice, este se activa. Su propio interruptor se encuentra en la página Activadores de la aplicación.

Úselo para

  • Tome medidas ante las transferencias bancarias y las facturas que aparecen como pagadas días después de la realización del pedido.
  • Informe al departamento de contabilidad sobre las devoluciones.
  • No procese un pedido para su preparación hasta que se haya abonado.

Lo que el evento «Cambio en el estado financiero del pedido» envía a su flujo de trabajo

Variable en Shopify Flow Tipo Qué contiene
order Pedido (Shopify) El pedido cuya situación financiera ha cambiado. Se trata de un pedido completo de Shopify, por lo que están disponibles todos sus campos y las acciones propias de Shopify Flow relacionadas con el pedido.
oldFinancialStatus Texto El estado financiero anterior (p. ej., pendiente, autorizado, pagado)
newFinancialStatus Texto El nuevo estado financiero (p. ej., pagado, reembolsado parcialmente, reembolsado, anulado)
eventId Texto El identificador de este evento. Búsquelo en el «Historial de eventos» de la aplicación para ver exactamente qué se envió.

Ejemplo: Autorizar los pedidos B2B una vez que se haya abonado la factura

  1. Se ha seleccionado Cambio en el estado financiero del pedido como activador.
  2. Añada una condición: oldFinancialStatus sea igual a pending y newFinancialStatus sea igual a paid.
  3. Añada las etiquetas de pedido awaiting-payment y un bucle For each sobre order.fulfillmentOrders con la acción Liberar la retención del pedido de preparación.
  4. Active el flujo de trabajo.

Se ha modificado la dirección de envío del pedido

Se activa cuando cambia la dirección de envío de un pedido una vez realizado. shippingAddress es una sola línea, mientras que shippingAddressDetails son los campos individuales.

Incendios provocados por Webhook de Shopify y detección de cambios
Autorización Acceso a los datos de pedidos + Acceso a los datos de clientes
Encendido Al activar un flujo de trabajo de Flow que lo utilice, este se activa. Su propio interruptor se encuentra en la página Activadores de la aplicación.

Úselo para

  • Detenga o redirija un envío cuando la dirección cambie una vez que haya comenzado la preparación del pedido.
  • Vuelva a realizar la validación de la dirección o una comprobación de fraude.

Qué envía el evento «Se ha modificado la dirección de envío del pedido» a su flujo de trabajo

Variable en Shopify Flow Tipo Qué contiene
order Pedido (Shopify) El pedido cuya dirección de envío ha cambiado. Se trata de un pedido completo de Shopify, por lo que están disponibles todos sus campos y las acciones propias de Shopify Flow relacionadas con el pedido.
shippingAddress Texto La dirección de envío (entrega) actual del pedido, en una sola línea con el formato adecuado (puede estar vacía)
shippingAddressDetails Objeto La dirección de envío (entrega) actual del pedido, en forma de campos estructurados (puede estar vacía)
shippingAddressDetails.firstName Texto Nombre que figura en la dirección
shippingAddressDetails.lastName Texto Apellido que figura en la dirección
shippingAddressDetails.name Texto Nombre completo, calculado a partir de «nombre» y «apellidos»
shippingAddressDetails.company Texto Nombre de la empresa u organización
shippingAddressDetails.address1 Texto Primera línea: dirección postal o número de apartado de correos
shippingAddressDetails.address2 Texto Segunda línea: apartamento, suite o vivienda
shippingAddressDetails.city Texto Ciudad, distrito, pueblo o localidad
shippingAddressDetails.province Texto Región: provincia, estado o distrito
shippingAddressDetails.provinceCode Texto Código de región (por ejemplo, ON)
shippingAddressDetails.zip Texto Código postal
shippingAddressDetails.country Texto Nombre del país
shippingAddressDetails.countryCode Texto Código de país de dos letras (por ejemplo, US)
shippingAddressDetails.phone Texto Número de teléfono que figura en la dirección
eventId Texto El identificador de este evento. Búsquelo en el «Historial de eventos» de la aplicación para ver exactamente qué se envió.

Ejemplo: Retener un pedido cuya dirección haya cambiado

  1. Se ha modificado la dirección de envío del pedido de recogida en Flow. Requiere acceso a los datos del pedido y del cliente; cuando se activa desde la página «Activadores», la aplicación solicita ambos datos en un único cuadro de diálogo.
  2. Añada una condición: order.displayFulfillmentStatus no es igual a FULFILLED.
  3. Añada las etiquetas de pedido address-changed y envíe un correo electrónico interno al almacén.
  4. Active el flujo de trabajo.

Próximos pasos

De forma predeterminada, la aplicación supervisa los pedidos de los últimos 60 días, que es el periodo que permite Shopify. Para responder a las modificaciones realizadas en pedidos más antiguos, amplíe el historial de pedidos en la página «Permisos». Consulte Permisos y acceso a los datos.