Devolució actualitzada
L’esdeveniment desencadenant Devolució actualitzada inicia un flux de treball quan canvien un o més camps d’una devolució, de les seves partides o de les seves comandes de processament invers a la botiga. Tries quins camps de devolució són rellevants i el flux de treball només s’executa quan canvia un d’aquests camps, com ara quan canvia l’estat de la devolució o s’afegeix una comissió de devolució.
Per iniciar un flux de treball quan una devolució arriba a una fase concreta, també pots utilitzar un esdeveniment desencadenant d’aquella fase, com ara Devolució sol·licitada, Devolució aprovada o Devolució tancada.
En aquesta pàgina
Camps que es poden supervisar
L’esdeveniment desencadenant Devolució actualitzada requereix que seleccionis com a mínim un camp per supervisar. Pots seleccionar fins a cinc camps. Quan canvia qualsevol dels camps seleccionats, s’executa el flux de treball. Els canvis en els camps que no has seleccionat no inicien el flux de treball.
Consulta la taula següent per obtenir més informació sobre els camps que pots supervisar.
| Tipus de camp | Camps |
|---|---|
| Devolució | closedAt, decline, requestApprovedAt, status |
| Partides de la devolució | returnLineItems.quantity, returnLineItems.refundableQuantity, returnLineItems.refundedQuantity, returnLineItems.restockingFee, returnLineItems.restockingFee.amountSet, returnLineItems.restockingFee.amountSet.presentmentMoney, returnLineItems.restockingFee.amountSet.shopMoney, returnLineItems.restockingFee.percentage, returnLineItems.unprocessedQuantity |
| Partides de canvi | exchangeLineItems |
| Tarifes d’enviament de devolució | returnShippingFees, returnShippingFees.amountSet, returnShippingFees.amountSet.presentmentMoney, returnShippingFees.amountSet.shopMoney |
| Comandes de processament invers | reverseFulfillmentOrders, reverseFulfillmentOrders.lineItems, reverseFulfillmentOrders.status |
Un camp amb un nom acabat en amountSet conté un import en dues monedes. Si supervises aquest camp, el flux de treball s’inicia quan canvia qualsevol dels dos imports. Per supervisar només un dels imports, selecciona el subcamp shopMoney per a l’import en la moneda de la botiga o el subcamp presentmentMoney per a l’import en la moneda del client.
Alguns camps també inicien el flux de treball quan s’afegeix un article a la devolució o se n’elimina un:
- Si supervises un camp del grup Partides de la devolució, el flux de treball s’inicia quan s’afegeix o s’elimina una partida de la devolució.
- Si supervises un camp de la comissió de devolució, com ara
returnLineItems.restockingFee.percentage, el flux de treball s’inicia quan s’afegeix una comissió de devolució a una partida o se n’elimina. - Si supervises el camp
exchangeLineItems, el flux de treball s’inicia quan s’afegeix un article de canvi a la devolució o se n’elimina un. - Si supervises un camp del grup Tarifes d’enviament de devolució, el flux de treball s’inicia quan s’afegeix o s’elimina una tarifa d’enviament de devolució.
- Si supervises un camp del grup Comandes de processament invers, el flux de treball s’inicia quan s’afegeix una comanda de processament invers a la devolució. Si supervises el camp
reverseFulfillmentOrderso el campreverseFulfillmentOrders.lineItems, el flux de treball també s’inicia quan s’elimina una partida d’una comanda de processament invers.
Selecciona els camps que inicien el flux de treball
Selecciona els camps que inicien el flux de treball quan es modifiquen.
Passos:
- A l’editor de fluxos de treball, fes clic a l’esdeveniment desencadenant Devolució actualitzada.
- A la secció Selecciona els camps de devolució, fes clic a Selecciona els camps.
- Al quadre de diàleg Afegeix un camp per supervisar, cerca el camp que vols supervisar o navega fins a trobar-lo i, a continuació, selecciona’l.
- Opcional: repeteix els passos 2 i 3 per supervisar fins a cinc camps.
Camps
L’esdeveniment desencadenant Devolució actualitzada conté els camps següents, que es poden utilitzar en condicions i accions i per obtenir dades al flux de treball. Els camps Devolució i Botiga estan sempre disponibles. Els altres camps només estan disponibles quan supervises un camp relacionat. Per exemple, el camp Comanda de processament invers està disponible quan supervises un camp d’una comanda de processament invers, com ara reverseFulfillmentOrders.status.
| Camp | Descripció |
|---|---|
| Devolució | La devolució que s’ha actualitzat. |
| Botiga | La botiga on s’ha actualitzat la devolució. |
| Partida de devolució | La partida de la devolució que ha canviat. En blanc quan s’ha eliminat una partida de la devolució. Disponible quan supervises returnLineItems.quantity o un camp de comissió de devolució. |
| Partida de canvi | La partida de canvi que s’ha afegit. En blanc quan s’ha eliminat una partida de canvi. Disponible quan supervises el camp exchangeLineItems. |
| Comanda de processament invers | La comanda de processament invers que ha canviat. Disponible quan supervises un camp d’una comanda de processament invers. |
Si supervises camps de diferents tipus, els camps Partida de devolució, Partida de canvi i Comanda de processament invers poden estar buits quan s’executa el flux de treball. Per exemple, si supervises tant status com returnLineItems.quantity, el camp Partida de devolució està buit quan només canvia l’estat. Els camps Partida de devolució i Partida de canvi poden estar buits encara que només supervisis camps del seu tipus. Abans d’utilitzar un d’aquests camps en una acció, afegeix una condició que comprovi que el camp té un valor.
L’esdeveniment desencadenant Devolució actualitzada només proporciona els valors actuals de la devolució i de les seves partides. Els valors anteriors dels camps que han canviat no estan disponibles al flux de treball. Per exemple, si supervises el camp status, pots utilitzar l’estat actual de la devolució en una condició o acció, però no pots utilitzar l’estat anterior al canvi.
Accions
Aquest esdeveniment desencadenant proporciona un objecte de devolució, de manera que permet utilitzar qualsevol acció que requereixi una devolució. A més, com que l’objecte de devolució inclou una comanda, l’esdeveniment desencadenant es pot utilitzar amb qualsevol acció de comanda, com ara:
- Afegeix una partida a la comanda
- Afegeix etiquetes a la comanda
- Arxiva la comanda
- Cancel·la la comanda
- Efectua el cobrament
- Posa en espera l’ordre de preparació
- Marca la comanda com a pagada
Les comandes permeten accedir a altres dades, com ara les del client, de manera que l’esdeveniment desencadenant es pot utilitzar amb accions de client. Entre aquestes accions hi ha:
- Afegeix etiquetes al client
- Elimina el metacamp del client
- Elimina etiquetes del client
- Actualitza el metacamp del client
- Actualitza la nota del client
Les comandes també contenen llistes de dades, com ara partides. Amb una acció Per a cada, pots recórrer aquestes llistes i executar accions en cada element. Per exemple, pots recórrer les partides i afegir una etiqueta a cada producte.
Prova de l’esdeveniment desencadenant Devolució actualitzada
Per provar un flux de treball que s’inicia amb aquest esdeveniment desencadenant, activa’l i, a continuació, modifica un dels camps que supervisa en una devolució al panell d’administració de Shopify. Per exemple, crea una devolució i, a continuació, processa-la o tanca-la.
Detalls de l’API
L’esdeveniment desencadenant Devolució actualitzada permet executar accions amb l’objecte Return de l’API de GraphQL. Aquest esdeveniment desencadenant correspon a l’acció update del tema Return de la referència de Shopify Events, filtrada pels camps que tries supervisar.