Retrieve Product Images & Media Info
Images are a central part of a product catalog. The Shopware 6 API Connector manages item pictures in both directions: it uploads images from Business Central to Shopware and can retrieve media information from Shopware in order to keep the assignment between both systems consistent. This page explains in detail which image and media functions are available and how the download and matching work.
How images are linked
In Shopware, every image has a media ID and – as soon as it is assigned to a product – a product media assignment. In Business Central, these identifiers are stored on the image record:
Shopware Image ID (media ID)
Unique identifier of the media file in Shopware.
Product Assignment ID
Link that assigns a media file to a specific product.
isCover
Identifies the cover image (main image) of the product.
Import from Main
Flags images that were adopted from the BC default picture.
Retrieving media info from Shopware
With the Retrieve Media Info function (Download Product Media Info), the connector fetches the current product media assignments from Shopware and matches them with the image records in Business Central. The procedure in detail:
Load the assignments
The connector calls the Shopware endpoint for product media and receives the assignment ID and the media ID for each assignment.
Match the images
For each media ID, the connector looks for the matching image in BC (using the stored Shopware Image ID) and adds the Product Assignment ID.
Detect orphaned images
Assignments for which there is no (longer a) matching image in BC are identified as orphaned, and the corresponding images are removed in Shopware.
Result
At the end, the connector reports how many records were updated and how many images were deleted in Shopware.
This matching run is particularly useful if some images were maintained directly in Shopware. It ensures that BC knows the correct assignment IDs and that later image updates are applied accurately.
Adopting default pictures from Business Central
With Import Default Images, the default item picture from Business Central is added as an image to the item's Shopware image list. If no cover image exists yet, the adopted image is automatically marked as the cover image. This lets you ensure in a single step that every item has at least its BC main image in the shop.
Controlling the cover image
The cover image is the main image that is displayed prominently in the shop. The connector can set the cover image in Shopware; conversely, when data is imported from Shopware, the cover image there can be set as the default picture in BC. The order of additional images is controlled by a sequence number.
Additional image functions
Additional images
In addition to the default picture, several further product images can be managed and uploaded.
Import from device
Images can be imported directly from your computer as additional Shopware images.
Download image
Individual images or a ZIP package containing several images can be downloaded from BC.
How this relates to other pages
Complete image maintenance (order, cover image, multiple images, alt text) is described on the Item Pictures page.
The image download is part of the comprehensive Item Matching & Data Import from Shopware.
Troubleshooting
Image without assignment
The Product Assignment ID is missing – retrieve the media info to add the assignment.
Duplicate image in the shop
Orphaned assignment – the media matching run removes surplus images in Shopware.
No cover image
Import the default picture; the first image is set as the cover.
Frequently Asked Questions
Can I retrieve images and media information from Shopware back to Business Central?
Yes. DownloadProductMediaInfo reads the media information of a product from Shopware. Using the "Download Item Pictures" action, you can download the images individually or together as a ZIP file – useful for making images that were maintained in Shopware available in BC.