Devolución actualizada
El activador Devolución actualizada inicia un flujo de trabajo cuando cambian uno o más campos de una devolución, de sus líneas de artículo o de sus pedidos para revertir la preparación de pedidos en la tienda. Eliges los campos de la devolución que te interesan y el flujo de trabajo solo se ejecuta cuando cambia alguno de ellos, por ejemplo, cuando cambia el estado de la devolución o se agrega un cargo por reposición.
Para iniciar un flujo de trabajo cuando una devolución llega a una etapa específica, también puedes usar un activador para esa etapa, como Devolución solicitada, Devolución aprobada o Devolución cerrada.
En esta página
Campos disponibles para supervisar
El activador Devolución actualizada requiere que selecciones al menos un campo para monitorear. Puedes seleccionar hasta cinco campos. Cuando cambia cualquiera de los campos seleccionados, se ejecuta el flujo de trabajo. Los cambios en los campos que no seleccionaste no inician el flujo de trabajo.
Consulta la siguiente tabla para obtener más información sobre los campos que puedes monitorear.
| Tipo de campo | Campos |
|---|---|
| Devolución | closedAt, decline, requestApprovedAt, status |
| Líneas de artículo de la devolución | returnLineItems.quantity, returnLineItems.refundableQuantity, returnLineItems.refundedQuantity, returnLineItems.restockingFee, returnLineItems.restockingFee.amountSet, returnLineItems.restockingFee.amountSet.presentmentMoney, returnLineItems.restockingFee.amountSet.shopMoney, returnLineItems.restockingFee.percentage, returnLineItems.unprocessedQuantity |
| Líneas de artículo de cambio | exchangeLineItems |
| Cargos de envío por devolución | returnShippingFees, returnShippingFees.amountSet, returnShippingFees.amountSet.presentmentMoney, returnShippingFees.amountSet.shopMoney |
| Pedidos para revertir la preparación de pedidos | reverseFulfillmentOrders, reverseFulfillmentOrders.lineItems, reverseFulfillmentOrders.status |
Un campo cuyo nombre termina en amountSet contiene un monto en dos monedas. Si monitoreas ese campo, cualquier cambio en uno de los dos montos inicia el flujo de trabajo. Para monitorear solo uno de los montos, selecciona el subcampo shopMoney para el monto en la moneda de la tienda, o el subcampo presentmentMoney para el monto en la moneda del cliente.
Algunos campos también inician el flujo de trabajo cuando se agrega o se elimina un artículo en la devolución:
- Si supervisas un campo del grupo Líneas de artículo de la devolución, el flujo de trabajo se inicia cuando se agrega o se elimina una línea de artículo de la devolución.
- Si supervisas un campo de cargo por reposición, como
returnLineItems.restockingFee.percentage, el flujo de trabajo se inicia cuando se agrega un cargo por reposición a una línea de artículo o se elimina de ella. - Si monitoreas el campo
exchangeLineItems, el flujo de trabajo se inicia cuando se agrega o se elimina un artículo de cambio en la devolución. - Si monitoreas un campo del grupo Cargos de envío por devolución, el flujo de trabajo se inicia cuando se agrega o se elimina un cargo de envío por devolución.
- Si monitoreas un campo del grupo Pedidos para revertir la preparación de pedidos, el flujo de trabajo se inicia cuando se agrega un pedido para revertir la preparación de pedidos a la devolución. Si monitoreas el campo
reverseFulfillmentOrderso el camporeverseFulfillmentOrders.lineItems, el flujo de trabajo también se inicia cuando se elimina una línea de artículo de un pedido para revertir la preparación de pedidos.
Selecciona los campos que inician el flujo de trabajo
Selecciona los campos que inician el flujo de trabajo cuando cambian.
Pasos:
- En el editor de flujos de trabajo, haz clic en el activador Devolución actualizada.
- En la sección Seleccionar campos de devolución, haz clic en Seleccionar campos.
- En el cuadro de diálogo Agregar campo para monitorear, busca el campo que quieras monitorear o navega hasta él y luego selecciónalo.
- Opcional: Repite los pasos 2 y 3 para monitorear hasta cinco campos.
Campos
El activador Devolución actualizada contiene los siguientes campos, que puedes usar en condiciones y acciones, y para obtener datos en el flujo de trabajo. Los campos Devolución y Tienda siempre están disponibles. Los demás campos solo están disponibles cuando monitoreas un campo relacionado. Por ejemplo, el campo Pedido para revertir la preparación de pedidos está disponible cuando monitoreas un campo de un pedido para revertir la preparación de pedidos, como reverseFulfillmentOrders.status.
| Campo | Descripción |
|---|---|
| Devolución | La devolución que se actualizó. |
| Tienda | La tienda donde se actualizó la devolución. |
| Línea de artículo de devolución | La línea de artículo de la devolución que cambió. Está vacía cuando se elimina una línea de artículo de la devolución. Disponible cuando supervisas returnLineItems.quantity o un campo de cargo por reposición. |
| Línea de artículo del cambio | La línea de artículo del cambio que se agregó. Está vacía cuando se elimina una línea de artículo del cambio. Disponible cuando supervisas el campo exchangeLineItems. |
| Pedido para revertir la preparación de pedidos | El pedido para revertir la preparación de pedidos que cambió. Disponible cuando monitoreas un campo de un pedido para revertir la preparación de pedidos. |
Si monitoreas campos de distintos tipos, los campos Línea de artículo de devolución, Línea de artículo de cambio y Pedido para revertir la preparación de pedidos pueden estar vacíos cuando se ejecute el flujo de trabajo. Por ejemplo, si monitoreas tanto status como returnLineItems.quantity, el campo Línea de artículo de devolución estará vacío cuando solo cambie el estado. Los campos Línea de artículo de devolución y Línea de artículo de cambio pueden estar vacíos incluso si solo monitoreas campos de su tipo. Antes de usar uno de estos campos en una acción, agrega una condición que compruebe que el campo tiene un valor.
El activador Devolución actualizada solo proporciona los valores actuales de la devolución y de sus líneas de artículo. Los valores anteriores de los campos que cambiaron no están disponibles en el flujo de trabajo. Por ejemplo, si monitoreas el campo status, puedes usar el estado actual de la devolución en una condición o acción, pero no puedes usar el estado anterior al cambio.
Acciones
Este activador proporciona un objeto de devolución, por lo que permite usar cualquier acción que requiera una devolución. Además, como el objeto de devolución incluye un pedido, el activador se puede usar con cualquier acción relacionada con los pedidos, entre ellas:
- Agregar línea de artículo al pedido
- Agregar etiquetas de pedido
- Archivar pedido
- Cancelar pedido
- Capturar pago
- Retener orden de preparación de pedido
- Marcar pedido como pagado
Los pedidos dan acceso a otros datos, como los del cliente, por lo que este activador se puede usar con acciones relacionadas con los clientes. Entre ellas se incluyen:
- Agregar etiquetas de cliente
- Eliminar metacampo de cliente
- Eliminar etiquetas de cliente
- Actualizar metacampo de cliente
- Actualizar nota del cliente
Los pedidos también contienen listas de datos, como las líneas de artículo. Con una acción Para cada, puedes recorrer estas listas y realizar acciones en cada artículo. Por ejemplo, puedes recorrer las líneas de artículo y agregar una etiqueta a cada producto.
Prueba el activador Devolución actualizada
Para probar un flujo de trabajo que se inicia con este activador, activa el flujo de trabajo y luego cambia uno de los campos que monitorea en una devolución en el panel de control de Shopify. Por ejemplo, crea una devolución y luego procesa la devolución o cierra la devolución.
Información de la API
El activador Devolución actualizada permite realizar acciones con el objeto Return de la API GraphQL. Este activador corresponde a la acción update del tema Return en la referencia de Shopify Events, filtrada según los campos que elijas monitorear.