Version 4.8.8.9

Mit dem neuesten apt-shop-Update werden die strukturierten Produktdaten (JSON-LD) deutlich erweitert und für zukünftige Anforderungen im Bereich KI-basierter Produktsuchen und Agentic Commerce vorbereitet.

Dank dieser Erweiterungen werden Produktinformationen nun noch präziser, rechtssicherer und maschinenlesbar bereitgestellt – sowohl für Suchmaschinen als auch für KI-Systeme.

Die neuen Features im Überblick:
 

• Erweiterte Schema.org-Datenstruktur: Vollständige Unterstützung des aktuellen Product-Schemas inkl. Offer-Details.
• Versandinformationen (shippingDetails): Der Händler hinterlegt einen Syntax-String zentral in den allgemeinen Shop-Einstellungen (z. B. pro Land Preis, Währung, Lieferzeit) und kann denselben String bei Bedarf als Merkmal je Produkt überschreiben.
  Beispiel: Kosten=4.90|Währung=EUR|Lieferzeit=2-4 Tage|Region=DE
• Rückgaberegeln (returnPolicy): Die Rückgabekonditionen werden als Syntax-String definiert (z. B. Frist, Gebühren, Methode) und können produktbezogen per Merkmal überschrieben werden.
  Beispiel: Frist=14|Kosten=Kostenlos|Methode=Post|Beschreibung=14 Tage Rückgabe
• Akzeptierte Zahlungsarten (acceptedPaymentMethod): Die akzeptierten Zahlarten werden als Syntax-String gepflegt (Liste zulässiger Methoden) und können je Produkt per Merkmal abweichen.
  Beispiel: PayPal|Kreditkarte|Vorkasse|Rechnung
• Händlerdaten (seller): Verkäuferinformationen werden automatisch aus den allgemeinen Shopdaten (Impressum) übernommen.
• Herstellerdaten (manufacturer): Erweiterte Übergabe der Herstellerinformationen gemäß gesetzlicher Vorgaben.
• Verbessertes Merkmal-Mapping (PIM): Neue Mapping-Tabelle und Syntax zur gezielten Ausgabe strukturierter Daten aus Produktmerkmalen.
• Optimierte Ausgabe zusätzlicher Eigenschaften (additionalProperty[]): Freie Produktmerkmale werden nun konsistent im JSON-LD integriert – vollständig KI-kompatibel.

Ziel des Updates

Dieses Update macht alle apt-shop-Systeme fit für kommende KI-Standards (z. B. Google Shopping Graph, Perplexity Product Agents, EU Digital Product Passport).
Die Datenbasis ist nun so vorbereitet, dass Produkte von Suchmaschinen und KI-Systemen korrekt erkannt, verstanden und kategorisiert werden können.

Hinweis für Händler

Bestehende Produktdaten werden automatisch erweitert.
Produktmerkmale, die auf der Produktseite erscheinen, werden jetzt bereits als strukturierte Daten exportiert.
Optionale Zusatzinformationen (Versand, Rückgabe, Zahlungsarten etc.) können im PIM über Produktmerkmale gepflegt oder als Standardwert in den allgemeinen Einstellungen vordefiniert werden.
Eine vollständige Übersicht findest du im Handbuch unter Kataloge > Merkmale > Strukturierte Daten (Handbuch öffnen).

Weitere Änderungen in diesem Update:

• Produktmerkmale auf Variantenebene: Merkmale können nun direkt Varianten zugeordnet werden, wenn sich die Angaben unterscheiden. Auf der Detailseite werden diese dynamisch aktualisiert (Theme-Änderung in JS-Datei erforderlich).
• Verpackungseinheiten mit UnitCode: Ergänzung um ISO-konforme UN/CEFACT-Codes für Verpackungseinheiten (siehe Handbuch).
• Neue Version REST API (v2): Unser Rest API ist in einer neuen Version verfügbar. Standardisierter OAuth2 Zugriff, angepasste Endpoints, Public API für SEO und KI Agents. Private API (wie bisher). Zur Nutzung der neuen Version erstelle für Deine API User eine ClientId und ein ClientSecret. Die neue interaktive Dokumentation ist jetzt in jeden Shop integriert. Den (öffentlichen) Link findest du im Bereich API Einstellungen. Gebe diese Informationen zur Nutzung bitte an Deine Partner weiter. Die API Version 1 wird zum 30.09.2026 deaktivert und mit dem heutigen Tage auch nicht weiterentwickelt.
• Asynchrone Webhooks: Webhooks werden jetzt asynchron versendet, um die direkt auslösenden Prozesse zu beschleunigen. Du findest jetzt auch ein Webhook-Logbuch im Shop.
• Webhooks-Authentifizierung: Das Webhook-Passwort wird jetzt mit einem einem Username als Basic Auth im Header übertragen. Bitte stelle die Authprüfung darauf hin um. Die Übersendung des Webhook-Passworts im Header allein, wird zum 30.09.2026 entfernt.