B2B-Preislisten und Preise nach Kundengruppe in WooCommerce

Händlerspezifische Preisliste, Mengenstaffeln, Mehrwertsteueranzeige und Cache-Kontrollen. Beschreibt, wie der Preis einer Web-Bestellung mit dem im ERP entstandenen Preis verglichen wird.
Technische Zusammenfassung
Technologie
WooCommerce, ERP-Preisliste, Redis-Objektcache, PHP
Thema
Modellierung und Anzeige von B2B-Preisregeln in WooCommerce
Niveau
Mittel bis fortgeschritten
Voraussetzungen
  • Kenntnisse der Produkt- und Steuereinstellungen von WooCommerce
  • Kenntnis der Preis-Engine und Rabattregeln im ERP
In diesem Beitrag7 Abschnitte

Die Beschwerde „Der Preis auf der Website war ein anderer als auf der Rechnung“ hat in B2B-Shops fast immer dieselbe Ursache: Die Preisregeln werden im Web und im ERP in unterschiedlicher Reihenfolge angewendet. Händlergruppenspezifische Liste, im Debitorenstamm hinterlegter Rabatt, Mengenstaffel und Projektpreis können gleichzeitig greifen. Da WooCommerce für den Einzelhandel entworfen wurde, deckt es dieses Modell nicht von selbst ab; ist der Aufbau falsch, entsteht im Warenkorb ein anderer Betrag, oder schlimmer, der Preis eines Kunden wird über den Cache einem anderen angezeigt. Im Folgenden beschreiben wir, wie wir B2B-Preise in WooCommerce modellieren und welche Entscheidung wo getroffen werden sollte.

B2B-Preismodelle

Preisregeln im Firmenkundengeschäft fallen meist unter einen oder eine Kombination dieser Typen:

Modell Definition Typische Quelle
Listenpreis Basispreis für alle ERP-Preisliste
Gruppenpreisliste Eigene Liste für Gruppen wie Händler, Distributor, Firmenkunde ERP oder Web
Debitorbezogener Rabatt Kundenspezifischer allgemeiner oder markenbezogener Satz ERP-Debitorenstamm
Staffelpreis Mit steigender Menge sinkender Stückpreis ERP oder Web
Vertrags-/Projektpreis Fester, befristeter Preis für bestimmte Produkte und Kunden ERP oder Angebotssystem

Die Reihenfolge, in der diese Regeln angewendet werden, muss an eine schriftliche Vorrangregel gebunden sein. Zum Beispiel: Gibt es einen Vertragspreis, überschreibt er alles andere; sonst wird die Gruppenliste genommen, darauf der Debitorrabatt angewendet und zuletzt die Staffel berechnet. Diese Reihenfolge muss exakt der Reihenfolge der Preis-Engine im ERP entsprechen. Andere Reihenfolge, anderer Betrag. Zu Projektbeginn fordern wir als erstes Dokument eine Beispielrechnung an, die zeigt, in welchen Schritten der Preis einer Bestellung im ERP entsteht.

Quelle des Preises: ERP oder E-Commerce

Aus Sicht der Unternehmens-Web- und E-Commerce-Architektur gibt es zwei grundlegende Wege. Entweder wird der Preis im ERP berechnet und das Web zeigt nur das Ergebnis, oder die Regeln werden ins Web übertragen und WooCommerce rechnet.

Vorgehen Vorteil Einschränkung
Live-Abfrage im ERP Eine einzige Wahrheitsquelle, identisch mit der Rechnung Jede Seite hängt vom ERP ab, langsam
Übertragung einer im ERP berechneten Preistabelle Schnell, identisch mit dem ERP-Ergebnis Tabelle Kunde × Produkt kann groß werden
Übertragung der Regeln, das Web rechnet Flexibel, geringes Datenvolumen Zwei Preis-Engines, Abweichungsrisiko

Sind Produkt- und Kundenzahl überschaubar, ist der sicherste Weg, die vom ERP berechneten Endpreise pro Gruppe oder Debitor ins Web zu übertragen. Gibt es wenige Regeln, aber sehr viele Kombinationen aus Kunde × Produkt, werden die Regeln übertragen; dann ist ein Kontrolljob Pflicht, der die Ergebnisse von Web und ERP regelmäßig anhand von Beispielbestellungen vergleicht. Zwei Preis-Engines laufen mit der Zeit auseinander. Die Live-Abfrage im ERP wird meist nur als letzte Prüfung bei Warenkorb und Bestellbestätigung genutzt. Zur Wahl der Übertragungsmethode lesen Sie den Beitrag Integrationsmuster zwischen ERP und Web.

Preise nach Kundengruppe und Debitor

In WooCommerce gibt es zwei verbreitete Wege, die Gruppeninformation zu führen: die WordPress-Benutzerrolle oder ein in den Benutzermetadaten gespeicherter Gruppen-/Debitorencode. Die Rolle als Preisgruppe zu nutzen, koppelt Berechtigung und Preis; an dem Tag, an dem ein Benutzer sowohl „Einkaufsfreigeber“ als auch „Händlergruppe A“ sein muss, bricht das Modell. Führen Sie Preisgruppe und Debitorencode in separaten Metafeldern und konzipieren Sie die Berechtigungen getrennt, wie im Beitrag Berechtigungsarchitektur für B2B-Portale beschrieben. Gibt es unter einem Debitor mehrere Benutzer, wird der Preis nicht an den Benutzer, sondern an den Debitor gebunden.

Der Preis wird über die Preisfilter von WooCommerce angewendet. Das folgende Beispiel liest den Gruppenpreis aus einer übertragenen Preistabelle. Da WooCommerce bei variablen Produkten Preisspannen in Transients cacht, muss dem Cache-Schlüssel die Gruppeninformation hinzugefügt werden:

function eretek_b2b_price( $price, $product ) {
    if ( $product->get_meta( '_eretek_tier_applied' ) ) { return $price; } // Staffel im Warenkorb angewendet
    $group = eretek_current_price_group();          // z. B. Benutzer-Meta: price_group
    if ( ! $group ) { return $price; }
    $p = eretek_lookup_price( $product->get_id(), $group ); // uebertragene Preistabelle
    return ( null !== $p ) ? $p : $price;
}
add_filter( 'woocommerce_product_get_price', 'eretek_b2b_price', 20, 2 );
add_filter( 'woocommerce_product_variation_get_price', 'eretek_b2b_price', 20, 2 );
add_filter( 'woocommerce_variation_prices_price', 'eretek_b2b_price', 20, 2 ); // Berechnung der Preisspanne

// Cache der Variations-Preisspanne nach Gruppe trennen
add_filter( 'woocommerce_get_variation_prices_hash', function ( $hash ) {
    $hash[] = eretek_current_price_group();
    return $hash;
} );

Die Preisabfrage darf nicht für jedes Produkt einen eigenen Datenbankaufruf machen. 48 Produkte auf einer Kategorieseite bedeuten 48 Abfragen. Holen Sie die Preise der Produkte einer Listenseite in einer Abfrage oder halten Sie sie pro Gruppe im persistenten Objektcache (etwa Redis). Soll ein reduzierter Preis angezeigt werden, müssen auch die Filter für regulären und Sonderpreis nach derselben Logik behandelt werden; sonst erscheint der durchgestrichene Preis falsch.

Staffelpreis und Mindestbestellung

Beim Staffelpreis richtet sich der Stückpreis nach der Menge im Warenkorb. Auf der Produktseite wird die Staffeltabelle angezeigt, angewendet wird sie bei der Warenkorbberechnung. In WooCommerce ist dafür die Action woocommerce_before_calculate_totals zuständig:

add_action( 'woocommerce_before_calculate_totals', function ( $cart ) {
    if ( is_admin() && ! defined( 'DOING_AJAX' ) ) { return; }
    foreach ( $cart->get_cart() as $item ) {
        $tier = eretek_tier_price( $item['product_id'], $item['quantity'] );
        if ( null !== $tier ) {
            $item['data']->set_price( $tier );
            $item['data']->update_meta_data( '_eretek_tier_applied', 1 ); // nur im Speicher, wird nicht gespeichert
        }
    }
}, 20 );

Bei der Staffelberechnung müssen zwei Entscheidungen klar sein: Bezieht sich die Staffel nur auf die Menge desselben Produkts oder auf die Summe derselben Produktfamilie (z. B. aller Farbvarianten); wird der Staffelpreis auf den Gruppenpreis angewendet oder ersetzt er ihn? Diese Entscheidungen müssen ihrem Gegenstück im ERP entsprechen. Und es gibt eine in der Praxis häufig ertappte Falle: Ist der Filter woocommerce_product_get_price aktiv, wird der im Warenkorb mit set_price() geschriebene Staffelpreis beim Lesen vom Filter wieder mit dem Gruppenpreis überschrieben. Die Markierung im Beispiel verhindert diesen Konflikt. Soll die Staffelfunktion den Gruppenpreis als Basis nehmen, muss die Berechnung innerhalb dieser Funktion erfolgen.

Weitere im B2B häufige Einschränkungen:

  • Mindestbestellwert: Liegt die Warenkorbsumme unter der Schwelle, wird der Zahlungsschritt blockiert und dem Benutzer der fehlende Betrag angezeigt. Die Prüfung lässt sich in der Action woocommerce_check_cart_items durch Hinzufügen eines Fehlers mit wc_add_notice() umsetzen.
  • Stück pro Karton: Wird ein Produkt nur in Verpackungseinheiten wie Vielfachen von 12 verkauft, werden Schrittweite des Mengenfelds und Warenkorbprüfung entsprechend eingestellt. Nur die Schrittweite in der Oberfläche zu ändern, genügt nicht; die Prüfung muss auch serverseitig erfolgen.
  • Zahlungsart nach Gruppe: Kauf auf Rechnung oder Überweisung wird nur freigegebenen Debitoren angezeigt.

Mehrwertsteueranzeige und Angebotsablauf

Firmenkunden bewerten Preise meist netto, Endkunden erwarten Bruttopreise. In WooCommerce bestimmen die Optionen „Preise im Shop anzeigen“ und „Preise im Warenkorb und an der Kasse anzeigen“ unter Einstellungen → Steuer dieses Verhalten; die Werte werden in den Optionen woocommerce_tax_display_shop und woocommerce_tax_display_cart als incl oder excl gespeichert. In einem gemischten Shop lassen sich diese Werte per Filter nach Benutzergruppe ändern; testen Sie aber, dass auf Produktseite, im Warenkorb, in E-Mails und in PDF-Angeboten überall dieselbe Regel gilt. Meist wird die E-Mail-Vorlage vergessen.

Unterscheiden sich Eingabeart der Preise (Option „Preise werden inklusive Steuer eingegeben“) und Anzeigeart, rechnet WooCommerce um, und es können Rundungsdifferenzen im Cent-Bereich entstehen. Kommt der Preis aus dem ERP netto, sollte auch der Shop mit Nettoeingabe eingerichtet werden. Da es in der Türkei mehrere Mehrwertsteuersätze gibt (ebenso in Deutschland mit Regel- und ermäßigtem Satz), müssen die Sätze pro Produkt über Steuerklassen zugeordnet und bei Satzänderungen gemeinsam mit dem ERP aktualisiert werden; prüfen Sie die aktuellen Sätze anhand der amtlichen Vorschriften.

Steht der Preis im Web nicht fest, wird ein Angebotsablauf genutzt: Der Kunde sendet den Warenkorb als Angebotsanfrage, das Vertriebsteam legt den Preis im ERP oder in der Angebotsansicht fest, und das freigegebene Angebot wird im Kundenkonto mit befristeten, fixierten Preisen zur Bestellung. Gültigkeitsdatum des Angebotspreises und die Menge, für die er gilt, sollten im Bestelldatensatz gespeichert werden; kommt Monate später ein Einwand, ist das der einzige Ort zum Nachsehen.

Auswirkungen auf Cache und Performance

Ein personalisierter Preis bricht die Grundannahme des Seitencaches: „Alle sehen dasselbe HTML.“ Im B2B gilt diese Annahme nicht. Für einen sicheren Aufbau:

  • Für angemeldete Benutzer sollten Full-Page-Cache und CDN-Cache abgeschaltet oder der Cache-Schlüssel so aufgeteilt werden, dass er die Preisgruppe enthält. Bei wenigen Gruppen kann je Gruppe eine eigene Cache-Variante genutzt werden; bei debitorbezogenen Preisen ist das nicht praktikabel.
  • Listenseiten für nicht angemeldete Besucher können im Cache bleiben; nach der Anmeldung werden Preise serverseitig erzeugt.
  • Prüfen Sie, dass bei per AJAX geladenen Teilen wie Produktlisten, Mini-Warenkorb und „ähnlichen Produkten“ die Antworten nicht gecacht werden.
  • Der persistente Objektcache beschleunigt Abfragen der Preistabelle; der Schlüssel muss Gruppen- oder Debitorencode enthalten und nach der Preisübertragung geleert werden.

Typische Beispiele für Datenlecks an falsche Benutzer in Cache-Schichten finden Sie im Leitfaden WooCommerce-Cache-Fehler. Die Prüfreihenfolge ist einfach: Öffnen Sie mit Testbenutzern aus zwei verschiedenen Preisgruppen dieselben Produkt-, Kategorie- und Warenkorbseiten in privaten Fenstern und vergleichen Sie den Cache-Status in den Antwort-Headern und die angezeigten Preise. Ein Test mit nur einem Benutzer beweist nichts.

Zum Preis- und Berechtigungsaufbau im Rahmen von Händler- und Kundenportalen sehen Sie sich die Seite B2B-Händler- und Kundenportale an, zur ERP-Preisübertragung die Seite ERP-, CRM- und API-Integrationen.

Häufig gestellte Fragen

Plugin oder Eigenentwicklung für B2B-Preise?

Genügen gruppenbasierte Listenpreise und einfache Staffeln, erfüllt ein ausgereiftes Plugin den Zweck. In Strukturen, in denen der Preis im ERP berechnet wird und es debitorbezogene Rabatte und Vertragspreise gibt, liefert eine eigene, mit der ERP-Übertragung abgestimmte Preisschicht meist vorhersehbarere Ergebnisse.

Wie oft sollten Preise aus dem ERP übertragen werden?

Das hängt von der Häufigkeit der Preisänderungen ab. In den meisten B2B-Strukturen genügt eine bei Änderung ausgelöste oder tägliche Batch-Übertragung. Bei Preisen, die sich durch Wechselkurseffekte häufig ändern, erhöhen Sie die Übertragungsfrequenz und prüfen bei der Warenkorbbestätigung den letzten Preis im ERP.

Sollten nicht angemeldeten Besuchern Preise angezeigt werden?

Das ist eine geschäftliche Entscheidung. Werden Preise angezeigt, dann der Listenpreis, der aus dem Cache ausgeliefert werden kann. Werden sie verborgen, muss der Preis nicht nur aus der Ansicht, sondern auch aus dem Seitenquelltext und den strukturierten Daten entfernt werden.

Verursacht die Anzeige von Nettopreisen Probleme im Warenkorb?

Bei korrekter Einstellung nicht. Die Eingabeart der Preise muss der im ERP entsprechen, Produkte müssen den richtigen Steuerklassen zugeordnet sein, und es muss getestet werden, dass in Shop, Warenkorb und E-Mail-Ausgaben dieselbe Anzeigeregel gilt.

Support

Kontaktieren Sie uns für Support oder eine Bestandsaufnahme zu diesem Thema.

Kontaktformular
[email protected]

Eretek Web

Wir bauen Unternehmenswebsites, WordPress- und CMS-Plattformen, Intranet- und SharePoint-Portale, Dokumentenmanagement sowie Formular- und Freigabeprozesse auf und halten sie sicher und aktuell.

Wissenszentrum

Weitere Beiträge