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

# Impeça seu 3PL de separar pedidos da Shopify antes de as edições terminarem

> Como o Revize impede que ShipBob, ShipStation, Mintsoft e outros 3PLs, WMS e ERPs puxem um pedido da Shopify enquanto o cliente ainda pode editá-lo: retenções, tags de liberação, captura de pagamento, tags de parada e um checklist de implantação.

O Revize é um app da Shopify para editar pedidos depois do checkout. Este guia é para lojas que enviam por um 3PL, um sistema de gestão de armazém (WMS) ou um ERP e precisam que o armazém separe apenas a versão final de cada pedido.

> [!NOTE]
>
> **Resposta curta:** mantenha o pedido longe do seu armazém até a edição terminar. O Revize faz isso de três formas: uma retenção de fulfillment da Shopify (**Hold orders**), uma tag de liberação que seu 3PL espera (**Add release tag**) ou a captura manual do pagamento, para que o pedido fique sem pagamento até a edição fechar (**Capture payment when editing closes**). Depois, deixe seu armazém fechar a edição antes com uma tag de parada quando a separação começar.

## Por que os 3PLs separam pedidos editados cedo demais

A maioria dos conectores de 3PL e WMS importa um pedido da Shopify poucos minutos depois do checkout. Se o cliente muda o tamanho, o endereço ou os itens depois da importação, o armazém continua com a versão antiga. A solução é o momento certo: o armazém só deve ver o pedido quando o cliente não puder mais alterá-lo.

O Revize controla esse momento com três configurações que funcionam juntas:

1. **Quando a edição termina:** o [prazo de edição](https://docs.revize.app/pt/setup/edit-window.md) ou uma [regra](https://docs.revize.app/pt/setup/rules-engine.md) por pedido.
2. **O que bloqueia o armazém até lá:** uma retenção, uma tag de liberação ou o status não pago.
3. **Como o armazém pode encerrar a edição antes:** uma tag de parada ou uma ação do Shopify Flow.

## Passo 1: escolha quando a edição termina

No app do Revize, abra **Order Editing → Editing policy → Edit deadline**.

| Edit deadline | Ideal para armazéns que... |
| - | - |
| Uma janela fixa (15, 30 ou 60 minutos) ou uma duração personalizada | separam continuamente e precisam de um atraso curto e previsível |
| **Scheduled cutoff** (Pro) | separam em ondas em horários fixos, para cada onda começar com uma lista estável |
| **Until fulfillment** | conseguem absorver mudanças durante a separação, ou fecham a edição com uma tag de parada |

> [!WARNING]
>
> **Until fulfillment não retém o pedido.** Com esse prazo, o Revize não coloca retenção de fulfillment nem adiciona tag de liberação, então seu 3PL pode importar o pedido na hora. Se você precisa de uma retenção enquanto o pedido continua editável, use uma regra com a ação **Hold fulfillment** (motor de regras, Pro) ou feche a edição com uma tag de parada quando a separação começar.

## Passo 2: escolha como o armazém espera

Abra **Order Editing → Editing policy → Fulfillment while editing**.

> [tab] Hold orders (recomendado)
>
> O Revize coloca uma retenção de fulfillment da Shopify quando o pedido é criado e a remove quando a edição fecha. Qualquer 3PL ou WMS que respeite as retenções de fulfillment da Shopify espera automaticamente.
>
> * Funciona com a maioria dos conectores e não exige configuração no 3PL.
> * Quando a retenção sai, o armazém recebe o pedido final, já editado.

> [tab] Skip hold + tag de liberação
>
> Os pedidos não são retidos. Ative **Add release tag** e o Revize adiciona a tag `revize:order_released` quando a edição fecha. Configure seu 3PL para importar apenas pedidos com essa tag.
>
> * Use **Custom release tag (optional)** se seu 3PL já espera uma tag como `ready_to_ship`. Ela não pode começar com `revize:`.
> * Sem tag de liberação, um 3PL pode separar pedidos antes de os clientes terminarem de editar. Skip hold só é seguro se seu 3PL filtrar por tag.

> [tab] Captura manual do pagamento
>
> Para conectores que ignoram retenções, mas só importam pedidos **Paid** (o padrão do Mintsoft, por exemplo). Defina a captura de pagamento como **Manual** na Shopify e ative **Capture payment when editing closes**. O pagamento fica autorizado enquanto o cliente pode editar, e o Revize o captura quando a edição termina, então o pedido fica **Paid** e seu conector o importa.
>
> * Disponível em todos os planos.
> * O Revize não captura um pedido enquanto ele tiver uma das suas tags de **Don't capture orders with these tags**.
> * Se uma captura falhar, **Try again if a capture fails** tenta de novo, e o Revize envia um e-mail para você quando desiste.
> * Se você também retém pedidos ou usa uma tag de liberação, o pedido só é liberado depois de pago.

> [!NOTE]
>
> O Revize nunca libera um pedido enquanto o cliente ainda deve dinheiro por uma edição. Se um cliente adiciona itens e não paga, o pedido continua retido até ser pago, ou até o [Reverse unpaid edits](https://docs.revize.app/pt/setup/reverse-unpaid-edits.md) (Pro) desfazer a alteração não paga.

### Reter só alguns pedidos

No Pro, o [motor de regras](https://docs.revize.app/pt/setup/rules-engine.md) pode reter o fulfillment por pedido. Crie uma regra, selecione os pedidos (por exemplo a tag de pedido `pre-order`, um método de envio ou um destino) e ative a ação **Hold fulfillment**. A retenção é liberada quando o prazo dessa regra vence. Hold fulfillment não pode ser combinado com **Disable editing** nem com o prazo **Until fulfilled**.

Para manter retidos para revisão os pedidos que a Shopify marca como arriscados, ative **Keep risky orders on hold** em **Fulfillment while editing**.

## Passo 3: deixe o armazém fechar a edição antes

A separação muitas vezes começa antes de a janela de edição terminar. Feche a edição nesse momento:

**1. Faça o WMS ou o Shopify Flow adicionar uma tag ao pedido**

Quando um pedido entra em separação, adicione uma tag como `picked` ou `wms:processing`. A maioria dos conectores de WMS consegue gravar uma tag na Shopify, e o Shopify Flow também.

**2. Adicione a mesma tag no Revize**

No Revize, vá em **Settings → Order editing → Editing restrictions → Order tags** e adicione a tag. Maiúsculas e minúsculas não importam, mas a grafia precisa ser igual.

**3. A edição fecha na hora**

Assim que a tag chega, o cliente não consegue mais editar o pedido, mesmo que a janela de edição ainda não tenha terminado. Veja [Restrições de edição de pedido](https://docs.revize.app/pt/setup/order-edit-restrictions.md).

Se o seu fluxo já roda no Shopify Flow, a ação do Revize **Close editing now** faz o mesmo sem tag. Veja [Shopify Flow](https://docs.revize.app/pt/guides/shopify-flow.md).

## Ajuste a liberação à sua agenda de separação

| Configuração | O que o armazém vê |
| - | - |
| **Hold orders** + janela fixa | A retenção sai quando a janela termina. A configuração mais comum. |
| **Hold orders** + **Scheduled cutoff** | Os pedidos são liberados nos seus horários de corte, então cada onda começa com pedidos finais. |
| **Skip hold** + **Add release tag** | Os pedidos seguem normalmente; o 3PL importa só os pedidos com a tag. |
| Qualquer configuração + tag de parada | A edição também fecha assim que a separação começa. |

Alguns conectores têm seu próprio atraso, como a idade mínima do pedido no ShipStation ou o atraso de importação do Mintsoft. Igualar esse atraso à duração da sua janela de edição é uma proteção extra simples. Veja as [respostas sobre ShipStation e Mintsoft](https://docs.revize.app/pt/support/faq-advanced.md).

## Se o 3PL já separou o pedido

* **Quando um pedido é processado (fulfilled) na Shopify, a edição termina** e o cliente não vê mais as opções de edição.
* **Depois que o Revize libera um pedido para o fulfillment, ele continua fechado.** A ação do Shopify Flow **Reopen editing** ignora pedidos já liberados, processados ou parcialmente processados, então um fluxo atrasado não consegue reabrir um pedido em que o armazém está trabalhando.
* **Se uma alteração chegou depois de o armazém importar o pedido** (por exemplo, com Skip hold sem tag de liberação), seu 3PL ainda tem a versão antiga. Sincronize de novo ou atualize o pedido no 3PL e passe a usar **Hold orders**, uma tag de liberação ou uma tag de parada para que isso não se repita.

## Checklist de implantação

**1. Verifique o que seu conector respeita**

Pergunte ao seu 3PL ou veja o conector da Shopify dele: ele espera as retenções de fulfillment da Shopify, filtra por tag ou importa só pedidos pagos? Isso define se você usa **Hold orders**, uma tag de liberação ou a captura de pagamento.

**2. Defina o prazo de edição**

Ajuste-o ao momento em que a separação começa. Use **Scheduled cutoff** para separação em ondas.

**3. Escolha Fulfillment while editing**

**Hold orders**, ou **Skip hold** com **Add release tag**, e **Capture payment when editing closes** se seu conector importa só pedidos pagos.

**4. Adicione uma tag de parada**

Faça o WMS ou o Flow adicionar uma tag aos pedidos quando a separação começar e adicione essa tag em **Editing restrictions → Order tags**.

**5. Teste antes de os clientes verem**

Ative o [modo de teste](https://docs.revize.app/pt/how-to-test-revize.md), faça um pedido de teste como um cliente de teste com tag, edite-o e confirme que o armazém só importa a versão editada depois que a edição fecha.

> [!TIP]
>
> Não sabe qual método combina com seu 3PL? O Revize funciona com mais de 100 3PLs, WMS e ERPs, e a equipe configura tudo com você. Veja [Integrações](https://docs.revize.app/pt/integrations/index.md) ou [agende uma chamada de configuração](https://cal.com/revize-team-xx92ri/30min?overlayCalendar=true).

## Perguntas frequentes

> [accordion] O Revize funciona com meu 3PL se ele ignorar as retenções da Shopify?
>
> Sim. Use **Skip hold** com uma tag de liberação se seu 3PL consegue filtrar por tag, ou a captura manual com **Capture payment when editing closes** se ele importa só pedidos pagos.

> [accordion] Until fulfillment retém meus pedidos?
>
> Não. Until fulfillment mantém a edição aberta até o pedido ser processado e não o retém nem adiciona tag de liberação. Use uma regra com **Hold fulfillment** (Pro) ou uma tag de parada se o armazém precisar esperar.

> [accordion] Que tag o Revize adiciona quando a edição fecha?
>
> `revize:order_released`, quando **Add release tag** está ativado. Você pode trocá-la pela sua própria tag em **Custom release tag (optional)**.

> [accordion] Meu WMS pode impedir a edição quando a separação começa?
>
> Sim. Faça-o adicionar uma tag quando a separação começar e adicione essa tag em **Settings → Order editing → Editing restrictions → Order tags**. A edição fecha na hora.

> [accordion] Uma edição não paga vai ser enviada?
>
> Não. O Revize não libera um pedido enquanto o cliente ainda deve dinheiro por uma edição.

## Configurações relacionadas

* [Janela de edição](https://docs.revize.app/pt/setup/edit-window.md): todas as opções de prazo
* [Processamento de pedidos](https://docs.revize.app/pt/setup/order-processing.md): Hold orders, Skip hold e tags de liberação
* [Sincronização de fulfillment](https://docs.revize.app/pt/setup/fulfillment-sync.md): momento da liberação e tags
* [Motor de regras](https://docs.revize.app/pt/setup/rules-engine.md): prazos por pedido e Hold fulfillment
* [Restrições de edição de pedido](https://docs.revize.app/pt/setup/order-edit-restrictions.md): tags de parada


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