Preiskontexte

Ein Produkt hat in Shopware selten genau einen Preis. Es hat einen je Sales Channel, je Währung, je Kundengruppe und je Preisregel. Antares indexiert diese Kombinationen einzeln, damit das Suchergebnis den Preis zeigt, der im Warenkorb dann auch gilt.

Der Fingerabdruck

Jede aufgelöste Preissituation bekommt eine stabile Kennung, zum Beispiel grp_b2b oder rule_a1b2c3d4. Der Connector leitet sie deterministisch ab: dieselbe Situation bekommt über Indexläufe hinweg dieselbe Kennung. Damit lässt sich ein Preis einem Kontext zuordnen, ohne dass die Suche etwas über deine Kundengruppen wissen muss.

Zu jedem Kontext gehören:

• die Preise je Währung,
• die Preisspanne bei Varianten,
• Staffelpreise je Währung, aufsteigend nach Menge.

Der Standardkontext

Ohne weitere Angabe liefert die Suche den Kontext, den ein nicht eingeloggter Besucher sieht — bei den meisten Shops der Listenpreis des Kanals. Für B2C-Shops ist das der Normalfall, und du musst dich um nichts kümmern.

Der signierte Token

Für eingeloggte B2B-Kunden erzeugt dein Storefront einen Preiskontext-Token und gibt ihn dem Widget mit. Der Token:

• ist von deinem Shop signiert und von der API prüfbar,
• enthält keine personenbezogenen Daten — er benennt eine Preissituation, keinen Kunden,
• ist kurzlebig und an die Sitzung gebunden.

In der API taucht er als priceContextToken auf, sowohl im Rumpf von POST /v1/search als auch als Abfrageparameter der Instant-Suche. Die vollständige Definition steht in der Referenz; sie wird aus dem Vertrag generiert und ist damit immer der aktuelle Stand.

{
  "q": "akkuschrauber",
  "sessionId": "…",
  "currency": "EUR",
  "priceContextToken": "…"
}

Ohne gültigen Token liefert die API den Standardkontext. Sie fällt also auf den Listenpreis zurück, statt einen Fehler zu werfen — ein abgelaufener Token darf die Suche eines eingeloggten Kunden nicht abschalten.

Tarif

Kundengruppen-Preise gehören zum Scale-Tarif. Varianten und Staffelpreise sind in allen Tarifen enthalten: jede Preiskombination, die dein Sales Channel kennt, wird indexiert, inklusive Währung.

Häufigster Fehler

Falsche Preise im Ergebnis, obwohl der Shop richtig rechnet: fast immer fehlt der Token oder er wird nur auf der Kategorieseite gesetzt und nicht im Suchfeld. Prüf die Anzeige eingeloggt, nicht ausgeloggt.