Zeigt eine Shopify-Validierungsregel keine Meldung, liegt meist einer von vier Gründen vor: Die Validierung ist ausgeschaltet, die Function ist fehlgeschlagen und der Checkout lief ohne sie weiter, die Regel läuft nur im Checkout, oder das Theme hat den Fehler erhalten und nicht angezeigt. Testen Sie Produktseite, Warenkorb und Checkout nacheinander, um die Ursache zu finden.
Diese Anleitung behandelt die Checkout-Validierung mit Shopify Functions, so blockieren Apps für Bestelllimits, Mindestbestellwerte und Öffnungszeiten (auch OrderRules) Bestellungen. Wenn Sie neu im Thema sind, beginnen Sie mit So funktioniert die Shopify-Checkout-Validierung.
Wo Shopify Validierungsfehler anzeigt
Wo die Meldung erscheint, hängt davon ab, wo sich der Kunde befindet.
| Wo der Kunde ist | Was passiert | Wer die Meldung anzeigt |
|---|---|---|
| Checkout | Der Fehler blockiert den Schritt. Ein Fehler für den ganzen Warenkorb erscheint auf der aktuellen Checkout-Seite, ein Fehler für ein Feld neben diesem Feld. | Shopify |
| Produktseite oder Warenkorb (Artikel hinzufügen oder ändern) | Die Warenkorb-Anfrage schlägt fehl und gibt den Fehler zurück. | Ihr Theme, sofern es den Fehler liest |
| Headless-Storefront | Fehler erscheinen im Warenkorb der Storefront API. | Ihr Frontend |
| Express-Checkout (Shop Pay, Apple Pay, Google Pay, PayPal, Jetzt kaufen) | Die Validierung läuft wie im Checkout. | Shopify |
In der mittleren Zeile gehen Meldungen verloren. Shopify schickt den Fehler zurück; ob der Kunde ihn sieht, hängt am JavaScript des Themes.
Die 9 Ursachen nach Symptom
| Symptom | Wahrscheinliche Ursache | Lösung |
|---|---|---|
| Keine Regel greift, nirgends | 1. Validierung nicht aktiv | In den Checkout-Regeln einschalten |
| Funktioniert bei kleinen Warenkörben, bei großen nicht | 2. Function abgestürzt oder Instruktionen aufgebraucht | Dem App-Entwickler Uhrzeit und Warenkorbgröße melden |
| Nichts im Warenkorb, aber im Checkout blockiert | 3. Regel läuft nur im Checkout | Erwartetes Verhalten; Kunden vorab informieren |
| "Sold out" oder ein allgemeiner Fehler statt Ihrer Meldung | 4. Theme versteckt oder ersetzt den Warenkorb-Fehler | In Dawn testen; die Fehlerbehandlung des Themes korrigieren |
| Funktioniert im Warenkorb, nicht mit Jetzt kaufen | 5. Express-Checkout hat Warenkorb-Attribute übersprungen | Auswahl pro Position speichern oder im Checkout verlangen |
| Die erste Bestellung nach dem Limit ging noch durch | 6. Zählerstände waren noch nicht aktualisiert | Spielraum lassen; Zählerstände werden nach jeder Bestellung aktualisiert |
| Eine andere Meldung erscheint | 7. Eine andere Regel oder App ist zuerst fehlgeschlagen | Prüfen, ob die Bestellregeln aktiv sind |
Die Meldung zeigt ' oder anderen Code | 8. Meldung doppelt maskiert | Dem App-Entwickler melden |
| Bestellung kam ganz ohne Prüfung an | 9. Bestellung kam aus einem Kanal ohne Validierung | POS, Verlängerungen, Bearbeitungen und API-Bestellungen werden nicht validiert |
1. Die Validierung ist nicht aktiv
Die Installation einer App mit Validierungs-Function schaltet sie nicht immer ein. Gehen Sie zu Einstellungen → Checkout → Checkout-Regeln und prüfen Sie, ob die Regel der App aufgeführt und eingeschaltet ist. Ist sie aus, läuft keine Regel dieser App auf irgendeiner Fläche. Bei OrderRules geht die Checkliste „Regeln greifen nicht" genau diesen Punkt zuerst durch.
2. Die Function ist abgestürzt, in ein Timeout gelaufen oder hat ihre Instruktionen aufgebraucht
Ein Validierungsfehler blockiert den Checkout immer. Ein fehlgeschlagener Lauf nicht. Wirft die Function einen Fehler oder überschreitet sie die Limits von Shopify, läuft der Checkout standardmäßig ohne diese Validierung weiter, und der Kunde sieht nichts. Die App kann das mit der Einstellung blockOnFailure ändern, wenn sie die Validierung anlegt.
Das Limit, das in der Praxis zuschlägt, sind 11 Millionen Instruktionen pro Lauf bei Warenkörben mit bis zu 200 Positionen. Die Kosten wachsen mit jeder Position im Warenkorb, eine Regel, die mit 3 Artikeln funktioniert, kann bei 40 Artikeln fehlschlagen. Hält Ihr Limit bei kleinen Warenkörben und versagt bei großen, ist das die wahrscheinliche Ursache. Händler sehen keine Function-Protokolle; der App-Entwickler sieht sie in seinem Partner Dashboard. Schicken Sie ihm die Uhrzeit der Bestellung und die Anzahl der Positionen im Warenkorb. Alle Limits stehen unter Function-Ressourcenlimits.
3. Die Regel läuft nur im Checkout
Shopify teilt der Function mit, wo der Käufer gerade ist: beim Ändern des Warenkorbs oder im Checkout. Viele Apps prüfen manche Regeln nur im Checkout, damit das Hinzufügen in den Warenkorb nie an einem Lieferdatum scheitert, das der Kunde noch nicht gewählt hat. Diese Regeln zeigen im Warenkorb nichts an und blockieren stattdessen im Checkout.
Bei OrderRules werden Shop geschlossen, Bestellobergrenzen, Produkt- und Variantenlimits, Mindest- und Schrittmengen sowie Tag- und Kollektionslimits beim Hinzufügen von Artikeln geprüft. Limits pro Kunde sowie Liefer- und Abholprüfungen laufen nur im Checkout, weil der Kunde eventuell noch nicht eingeloggt ist oder noch kein Datum gewählt hat. Wenn Kunden es schon vor dem Checkout wissen sollen, zeigen Sie die Regel mit einem Hinweis im Onlineshop auf der Seite an.
4. Das Theme versteckt oder ersetzt den Fehler
Lehnt eine Regel das Hinzufügen in den Warenkorb oder eine Mengenänderung ab, erhält das Theme eine fehlgeschlagene Anfrage mit der Meldung darin. Was dann passiert, ist Theme-Code:
- Dawn (16.x) zeigt die Meldung unter dem Button „In den Warenkorb" an. Es kann den Button zusätzlich auf "Sold out" (Ausverkauft) umstellen, sodass das Produkt nicht verfügbar wirkt, obwohl es das ist.
- Quick-Add-Buttons auf Kollektionsseiten zeigen oft nur "Sold out" oder einen kurzen allgemeinen Fehler.
- Eigene Warenkorb-Drawer ignorieren den Fehler unter Umständen komplett und fügen den Artikel einfach nicht hinzu.
So bestätigen Sie, dass es am Theme liegt: Öffnen Sie die Entwicklertools des Browsers, wechseln Sie zum Tab Netzwerk (Network) und fügen Sie das Produkt erneut hinzu. Eine fehlgeschlagene Anfrage an /cart/add.js oder /cart/change.js, deren Antwort Ihre Meldung enthält, bedeutet: Die Regel hat funktioniert, das Theme hat sie nicht angezeigt. Probieren Sie dieselbe Aktion in einer unveränderten Dawn-Vorschau. Zeigt Dawn die Meldung an, bitten Sie Ihren Theme-Entwickler, den Fehler aus der fehlgeschlagenen Warenkorb-Anfrage anzuzeigen.
5. Der Express-Checkout hat ein Warenkorb-Attribut übersprungen
Die Validierungsreferenz von Shopify weist darauf hin, dass der beschleunigte Checkout von einer Produktseite Warenkorb-Attribute überspringt. Hängt eine Regel von einer Auswahl ab, die der Kunde auf der Warenkorbseite getroffen und als Warenkorb-Attribut gespeichert hat, etwa einem Lieferdatum oder einer Geschenknotiz, sendet ein Button „Jetzt kaufen" oder Shop Pay auf der Produktseite sie nie mit. Je nach Aufbau der App kann die Regel die Auswahl entweder nicht sehen oder blockiert die Bestellung mit einer Meldung wie „Datum wählen".
Die Lösung liegt in der App: die Auswahl an jeder Position speichern, was Buttons auf der Produktseite mitsenden, oder die Auswahl im Checkout verlangen. OrderRules speichert ein auf der Produktseite gewähltes Lieferdatum an der Position, damit Bestellungen über „Jetzt kaufen" es behalten. Testen Sie diesen Button in Ihrem Shop vor einem umsatzstarken Tag.
6. Die Zählerstände waren noch nicht aktuell
Eine Function kann während des Checkouts den Server der App nicht aufrufen. Sie liest Zählerstände, die die App zuvor gespeichert hat, und die App aktualisiert sie nach jeder Bestellung. Deshalb kann der erste Checkout nach Erreichen eines Limits durchgehen, und zwei gleichzeitige Checkouts für die letzte Einheit können beide durchgehen. Hier fehlt keine Meldung; die Regel hat den alten Zählerstand gesehen. Lassen Sie bei einer Obergrenze, die Sie nicht überschreiten dürfen, etwas Spielraum, und lesen Sie Limits pro Checkout vs. pro Kunde, wie Kundenlimits zählen.
7. Eine andere Regel oder App hat zuerst geantwortet
Shopify führt jede aktive Validierungs-Function aus, bis zu 25 pro Shop, und jede einzelne, die einen Fehler zurückgibt, blockiert den Checkout. Innerhalb einer App werden Regeln oft in fester Reihenfolge geprüft. Bei OrderRules zeigt ein geschlossener Shop nur die Meldung „geschlossen", selbst wenn der Warenkorb auch unter dem Mindestwert liegt. Der Kunde behebt eins, dann sieht er das Nächste. Die vollständige Reihenfolge steht unter welche Meldung der Kunde sieht.
Stammt die Meldung gar nicht von Ihrer App, blockiert die Validierung einer anderen App. Prüfen Sie die Liste unter Einstellungen → Checkout → Checkout-Regeln.
8. Die Meldung zeigt Code
Ein Apostroph, der als ' erscheint, oder ein Und-Zeichen als &, bedeutet: Die Meldung wurde zwischen App und Seite zweimal HTML-maskiert. Das ist ein Anzeigefehler in der App oder im Theme, kein Fehler in Ihren Einstellungen. Melden Sie dem App-Entwickler die genaue Seite und Meldung.
9. Die Bestellung hat die Checkout-Validierung nie durchlaufen
Manche Bestellungen durchlaufen die Warenkorb- und Checkout-Validierung gar nicht, also gibt es keine Meldung, die angezeigt werden könnte:
- Shopify-POS-Verkäufe
- Abo-Verlängerungen (der erste Abo-Checkout wird validiert)
- Bestellbearbeitungen nach dem Kauf
- Bestellungen anderer Apps oder Integrationen über die Create Order API
- Vorbestellungen und Erst-testen-dann-kaufen-Käufe
Entwurfsbestellungen, die über den Rechnungs-Checkout bezahlt werden, werden validiert. Bei OrderRules werden Bestellungen aus den oben genannten Kanälen nicht blockiert, zählen aber trotzdem für Ihre Limits. Die vollständige Tabelle steht unter Kompatibilität und Einschränkungen.
Alle Flächen in 10 Minuten testen
Nutzen Sie einen Entwicklungsshop oder ein Testprodukt und legen Sie eine Regel an, die Sie absichtlich brechen können, etwa ein Maximum von 2.
- Produktseite: 3 hinzufügen. Notieren Sie, was Button und Meldung tun.
- Quick-Add in der Kollektion: Das Produkt von einer Kollektionsseite hinzufügen.
- Warenkorbseite und Drawer: Die Menge auf 3 ändern.
- Checkout: Mit 3 im Warenkorb zum Checkout gehen. Sie sollten die Meldung sehen und nicht bezahlen können.
- Jetzt kaufen und Shop Pay: 3 von der Produktseite mit jedem Button kaufen.
- Eingeloggt und ausgeloggt: Den Checkout bei beiden Varianten wiederholen, wenn Sie Limits pro Kunde nutzen.
- Ein großer Warenkorb: 40 oder mehr Positionen hinzufügen, wenn Ihr Shop viele kleine Artikel verkauft.
Lassen Sie beim Testen den Tab „Netzwerk" geöffnet. Jeder Schritt, der blockiert, ohne dass eine Meldung auf dem Bildschirm erscheint, ist ein Theme-Problem (Ursache 4). Jeder Schritt, der durchgeht, obwohl er nicht sollte, deutet auf die Ursachen 1, 2, 5 oder 9.
Weiterführende Artikel
- So funktioniert die Shopify-Checkout-Validierung
- Regeln greifen nicht: die OrderRules-Checkliste
- Wo OrderRules-Regeln geprüft werden: Kompatibilität & Einschränkungen
- Dynamische Hinweise im Onlineshop
Quellen
- Shopify.dev: Cart and Checkout Validation Function API (Targets, Schritte der Buyer Journey, fehlgeschlagene Läufe und
blockOnFailure, unterstützte Flächen, beschleunigter Checkout und Warenkorb-Attribute) - Shopify.dev: Function APIs: Ressourcenlimits
- Shopify Dawn auf GitHub:
assets/product-form.js(Fehlerbehandlung beim Hinzufügen in den Warenkorb, Version 16.2.0)