Produktdokumente sind Produktdaten.

Auf vielen Produktseiten erscheinen Dokumente als einfache Downloadliste: Datenblatt, Anleitung, Zertifikat. Technisch wird eine Datei an ein Produkt gehängt und im Shop verlinkt.

In Industrie- und B2B-Sortimenten reicht dieses Modell oft nicht. Ein Dokument besitzt eine eigene Sprache, Version, Gültigkeit, Freigabe und Marktzuordnung. Es kann für eine Produktfamilie, eine einzelne Variante oder nur einen bestimmten Produktionszeitraum gelten. Eine neuere Fassung ersetzt eine ältere, während die alte für bereits verkaufte Produkte weiterhin relevant bleibt.

Produktdokumente sollten deshalb wie strukturierte Produktdaten modelliert werden – nicht wie lose Anhänge.

Ein Dokument ist eine eigene Entität

Ein belastbares Dokumentenmodell kann enthalten:

• Dokument-ID,
• Dokumenttyp,
• Titel,
• Sprache,
• Version,
• Erstell- und Freigabedatum,
• Gültig-ab- und Gültig-bis-Zeitpunkt,
• Markt oder Rechtsraum,
• Produkt-, Varianten- oder Serienbezug,
• Produktionszeitraum,
• Freigabestatus,
• Dateiformat und Größe,
• Prüfsumme,
• Quellsystem,
• Ersatzdokument,
• Zugriffsberechtigung.

Damit kann das System entscheiden, welches Dokument welchem Nutzer angezeigt werden darf.

Dokumenttypen besitzen unterschiedliche Regeln

Bedienungsanleitung

• meist sprachabhängig,
• kann mehrere Produktvarianten abdecken,
• alte Versionen bleiben für Bestandsprodukte relevant.

Technisches Datenblatt

• häufig eng an Produktversion oder Markt gebunden,
• technische Werte müssen mit dem Produktdatensatz konsistent sein.

Zertifikat oder Konformitätserklärung

• besitzt Gültigkeit, Rechtsraum und Freigabestatus,
• darf nach Ablauf nicht unkontrolliert weiter als aktuell erscheinen.

Zeichnung oder CAD-Datei

• kann nur für registrierte Händler oder Kunden zugänglich sein,
• benötigt klare Varianten- und Versionszuordnung.

Sicherheitsdokument

• kann verpflichtend und marktbezogen sein,
• Änderungen benötigen besondere Nachvollziehbarkeit.

Ein allgemeiner Dateiupload kann diese Unterschiede nicht zuverlässig abbilden.

Wo werden Dokumente geführt?

Mögliche Quellen:

• PIM,
• DMS oder SharePoint,
• ERP,
• Qualitätsmanagementsystem,
• Herstellerfeed,
• Shopware,
• individuelle Produktdatenplattform.

Wie bei anderen Produktinformationen muss festgelegt werden, welches System für Metadaten, Datei und Freigabe führend ist.

Ein häufig sinnvolles Modell:

DMS/PIM führt Datei und Freigabe
        ↓
Product Data Hub normalisiert Metadaten und Produktbezug
        ↓
Shopware erhält veröffentlichbare Dokumente
oder sichere Download-URLs

Shopware muss die Dokumente dann nicht fachlich verwalten, kann sie aber performant und passend zum Produkt anzeigen.

Produktbezug ist mehrdimensional

Ein Dokument kann gelten für:

• genau eine Variante,
• alle Varianten eines Produkts,
• eine Produktfamilie,
• mehrere Baureihen,
• Produkte mit einem bestimmten Merkmal,
• einen Seriennummernbereich,
• einen Produktionszeitraum,
• einen Markt.

Diese Beziehungen sollten explizit modelliert werden. Dateinamen oder Ordnerpfade sind dafür zu fehleranfällig.

Versionierung und Ablösung

Eine neue Dokumentversion darf die alte nicht einfach überschreiben, wenn ältere Produkte weiterhin im Feld sind.

Ein Dokumentenlebenszyklus kann lauten:

Entwurf → fachlich geprüft → freigegeben → veröffentlicht
→ durch neue Version ersetzt → archiviert

Beim Ersatz bleibt die Beziehung erhalten:

Anleitung v2 ersetzt Anleitung v1 ab Produktionsdatum X

So kann das Kundenkonto für eine historische Bestellung weiterhin die passende damalige Anleitung anzeigen, während die öffentliche Produktseite die aktuelle Fassung erhält.

Sprache und Fallbacks

Für jede Zielsprache muss entschieden werden:

• Ist ein übersetztes Dokument verpflichtend?
• Darf auf Englisch zurückgefallen werden?
• Darf das Original angezeigt werden, wenn keine Übersetzung existiert?
• Wie wird der Nutzer über die Sprache informiert?
• Gelten andere Märkte oder Normen?

Ein Sprachfallback sollte nicht versehentlich ein rechtlich ungeeignetes Dokument aus einem anderen Markt ausgeben.

Öffentliche und geschützte Dokumente

Nicht jedes Dokument ist für jeden Nutzer bestimmt.

Mögliche Zugriffsmodelle:

• öffentlich,
• nur eingeloggte Nutzer,
• nur Käufer des Produkts,
• nur Händler,
• nur definierte Kundengruppen,
• zeitlich begrenzter Download,
• individueller Freigabeprozess.

Die Berechtigung sollte nicht nur in der Oberfläche versteckt werden. Auch die tatsächliche Datei oder Download-URL muss geschützt sein.

Caching und Aktualität

Dokumente werden häufig über CDN oder Medienservices ausgeliefert. Bei neuen Versionen muss sichergestellt sein, dass Nutzer nicht weiter eine veraltete Datei erhalten.

Geeignete Mechanismen:

• versionierte URLs,
• Prüfsummen,
• Cache-Invalidierung,
• unveränderliche Dateien mit neuer ID,
• kontrollierte Alias-URLs für „aktuelle Fassung".

Das Überschreiben derselben Datei unter derselben URL erschwert Nachvollziehbarkeit und Cachekontrolle.

Suche und Auffindbarkeit

Produktdokumente können auch unabhängig von der Produktseite gesucht werden. Dafür sind strukturierte Metadaten notwendig.

Suchfelder:

• Dokumenttyp,
• Produktnummer,
• Baureihe,
• Sprache,
• Version,
• Gültigkeit,
• Markt,
• Titel und Inhalt,
• Freigabestatus.

Bei PDFs kann zusätzlich der Text indexiert werden, sofern rechtlich und technisch sinnvoll. Der Nutzer sollte dennoch erkennen, zu welchem Produkt und welcher Version das Ergebnis gehört.

Qualitätsprüfungen

Mögliche Validierungen:

• Pflichtdokumente je Produktkategorie vorhanden,
• richtige Sprache und Marktzuordnung,
• keine abgelaufenen Zertifikate als aktuell markiert,
• Datei erreichbar und nicht beschädigt,
• eindeutige aktuelle Version,
• Produktbezug vollständig,
• keine öffentlichen Links auf geschützte Dokumente,
• Dateiname, Titel und Metadaten konsistent.

Diese Prüfungen sollten Teil der Product-Data-Qualität sein.