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.id

Gibt die eindeutige numerische ID des Warenkorbs zurück.

cart.item_count

Gibt die Anzahl der Positionen zurück.

cart.product_count

Gibt die Anzahl der Produkte zurück. Dies entspricht der Summe über die Menge aller Positionen.

cart.line_items

Gibt die Positionen in Form einer Liste von <obj>line_item</obj> Objekte zurück.

cart.line_items_subtotal

Gibt die Zwischensumme abzüglich Positionsrabatten zurück.

cart.coupon_name

Gibt den Namen des Coupons zurück.

cart.coupon_description

Gibt die Beschreibung des Coupons zurück

cart.coupon_has_free_shipping

Gibt <liquid>true</liquid> zurück, falls der Coupon eine Versandkostenfrei-Option besitzt.

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.coupon_total

Gibt den gewährten Rabatt des Coupons zurück.

cart.discount_name

Gibt den Namen des Rabatts zurück.

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_total

Gibt den gewährten Rabatt zurück.

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_name

Gibt den Namen der Premium-Gebühr 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_total

Gibt die absolute Premium-Gebühr zurück.

cart.premium_percent

Gibt die prozentuale Premium-Gebühr zurück.

cart.premium_tax_name

Gibt die Steuernbezeichnung für Premium zurück.

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_percent

Gibt den Steuersatz für Premium zurück.

cart.premium_tax_name[2|3]

Gibt die zweiten bzw. dritten Steuernbezeichnung für Premium zurück, falls forhanden.

cart.premium_tax_percent[2|3]

Gibt den zweiten bzw. dritten Steuersatz für Premium zurück.

cart.shipping_method.id

Gibt ID der Versandmethode zurück.

cart.shipping_handle

Gibt das Handle der Versandmethode zurück.

cart.shipping_name

Gibt den Namen der Versandmethode zurück.

cart.shipping_description

Gibt die Beschreibung der Versandmethode zurück.

cart.shipping_cost

Gibt die Versandkosten zurück.

cart.before_discount_shipping_cost

Gibt die Versandkosten vor Abzug von Rabatten zurück.

cart.shipping_tax_name

Gibt die Steuernbezeichnung für die Versandkosten zurück.

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_percent

Gibt den Steuersatz für die Versandkosten zurück.

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_name

Gibt den Namen der Zusatzgebühr für den Versand zurück.

cart.shipping_fee_cost

Gibt die Zusatzgebühr für den Versand 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_percent

Gibt die prozentuale Zusatz-Gebühr für den Versand zurück.

cart.shipping_fee_tax_name

Gibt die Steuernbezeichnung für die Zusatzgebühr des Versand zurück.

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_percent

Gibt den Steuersatz für die Zusatzgebühr des Versands zurück.

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.shipping_total

Gibt die Summe aus Versandkosten und Zusatzgebühr zurück.

cart.payment_method.id

Gibt ID der Zahlungsmethode zurück.

cart.payment_handle

Gibt das Handle der Zahlungsmethode zurück.

cart.payment_name

Gibt den Namen der Zahlungsmethode zurück.

cart.payment_description

Gibt die Beschreibung der Zahlungsmethode zurück.

cart.payment_due_period

Gibt das Zahlungsziel zurück.

cart.payment_legal

Gibt den rechtlichen Hinweis zur Zahlungsmethode 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_cost

Gibt die Zahlungskosten zurück.

cart.payment_tax_name

Gibt die Steuernbezeichnung für die Zahlungskosten zurück.

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_percent

Gibt den Steuersatz für die Zahlungskosten zurück.

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_name

Gibt den Namen der Zusatzgebühr für den Zahlung zurück.

cart.payment_fee_cost

Gibt die Zusatzgebühr für den Zahlung 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_percent

Gibt die prozentuale Zusatz-Gebühr für die Zahlung zurück.

cart.payment_fee_tax_name

Gibt die Steuernbezeichnung für die Zusatzgebühr der Zahlung zurück.

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_percent

Gibt den Steuersatz für die Zusatzgebühr der Zahlung zurück.

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.payment_total

Gibt die Summe aus Zahlungskosten und Zusatzgebühr zurück.

cart.total_weight

Gibt das Summe des Logistk-Gewicht aller Artikel im Warenkorb zurück.

cart.total_volume

Gibt das Summe des Logistk-Volumen aller Artikel im Warenkorb zurück.

cart.before_tax_total

Gibt die Netto-Warenkorbsumme zurück.

cart.tax_lines

Gibt die aufsummierten Steuersätze in Form einer Liste von <obj>tax_line</obj> Objekte zurück.

cart.taxes_total

Gibt den Höhe der Steuern zurück.

cart.total

Gibt den Brutto-Warenkorbwert zurück.

cart.comment

Gibt den Kommentar zum Warenkorb zurück.

cart._string[1..10]

Warenkorbbezogene Textfelder zur freien Belegung.

cart._integer[1..10]

Warenkorbbezogene Ganzahl-Felder zur freien Belegung.

cart._float[1..2]

Warenkorbbezogene Gleitkommazahl-Felder zur freien Belegung

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
     }]
  }
}