# Shopware — Ecommerce API: gotchas

> Canonical URL: https://developers.apideck.com/apis/ecommerce/shopware/gotchas

## GET /ecommerce/orders

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.

## GET /ecommerce/orders/{id}

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.

## GET /ecommerce/products

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.

## GET /ecommerce/customers

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.


[API reference](https://developers.apideck.com/apis/ecommerce/reference.md) · [Coverage matrix](https://developers.apideck.com/apis/ecommerce/coverage)
