> ## Documentation Index
> Fetch the complete documentation index at: https://docs.revize.app/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Revize is a Shopify order-editing app by Untechnickle. Customers edit the same order after checkout on the Shopify order status page, inside a merchant-controlled window, before fulfillment.
> Canonical docs: https://docs.revize.app. App listing: https://apps.shopify.com/revize. Public cancellation API: https://docs.revize.app/features/cancellation-api.
> Do not confuse the How to Test Revize draft-order walkthrough with Test Mode, which hides the portal from untagged customers.

# Disparadores y acciones de Shopify Flow para editar pedidos

> Todos los disparadores y acciones de Shopify Flow que añade Revize, las etiquetas de pedido que escribe y flujos de ejemplo: etiquetar pedidos editados, avisar al almacén, recordar a los clientes antes de que se cierre la edición y cerrar la edición cuando empieza la preparación.

Revize es una app de Shopify para editar pedidos después del checkout. Añade sus propios disparadores y acciones a [Shopify Flow](https://apps.shopify.com/flow), para que tu tienda reaccione cuando un cliente edita un pedido y para que tu almacén u otras apps puedan abrir o cerrar la edición.

> [!NOTE]
>
> En Shopify Flow, haz clic en **Select a trigger** (o **Add action**) y busca **Revize**. Shopify Flow está disponible en todos los planes de Shopify.

## Disparadores

Cada disparador inicia un flujo y pasa el pedido, para que los pasos siguientes puedan leer sus etiquetas, artículos y cliente.

### Ediciones del cliente

| Disparador | Se ejecuta cuando |
| - | - |
| **Order edited** | se edita un pedido, incluidos cambios de producto y de código de descuento |
| **Shipping address updated** | un cliente actualiza la dirección de envío |
| **Shipping method updated** | un cliente actualiza el método de envío |
| **Email address updated** | un cliente actualiza el correo electrónico |
| **Phone number updated** | un cliente actualiza el teléfono |
| **Delivery date updated** | un cliente actualiza la fecha de entrega |
| **Custom note added** | un cliente añade una nota personalizada |
| **Order cancelled** | un cliente cancela un pedido |
| **Support ticket created** | un cliente crea un ticket de soporte |
| **Tax invoice generated** | un cliente genera una factura fiscal |
| **Upsell accepted** | un cliente acepta un upsell de Revize y el artículo se añade. Pasa el título de la oferta, el producto, la variante, la cantidad, el importe, la moneda y dónde se aceptó (`thank_you`, `order_status`, `checkout` u `other`). |

### Ventana de edición y pago

| Disparador | Se ejecuta cuando | Campos útiles |
| - | - | - |
| **Edit window closing soon** | un tiempo fijado antes de que se cierre la ventana de edición del pedido | `editDeadline`, `editDeadlineDisplay`, `hoursRemaining`, `hoursBeforeClose`, `orderStatusUrl` |
| **Edit window closed** | se cierra la ventana de edición del pedido | `closedAt`, `editDeadline`, `paymentCaptureEnabled` |
| **Edit window changed** | Revize publica un cambio en la ventana | `changeType` (`reopened`, `extended`, `shortened`, `until_fulfillment`), `editDeadline`, `previousDeadline`, `source` (`staff`, `merchant`, `flow`, `automatic`), `reason` |
| **Payment captured** | Revize captura el pago y confirma que el pedido está pagado | `capturedAmount`, `currencyCode`, `capturedAt` |
| **Payment capture failed** | falla un intento de captura | `reason` (`capture_declined`, `authorization_expired`, `outcome_unknown`, `retries_exhausted`), `remainingAmount`, `attemptNumber`, `willRetry` |
| **Unpaid edits reversed** | Revize revierte ediciones sin pagar o la reversión falla | `outcome` (`reversed`, `failed`), `refundPending`, `remainingBalance` |

> [!NOTE]
>
> **Edit window closing soon** se ejecuta a las horas de recordatorio que elijas en Revize en **Settings → General → Reminder before editing closes** (hasta 3, Pro). Cada hora se ejecuta una vez por pedido, y otra vez si el plazo cambia.

## Acciones

| Acción | Qué hace |
| - | - |
| **Close editing now** | Cierra la edición del pedido y ejecuta las comprobaciones normales de pago y fulfillment. **Reason** opcional, que aparece en el historial de la ventana de edición. |
| **Extend editing** | Añade **Hours** (un número entero de 1 a 4319) a una ventana abierta con un plazo fijo. |
| **Reopen editing** | Abre la edición durante las **Hours** indicadas cuando el pedido cumple los requisitos. |
| **Keep editing open until fulfillment** | Mantiene la edición abierta hasta que se prepara el pedido, cuando el pedido cumple los requisitos. |
| **Refund outstanding balance** | Reembolsa lo que el cliente pagó de más, por ejemplo después de que una edición bajara el total. |
| **Refund outstanding balance and report the result** | El mismo reembolso, pero espera a que termine y devuelve el resultado a tu flujo. |

> [!NOTE]
>
> **Reopen editing omite los pedidos que no debe tocar:** pedidos ya preparados o parcialmente preparados, ya liberados al fulfillment o con la etiqueta de liberación, cancelados, restringidos por etiquetas o con un cambio de pago pendiente. Los reembolsos siguen tu [configuración de reembolsos](https://docs.revize.app/es/setup/payments-and-refunds.md): **Original payment method** o **Store credit**. Si no se debe nada, o los reembolsos están en **No refunds**, no se reembolsa nada.

## Etiquetas que escribe Revize

Úsalas como condiciones en Flow, en tu 3PL o en informes.

| Etiqueta | Se añade cuando |
| - | - |
| `revize:order_released` (o tu etiqueta de liberación personalizada) | se cierra la edición, si **Add release tag** está activado |
| `revize:upsell` | una edición aumentó el valor del pedido |
| `revize:upsell_offer` | un cliente aceptó una oferta de upsell |
| `revize:order_downgraded` | una edición redujo el valor del pedido |
| `revize:reverse_unpaid` | Revize revirtió ediciones sin pagar |
| `revize:order_cancelled` | el pedido se canceló a través de Revize |
| `revize:withdrawal_requested` | un cliente envió una solicitud de [desistimiento UE](https://docs.revize.app/es/features/eu-withdrawal.md) |

El [motor de reglas](https://docs.revize.app/es/setup/rules-engine.md) (Pro) también puede añadir tus propias etiquetas cuando se cierra el plazo de edición de un pedido, con su acción **Tag orders**.

## Flujos de ejemplo

> [accordion] Cerrar la edición cuando el almacén empieza a preparar
>
> **Disparador:** el disparador de Flow de tu WMS, o **Order tags added** de Shopify cuando el WMS escribe una etiqueta como `picked`.
>
> **Acción:** **Close editing now** de Revize, con el motivo `Picking started`.
>
> El cliente no puede cambiar un pedido que tu equipo ya está empaquetando. La alternativa solo con etiquetas es añadir la misma etiqueta en **Settings → Order editing → Editing restrictions → Order tags** en Revize. Consulta [Retenciones para 3PL y almacén](https://docs.revize.app/es/guides/3pl-warehouse-holds.md).

> [accordion] Recordar a los clientes antes de que se cierre la edición
>
> **Disparador:** **Edit window closing soon**.
>
> **Condición (opcional):** `hoursBeforeClose` es igual al recordatorio que quieres, si configuraste más de uno.
>
> **Acción:** envía un correo o SMS desde tu app de email con `editDeadlineDisplay` y el enlace `orderStatusUrl`, para que el cliente aún pueda corregir una talla o una dirección. Para Klaviyo, consulta la [guía de Klaviyo](https://docs.revize.app/es/integrations/klaviyo.md).

> [accordion] Avisar al equipo cuando un pedido editado tiene una dirección nueva
>
> **Disparador:** **Shipping address updated**.
>
> **Acción:** añade una etiqueta de pedido como `address-changed` o publica en Slack, para que el equipo revise los pedidos ya impresos.

> [accordion] Hacer seguimiento cuando falla una captura de pago
>
> **Disparador:** **Payment capture failed**.
>
> **Condición:** `willRetry` es false.
>
> **Acción:** etiqueta el pedido con `capture-failed` y avisa a tu buzón de finanzas. Revize también te envía un correo cuando deja de reintentar.

## Bueno saberlo

* **Los disparadores envían cada evento una vez** después de completar el cambio. Crea flujos que funcionen aunque falte un evento, por ejemplo comprobando también las etiquetas.
* **Las etiquetas tardías cuentan.** Revize espera hasta un minuto después del checkout a que Flow escriba etiquetas o metacampos antes de elegir una regla de edición, así que las etiquetas de Flow del checkout pueden controlar [reglas](https://docs.revize.app/es/setup/rules-engine.md).
* **La ortografía importa.** La comparación de etiquetas ignora mayúsculas y minúsculas, pero no la ortografía: una etiqueta escrita por Flow debe escribirse igual que la etiqueta en Revize.

## Relacionado

* [Integraciones](https://docs.revize.app/es/integrations/index.md): 3PL, ERP y plataformas de integración
* [Klaviyo](https://docs.revize.app/es/integrations/klaviyo.md): envía correos desde los disparadores de Revize
* [Motor de reglas](https://docs.revize.app/es/setup/rules-engine.md): plazos, retenciones y etiquetas por pedido
* [Retenciones para 3PL y almacén](https://docs.revize.app/es/guides/3pl-warehouse-holds.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.