Shop-Software CP::Shop - Eröffnen Sie Ihren eigenen Online-Shop!Shop-Software CP::Shop - Eröffnen Sie Ihren eigenen Online-Shop!

Spezialisten mit langjähriger Erfahrung

Schnelle Projektumsetzungen

sandoba.takeoff - Komplettpaket für Ihr Internetprojekt Kontakt mit sandoba.de aufnehmen

Webservices: Warenkorb

Eine Besonderheit der Webservices-Schnittstelle von CP::Shop ist die Möglichkeit, den Warenkorb mittels Webservices verwalten zu können, ohne dass der Kunde bemerkt, dass dieser Vorgang eigentlich synchron bei einem anderen Shop abläuft. Um eine Bestellung mittels Webservices durchzuführen, sind folgende Schritte nacheinander zu befolgen:

  • Neuen Warenkorb anlegen
  • Warenkorb mit Artikeln füllen
  • Artikelanzahl anpassen (optional)
  • Artikel entfernen (optional)
  • Warenkorbinhalt anzeigen (optional)
  • Warenkorb löschen (optional)
  • Warenkorb absenden
Neuen Warenkorb anlegen

Bevor Artikel zum Warenkorb hinzugefügt werden können, muss zuerst ein neuer Warenkorb über eine spezielle URL angelegt werden. U.a. wird in dieser URL der Parameter "cart" genutzt mit dem Wert "create". Als Ergebnis liefert CP::Shop einen "Userkey" zurück, der nachfolgend diesen Warenkorb repräsentiert.

*/webservices.php?file=shop&cart=create
// legt einen Warenkorb an

Der Userkey sollte im Partner-Shop hinterlegt werden. Dies kann bspw. per Session, Cookie oder als Parameter über die URL geschehen. Wenn der Userkey nicht mehr vorhanden ist, dann kann auch keine Verbindung mehr zwischen dem aktuellen Nutzer und dessen Warenkorb hergestellt werden.

Warenkorb mit Artikeln füllen

Nachdem der Warenkorb angelegt und der Userkey gespeichert wurde, kann im nächsten Schritt mit dem Hinzufügen der neuen Artikel begonnen werden. Der Parameter "cart" in der URL besitzt nun den Wert "add". Schrittweise werden dem CP::Shop jetzt die einzelnen Artikel übermittelt, zusammen mit der gewünschten Anzahl und dem Userkey. Für jeden Artikel muss die shop-interne Nummer (aus dem Feld "number") bzw. die normale Artikelnummer (aus dem Feld "itemnr") übermittelt werden.


*/webservices.php?file=shop&cart=add&article.CP_015=2&userkey=3jlkjf8JLKAAi95
// Artikel "CP_015" zu einem vorhandenen Warenkorb hinzufügen

Sie können gleichzeitig beliebig viele unterschiedliche Artikel zum Warenkorb hinzufügen, indem der Abschnitt "&article.[ARTIKEL-NUMMER]=[ANZAHL]" in der URL mit den entsprechenden Angaben wiederholt wird.

Artikelanzahl anpassen

Im Warenkorb vorhandene Artikel können jederzeit in der Anzahl geändert werden. Hierzu muss in der URL der Parameter "cart" auf "edit" gesetzt werden. Es folgt die Aufzählung der Artikel, zusammen mit der gewünschten neuen Anzahl:


Die neue Anzahl kann eine beliebige Zahl > 0 sein. Um einen Artikel aus dem Warenkorb komplett zu entfernen, nutzen Sie den folgenden Schritt. Diese Trennung dient hauptsächlich der besseren Übersicht.

Artikel entfernen

Ein Artikel kann auch komplett aus dem Warenkorb entfernt werden. Der Parameter "cart" lautet nun "delete". Es folgt die Aufzählung der Artikel, zusammen mit der gewünschten neuen Anzahl (wie bei "add" und "edit"):


Warenkorbinhalt anzeigen

Zur Simulation eines Warenkorbes gehört natürlich auch die Anzeige des aktuellen Warenkorbinhaltes mit den einzelnen Artikeln und deren Menge. Diese Informationen können z.B. mit der Abfrage von Artikelinformationen verknüpft werden, um Preise und Bilder im Warenkorb anzeigen zu können. Der Parameter "cart" lautet nun "get":


Warenkorb löschen

Um sich beim Löschen des Warenkorbinhaltes das schrittweise Löschen der einzelnen Artikel zu ersparen, gibt es auch für diese Aufgabe eine spezielle URL. Der Parameter "cart" wird nun auf "clear" gestellt:


Warenkorb absenden

Sind alle Artikel im Warenkorb, können Sie den Benutzer mittels Checkout-Button zum eigentlichen Shop springen lassen. Dort kann er durch Auswahl der gewünschten Zahlungsart, Eintragen seiner Adresse usw. dann die Bestellung abschließen. Der Parameter "cart" muss hierzu auf "checkout" gestellt werden:

Weitere Einträge zu "CP::Shop"

<< zurück zur Kategorie "CP::Shop"

Hier finden Sie die eBusiness-/eCommerce-Spezialisten von sandoba.de:
https://www.sandoba.de/dokumentation/cms-infos/webservices-warenkorb-517.html