Field Reference: Item Card

This reference lists all Shopware-relevant fields and actions on the Item Card (and in the item list) in the Shopware 6 API Connector. You will find the functional explanations under "(Simple) Items", "Configurable Items", and the other chapters of master data management.

Shopware fields on the item

The connector adds its own web fields (prefix SOUSHW) to the Item Card. They control release, linking, and synchronization status.

Field	Meaning
Web Item	Only if set to Yes is the item transferred to Shopware.
Web ID	Shopware product UUID; set automatically after the first successful upload.
isSynced (Synchronized)	Indicates whether the product is currently synchronized.
Synced At / Synced Message	Time and result/error message of the last synchronization.
Origin	Origin of the record (default: BC).
Active (Shopware active)	Controls whether the product is active in Shopware.
Out Of Stock	Forces an inventory of 0 in Shopware, regardless of the inventory in BC.
Parent No (Parent Item No.)	For variants, refers to the parent item.
Upload Image	Controls the image upload for this item.
isStock Synced / Stock Synced At	Partial sync status for inventory.
isPrice Synced / Price Synced At	Partial sync status for the price.
isImage Synced / Image Synced At	Partial sync status for pictures.
Stock Level Ind 1 / 2	Display indicators for inventory.
Shopware Categories	Pipe-separated list of the assigned categories (multiple assignments possible).
Shopware Tags	Pipe-separated list of the assigned tags.
Grouped Product ID / Is Grouped Product / Grouped Synced (At)	Fields for group items.
Include Main Product	Adds the main product to the shopping cart as well for group items.

If you change a synchronization-relevant field, the connector automatically resets isSynced, isStock Synced, and isPrice Synced – the item is transferred again during the next run.

Origin of the Shopware values (field mapping)

These standard item fields determine the content in Shopware:

BC field	Shopware field
No.	productNumber (SKU – matching key)
Description	name (product name)
Marketing Text	description (HTML description)
GTIN	ean
Base Unit of Measure	Unit of measure (unitId)
VAT Prod. Posting Group	Tax rate (taxId)
Item Category Code / Shopware Categories	Category assignment
Net Weight × Sales Unit of Measure	weight

Actions on the Item Card

Action	Function
Upload Product	Uploads the item individually; sets "Web Item" and "Active" if required.
Import Default Images	Imports the BC default pictures as Shopware images of the item.
Price List Lines	Opens the price line view of the item.
Reset Sync Status	Resets the sync flags for items, price lines, sales channels, pictures, and attributes.
Additional Items / Grouped Products	Manages additional items and group items.
Sync Grouped Products	Synchronizes the assigned group/additional items.
Upload Documents	Uploads BC document attachments of the item to Shopware.
Upload SharePoint Documents	Uploads assigned SharePoint documents to Shopware.

Item list – columns & actions

The item list additionally shows the columns Web Item, Web ID, isSynced, and Shopware Categories.

Action	Function
Excel Import Marketing Text	Imports marketing texts from an Excel file (bulk maintenance).
Import CSV Marketing Text	Imports marketing texts from a CSV file.
Import Default Images	Imports default pictures for all (selected) items.

For the initial load, mark items as web items, assign categories, and start the bulk upload. The Web ID is then filled automatically for each item.