Warenkörbe
Überblick
Ein Warenkorb ist ein begonnener Einkauf im Shop, der noch keine Bestellung ist. Der Shop meldet ihn, sobald jemand den Checkout beginnt, und jede Änderung schreibt denselben Warenkorb fort. Ruht er eine Stunde, trägt eine E-Mail-Adresse und ist nicht bestellt, gilt er als verlassen — das ist der Auslöser der Warenkorb-Erinnerung und eigener Automationen.
Sie erreichen die Liste über Warenkörbe in den Verkaufskanälen.
Kernaufgaben
Stand ablesen. Jede Zeile zeigt letzte Aktivität, Adresse, Name, Kanal, Inhalt, Summe und den Stand:
- Offen — begonnen, die Stunde Ruhe ist noch nicht um oder es fehlt die Adresse.
- Verlassen — gemeldet; die Warenkorb-Erinnerung hat ihn aufgenommen, wenn sie läuft.
- Bestellt — der Shop hat den Abschluss gemeldet, oder eine Bestellung derselben Adresse kam im selben
Kanal herein. Wartende Erinnerungen enden damit sofort.
Nach Stand filtern. Der Filter Stand zeigt etwa nur die verlassenen Warenkörbe.
Shop anbinden. Gemeldet wird über einen Ablauf im Integrations-Hub. Für Shopify gibt es die Vorlage Shopify: Warenkörbe per Webhook — siehe Shopify. Andere Shops melden über eine eigene Zuordnung an dieselbe Schnittstelle.
Felder im Detail
Die Spalte Was es bewirkt beantwortet, was sich im System ändert — nicht, wie das Feld heißt. Der graue Name dahinter ist das Feld der API.
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Kennung externalId | ja | Text | Erkennt den Warenkorb wieder; jede Meldung mit derselben Kennung schreibt ihn fort. |
E-Mail email | nein | Adresse | Ohne Adresse wird kein Warenkorb als verlassen gemeldet — niemand wäre zu erinnern. |
Telefon phone | nein | Nummer | Für die Kurznachricht der Erinnerung; versendet wird nur mit SMS-Einwilligung. |
Summe totalAmount | nein | Cent | Steht in der Erinnerung („zusammen 49,90 EUR"). |
Inhalt items | nein | Liste | Artikel, Menge und Preis; die Erinnerung nennt bis zu drei. |
Rückweg recoveryUrl | nein | Adresse im Shop | Der Knopf Zum Warenkorb führt dorthin. |
Letzte Aktivität lastActivityAt | — | Zeitpunkt | Ab hier läuft die Stunde bis verlassen; jede Änderung setzt sie neu. |
Stand status | — | offen, verlassen, bestellt | Siehe oben. |
Bestellt am orderedAt | — | Zeitpunkt | Wann bestellt wurde. Der Shop meldet ihn als completedAt, sonst setzt ihn eine Bestellung derselben Adresse im selben Kanal. |
Einstellungen & Rechte
- Modul
module.channels. channels.checkout.view— Warenkörbe sehen. Ein eigenes Recht, weil Adresse und Inhalt einer Person
sichtbar werden; Marken-Schnitt über den Kanal.
channels.sync.execute— Warenkörbe melden (der Ablauf im Integrations-Hub).- Die Standard-Automation Warenkorb verlassen melden ist ab Werk an. Für eine andere Frist legen Sie
eine Kopie mit anderem Abstand an und schalten diese ab.
- Über die Schnittstelle:
POST /v1/channels/channels/{ulid}/checkouts(melden),
GET /v1/channels/checkouts (lesen).
FAQ & Fehlerbilder
Die Liste bleibt leer. Der Shop meldet noch keine Warenkörbe. Installieren Sie im Integrations-Hub die Vorlage für Ihren Shop und tragen Sie dort die Webhook-Adresse ein.
Ein Warenkorb bleibt offen, obwohl er seit Stunden ruht. Es fehlt die E-Mail-Adresse — Shopify kennt sie erst, wenn der Käufer sie im Checkout eingegeben hat.
Shopware und WooCommerce melden keine Warenkörbe. Beide liefern ab Werk kein Ereignis für begonnene Warenkörbe. Ein Shop-Plugin, das Warenkörbe per Webhook sendet, lässt sich über eine eigene Zuordnung an dieselbe Schnittstelle anbinden.