Vai al contenuto principale
Tecnico

Errore di validazione del carrello o del checkout Shopify che non compare? 9 cause e rimedi

Jahangir Alam21 novembre 2026Fatti verificati il 21 novembre 202610 min read

Quando una regola di validazione Shopify non mostra alcun messaggio, di solito succede una di queste quattro cose: la validazione è disattivata, la Function è andata in errore e il checkout è proseguito senza, la regola gira solo al checkout, oppure il tema ha ricevuto l'errore e non l'ha mostrato. Prova pagina prodotto, carrello e checkout uno alla volta per capire quale.

Questa guida riguarda la validazione del checkout creata con Shopify Functions, cioè il modo in cui le app per limiti d'ordine, ordine minimo e orari del negozio (OrderRules compreso) bloccano gli ordini. Se è la prima volta, parti da come funziona la validazione del checkout di Shopify.

Dove Shopify mostra gli errori di validazione

Dove compare il messaggio dipende da dove si trova il cliente.

Dove si trova il clienteCosa succedeChi mostra il messaggio
CheckoutL'errore blocca il passaggio. Un errore sull'intero carrello compare nella pagina di checkout corrente; un errore su un campo compare accanto al campo.Shopify
Pagina prodotto o carrello (aggiunta o modifica di articoli)La richiesta al carrello fallisce e restituisce l'errore.Il tuo tema, se legge l'errore
Storefront headlessGli errori compaiono nel carrello della Storefront API.Il tuo front end
Checkout express (Shop Pay, Apple Pay, Google Pay, PayPal, Buy it now)La validazione gira come nel checkout.Shopify

La riga centrale è dove i messaggi si perdono. Shopify rimanda indietro l'errore; se l'acquirente lo vede dipende dal JavaScript del tema.

Le 9 cause, per sintomo

SintomoCausa probabileRimedio
Nessuna regola scatta, da nessuna parte1. Validazione non attivaAttivala in Regole di checkout
Funziona con carrelli piccoli, non con quelli grandi2. La Function è andata in errore o ha esaurito le istruzioniSegnalalo allo sviluppatore dell'app con l'orario e la dimensione del carrello
Niente nella pagina del carrello, blocco al checkout3. La regola gira solo al checkoutÈ normale; avvisa i clienti in anticipo
"Esaurito" o un errore generico al posto del tuo messaggio4. Il tema nasconde o sostituisce l'errore del carrelloProva con Dawn; correggi la gestione degli errori del tema
Funziona dal carrello, non da Buy it now5. Il checkout express ha saltato gli attributi del carrelloSalva la scelta per ogni riga, oppure richiedila al checkout
Il primo ordine oltre il limite è passato6. I conteggi non erano ancora aggiornatiLascia un margine; i conteggi si aggiornano dopo ogni ordine
Compare un messaggio diverso7. Un'altra regola o app è scattata primaControlla l'ordine in cui vengono verificate le regole
Il messaggio mostra ' o altro codice8. Messaggio con escape doppioSegnalalo allo sviluppatore dell'app
L'ordine è arrivato senza alcun controllo9. L'ordine viene da un canale che salta la validazioneGli ordini POS, i rinnovi, le modifiche e quelli via API non vengono validati

1. La validazione non è attiva

Installare un'app con una Function di validazione non sempre la attiva. Vai in Impostazioni → Checkout → Regole di checkout e verifica che la regola dell'app sia nell'elenco e attiva. Se è disattivata, nessuna regola di quell'app gira su alcuna superficie. In OrderRules, la checklist per le regole che non si applicano parte proprio da qui.

2. La Function è andata in errore, è scaduta o ha esaurito le istruzioni

Un errore di validazione blocca sempre il checkout. Un'esecuzione fallita no. Se la Function genera un errore o supera i limiti di Shopify, per impostazione predefinita il checkout prosegue senza quella validazione e il cliente non vede nulla. L'app può cambiare questo comportamento con l'impostazione blockOnFailure quando crea la validazione.

Il limite che pesa di più nella pratica è 11 milioni di istruzioni per esecuzione per carrelli fino a 200 righe. Il costo cresce a ogni riga del carrello, quindi una regola che funziona con 3 articoli può fallire con 40. Se il tuo limite regge con i carrelli piccoli e salta con quelli grandi, questa è la causa probabile. I commercianti non possono vedere i log di esecuzione delle Function; lo sviluppatore dell'app sì, dal suo Partner Dashboard. Mandagli l'orario dell'ordine e il numero di righe del carrello. L'elenco completo dei limiti è in Function resource limits.

3. La regola gira solo al checkout

Shopify dice alla Function dove si trova l'acquirente: sta modificando il carrello o è al checkout. Molte app verificano alcune regole solo al checkout, così l'aggiunta al carrello non fallisce mai per, ad esempio, una data di consegna che il cliente non ha ancora scelto. Queste regole non mostrano nulla nella pagina del carrello e bloccano invece al checkout.

In OrderRules, negozio chiuso, tetti d'ordine, tetti per prodotto e variante, quantità minime e a scatti, e limiti per tag e collezione vengono verificati all'aggiunta degli articoli. I limiti per cliente e i controlli di consegna e ritiro girano solo al checkout, perché il cliente potrebbe non aver ancora effettuato l'accesso o scelto una data. Se vuoi che i clienti lo sappiano prima del checkout, mostra la regola nella pagina con un messaggio nello storefront.

4. Il tema nasconde o sostituisce l'errore

Quando una regola rifiuta un'aggiunta al carrello o una modifica di quantità, il tema riceve una richiesta fallita con il messaggio dentro. Quello che succede dopo dipende dal codice del tema:

  • Dawn (16.x) mostra il messaggio sotto il pulsante di aggiunta al carrello. Può anche cambiare il pulsante in "Sold out" (Esaurito), così il prodotto sembra non disponibile anche se lo è.
  • I pulsanti di aggiunta rapida nelle pagine collezione spesso mostrano solo "Sold out" o un breve errore generico.
  • I carrelli a comparsa personalizzati possono ignorare del tutto l'errore e semplicemente non aggiungere l'articolo.

Per confermare che sia il tema: apri gli strumenti per sviluppatori del browser, vai alla scheda Network e aggiungi di nuovo il prodotto. Se una richiesta /cart/add.js o /cart/change.js fallita contiene il tuo messaggio nella risposta, la regola ha funzionato e il tema non l'ha mostrato. Prova la stessa azione in un'anteprima di Dawn non modificato. Se Dawn mostra il messaggio, chiedi al tuo sviluppatore del tema di mostrare l'errore della richiesta di carrello fallita.

5. Il checkout express ha saltato un attributo del carrello

Il riferimento di Shopify sulla validazione segnala che il checkout accelerato da una pagina prodotto salta gli attributi del carrello. Se una regola dipende da qualcosa scelto dal cliente nella pagina del carrello e salvato come attributo del carrello, come una data di consegna o un biglietto regalo, un pulsante Buy it now o Shop Pay nella pagina prodotto non lo invia mai. A seconda di come è costruita l'app, la regola o non vede la scelta oppure blocca l'ordine con un messaggio tipo "scegli una data".

Il rimedio sta nell'app: salvare la scelta su ogni riga, cosa che i pulsanti della pagina prodotto trasportano, oppure richiedere la scelta al checkout. OrderRules salva sulla riga la data di consegna scelta nella pagina prodotto, così gli ordini con Buy it now la mantengono. Prova questo pulsante sul tuo negozio prima di una giornata di punta.

6. I conteggi non erano ancora aggiornati

Una Function non può chiamare il server dell'app durante il checkout. Legge i conteggi che l'app ha salvato prima, e l'app li aggiorna dopo ogni ordine. Quindi il primo checkout dopo il raggiungimento di un limite può passare, e due checkout nello stesso istante per l'ultima unità possono passare entrambi. Qui non manca nessun messaggio: la regola ha visto il conteggio vecchio. Lascia un po' di margine su un tetto che non puoi superare, e vedi per checkout o per cliente: come funzionano i limiti per capire come si contano i limiti per cliente.

7. Un'altra regola o app ha risposto per prima

Shopify esegue ogni Function di validazione attiva, fino a 25 per negozio, e basta che una restituisca un errore per bloccare il checkout. All'interno di una stessa app, le regole vengono spesso verificate in un ordine fisso. In OrderRules, un negozio chiuso mostra solo il messaggio di chiusura anche se il carrello è anche sotto il minimo. Il cliente risolve una cosa, poi vede la successiva. Vedi quale messaggio vede il cliente per l'ordine completo.

Se il messaggio non viene affatto dalla tua app, a bloccare è la validazione di un'altra app. Controlla l'elenco in Impostazioni → Checkout → Regole di checkout.

8. Il messaggio mostra del codice

Un apostrofo che appare come ', o una e commerciale come &, indica che il messaggio ha subito un doppio escape HTML da qualche parte tra l'app e la pagina. È un difetto di visualizzazione dell'app o del tema, non delle tue impostazioni. Segnala allo sviluppatore dell'app la pagina e il messaggio esatti.

9. L'ordine non è mai passato dalla validazione del checkout

Alcuni ordini non eseguono affatto la validazione di carrello e checkout, quindi non c'è alcun messaggio da mostrare:

  • Le vendite Shopify POS
  • Gli ordini di rinnovo degli abbonamenti (il primo checkout dell'abbonamento viene validato)
  • Le modifiche agli ordini dopo l'acquisto
  • Gli ordini creati da altre app o integrazioni tramite la Create Order API
  • Gli acquisti in preordine e con prova prima dell'acquisto

Le bozze d'ordine pagate tramite il checkout della fattura vengono validate. In OrderRules, gli ordini dai canali qui sopra non vengono bloccati, ma contano comunque nei tuoi limiti. La tabella completa è in compatibilità e limitazioni.

Prova ogni superficie in 10 minuti

Usa un negozio di sviluppo o un prodotto di prova, e imposta una regola che puoi violare di proposito, come un massimo di 2.

  1. Pagina prodotto: aggiungi 3. Osserva cosa fanno il pulsante e il messaggio.
  2. Aggiunta rapida dalla collezione: aggiungi il prodotto da una pagina collezione.
  3. Pagina e carrello a comparsa: porta la quantità a 3.
  4. Checkout: vai al checkout con 3 nel carrello. Dovresti vedere il messaggio e non poter pagare.
  5. Buy it now e Shop Pay: acquista 3 dalla pagina prodotto con ciascun pulsante.
  6. Con e senza accesso: ripeti il checkout nei due modi se usi limiti per cliente.
  7. Un carrello grande: aggiungi 40 righe o più se il tuo negozio vende molti piccoli articoli.

Tieni aperta la scheda Network mentre provi. Ogni passaggio che blocca senza un messaggio a schermo è un problema del tema (causa 4). Ogni passaggio che passa quando non dovrebbe dipende dalle cause 1, 2, 5 o 9.

Letture correlate

Fonti

Domande frequenti

Le cause più comuni sono: la validazione non è attiva in Impostazioni → Checkout → Regole di checkout; la Function è andata in errore o ha esaurito le istruzioni, quindi il checkout è proseguito senza di lei; la regola gira solo al checkout, quindi nella pagina del carrello non si vede nulla; oppure il tema intercetta l'errore del carrello e mostra un messaggio generico o "Esaurito". Prova separatamente pagina prodotto, carrello e checkout per capire quale sia.

Nel checkout, un errore riferito all'intero carrello compare nel passaggio corrente, mentre un errore riferito a un campo compare accanto a quel campo. Nel negozio online, un errore restituito mentre si aggiungono o si modificano articoli torna al tema come richiesta di carrello non riuscita. Spetta al tema decidere se e dove mostrarlo. Gli storefront headless leggono gli errori dal carrello della Storefront API.

Se una regola di validazione rifiuta una richiesta di aggiunta al carrello, alcuni temi trattano ogni aggiunta non riuscita come esaurito. Dawn, per esempio, mostra il messaggio sotto il pulsante e può anche cambiare il pulsante in "Sold out". Il prodotto non è esaurito: la regola ha bloccato quella quantità o quel carrello. Controlla quale regola si applica al prodotto.

Non per impostazione predefinita. Se l'esecuzione di una Function fallisce, per esempio per timeout o perché finisce le istruzioni su un carrello grande, Shopify lascia proseguire il checkout senza quella validazione, a meno che l'app l'abbia creata con blockOnFailure attivo. Il cliente non vede alcun messaggio e l'ordine passa.

La validazione gira su Shop Pay, Apple Pay, Google Pay, PayPal express e Buy it now. Una sola avvertenza: il checkout express da una pagina prodotto salta gli attributi del carrello, quindi una regola che dipende da qualcosa scelto dal cliente nella pagina del carrello, come una data di consegna salvata come attributo del carrello, lì non la vede.

Le vendite POS, gli ordini di rinnovo degli abbonamenti, le modifiche agli ordini, gli ordini creati tramite API e gli acquisti in preordine o con prova prima dell'acquisto non eseguono la validazione di carrello e checkout, quindi non possono mostrarne il messaggio. Le bozze d'ordine pagate tramite il checkout della fattura la eseguono.

Stai confrontando app?

Scopri come OrderRules si confronta con tutte le altre app Shopify di questa categoria.

Pronto a prendere il controllo dei tuoi ordini?

Prova OrderRules gratis