Bei einem klassischen Magento Frontend leert ein Kunde seinen Warenkorb normalerweise Artikel für Artikel. Bei Headless Frontends, Apps oder eigenen Integrationen kann es dagegen sinnvoll sein, einen Warenkorb mit einem einzigen Aufruf vollständig zurückzusetzen.
Dafür gibt es in Magento GraphQL die Mutation clearCart.
Sie entfernt sämtliche Positionen aus einem angegebenen Warenkorb. Der Warenkorb selbst bleibt dabei bestehen und kann anschließend weiterverwendet werden.
Wozu braucht man das?
Ein typischer Anwendungsfall ist ein Headless Frontend, in dem dem Kunden eine Funktion wie „Warenkorb leeren“ angeboten wird.
Ohne clearCart müsste die Anwendung zunächst sämtliche Warenkorbpositionen laden und anschließend jede einzelne Position entfernen.
Statt:
Warenkorb laden → Positionen ermitteln → jede Position einzeln löschen
reicht ein einzelner GraphQL Aufruf.
Auch eigene Apps, externe Bestellsysteme oder agentische Anwendungen können einen Warenkorb damit gezielt zurücksetzen, bevor eine neue Zusammenstellung aufgebaut wird.
clearCart per GraphQL aufrufen
Benötigt wird die UID des Warenkorbs:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 |
mutation { clearCart( input: { uid: "B79Qefk7pUaxahYtO8WjOtr5UyEyjaYV" } ) { cart { id itemsV2 { items { uid } } } errors { type message } } } |
War der Aufruf erfolgreich, bleibt der Warenkorb erhalten, enthält anschließend aber keine Positionen mehr.
Die Antwort sieht entsprechend beispielsweise so aus:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
{ "data": { "clearCart": { "cart": { "id": "B79Qefk7pUaxahYtO8WjOtr5UyEyjaYV", "itemsV2": { "items": [] } }, "errors": null } } } |
Warum nicht einfach jeden Artikel einzeln entfernen?
Natürlich lässt sich ein Warenkorb auch mit einzelnen Remove Mutations leeren. Bei zehn Warenkorbpositionen bedeutet das allerdings mehrere Operationen und zusätzliche Logik auf Seiten des Clients.
Mit clearCart beschreibt der Client dagegen direkt seine eigentliche Absicht: Dieser Warenkorb soll komplett leer werden.
Das macht die Integration einfacher und verhindert beispielsweise, dass nach einem teilweise fehlgeschlagenen Löschvorgang einzelne Positionen im Warenkorb zurückbleiben.
Auch für KI Agenten interessant
Die Mutation ist außerdem ein gutes Beispiel dafür, warum GraphQL für Headless und agentische Commerce Anwendungen interessant ist.
Ein Agent könnte beispielsweise den Auftrag erhalten, einen vorhandenen Warenkorb zu verwerfen und anschließend eine neue Produktauswahl zusammenzustellen. Statt selbst zu überlegen, welche einzelnen Warenkorbpositionen entfernt werden müssen, kann er eine dafür vorgesehene Commerce Funktion aufrufen.
Damit ist clearCart zwar eine sehr kleine Magento GraphQL Funktion, löst aber einen durchaus alltäglichen Anwendungsfall sauber mit einem einzigen Aufruf.