--- title: "Os Shopify Scripts acabaram: como substituir limites de quantidade e regras de checkout por Functions" description: "Os Shopify Scripts pararam de rodar em 30 de junho de 2026. Veja o que substitui cada tipo de script, por que os limites de quantidade agora bloqueiam o checkout com uma mensagem em vez de alterar o carrinho em silêncio e quais regras os Scripts nunca conseguiram aplicar." contentType: "blog" locale: "pt-br" localized: true source: "https://orderrules.com/pt-br/blog/shopify-scripts-to-functions-order-limits" slug: "shopify-scripts-to-functions-order-limits" date: "2026-09-28" tags: - "shopify" - "shopify scripts" - "shopify functions" - "migration" - "checkout validation" - "order limits" - "shopify plus" --- **Os Shopify Scripts pararam de rodar em 30 de junho de 2026.** Os scripts que ainda estavam publicados foram desativados, e nada foi migrado automaticamente. Descontos, regras de frete e regras de pagamento vão para as próprias APIs de Shopify Functions. Limites de quantidade e regras de checkout vão para a **Cart and Checkout Validation** (validação de carrinho e checkout), e se comportam de outro jeito. Um script normalmente reduzia a quantidade no carrinho sem avisar o cliente. Uma Function de validação, em vez disso, **bloqueia o checkout e mostra uma mensagem**. Ela também roda nos checkouts expressos, funciona em qualquer plano quando vem de um app da App Store e consegue aplicar regras que os Scripts nunca conseguiram: horário da loja, limites diários de pedidos e limites por cliente ao longo de vários pedidos. Última verificação: **28 de setembro de 2026**, na central de ajuda, no changelog e na documentação para desenvolvedores do Shopify. As fontes estão no final. *Aviso: o OrderRules é um app de validação de checkout, uma das opções abaixo. Quando as ferramentas nativas do Shopify resolvem, nós dizemos.* ## A linha do tempo | Data | O que aconteceu | |---|---| | Fev. 2023 | O Shopify anuncia que os Scripts vão acabar em 13 de agosto de 2024 | | Depois | A data passa para 28 de agosto de 2025 e, depois, para 30 de junho de 2026 | | 4 fev. 2025 | É lançado o relatório de personalizações, com prazo em 30 de junho de 2026 | | 15 abr. 2026 | Os Scripts não podem mais ser editados nem publicados | | **30 jun. 2026** | **Todos os Scripts param de rodar** | A central de ajuda do Shopify agora diz: "Any Scripts that were still published on your store have been deactivated and no longer work." (Todos os Scripts que ainda estavam publicados na sua loja foram desativados e não funcionam mais.) O checkout continuou sem eles. O que cada script fazia simplesmente deixou de valer: um desconto, uma tarifa de frete oculta ou um limite de quantidade. Se você não substituiu um script de quantidade, pedidos acima do seu antigo limite podem passar hoje. ## O que substitui cada tipo de script Os Scripts eram de três tipos: line item (item de linha), frete e pagamento. Cada um corresponde a uma Function API ou a um recurso nativo. | O que o script fazia | Substituto | Observações | |---|---|---| | Descontos em itens, preços escalonados ou "compre um, leve outro", preços por tag de cliente | Descontos nativos, um app de descontos (Discount Function API) ou catálogos B2B com preços por volume | Até 25 Functions de desconto por loja | | Kits ou alteração do preço da linha | Cart Transform Function API | A alteração de preço (`lineUpdate`) é só Plus | | Ocultar, renomear ou reordenar tarifas de frete | Delivery Customization Function API | Até 25 por loja | | Ocultar, renomear ou reordenar formas de pagamento (por exemplo, sem pagamento na entrega acima de $500) | Payment Customization Function API | Até 25 por loja | | **Limitar quantidades, mínimos, múltiplos** | **Cart and Checkout Validation Function API** | Bloqueia o checkout com uma mensagem; até 25 por loja | | Valor mínimo ou máximo do pedido | Limites de valor do pedido do Checkout Blocks (nativo) | Todos os planos desde 13 de abril de 2026 | | Mínimo, máximo e incremento para compradores B2B | Regras de quantidade do catálogo B2B (nativo) | Todos os planos desde 2 de abril de 2026; só compradores de empresas B2B | Para ver o que você tinha, abra **Apps → Script Editor** e procure o **relatório de personalizações**. Ele cobre scripts de pagamento, frete e desconto de produto, com apps recomendados e tutoriais de Functions para cada um. Ele não converte código. Um script que limitava quantidades aparece como script de desconto de produto (line item), e o relatório não necessariamente vai indicar a validação, então revise esses scripts manualmente. ## Limites de quantidade: o comportamento mudou Esta é a parte que a maioria dos guias de migração pula. **Os Scripts não conseguiam bloquear o checkout.** A Script API não tinha como rejeitar um carrinho; o único "reject" era para códigos de desconto. Lojas que limitavam quantidades usavam um contorno num script de line item: forçavam a quantidade para baixo, ou dividiam a linha e descartavam as unidades extras. O cliente chegava ao checkout com menos itens do que escolheu, muitas vezes sem explicação. Eram contornos da comunidade, não recursos documentados. **As Functions não conseguem alterar quantidades.** A Cart Transform pode expandir, juntar ou reapresentar linhas, mas não pode reduzi-las. A ferramenta da era das Functions para limites é a Cart and Checkout Validation. Ela verifica o carrinho e, quando uma regra é quebrada, **bloqueia o checkout e mostra uma mensagem**, por exemplo "Você pode comprar até 2 unidades deste item." O que isso significa na migração: - **Escreva a mensagem.** Um cliente que atinge um limite agora vê o seu texto no checkout. Diga o que mudar: "Remova 1 para continuar", não "Erro". - **Mostre o limite antes.** Coloque o limite na página do produto e no carrinho, para que a mensagem no checkout raramente seja surpresa. Apps de validação costumam trazer um bloco de tema para isso. O OrderRules mostra os limites nas páginas de produto e pode ajustar os campos de quantidade para múltiplos válidos. - **Os checkouts expressos estão cobertos.** O Shopify afirma que a validação inclui os checkouts expressos: Shop Pay, PayPal, Google Pay e Apple Pay. Limites de quantidade feitos só no tema não se sustentam ali, porque os botões de compra imediata pulam o carrinho. ## Regras que os Scripts nunca conseguiram aplicar Os Scripts rodavam num sandbox. Não tinham requisições web, nem banco de dados e, nas palavras do Shopify, não podiam "involve random or time-based calculations" (envolver cálculos aleatórios ou baseados em tempo). Eles viam o carrinho atual, mais as tags, o número de pedidos e o total gasto do cliente. Por isso, três regras comuns nunca foram possíveis com Scripts: | Regra | Por que os Scripts não conseguiam | Com um app de validação | |---|---|---| | Fechar o checkout fora do horário da loja, ou parar pedidos para o mesmo dia após um horário de corte | Sem lógica baseada em tempo | Verificado no checkout em relação à sua agenda | | Limitar pedidos por dia ou por semana para a loja ou um produto | Sem registro dos pedidos do dia | O app conta os pedidos e bloqueia o checkout ao atingir o limite | | Limitar um cliente ao longo de vários pedidos ("2 por cliente, para sempre") | Sem histórico de compras por produto | O app registra as compras de cada cliente e as verifica no checkout | Se você desistiu de uma dessas regras porque os Scripts não conseguiam, vale olhar de novo. ## Planos: o Plus não é mais obrigatório Os Scripts eram exclusivos do Shopify Plus. Com as Functions é diferente: - **Apps públicos da App Store com Functions funcionam em qualquer plano**, inclusive no Basic. - **Apps personalizados com Functions ainda exigem o Plus.** - Os limites de valor do pedido do Checkout Blocks e as regras de quantidade B2B estão em **todos os planos** desde abril de 2026. Assim, uma loja que saiu do Plus, ou que nunca o teve, pode aplicar regras de checkout que antes exigiam o Plus. ## Onde a validação não roda As Functions de validação cobrem o checkout da loja online, os checkouts expressos, o carrinho, os checkouts B2B e os pedidos preliminares. O Shopify lista estes como **não suportados**: - **POS** - **Renovações de assinatura** (pedidos recorrentes) - **Edições de pedido**, no admin ou no checkout - **Pedidos criados pela Create Order API** - Opções de compra de **pré-venda e "experimente antes de comprar"** Se uma regra precisa valer em um desses lugares, planeje outra coisa, como procedimentos da equipe no POS. No OrderRules, os pedidos de POS e as renovações de assinatura continuam contando para os limites, mesmo sem serem bloqueados. A lista completa está na nossa página de [compatibilidade e limitações conhecidas](/docs/guides/compatibility-and-limitations). ## Checklist de migração para regras de quantidade e de checkout 1. **Liste seus scripts.** Abra o relatório de personalizações e o código do Script Editor, se você guardou uma cópia. Anote todo script de line item que mexia na quantidade. 2. **Escreva cada regra em uma frase.** Por exemplo: "No máximo 2 deste moletom por pedido", "Compradores atacadistas pedem de 12 em 12" ou "Nenhum pedido acima de $2,000 sem aprovação". É mais fácil escolher um substituto para uma frase do que para código Ruby. 3. **Use primeiro as opções nativas.** - Limites de valor do pedido → Checkout Blocks. - Mínimos e múltiplos B2B → regras de quantidade do catálogo B2B. - Um carrinho enorme de um item em estoque → o limite de adição ao carrinho (**Configurações → Checkout**; só produtos com estoque rastreado). 4. **Escolha um app para o resto.** Mínimos e múltiplos para compradores comuns, limites por dia ou por semana, limites por cliente ao longo de vários pedidos e horário da loja exigem um app de validação. 5. **Reescreva as mensagens** como instruções e mostre os limites nas páginas de produto. 6. **Teste todos os caminhos.** Teste o checkout normal, o Shop Pay, um botão de compra imediata e um pedido preliminar. Depois, anote o que não será verificado: POS, renovações de assinatura e edições de pedido. Para uma visão regra a regra do que o Shopify agora faz nativamente, veja [limites de pedido nativos do Shopify vs apps](/blog/shopify-native-order-limits-vs-orderrules). ## Onde o OrderRules se encaixa O OrderRules é um app público da App Store construído sobre a validação de checkout do Shopify, então funciona em qualquer plano. Ele cobre as regras de quantidade e de checkout que os Scripts tratavam mal ou não conseguiam tratar: - **Quantidade mínima de pedido e quantidade por múltiplo** por produto ou variante, para todos os compradores. Veja o [guia de quantidade mínima de pedido](/blog/shopify-minimum-order-quantity-guide). - **Limites diários, semanais e mensais** para a loja, um produto ou uma coleção. - **Limites por cliente ao longo de vários pedidos** por pedidos, unidades, gasto ou peso. O cliente precisa fazer login; veja [limites de compra por cliente](/features/customer-limits). - **Horário da loja e fechamentos em feriados** que fecham o checkout. Ele não define valores mínimos de pedido (use o Checkout Blocks). Não tem máximo por pedido para um único produto; para isso, use o limite de adição ao carrinho do Shopify ou um limite diário por cliente. Para entender como a validação funciona por dentro, veja [a validação de checkout do Shopify explicada](/blog/shopify-checkout-validation-functions-block-orders). ## Fontes - Changelog do Shopify: [Os Scripts não podem mais ser editados nem publicados (12 mar. 2026)](https://changelog.shopify.com/posts/shopify-scripts-can-no-longer-be-edited-or-published) · [Relatório de personalizações (4 fev. 2025)](https://changelog.shopify.com/posts/shopify-scripts-customizations-report-now-available-to-accelerate-migration) - Changelog do Shopify.dev: [Os Shopify Scripts serão descontinuados em 30 de junho de 2026](https://shopify.dev/changelog/shopify-scripts-will-be-deprecated-on-june-30-2026) - Central de Ajuda do Shopify: [Script Editor](https://help.shopify.com/en/manual/checkout-settings/script-editor) · [Limitações](https://help.shopify.com/en/manual/checkout-settings/script-editor/limitations) · [Transição para Functions](https://help.shopify.com/en/manual/checkout-settings/script-editor/transitioning-to-functions) - Shopify.dev: [Cart and Checkout Validation Function API](https://shopify.dev/docs/api/functions/latest/cart-and-checkout-validation) · [Cart Transform](https://shopify.dev/docs/api/functions/latest/cart-transform) · [Disponibilidade das Shopify Functions](https://shopify.dev/docs/apps/build/functions) - Changelog do Shopify: [Limites de valor do pedido do Checkout Blocks em todos os planos (13 abr. 2026)](https://changelog.shopify.com/posts/checkout-blocks-order-value-limits-available-on-all-plans) · [Recursos B2B nos planos que não são Plus (2 abr. 2026)](https://changelog.shopify.com/posts/key-b2b-features-now-available-on-non-plus-plans) - Shopify Community: [Anúncio da descontinuação dos Shopify Scripts (fev. 2023)](https://community.shopify.com/t/shopify-scripts-deprecation/191509)