Checkout-Regeln und Kauf-Freigaben

Diese Referenz richtet sich an Administratoren und Integratoren. Sie beschreibt, wie Sie in Workspace festlegen, wer in einem Shop bestellen darf und welche Angaben, Freigaben und Zahlungsnachweise dafür nötig sind. Entscheidend sind die Regeln des Mandanten und des jeweiligen Vertriebskanals. Ein Firmenname allein erteilt weder Firmenkontozugriff noch steuerliche Vergünstigungen.

Mandant und Vertriebskanal

Unter Kaufbedingungen legen Sie unveränderliche Regelversionen an. Ohne Vertriebskanal gilt eine Version als Mandantenvorgabe. Mit Vertriebskanal enthält sie dessen Abweichungen. Das Dokument wird als JSON gepflegt.

Kanäle ohne Commerce-Profil, etwa für einen Produktfeed, verhindern die Aktivierung der Mandantenvorgabe nicht. Die Vorschau kennzeichnet sie gesondert. Für einen Checkout mit aktiven Regeln muss das Commerce-Profil vorhanden und weiterhin dem Vertriebskanal zugeordnet sein.

Eine leere Liste ist eine ausdrückliche Konfiguration. Ein weggelassenes Feld bedeutet Vererbung. Ein Kanal mit leerem overrides kehrt zur Mandantenvorgabe zurück. Ohne aktive Mandantenvorgabe kann keine Kanalabweichung aktiviert werden.

Öffnen Sie vor der Aktivierung die Vorschau. Sie zeigt den bisherigen und den geplanten Stand, die Herkunft der Werte und Sperren. Die Aktivierung prüft die Abhängigkeiten erneut. Ändert jemand zwischenzeitlich den aktiven Stand, müssen Sie die Vorschau neu laden. Eine neue Mandantenvorgabe muss auch mit bereits aktiven Kanalabweichungen vereinbar sein.

Welche Bedingungen lassen sich kombinieren?

Alle Bedingungen einer Regel müssen zutreffen. Innerhalb einer Auswahlliste genügt ein Wert. Regeln werden nach aufsteigender Prioritätszahl ausgewertet; die erste passende Regel bestimmt die Entscheidung. Pflichtanforderungen gelten zusätzlich.

Für Beträge stehen merchandise_net, merchandise_gross, total_net und total_gross zur Verfügung. Nur die Gesamtbeträge schließen Versand ein. Dezimalwerte werden als Strings übertragen. Ein Betrag in EUR wird nicht ohne Weiteres als Grenze für eine Bestellung in einer anderen Währung verwendet.

Entscheidungen und Anforderungen

Anforderungen können ein Konto, Firmenzugriff, Zahlungsbedingungen, Zusatzfelder, eine Kauf-Freigabe oder einen Zahlungsnachweis verlangen. Rechnungskauf setzt gültige Zahlungsbedingungen voraus. Eine Kauf-Freigabe ändert weder Sonderpreise noch Steuerfreigaben oder Firmenberechtigungen.

Zusatzfelder unterstützen Text, Ganzzahl, Dezimalzahl als String, Boolean und Datum. Felddefinitionen können lokalisierte Labels, Auswahlwerte und Grenzen enthalten. Die Pflicht entsteht durch die passende Anforderung. false und 0 sind Werte und werden nicht als fehlende Angabe behandelt.

Beispiel: Gastkauf mit Betragsschranke

Dieses Mandantendokument erlaubt Vorkasse sowie Karten- und PayPal-Zahlungen bis einschließlich 500 EUR Gesamtbrutto. Andere Fälle gehen auf den Angebotsweg. Es ist ein Konfigurationsbeispiel; die Zahlwege und die übrigen Shopvoraussetzungen müssen im betroffenen Vertriebskanal eingerichtet sein.

{
  "policy": {
    "version": 1,
    "rules": [{
      "key": "guest-prepaid-up-to-500-eur",
      "priority": 100,
      "when": {
        "payments": [
          {"method": "prepayment", "instrument": "bank_transfer", "provider": ""},
          {"method": "card", "instrument": "card_credit", "provider": "stripe"},
          {"method": "wallet", "instrument": "paypal_wallet", "provider": "paypal"}
        ],
        "amount": {"basis": "total_gross", "currency": "EUR", "minimum": "0", "maximum": "500"}
      },
      "result": {"action": "allow", "quoteAllowed": true, "require": {"assurance": "settled"}}
    }],
    "fallback": {"action": "quote", "quoteAllowed": true, "require": {}},
    "mandatory": [],
    "fields": []
  },
  "locks": {"mandatory": true}
}

Der Firmenname ist hier kein Ausschlussgrund. Bei Vorkasse bleibt die Leistung bis zum verbuchten Zahlungseingang gesperrt. Karte und PayPal benötigen ebenfalls einen serverseitig bestätigten Zahlungsnachweis. Ein Browser-Erfolg allein reicht nicht aus.

Eine zusätzliche Kanalabweichung kann beispielsweise außerhalb der passenden Regel auch den Angebotsweg schließen:

{"overrides":{"fallback":{"action":"deny","quoteAllowed":false,"require":{}}}}

Kauf-Freigabe prüfen

approval: "account" setzt eine Anmeldung voraus. Die Freigabe kann innerhalb ihrer geprüften Regel-, Einkaufs- und Zahlungsbedingungen erneut verwendet werden. approval: "transaction" ist die vorgangsgebundene Gastprüfung. Grenzen Sie Gastregeln mit authenticated: false von Kontoregeln ab. Dafür konfigurieren Sie einen Vorgangstyp, eine zuständige Gruppe, einen passenden Workflow und die Laufzeiten für Freigabe und Gastzugriff. Die Aktivierung prüft diese Voraussetzungen.

Der Workflow führt durch submitted, in_review, waiting_customer, approved, rejected oder withdrawn. Im Vorgang zeigt Checkout-Freigabe die Antragsdaten, die letzte Kundenantwort und die internen Prüfnotizen. Sachbearbeiter beginnen die Prüfung, stellen eine Rückfrage oder entscheiden. Interne Notiz und kundensichtbare Rückfrage sind getrennte Eingaben.

Gastzugriff verwendet einen per E-Mail zugestellten Anfragecode. Der Code gehört zum konkreten Antrag, Warenkorb und Vertriebskanal. Antragsteller können ihren Antrag lesen, ihre E-Mail bestätigen, antworten und zurücknehmen. Sie können sich nicht selbst freigeben. Eine erneute Zustellung muss ausdrücklich angefordert werden und ersetzt den bisherigen Code.

Eine Genehmigung bestellt nicht automatisch. Änderungen an Käufer, Warenkorb, Zahlungswahl oder maßgeblichen Anforderungen können eine neue Prüfung verlangen. Abgelaufene oder widerrufene Freigaben können nicht für neue Bestellungen genutzt werden. Ein Widerruf sperrt außerdem noch ausstehende Leistungen betroffener Bestellungen. Historische Bestellnachweise bleiben erhalten. Beim Löschen des Prüfvorgangs werden die Antragsdaten entfernt und zugehörige Freigaben widerrufen.

Zahlung und Leistungsfreigabe

assurance: "settled" verlangt vollständige bestätigte Zahlung. authorized lässt auch eine ausreichend hohe, noch gültige Autorisierung zu. Ohne belastbare Laufzeitangabe gilt eine Autorisierung nicht als Freigabenachweis. Die vorhandenen öffentlichen Karten- und PayPal-Abläufe führen zur Zahlung; das Regelmodell allein schaltet keinen getrennten Autorisieren-und-später-Einziehen-Ablauf frei.

Betrag, Währung, Bestellung und Zahlweg müssen zusammenpassen. Erstattungen, Stornierungen und abgelaufene Autorisierungen werden berücksichtigt. Versand, Beschaffung und digitale Leistung prüfen die erforderlichen Nachweise erneut.

Aktivierung prüfen

Prüfen Sie vor der Nutzung mindestens einen erlaubten und einen abgewiesenen Fall je Vertriebskanal. Testen Sie Beträge knapp unter, genau auf und knapp über einer Grenze. Wechseln Sie Einkaufsabsicht, Zahlungswahl und Lieferland. Bei Freigabepflicht müssen auch Rückfrage, Ablehnung, Ablauf und Widerruf geprüft werden.

Der Standard-Warenkorb zeigt die serverseitigen Anforderungen und verfügbaren Aktionen. Die Einrichtung ist erfolgreich, wenn die vorgesehenen Fälle genau diese Ergebnisse liefern und eine geänderte Entscheidung vor dem Bestellen neu bestätigt werden muss. Eine Regelversion verändert bereits angelegte Bestellungen und Angebote nicht nachträglich. Geänderte Angebote werden bei Umwandlung erneut geprüft; policygebundene Angebote werden für einen anderen Käufer durch einen neuen Checkout ersetzt, nicht geklont oder zusammengeführt.

Für eigene Shopschnittstellen siehe Warenkorb, Checkout und Payment.