Produktbilder & Medien-Infos abrufen
Bilder sind ein zentraler Bestandteil eines Produktkatalogs. Der Shopware 6 API Connector verwaltet Artikelbilder in beide Richtungen: Er lädt Bilder aus Business Central nach Shopware hoch und kann Medien-Informationen aus Shopware abrufen, um die Zuordnung zwischen beiden Systemen konsistent zu halten. Diese Seite erklärt ausführlich, welche Bild- und Medienfunktionen es gibt und wie der Download bzw. Abgleich funktioniert.
Wie Bilder verknüpft werden
Jedes Bild besitzt in Shopware eine Media-ID und – sobald es einem Produkt zugewiesen ist – eine Product-Media-Zuordnung (Assignment). In Business Central werden diese Kennungen am Bilddatensatz gespeichert:
Shopware Image ID (Media-ID)
Eindeutige Kennung der Mediendatei in Shopware.
Product Assignment ID
Verknüpfung, die ein Medium einem konkreten Produkt zuordnet.
isCover
Kennzeichnet das Coverbild (Hauptbild) des Produkts.
Import from Main
Markiert Bilder, die aus dem BC-Standardbild übernommen wurden.
Medien-Infos aus Shopware abrufen
Mit der Funktion Medien-Infos abrufen (Download Product Media Info) holt der Connector die aktuellen Product-Media-Zuordnungen aus Shopware und gleicht sie mit den Bilddatensätzen in Business Central ab. Der Ablauf im Detail:
Zuordnungen laden
Der Connector ruft den Shopware-Endpunkt für Produkt-Medien auf und erhält je Zuordnung die Assignment-ID und die Media-ID.
Bilder abgleichen
Für jede Media-ID sucht der Connector das passende Bild in BC (über die gespeicherte Shopware Image ID) und trägt die Product Assignment ID nach.
Verwaiste Bilder erkennen
Zuordnungen, zu denen es in BC kein passendes Bild (mehr) gibt, werden als verwaist erkannt und die zugehörigen Bilder in Shopware entfernt.
Ergebnis
Am Ende meldet der Connector, wie viele Datensätze aktualisiert und wie viele Bilder in Shopware gelöscht wurden.
Dieser Abgleich ist besonders nützlich, wenn Bilder teils direkt in Shopware gepflegt wurden. Er sorgt dafür, dass BC die korrekten Assignment-IDs kennt und spätere Bild-Updates zielgenau erfolgen.
Standardbilder aus Business Central übernehmen
Über Standardbilder importieren (Import Default Images) wird das Standard-Artikelbild aus Business Central als Bild in die Shopware-Bilderliste des Artikels übernommen. Existiert noch kein Coverbild, wird das übernommene Bild automatisch als Coverbild markiert. So lässt sich mit einem Schritt sicherstellen, dass jeder Artikel mindestens sein BC-Hauptbild im Shop besitzt.
Coverbild steuern
Das Coverbild ist das Hauptbild, das im Shop prominent angezeigt wird. Der Connector kann das Coverbild in Shopware setzen; umgekehrt kann bei der Datenübernahme aus Shopware das dortige Coverbild als Standardbild in BC gesetzt werden. Die Reihenfolge weiterer Bilder wird über eine Sequenznummer gesteuert.
Weitere Bildfunktionen
Zusätzliche Bilder
Neben dem Standardbild können mehrere weitere Produktbilder verwaltet und hochgeladen werden.
Import vom Gerät
Bilder lassen sich direkt von Ihrem Computer als zusätzliche Shopware-Bilder importieren.
Bild herunterladen
Einzelne Bilder oder ein ZIP-Paket mehrerer Bilder können aus BC heruntergeladen werden.
Zusammenspiel mit anderen Seiten
Die vollständige Bildpflege (Reihenfolge, Coverbild, Mehrfachbilder, Alt-Text) beschreibt die Seite Artikelbilder.
Der Bild-Download ist Teil der umfassenden Artikel-Matching & Datenübernahme aus Shopware.
Fehlerbehebung
Bild ohne Zuordnung
Product Assignment ID fehlt – Medien-Infos abrufen, um die Zuordnung nachzutragen.
Bild doppelt im Shop
Verwaiste Zuordnung – der Medien-Abgleich entfernt überzählige Bilder in Shopware.
Kein Coverbild
Standardbild importieren; das erste Bild wird als Cover gesetzt.
Häufige Fragen
Kann ich Bilder und Medien-Informationen aus Shopware zurück nach Business Central holen?
Ja. DownloadProductMediaInfo liest die Medien-Informationen eines Produkts aus Shopware aus. Über die Aktion „Download Item Pictures“ lassen sich die Bilder einzeln oder gesammelt als ZIP herunterladen – nützlich, um in Shopware gepflegte Bilder in BC verfügbar zu machen.