cart
Das <liquid>cart</liquid> Objekt enthält Informationen über den aktuellen Warenkorb und die enthaltenen Positionen.
Verfügbarkeit in Templates
In folgenden Templates steht das <obj>cart</obj> Objekt zur Verfügung.
Attribute
Die nachfolgenden Attribute stehen im <obj>cart</obj> Objekt zur Verfügung.
cart.product_count
Gibt die Anzahl der Produkte zurück. Dies entspricht der Summe über die Menge aller Positionen.
cart.coupon_has_free_shipping
Gibt <liquid>true</liquid> zurück, falls der Coupon eine Versandkostenfrei-Option besitzt.
cart.coupon_promotion_products
Gibt die Liste der Promotion Artikel des Aktions-Gutschein zurück. Es wird das <obj>product</obj> Objekt vom Typ <liquid>product.associations</liquid> verwendet. Außerdem stehen folgende Felder je Promotion Artikel zur Verfügung:
- <liquid>is_in_cart</liquid> - Gibt <liquid>true</liquid> zurück, falls sich das Promotion-Produkt bereits im Warenkorb befindet
- <liquid>auto_add_to_cart</liquid> - Gibt <liquid>true</liquid> zurück, falls das Promotion-Produkt automatisch zum Warenkorb hinzugefügt wird
cart.coupon_code
Gibt den Coupon-Code zurück. Dies kann sowohl dem erfolgreich eingelösten Coupon-Code entsprechen, als auch bei einem fehlerhaften Versuch dem ungültigen Coupon-Code.
cart.coupon_error
Gibt ein Fehler-Code zurück, falls der Coupon-Code nicht eingelöst werden konnte.
Übersicht der Fehlercodes:
- <liquid>invalid</liquid> - Ungültiger Coupon-Code
- <liquid>expired</liquid> - Abgelaufener Coupon
- <liquid>max_uses_reached</liquid> - Maxmimale Anzahl der Einlösungen erreicht
- <liquid>registered_customers_only</liquid> - Nur für registrierte Kunden gültig
- <liquid>order_value_too_low</liquid> - Mindesetbestellwert nicht erreicht
- <liquid>invalid_shipping_zone</liquid> - Für die Lieferzone nicht gültig
- <liquid>shipping_costs_exceeded</liquid> - Lieferkosten übersteigen die im Coupon vorgesehenen maximalen Betrag
- <liquid>customer_discount_exists</liquid> - Es existiert bereits ein anderer Kundenrabatt
cart.coupon_type
Gibt zurück, ob es sich um einen prozentualen oder absoluten Coupon handelt:
- <liquid>percentage</liquid> - prozentualer Coupon
- <liquid>absolute</liquid> - absoluter Coupon
cart.discount_type
Gibt zurück, ob es sich um einen prozentualen oder absoluten Rabatt handelt:
- <liquid>percentage</liquid> - prozentualer Rabatt
- <liquid>absolute</liquid> - absoluter Rabatt
cart.discount_promotion_products
Gibt die Liste der Promotion Artikel der "Generellen Aktion" zurück. Es wird das <obj>product</obj> Objekt vom Typ <liquid>product.associations</liquid> verwendet. Außerdem stehen folgende Felder je Promotion Artikel zur Verfügung:
<liquid>is_in_cart</liquid> - Gibt <liquid>true</liquid> zurück, falls sich das Promotion-Produkt bereits im Warenkorb befindet
<liquid>auto_add_to_cart</liquid> - Gibt <liquid>true</liquid> zurück, falls das Promotion-Produkt automatisch zum Warenkorb hinzugefügt wird
cart.after_discount_before_tax_subtotal
Gibt die Netto-Zwischensumme abzüglich Positionsrabatte und Kopfrabatte zurück.
cart.before_discount_subtotal
Gibt die Zwischensumme vor Abzug der Possitionsrabatte und Kopfrabatte zurück.
cart.after_discount_subtotal
Gibt die Zwischensumme nach Abzug der Positionsrabatte und Kopfrabatte Rabtte zurück
cart.premium_type
Gibt zurück, ob es sich um einen prozentualen oder absoluten Premium-Gebühr handelt:
- <liquid>percentage</liquid> - prozentualer Rabatt
- <liquid>absolute</liquid> - absoluter Rabatt
cart.premium_tax_type
Gibt die Berechnungsgrundlage für den Steuersatz von Premium zurück. Dieses Feld kann folgende Werte besitzen:
- <liquid>null</liquid> - Berechnung wird dynamisch anhand der im Warenkorb vorhandenen Steuersätze anteilig vorgenommen
- <liquid>fixed</liquid> - Es wird ein fixer Steuersatz verwendet, der in <liquid>premium_tax_percent</liquid> angegeben ist
- <liquid>line_item_max</liquid> - Es wird der höchte im Warenkorb vorhandene Steuersatz verwendet
cart.premium_tax_name[2|3]
Gibt die zweiten bzw. dritten Steuernbezeichnung für Premium zurück, falls forhanden.
cart.shipping_tax_type
Gibt die Berechnungsgrundlage für den Steuersatz der Versandkoten zurück. Dieses Feld kann folgende Werte besitzen:
- <liquid>null</liquid> - Berechnung wird dynamisch anhand der im Warenkorb vorhandenen Steuersätze anteilig vorgenommen
- <liquid>fixed</liquid> - Es wird ein fixer Steuersatz verwendet, der in <liquid>premium_tax_percent</liquid> angegeben ist
- <liquid>line_item_max</liquid> - Es wird der höchte im Warenkorb vorhandene Steuersatz verwendet
cart.shipping_tax_name[2|3]
Gibt die zweiten bzw. dritten Steuernbezeichnung für die Versandkosten zurück, falls forhanden.
cart.shipping_tax_percent[2|3]
Gibt den zweiten bzw. dritten Steuersatz für die Versandkosten zurück.
cart.shipping_fee_type
Gibt zurück, ob es sich um eine prozentuale oder absolute Versand-Zusatzgebühr handelt:
- <liquid>percentage</liquid> - prozentuale Zusatzgebühr
- <liquid>absolute</liquid> - absoluter Zusatzgebühr
cart.shipping_fee_tax_type
Gibt die Berechnungsgrundlage für den Steuersatz der Zusatzgebühren für den Versand zurück. Dieses Feld kann folgende Werte besitzen:
- <liquid>null</liquid> - Berechnung wird dynamisch anhand der im Warenkorb vorhandenen Steuersätze anteilig vorgenommen
- <liquid>fixed</liquid> - Es wird ein fixer Steuersatz verwendet, der in <liquid>premium_tax_percent</liquid> angegeben ist
- <liquid>line_item_max</liquid> - Es wird der höchte im Warenkorb vorhandene Steuersatz verwendet
cart.shipping_fee_tax_name[2|3]
Gibt die zweiten bzw. dritten Steuernbezeichnung für die Zusatzgebühr des Versands zurück, falls forhanden.
cart.shipping_fee_tax_percent[2|3]
Gibt den zweiten bzw. dritten Steuersatz für die Zusatzgebühr des Versands zurück.
cart.payment_type
Gibt den Zahlungstyp zurück. Dieses Feld kann folgende Werte besitzen:
- <liquid>payment_invoice</liquid> - Rechnung
- <liquid>payment_cash_on_delivery</liquid> - Nachnahme
- <liquid>payment_withdrawal</liquid> - Bankeinzug
- <liquid>payment_cash</liquid> - Barzahlung
- <liquid>payment_prepayment</liquid> - Vorauskasse
- <liquid>payment_installments</liquid> - Ratenzahlung
- <liquid>payment_paypal</liquid> - PayPal
- <liquid>payment_creditcard</liquid> - Kreditkarte
- <liquid>payment_online_bank_transfer</liquid> - Online Bank Transfer
- <liquid>payment_debit_card</liquid> - Debitkarte
cart.payment_tax_type
Gibt die Berechnungsgrundlage für den Steuersatz der Zahlungskosten zurück. Dieses Feld kann folgende Werte besitzen:
- <liquid>null</liquid> - Berechnung wird dynamisch anhand der im Warenkorb vorhandenen Steuersätze anteilig vorgenommen
- <liquid>fixed</liquid> - Es wird ein fixer Steuersatz verwendet, der in <liquid>premium_tax_percent</liquid> angegeben ist
- <liquid>line_item_max</liquid> - Es wird der höchte im Warenkorb vorhandene Steuersatz verwendet
cart.payment_tax_name[2|3]
Gibt die zweiten bzw. dritten Steuernbezeichnung für die Zahlungskosten zurück, falls forhanden.
cart.payment_tax_percent[2|3]
Gibt den zweiten bzw. dritten Steuersatz für die Zahlungskosten zurück.
cart.payment_fee_type
Gibt zurück, ob es sich um eine prozentuale oder absolute Zahlungs-Zusatzgebühr handelt:
- <liquid>percentage</liquid> - prozentuale Zusatzgebühr
- <liquid>absolute</liquid> - absoluter Zusatzgebühr
cart.payment_fee_tax_type
Gibt die Berechnungsgrundlage für den Steuersatz der Zusatzgebühren für die Zahlung zurück. Dieses Feld kann folgende Werte besitzen:
- <liquid>null</liquid> - Berechnung wird dynamisch anhand der im Warenkorb vorhandenen Steuersätze anteilig vorgenommen
- <liquid>fixed</liquid> - Es wird ein fixer Steuersatz verwendet, der in <liquid>premium_tax_percent</liquid> angegeben ist
- <liquid>line_item_max</liquid> - Es wird der höchte im Warenkorb vorhandene Steuersatz verwendet
cart.payment_fee_tax_name[2|3]
Gibt die zweiten bzw. dritten Steuernbezeichnung für die Zusatzgebühr der Zahlung zurück, falls forhanden.
cart.payment_fee_tax_percent[2|3]
Gibt den zweiten bzw. dritten Steuersatz für die Zusatzgebühr der Zahlung zurück.
cart.tax_lines
Gibt die aufsummierten Steuersätze in Form einer Liste von <obj>tax_line</obj> Objekte zurück.
Beispiel
Nachfolgend sehen Sie beispielhaft einen Ausschnitt aus dem <obj>cart</obj> Objekt.
{
"cart": {
"id": 1469183946470587904,
"customer": {
"registered": false,
"email": "info@example.com"
},
"billing_address": {
"gender": "m",
"first_name": "Jane",
"last_name": "Doe",
"line2": "Main Street 1",
"city": "Beverly Hills",
"zip": "90210",
"country": "US",
"country_name": "United States of America"
},
"product_count": 3,
"item_count": 2,
"line_items": [{
"position": 1,
"id": 100055,
"name": "Red shirt",
"url": "/red-shirt-40/",
"sku": "71766750-25-40",
"item_quantity": 2,
"list_price": 49.95,
"price": 49.95,
"before_discount_price": 49.95,
"total": 89.91,
"before_discount_total": 99.9,
"tax_name": "Mwst.",
"tax_percent": 19,
"coupon_code": "FEQHP7VK",
"discount_percent": 10,
"discount_total": 9.99
},{
"position": 2,
"id": 100022,
"name": "Sunglasses",
"url": "/sunglasses/",
"sku": "003-00-00",
"item_quantity": 1,
"list_price": 60,
"price": 60,
"before_discount_price": 60,
"total": 54,
"before_discount_total": 60,
"tax_name": "Mwst.",
"tax_percent": 19,
"coupon_code": "FEQHP7VK",
"discount_percent": 10,
"discount_total": 6
}],
"total_weight": 0,
"total_volume": 0
"coupon_code": "FEQHP7VK",
"coupon_type": "percent",
"coupon_total": 15.99,
"coupon_has_free_shipping": false,
"discount_type": "absolute",
"discount_total": 5,
"shipping_method": {
"id": 1
},
"shipping_name": "Standard Shipping",
"shipping_handle": "standard",
"shipping_cost": 0,"
"shipping_tax_type": "line_item_dynamic",
"shipping_tax_name": "Mwst.",
"shipping_tax_priority": 1,
"shipping_total": 0,
"payment_method": {
"id": 1
},
"payment_name": "Invoice",
"payment_handle": "invoice",
"payment_type": "payment_invoice",
"payment_cost": 0,
"payment_tax_type": "line_item_dynamic",
"payment_tax_name": "Mwst.",
"payment_tax_priority": 1,
"payment_total": 0,
"line_items_subtotal": 143.91,
"before_discount_subtotal": 159.9,
"after_discount_subtotal": 138.91,
"after_discount_before_tax_subtotal": 116.73,
"before_tax_total": 116.73,
"taxes_total": 22.18,
"total": 138.91,
"tax_lines": [{
"tax_rate_id": 1,
"name": "Mwst.",
"percent": 19,
"before_tax_total": 116.73,
"tax_total": 22.18,
"total": 138.91
}]
}
}