> For the complete documentation index, see [llms.txt](https://docs.solutioo.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.solutioo.de/shopware/daten-aus-shopware-download-and-matching/produktbilder-and-medien-infos-abrufen.md).

# 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:

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Shopware Image ID (Media-ID)</strong></td><td>Eindeutige Kennung der Mediendatei in Shopware.</td></tr><tr><td><strong>Product Assignment ID</strong></td><td>Verknüpfung, die ein Medium einem konkreten Produkt zuordnet.</td></tr><tr><td><strong>isCover</strong></td><td>Kennzeichnet das Coverbild (Hauptbild) des Produkts.</td></tr><tr><td><strong>Import from Main</strong></td><td>Markiert Bilder, die aus dem BC-Standardbild übernommen wurden.</td></tr></tbody></table>

**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:

{% stepper %}
{% step %}
**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**.
{% endstep %}

{% step %}
**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.
{% endstep %}

{% step %}
**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.
{% endstep %}

{% step %}
**Ergebnis**

Am Ende meldet der Connector, **wie viele Datensätze aktualisiert** und **wie viele Bilder in Shopware gelöscht** wurden.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
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.
{% endhint %}

**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**

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Zusätzliche Bilder</strong></td><td>Neben dem Standardbild können mehrere weitere Produktbilder verwaltet und hochgeladen werden.</td></tr><tr><td><strong>Import vom Gerät</strong></td><td>Bilder lassen sich direkt von Ihrem Computer als zusätzliche Shopware-Bilder importieren.</td></tr><tr><td><strong>Bild herunterladen</strong></td><td>Einzelne Bilder oder ein ZIP-Paket mehrerer Bilder können aus BC heruntergeladen werden.</td></tr></tbody></table>

**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**

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Bild ohne Zuordnung</strong></td><td>Product Assignment ID fehlt – Medien-Infos abrufen, um die Zuordnung nachzutragen.</td></tr><tr><td><strong>Bild doppelt im Shop</strong></td><td>Verwaiste Zuordnung – der Medien-Abgleich entfernt überzählige Bilder in Shopware.</td></tr><tr><td><strong>Kein Coverbild</strong></td><td>Standardbild importieren; das erste Bild wird als Cover gesetzt.</td></tr></tbody></table>

### 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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.solutioo.de/shopware/daten-aus-shopware-download-and-matching/produktbilder-and-medien-infos-abrufen.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.