Zum Inhalt

Produktdokumente

Zu einem BC-Artikel lassen sich typisierte Produktdokumente pflegen – Datenblatt, Handbuch, Konformitätserklärung, Sicherheitsdatenblatt, Broschüre u. a. Der Shopware 6 Connector lädt diese Dokumente in die shop-eigene Media hoch und verlinkt sie über Custom Fields am Produkt. Der Kunde findet die Downloads öffentlich auf der Produktseite.

Zentral im Hub gepflegt

Die Dokumente liegen zentral im merchantCENTRAL Hub je BC-Artikel (ALN MC Product Document) und stehen damit allen Marktplatz-Connectoren zur Verfügung – nicht nur Shopware. Der Connector überträgt sie in den Shop.

Seite öffnen

  • Produktdokumente werden am BC-Artikel gepflegt (Hub-Funktion „Produktdokumente").
  • Die Übertragung erfolgt beim Artikel-Upload in den Shop; der Ablage-Status je Shop wird intern in Shopware 6 Product Document Media geführt.

Quellen

Jede Dokumentzeile hat eine Quelle – in allen Fällen landet die Datei am Ende in der Shop-Media (keine toten Links, CDN/Caching des Shops inklusive):

Quelle Ablage
BC-Artikel-Anhang Standard-Anhänge (Document Attachment) am Artikel
Hub-Datei Medienfeld direkt an der Dokumentzeile im Hub
Externe URL nur der Link (Hersteller-PDF); Shopware holt die Datei selbst (Upload-from-URL)

Einstellungen (Setup / je Shop)

Feld Wo Beschreibung
Produktdokumente synchronisieren Shop (Override) Ob Produktdokumente beim Artikel-Push in diesen Shop hochgeladen werden (Default / Yes / No).
Feldname Produktdokumente Setup / Shop Technisches Shopware-Custom-Field, das die Dokumentliste als JSON-Text erhält (Feldtyp Text – die Shopware-Administration bietet keinen JSON-Feldtyp an; das Theme dekodiert den Text). Standard ad_documents – auf das Custom Field des Ziel-Themes einstellen.
Feldname Datenblatt-URL Setup / Shop Custom Field für die primäre Datenblatt-URL. Standard ad_datasheet_url.
Dokumente in den Shop hochladen Setup / Shop (Override) Separater Schalter: lädt gebuchte Rechnungen/Gutschriften als PDF an die Shop-Bestellung (nicht an das Produkt).

Nur geänderte Dokumente

Unveränderte Dokumente werden beim erneuten Upload übersprungen (Zeitstempel-Abgleich je Shop). Ein neueres Dokument im Hub löst automatisch einen erneuten Upload aus.

Ablauf

  1. Am BC-Artikel die Produktdokumente pflegen (Quelle je Zeile wählen).
  2. Im Shop-Setup das passende Custom Field (Theme) unter Product Documents Field Name hinterlegen.
  3. Je Shop Produktdokumente synchronisieren auf Default oder Yes lassen.
  4. Artikel hochladen – die Dokumente werden in die Shop-Media geladen und am Produkt verlinkt.
  5. Im Storefront/Theme die Dokumente an der Produktseite anzeigen (Theme-abhängig).

Datenformat (für Theme-Entwickler)

Das Custom Field enthält die Dokumentliste als JSON-Text, ein Array von Objekten:

[
  {
    "type": "manual",
    "typeLabel": "Handbuch",
    "title": "Bedienungsanleitung",
    "url": "https://shop.example.com/media/…/bedienungsanleitung.pdf",
    "mediaId": "018f36cd6a1e7c9b…",
    "position": 1
  }
]
Schlüssel Bedeutung
type Stabiler, sprachunabhängiger Typ-Schlüssel – das Theme gruppiert und übersetzt darüber (Snippets). Werte: datasheet, manual, certificate, safety_data_sheet, brochure, other. Unbekannte künftige Typen kommen als other.
typeLabel Typ-Bezeichnung in der BC-Sitzungssprache – lesbarer Fallback für Themes ohne eigene Snippets.
title Dokumenttitel (leer gepflegt → Typ-Bezeichnung).
url Öffentliche Media-URL der Datei im Shop.
mediaId UUID der Media-Entität im Shop.
position Sortierung aus der BC-Dokumentliste.

Das zweite Feld (Datasheet URL Field Name, Standard ad_datasheet_url) enthält als einfachen Text die URL des ersten Datenblatts – für Themes, die nur einen prominenten Datenblatt-Link zeigen.

Verwandte Seiten