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 cliente | Cosa succede | Chi mostra il messaggio |
|---|---|---|
| Checkout | L'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 headless | Gli 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
| Sintomo | Causa probabile | Rimedio |
|---|---|---|
| Nessuna regola scatta, da nessuna parte | 1. Validazione non attiva | Attivala in Regole di checkout |
| Funziona con carrelli piccoli, non con quelli grandi | 2. La Function è andata in errore o ha esaurito le istruzioni | Segnalalo allo sviluppatore dell'app con l'orario e la dimensione del carrello |
| Niente nella pagina del carrello, blocco al checkout | 3. La regola gira solo al checkout | È normale; avvisa i clienti in anticipo |
| "Esaurito" o un errore generico al posto del tuo messaggio | 4. Il tema nasconde o sostituisce l'errore del carrello | Prova con Dawn; correggi la gestione degli errori del tema |
| Funziona dal carrello, non da Buy it now | 5. Il checkout express ha saltato gli attributi del carrello | Salva la scelta per ogni riga, oppure richiedila al checkout |
| Il primo ordine oltre il limite è passato | 6. I conteggi non erano ancora aggiornati | Lascia un margine; i conteggi si aggiornano dopo ogni ordine |
| Compare un messaggio diverso | 7. Un'altra regola o app è scattata prima | Controlla l'ordine in cui vengono verificate le regole |
Il messaggio mostra ' o altro codice | 8. Messaggio con escape doppio | Segnalalo allo sviluppatore dell'app |
| L'ordine è arrivato senza alcun controllo | 9. L'ordine viene da un canale che salta la validazione | Gli 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.
- Pagina prodotto: aggiungi 3. Osserva cosa fanno il pulsante e il messaggio.
- Aggiunta rapida dalla collezione: aggiungi il prodotto da una pagina collezione.
- Pagina e carrello a comparsa: porta la quantità a 3.
- Checkout: vai al checkout con 3 nel carrello. Dovresti vedere il messaggio e non poter pagare.
- Buy it now e Shop Pay: acquista 3 dalla pagina prodotto con ciascun pulsante.
- Con e senza accesso: ripeti il checkout nei due modi se usi limiti per cliente.
- 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
- Come funziona la validazione del checkout di Shopify
- Regole che non si applicano: la checklist di OrderRules
- Dove vengono verificate le regole di OrderRules: compatibilità e limitazioni
- Messaggi dinamici nello storefront
Fonti
- Shopify.dev: Cart and Checkout Validation Function API (target, passaggi del percorso d'acquisto, esecuzioni fallite e
blockOnFailure, superfici supportate, checkout accelerato e attributi del carrello) - Shopify.dev: Function APIs: resource limits
- Shopify Dawn su GitHub:
assets/product-form.js(gestione degli errori di aggiunta al carrello, versione 16.2.0)