Shopware – Gotchas

Service ID: shopware

Shopware is a trendsetting ecommerce platform to power your online business. Our ecommerce solution offers the perfect combination of beauty & brains you need to build and customize a fully responsive online store.

⚠️

4 gotchas across 3 resources

These are connector-specific behaviors and limitations to be aware of when integrating.

Customers1 gotcha

allcustomersAll

Shopware does not expose a native cross-page total record count in default list responses. meta.total_count will not appear. Surfacing the total requires setting total-count-mode: 1 in the request criteria when calling the Shopware Admin search API — an extra requirement not currently implemented.

Orders2 gotchas

allordersAll

Shopware does not expose a native cross-page total record count in default list responses. meta.total_count will not appear. Surfacing the total requires setting total-count-mode: 1 in the request criteria when calling the Shopware Admin search API — an extra requirement not currently implemented.

Shopware applies order-level promotions as separate type: promotion line items with negative totalPrice, rather than reducing the price on individual product lines. As a result, line_items[].total_amount reflects each product line's price before order-level promotion allocation. Use the top-level discounts[] array to access promotion codes and applied amounts.

Line items with type of promotion, credit, or discount are excluded from line_items[]. Items with a null or unknown type are retained.

oneordersOne

Shopware applies order-level promotions as separate type: promotion line items with negative totalPrice, rather than reducing the price on individual product lines. As a result, line_items[].total_amount reflects each product line's price before order-level promotion allocation. Use the top-level discounts[] array to access promotion codes and applied amounts.

Line items with type of promotion, credit, or discount are excluded from line_items[]. Items with a null or unknown type are retained.

Products1 gotcha

allproductsAll

Shopware does not expose a native cross-page total record count in default list responses. meta.total_count will not appear. Surfacing the total requires setting total-count-mode: 1 in the request criteria when calling the Shopware Admin search API — an extra requirement not currently implemented.