Product Synchornization

1 Synchronisation Methods

Please make sure that

Method	Trigger	Scope	Where to enable / run	Screenshot
Changelog Entity Sync	Every 10 minutes	Only products that changed since the previous run	Automatic — no configuration required
Full Catalogue Sync	Daily, at the scheduled hour	Entire product catalogue	Enable Daily Product Synchronisation in Settings → Extensions → Nosto
Manual Full Sync	On demand	Entire product catalogue	Marketing → Nosto Job Listing → Schedule Full Product Sync

---

2 Required Fields

Synchronisation will fail unless every product contains the seven mandatory attributes below.

Field	Message if missing
product_id
name
url
image_url
availability
price	(null values default to 0; no warning)
price_currency_code

Tip — placeholder images Shopware allows products without images. From Nosto v3.3.9 / v4.2.9 onward, such items receive image_url = /bundles/storefront/assets/icon/default/placeholder.svg. Ensure that file exists or the product will sync but remain Not promotable.

---

3 Shopware Defaults vs. Nosto

• Name, Product Number, Price (gross/net) are mandatory UI fields in Shopware.

• product_id and url are generated on save.

• Stock defaults to 0 if left blank.

• A product saved without images displays fine in Shopware but requires the placeholder rule above to stay promotable in Nosto.

---

4 Impact of Clearance sale & Hide products after clearance

Stock	Clearance sale	Hide after clearance	Behaviour on storefront	Status in Nosto
≥ 1	—	—	Always visible, purchasable	InStock
0	Off	Off or On	Visible (can’t buy)	InStock
0	On	Off	Visible (can’t buy)	OutOfStock
0	On	On	Hidden	Discontinued (if previously synced)

Please familiarise yourself with Clearance Sale & Hide products after clearance

---

5 Key Nosto Plugin Options

Option	Effect
Sync inactive products	Mirrors Shopware logic for inactive items (needed if you rely on variant fall-backs).
Sync first available variant	Keeps a product promotable when the parent is on clearance & out of stock.
Category exclusion	Any product in the selected category is omitted from the feed (or becomes Discontinued).

Enable both sync options above to make Nosto match the default Shopware storefront behaviour.

---

6 Display Scenarios & Resulting Nosto Status

6.1 Simple Product (no variants)

Condition	Storefront	Nosto status
Stock 0 & both clearance sale and hide after clearance flags are On	Hidden	Discontinued
Stock 0 & Clearance sale On only	Visible, can’t buy	OutOfStock
Stock ≥ 1	Visible, purchasable	InStock

---

6.2 Variant Product — Display parent mode

Condition	Storefront outcome	Nosto status (parent / variant)
Parent OOS, both clearance sale and hide after clearance flags On	First available variant shown	Variant InStock
Parent OOS, Clearance sale flag On	Parent shown (can’t buy)	Parent OutOfStock
Parent inactive, variant active	Variant shown	Variant InStock/OutOfStock (depending on availability)

---

6.3 Variant Product — Display cheapest mode

Condition	Nosto status for cheapest variant
OOS + both clearance sale and hide after clearance flags On	Discontinued
OOS + Clearance sale On	OutOfStock
Cheapest inactive	Next active variant syncs (status depends on stock)

---

6.4 Variant Product — Choose a variant mode

Condition	Storefront	Nosto status
Selected variant OOS + both clearance sale and hide after clearance flags On	First available variant shown	Variant InStock
Selected variant OOS + Clearance sale On	Variant shown (can’t buy)	OutOfStock
Selected variant inactive	First active variant shows	InStock/OutOfStock (depending on availability)

---

6.5 Expanded Property Listings

No property selected

Flags	Storefront	Nosto status
Clearance sale On only	First active variant per product	InStock/OutOfStock (depending on availability)
Both clearance sale and hide after clearance flags On	First available variant	InStock

All properties selected

• Every active variant is listed; Nosto mirrors availability per variant.

• With Both clearance sale and hide after clearance flags On, only available variants appear and sync as InStock.

Sub-set of properties

• One variant per selected property value.

• With Both clearance sale and hide after clearance flags On, only available variants appear and sync as InStock.

---