Lightspeed eCom (C-Series) – Gotchas
Lightspeed's eCommerce platform and online store software will help your business build a strong web presence.
4 gotchas across 3 resources
These are connector-specific behaviors and limitations to be aware of when integrating.
Customers1 gotcha
customersAllLightspeed Ecommerce does not expose a total record count in list responses. meta.total_count will not appear.
Orders2 gotchas
ordersAllLightspeed Ecommerce does not expose a total record count in list responses. meta.total_count will not appear.
line_items[].total_amount is computed as (price × quantity) − sum(discounts[].total) + tax. When the store uses gross pricing (pricesIncludeTax: true), items[].price already includes tax and items[].tax is not added to avoid double-counting. line_items[].unit_price uses items[].price, which includes option-modifier surcharges over the base SKU price (productPrice is not used because it omits modifiers).
The list endpoint (GET /orders) does not embed order products, so line_items[] is not populated on list responses. Fetch the single-order endpoint (GET /orders/{id}) to retrieve line_items[] with per-item pricing, tax, and discounts.
ordersOneline_items[].total_amount is computed as (price × quantity) − sum(discounts[].total) + tax. When the store uses gross pricing (pricesIncludeTax: true), items[].price already includes tax and items[].tax is not added to avoid double-counting. line_items[].unit_price uses items[].price, which includes option-modifier surcharges over the base SKU price (productPrice is not used because it omits modifiers).
Products1 gotcha
productsAllLightspeed Ecommerce does not expose a total record count in list responses. meta.total_count will not appear.