FAQ
LS RealMargin: Landed Cost · Updated 19 October 2026
Short answers for merchants. Step-by-step use is in the app documentation.
What does the app do?
Shopify stores one Cost per item on each variant. That figure is often only the supplier price. Freight, duty, brokerage, insurance, and fees arrive on separate invoices, sometimes after the goods have already sold. LS RealMargin allocates those extra costs across the lines on a shipment receipt, previews the true unit cost, and writes a weighted-average cost back to Shopify. On the Growth plan it also shows, inside the app, how margin on units already sold compared with that true cost.
What does it not do?
It is not a full inventory or accounting system. It does not keep FIFO cost layers, create purchase orders, manage suppliers, sync Xero or QuickBooks, read PDF invoices, or look up tariff rates. It writes one average Cost per item per variant. That cost is store-wide, not a separate cost per location.
Does Apply change past Shopify orders?
No. Apply updates the current Cost per item on the inventory item. Shopify’s historical order profit uses the cost that existed when the order was placed, and this app cannot rewrite that. The margin report is a restatement inside the app only.
What number is written to Shopify?
A weighted average. Existing on-hand units keep their previous Cost per item. The units on this receipt come in at the landed unit cost (supplier price plus allocated extras, after any manual exchange rate). The new Cost per item is the average of those two groups. If nothing is on hand, the new cost is the landed unit cost.
What does “Stock is already in Shopify” mean?
Turn it on when this receipt’s quantity is already included in Shopify’s current on-hand count. The average then treats on-hand minus this receipt’s quantity as the stock from before the shipment. Turn it off when on-hand is still the stock from before these units arrive. The choice is a default in Settings and can be reviewed before you apply. Settings never change a cost by themselves.
Can I undo a write?
Starter and Growth can undo. Undo restores the Cost per item that was stored before that receipt was applied. If someone has changed that cost in Shopify since the write, the line is marked as a conflict and is not overwritten. Free does not include undo. An undone receipt cannot be applied again; duplicate it into a new draft instead.
A freight invoice arrived after I applied. What do I do?
On an applied or partially applied receipt, use Add extra cost (late invoice). The app undoes the previous write, adds the new cost, and applies the revised average. This is allowed only when that receipt is still the latest cost write for those variants. If undo finds a conflict, fix the Shopify cost or resolve the conflict before revising.
Why is Undo, CSV, or the margin report unavailable?
Those features depend on the plan. Free includes allocation, preview, and up to 3 applied receipts per month. Starter adds unlimited applies and undo. Growth adds the margin report, CSV import and export, and a manual exchange rate when the supplier currency differs from the store currency. Paid plans include a 14-day trial. Billing is handled by Shopify. The app does not collect card numbers.
Why does the margin report say orders access is needed?
Shopify treats the Order object as protected customer data. The read_orders scope is not enough on its own. Until Protected customer data is approved for this app, Shopify blocks order reads. The report then shows “Orders access needed”, and sold units stay blank. Preview does the same: it still calculates landed cost, and it adds a warning instead of failing the page.
To approve access:
- Open the Partner Dashboard and select this app.
- Go to API access requests, then Protected customer data.
- Select only App functionality and Store management.
- Do not request customer name, email, phone, or address. The report needs sold quantity and the line total in the shop’s currency. It does not need a customer profile.
- Save, then run the report again.
On a development store you can save those reasons without an App Store review. A public app must pass Shopify’s protected customer data review before production stores can use the margin report. The app does not store customer names, emails, phones, or addresses. See the documentation and the Privacy Policy.
Why are some older orders missing?
Shopify’s default order access is about the last 60 days. A date range longer than that can omit older orders unless the separate read_all_orders scope is approved. This app does not request that scope. Refunds and returns are not subtracted in this version, so a returned unit can still count as sold.
Does the app store customer information?
No. It stores the shop domain, the session used to call Shopify, shop settings, receipt lines and costs, and an audit of apply, undo, and settings changes. Product and variant IDs and cost amounts are stored. Shopper personal information is not. Uninstall deletes sessions immediately. Shop data is removed on Shopify’s shop redact webhook, or after the uninstall retention period described in the Privacy Policy.
Will Settings change costs already on my products?
No. Settings only set defaults for the next receipt: allocation method, whether stock is already in Shopify, and the weight unit. Store currency is read from Shopify and cannot be edited here. Applied receipts stay as they were. The plan is not changed from Settings.
Can I copy a receipt?
Yes. Duplicate creates a new draft with the same header, lines, and extra costs. The reference becomes the original plus “ copy”, then “ copy 2” if that name is taken. Allocated amounts, landed costs, and write status are cleared. Shopify Cost per item is not changed until you preview and apply the copy.
What if some lines fail to write?
The receipt is marked partial. Lines that succeeded stay written. Retry failed lines attempts only the lines that failed. You can also undo a partial receipt on Starter or Growth, subject to the same conflict check as a full undo.
Who do I contact?
Email lizasolutions9@gmail.com. We typically reply within one business day. Also see the app documentation, Privacy Policy, and Terms of Service.