For the complete documentation index, see llms.txt. This page is also available as Markdown.

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:

1

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.

2

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.

3

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.

4

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.