Valores antiguos y nuevos: cómo puede aprovecharlos un flujo de trabajo

Valores antiguos y nuevos: cómo puede aprovecharlos un flujo de trabajo

Copiar página

Shopify Flow

Los propios activadores actualizados de Flow transfieren al flujo de trabajo el registro tal y como está en ese momento. Las páginas de ayuda de Shopify lo dejan claro para cada uno de ellos: solo están disponibles los valores actuales; los valores anteriores al cambio no lo están. Para una alerta que indique que algo ha cambiado, eso es suficiente.

Muchos flujos de trabajo requieren más información que esa. «El precio ha bajado más de un 10 %» necesita el precio anterior. «El identificador ha cambiado, redirija la URL anterior» necesita el identificador anterior. «El cliente se ha dado de baja» necesita saber que estaba suscrito anteriormente. Cada activador de cambio de esta aplicación incluye ambos valores, por lo que estos flujos de trabajo consisten en una condición y una acción, sin código y sin necesidad de almacenar nada manualmente.

De dónde procede el valor anterior

La aplicación recuerda el último valor conocido de los campos que supervisa, por cada registro. Cuando Shopify notifica una actualización, la compara y, si un campo supervisado presenta alguna diferencia, activa el activador con ambos valores. En la práctica, hay dos detalles que son importantes:

  • La primera vez que la aplicación detecta un registro, simplemente lo memoriza. No se activa ninguna acción, ya que no hay nada con lo que compararlo. Cuando activa un activador, la aplicación lee los registros existentes una vez en segundo plano, de modo que el primer cambio real ya activa la acción correspondiente. En el caso de los pedidos, lee los últimos 60 días de forma predeterminada, y puede ampliar ese intervalo desde la aplicación.
  • Los valores corresponden al momento en que se produjo el cambio. Un flujo de trabajo activado por un activador de Flow lee el registro cuando se ejecuta dicho flujo de trabajo. Si el registro vuelve a cambiar un segundo después, o se elimina, ese flujo de trabajo detectará el estado más reciente o no podrá cargar el registro. Un evento de esta aplicación conserva los valores con los que se creó. Puede consultarlos más tarde en el «Historial de eventos» de la aplicación.
Se ha creado un evento en el «Historial de eventos», marcado como «Éxito», con el precio anterior y el nuevo.
Un evento, disponible en el «Historial de eventos» de la aplicación: el precio antes y después del cambio.

Lo que solo se puede construir con el valor anterior

Flujo de trabajo Activador La condición que requiere el valor anterior Listo para usar
Redirigir la URL anterior cuando se cambie el nombre de un producto o una colección Se ha modificado el nombre del producto; se ha modificado el nombre de la colección ninguna: la redirección se realiza desde oldHandle a newHandle Redirigir las URL antiguas de los productos cuando cambie el identificador de un producto, Redirigir las antiguas URL de las colecciones cuando cambie el identificador de una colección
Etiquete los productos cuyo precio haya bajado un 10 % o más Se ha modificado el precio de una variante de producto priceChange.percentChange es menor o igual que -10 Marque los productos cuando el precio de una variante baje un 10 % o más
Marque un producto como en oferta y vuelva a quitarle la etiqueta de oferta Se ha modificado el precio de una variante de producto priceChange.oldCompareAtPrice.amount está vacío y priceChange.newCompareAtPrice.amount no lo está, o al revés Añade etiquetas a los productos como «en oferta» cuando se añada un precio de comparación, Retire la etiqueta de rebaja cuando se elimine el precio de comparación.
Autorice un pedido cuando se reciba un pago pendiente Se ha modificado el estado financiero del pedido oldFinancialStatus es igual a pending y newFinancialStatus es igual a paid Marcar los pedidos cuando se reciba un pago pendiente
Avise al almacén cuando cambie la dirección tras la pantalla de pago Se ha modificado la dirección de envío del pedido ninguna: el mensaje muestra oldShippingAddress y shippingAddress Etiquetar los pedidos cuando cambie la dirección de envío tras la pantalla de pago
Etiquete a los clientes que se den de baja y elimine la etiqueta cuando vuelvan Se ha modificado el consentimiento de los clientes para el marketing por correo electrónico consentState es igual a unsubscribed; oldConsentState le indica cuál era su valor anterior Etiquete a los clientes cuando se den de baja de las campañas de marketing por correo electrónico
Conserve el SKU anterior para su ERP o su feed Se ha modificado el SKU de la variante de producto ninguno: se escribe skuChange.oldSku en un metacampo Guarde el SKU anterior cuando cambie el SKU de una variante
Revise el margen cuando aumente un coste Se ha modificado el coste de una variante de producto variantCostChange.percentChange mayor que 5 Marque los productos para una revisión de los márgenes cuando aumente el coste de una variante de producto
Coloca una etiqueta en un producto como «stock bajo» una sola vez, cuando supere el límite Se ha modificado el nivel del inventario en la ubicación inventoryLevel.oldAvailable es mayor o igual que 5 y inventoryLevel.newAvailable es menor que 5 Marca los productos como «inventario bajo» cuando el inventario sea inferior a cinco unidades

Otros tres que los comerciantes construyen ellos mismos:

  • Indique la dirección anterior cuando cambie el correo electrónico de un cliente. La notificación «Se ha cambiado el correo electrónico del cliente» incluye oldEmail y email. Envíe la notificación a oldEmail mediante una acción de correo electrónico que admita una variable como destinatario, por ejemplo, Workflow Transactional Email. Sin la dirección anterior, no queda nadie a quien avisar.
  • Reaccione ante un paso en un estado personalizado. Un metacampo loyalty.tier pasa de silver a gold: la actualización del metacampo del cliente incluye metafield.previousValue y metafield.value, por lo que el flujo de trabajo puede felicitar por la mejora y no hacer nada en caso de un descenso de categoría.
  • Actúe sobre una etiqueta eliminada. Una vez eliminada una etiqueta, el registro se muestra como si nunca la hubiera tenido. Las etiquetas «Orden», «Cliente», «Producto» y «Pedido preliminar» indican las etiquetas que se han eliminado. Consulte Ejecutar un flujo de trabajo cuando se añada o se elimine una etiqueta concreta.

Todos los valores anteriores y posteriores, por activador

Pedidos

Activador Antes y después
Etiquetas de pedido añadidas, etiquetas de pedido eliminadas addedTags, removedTags, previousTags, currentTags
Se ha modificado la nota del pedido oldNote, newNote
Se ha modificado el estado financiero del pedido oldFinancialStatus, newFinancialStatus
Se ha modificado la preparación de pedidos oldFulfillmentStatus y newFulfillmentStatus, así como por línea o envío en changes.items: «preparado», «pendiente de preparar», «seguimiento actualizado con número, URL y empresa»
Se ha modificado el estado de visualización del pedido oldDisplayFulfillmentStatus, newDisplayFulfillmentStatus
Se han modificado los atributos del pedido changes.items, con changeType, key, oldValue y newValue
Se han modificado los artículos del pedido changes.items, con changeType (añadido, eliminado, cambio en la cantidad, el precio o la variante) y la cantidad, el precio y la variante anteriores y actuales
Se ha modificado la dirección de envío del pedido shippingAddress y oldShippingAddress, ambos también como campos independientes
Pedido de actualización de metacampos metafield.value, metafield.previousValue
Actualización del pedido changes.fields y changes.items con field, oldValue y newValue para el estado financiero, el estado de preparación, las etiquetas, las notas, los artículos y los atributos personalizados

Clientes

Activador Antes y después
Etiquetas de clientes añadidas, etiquetas de clientes eliminadas addedTags, removedTags, previousTags, currentTags
Se ha modificado la nota del cliente oldNote, newNote
Se ha modificado el estado del cliente oldState, newState
Se ha modificado el nombre del cliente firstName, lastName, oldFirstName, oldLastName
Se ha modificado la dirección de correo electrónico del cliente email, oldEmail
Se ha modificado el número de teléfono del cliente phone, oldPhone
Se ha modificado la dirección del cliente address y oldAddress, cada uno de ellos también como campos independientes
Se ha modificado el consentimiento para el marketing por correo electrónico de los clientes; se ha modificado el consentimiento para el marketing por SMS de los clientes consentState, optInLevel, oldConsentState, oldOptInLevel
Actualización de los metacampos de los clientes metafield.value, metafield.previousValue
Información para los clientes changes.fields y changes.items para etiquetas, notas y estado

Productos y variantes

Activador Antes y después
Etiquetas de producto añadidas, etiquetas de producto eliminadas addedTags, removedTags, previousTags, currentTags
Se han modificado el título del producto, el identificador, la descripción, el estado, el proveedor y el tipo el valor antiguo y el nuevo, por ejemplo, oldTitle y newTitle
Producto publicado en el canal, producto retirado del canal channels.added, channels.removed, channels.current
Se ha modificado el precio de una variante de producto priceChange.oldPrice, newPrice, oldCompareAtPrice, newCompareAtPrice, delta, percentChange, direction
Se ha modificado el precio unitario de una variante de producto unitPriceChange.oldUnitPrice, newUnitPrice, delta, percentChange, direction
Se ha modificado el coste de una variante de producto variantCostChange.oldCost, newCost, delta, percentChange, direction
Se ha modificado el SKU de la variante de producto skuChange.oldSku, newSku
Se ha modificado el código de barras de una variante de producto barcodeChange.oldBarcode, newBarcode, las listas de códigos de barras antiguos y nuevos, added, removed
Actualización de metacampos de productos, actualización de metacampos de variantes de productos metafield.value, metafield.previousValue
Actualización del producto changes.fields y changes.items para el título, el identificador, la descripción, el estado, el proveedor, el tipo de producto y las etiquetas; y, por variante, para el precio, el precio de comparación, el SKU, el código de barras, la política de inventario, la tributación, el título, las opciones y la imagen

Existencias, colecciones, ubicaciones y mucho más

Activador Antes y después
Variación del nivel de inventario, agotamiento del inventario y reposición del inventario en la ubicación inventoryLevel.oldAvailable``newAvailable``delta``percentChange``direction, junto con la ubicación
Se han modificado el título, el identificador y la descripción de la colección el valor anterior y el nuevo
Actualización de la ubicación, Actualización de la empresa, Actualización de la ubicación de la empresa, Actualización del descuento, Actualización del blog, Actualización de una entrada del blog, Actualización de una página changes.fields y changes.items del registro, siempre
Actualización de la colección, actualización del pedido preliminar, actualización del mercado la misma lista de changes, cuando la opción Enviar valores antiguos y nuevos está activada
Los diez activadores del pedido preliminar el mismo esquema que los pedidos: etiquetas, notas, atributos, artículos, estado, correo electrónico y direcciones
Actualización de metacampos para 15 tipos de registros metafield.value, metafield.previousValue

Referencia completa sobre los activadores muestra todos los activadores con todos sus campos.

Las cifras ya vienen con las operaciones aritméticas realizadas

Las condiciones de Flow se comparan, no se calculan, y los importes monetarios se introducen en Flow como texto. Por lo tanto, la expresión «ha bajado más de un 10 %» no puede calcularse dentro de un flujo de trabajo a partir de dos precios. Por ello, los activadores de «precio», «precio unitario», «coste» y «stock» envían el resultado en forma de números:

Campo Significado Ejemplo
delta nuevo valor menos valor anterior -5
percentChange la variación expresada como porcentaje del valor anterior -12.5 significa que ha bajado un 12,5 por ciento
direction increase, decrease o unchanged decrease
Selector de variables de Shopify Flow para el precio de una variante de producto, con los campos «precio anterior», «nuevo precio», «diferencia», «variación porcentual» y «dirección»
Las variables «Precio de la variante de producto» han cambiado en el selector de Shopify Flow.
Condición de Shopify Flow: priceChange.percentChange es inferior a -10
Una condición sobre el porcentaje que ha calculado la aplicación. No es necesario realizar ningún paso de programación.
¿Shopify Flow proporciona el valor anterior de un campo?

No con sus propios activadores actualizados. Las páginas de ayuda de Shopify sobre los activadores «Producto actualizado», «Pedido actualizado», «Cliente actualizado» y los demás activadores de actualización indican que, en el flujo de trabajo, solo están disponibles los valores actuales. Los activadores de esta aplicación envían el valor anterior y el posterior.

¿Puedo calcular el valor anterior dentro de Shopify Flow?

Solo si lo ha almacenado usted mismo antes del cambio, por ejemplo, copiando un valor en un metacampo mediante otro flujo de trabajo y volviéndolo a leer. Esa copia debe existir antes del primer cambio y mantenerse al día en cada registro. La aplicación se encarga de este seguimiento para los campos que supervisa.

¿Se puede consultar el valor anterior en los metacampos?

Sí. Cada activador de metacampo de esta aplicación incluye metafield.previousValue junto a metafield.value, para 15 tipos de registros. Consulte Cambios en los metacampos de Shopify Flow: los activadores actualizados y los activadores de metacampos.

¿Por qué no se activó nada al producirse el primer cambio de disco?

La aplicación necesita un punto de partida. Cuando se activa un activador, lee sus registros existentes una vez en segundo plano. Solo se tiene en cuenta cualquier cambio realizado antes de que dicha lectura llegara al registro. El siguiente cambio se activa. Historial de eventos y resolución de problemas muestra el estado de dicha sincronización.

Próximos pasos