Product Cost & Profit Reports

No. It stores cost prices and order snapshots in its own tables. Your products, prices, orders and taxes are never modified.

New orders use the new cost. Existing orders keep the cost they were placed with, so past profit never changes. Items added to an existing order in the admin panel take the current cost.

Open Orders → Profit reports → Tools and create snapshots for the period. They use today's cost prices and are marked as estimated.

At least one item has no cost price. Its cost counts as 0, so the profit is too high. Enter the cost price: orders placed from then on use it. An existing snapshot is not recalculated, so the cost of that item stays 0 for the old order; the report marks such orders with a missing-cost note.

Orders in the statuses selected in the settings (Paid and Complete by default). The order page shows the profit for every status. In Multi-Vendor, parent orders are not counted; the vendor orders are.

By default, no: when your prices include tax, the included tax is subtracted so profit is calculated on net amounts. Switch off Exclude included taxes from revenue to count gross amounts.

Shipping charged to the customer counts as income; enter the real shipping cost on the order page to see the shipping result (by default the actual cost equals the charge). The payment fee (percent and fixed) and a fixed cost per order from the settings are stored with each new order and subtracted.

Yes: in CS-Cart 4.17 and later every variation is a product, so each has its own cost price. Cost prices for the legacy option combinations (inventory) are not supported.

Vendors see only the costs and profit of their own products and orders. In Vendor access to costs and profit you choose no access, view only or view and edit. Vendors cannot edit the real shipping cost or the extra cost of an order.

No. A single small write happens when an order is placed (the snapshot), wrapped so that a failure can never stop the checkout. Nothing is shown on the storefront.

Without a valid license (no key after the 14-day start period, an invalid or revoked key, a domain the license does not cover, or no successful check for 14 days), profit reports, the CSV export, the order profit panel and the margin columns are hidden. Cost prices stay editable and new orders keep receiving their cost snapshot, so the history is complete when the license is active again. Your products and orders are never affected.

Open Add-ons → Manage add-ons → Product Cost & Profit Reports: the License card at the top says what is wrong. Fix it on the License tab and click Check now. See License.

Yes. Subdomains of your licensed domain (for example staging.example.com) and local development hosts (localhost, private IP addresses, .local, .test) are covered by the same license.

Nothing changes for 14 days: the add-on keeps working and retries every hour. Only if no check succeeds for 14 days is it switched off until the next successful check.

No. The check runs only in the admin panel or from cron, at most once a day, never while customers browse or check out.