> ## 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.

# Gatilhos e ações do Shopify Flow para edição de pedidos

> Todos os gatilhos e ações do Shopify Flow que o Revize adiciona, as tags de pedido que ele grava e fluxos de exemplo: marcar pedidos editados, avisar o armazém, lembrar clientes antes de a edição fechar e fechar a edição quando a separação começa.

O Revize é um app da Shopify para editar pedidos depois do checkout. Ele adiciona gatilhos e ações próprios ao [Shopify Flow](https://apps.shopify.com/flow), para que sua loja reaja quando um cliente edita um pedido e para que seu armazém ou outros apps possam abrir ou fechar a edição.

> [!NOTE]
>
> No Shopify Flow, clique em **Select a trigger** (ou **Add action**) e pesquise **Revize**. O Shopify Flow está disponível em todos os planos da Shopify.

## Gatilhos

Cada gatilho inicia um fluxo e passa o pedido, para que as etapas seguintes possam ler as tags, os itens e o cliente.

### Edições do cliente

| Gatilho | Executa quando |
| - | - |
| **Order edited** | um pedido é editado, incluindo mudanças de produto e de código de desconto |
| **Shipping address updated** | um cliente atualiza o endereço de entrega |
| **Shipping method updated** | um cliente atualiza o método de envio |
| **Email address updated** | um cliente atualiza o e-mail |
| **Phone number updated** | um cliente atualiza o telefone |
| **Delivery date updated** | um cliente atualiza a data de entrega |
| **Custom note added** | um cliente adiciona uma nota personalizada |
| **Order cancelled** | um cliente cancela um pedido |
| **Support ticket created** | um cliente cria um ticket de suporte |
| **Tax invoice generated** | um cliente gera uma nota fiscal |
| **Upsell accepted** | um cliente aceita um upsell do Revize e o item é adicionado. Passa o título da oferta, o produto, a variante, a quantidade, o valor, a moeda e onde foi aceito (`thank_you`, `order_status`, `checkout` ou `other`). |

### Janela de edição e pagamento

| Gatilho | Executa quando | Campos úteis |
| - | - | - |
| **Edit window closing soon** | um tempo definido antes de a janela de edição do pedido fechar | `editDeadline`, `editDeadlineDisplay`, `hoursRemaining`, `hoursBeforeClose`, `orderStatusUrl` |
| **Edit window closed** | a janela de edição do pedido fecha | `closedAt`, `editDeadline`, `paymentCaptureEnabled` |
| **Edit window changed** | o Revize publica uma mudança na janela | `changeType` (`reopened`, `extended`, `shortened`, `until_fulfillment`), `editDeadline`, `previousDeadline`, `source` (`staff`, `merchant`, `flow`, `automatic`), `reason` |
| **Payment captured** | o Revize captura o pagamento e confirma que o pedido está pago | `capturedAmount`, `currencyCode`, `capturedAt` |
| **Payment capture failed** | uma tentativa de captura falha | `reason` (`capture_declined`, `authorization_expired`, `outcome_unknown`, `retries_exhausted`), `remainingAmount`, `attemptNumber`, `willRetry` |
| **Unpaid edits reversed** | o Revize desfaz edições não pagas, ou o desfazer falha | `outcome` (`reversed`, `failed`), `refundPending`, `remainingBalance` |

> [!NOTE]
>
> **Edit window closing soon** é executado nos horários de lembrete que você escolhe no Revize em **Settings → General → Reminder before editing closes** (até 3, Pro). Cada horário é executado uma vez por pedido, e de novo se o prazo mudar.

## Ações

| Ação | O que faz |
| - | - |
| **Close editing now** | Fecha a edição do pedido e executa as verificações normais de pagamento e fulfillment. **Reason** opcional, exibido no histórico da janela de edição. |
| **Extend editing** | Adiciona **Hours** (um número inteiro de 1 a 4319) a uma janela aberta com prazo definido. |
| **Reopen editing** | Abre a edição pelo número de **Hours** pedido quando o pedido é elegível. |
| **Keep editing open until fulfillment** | Mantém a edição aberta até o pedido ser processado, quando o pedido é elegível. |
| **Refund outstanding balance** | Reembolsa o que o cliente pagou a mais, por exemplo depois de uma edição reduzir o total. |
| **Refund outstanding balance and report the result** | O mesmo reembolso, mas espera terminar e devolve o resultado ao seu fluxo. |

> [!NOTE]
>
> **Reopen editing ignora pedidos que não deve mexer:** pedidos já processados ou parcialmente processados, já liberados para o fulfillment ou com a tag de liberação, cancelados, restritos por tags ou com uma mudança de pagamento pendente. Os reembolsos seguem sua [configuração de reembolso](https://docs.revize.app/pt/setup/payments-and-refunds.md): **Original payment method** ou **Store credit**. Se nada for devido, ou se os reembolsos estiverem em **No refunds**, nada é reembolsado.

## Tags que o Revize grava

Use-as como condições no Flow, no seu 3PL ou em relatórios.

| Tag | Adicionada quando |
| - | - |
| `revize:order_released` (ou sua tag de liberação personalizada) | a edição fecha, se **Add release tag** estiver ativado |
| `revize:upsell` | uma edição aumentou o valor do pedido |
| `revize:upsell_offer` | um cliente aceitou uma oferta de upsell |
| `revize:order_downgraded` | uma edição reduziu o valor do pedido |
| `revize:reverse_unpaid` | o Revize desfez edições não pagas |
| `revize:order_cancelled` | o pedido foi cancelado pelo Revize |
| `revize:withdrawal_requested` | um cliente enviou um pedido de [desistência UE](https://docs.revize.app/pt/features/eu-withdrawal.md) |

O [motor de regras](https://docs.revize.app/pt/setup/rules-engine.md) (Pro) também pode adicionar suas próprias tags quando o prazo de edição de um pedido fecha, com a ação **Tag orders**.

## Fluxos de exemplo

> [accordion] Fechar a edição quando o armazém começa a separar
>
> **Gatilho:** o gatilho do Flow do seu WMS, ou o **Order tags added** da Shopify quando o WMS grava uma tag como `picked`.
>
> **Ação:** **Close editing now** do Revize, com o motivo `Picking started`.
>
> O cliente não consegue mudar um pedido que sua equipe já está embalando. A alternativa só com tags é adicionar a mesma tag em **Settings → Order editing → Editing restrictions → Order tags** no Revize. Veja [Retenções para 3PL e armazém](https://docs.revize.app/pt/guides/3pl-warehouse-holds.md).

> [accordion] Lembrar os clientes antes de a edição fechar
>
> **Gatilho:** **Edit window closing soon**.
>
> **Condição (opcional):** `hoursBeforeClose` igual ao lembrete que você quer, se definiu mais de um.
>
> **Ação:** envie um e-mail ou SMS pelo seu app de e-mail com `editDeadlineDisplay` e o link `orderStatusUrl`, para o cliente ainda poder corrigir um tamanho ou endereço. Para o Klaviyo, veja o [guia do Klaviyo](https://docs.revize.app/pt/integrations/klaviyo.md).

> [accordion] Avisar a equipe quando um pedido editado tem um endereço novo
>
> **Gatilho:** **Shipping address updated**.
>
> **Ação:** adicione uma tag de pedido como `address-changed` ou publique no Slack, para a equipe conferir pedidos já impressos.

> [accordion] Acompanhar quando uma captura de pagamento falha
>
> **Gatilho:** **Payment capture failed**.
>
> **Condição:** `willRetry` é false.
>
> **Ação:** adicione a tag `capture-failed` ao pedido e avise a caixa de entrada do financeiro. O Revize também envia um e-mail para você quando para de tentar.

## Bom saber

* **Os gatilhos enviam cada evento uma vez** depois que a alteração termina. Monte fluxos que funcionem mesmo se um evento faltar, por exemplo verificando também as tags.
* **Tags atrasadas contam.** O Revize espera até um minuto depois do checkout para o Flow gravar tags ou metacampos antes de escolher uma regra de edição, então tags do Flow no checkout podem acionar [regras](https://docs.revize.app/pt/setup/rules-engine.md).
* **A grafia importa.** A comparação de tags ignora maiúsculas e minúsculas, mas não a grafia: uma tag gravada pelo Flow precisa ser escrita exatamente como a tag no Revize.

## Relacionado

* [Integrações](https://docs.revize.app/pt/integrations/index.md): 3PLs, ERPs e plataformas de integração
* [Klaviyo](https://docs.revize.app/pt/integrations/klaviyo.md): envie e-mails a partir dos gatilhos do Revize
* [Motor de regras](https://docs.revize.app/pt/setup/rules-engine.md): prazos, retenções e tags por pedido
* [Retenções para 3PL e armazém](https://docs.revize.app/pt/guides/3pl-warehouse-holds.md)


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