> 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/shopware6_en_us/reference-and-lookup/field-reference-item-card.md). # 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. | {% hint style="info" %} 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. {% endhint %} ### 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. | {% hint style="success" %} 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. {% endhint %} --- # 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/shopware6_en_us/reference-and-lookup/field-reference-item-card.md?ask=&goal= ``` `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.