How it works
One order, from capture to contribution margin.
Nine steps. Four systems. The step numbers below carry a status, because parts of this flow run today and parts are still being built, and you should know which is which before a demo rather than after a contract.
Sales channels
- Shopify
- Amazon
- Walmart (planned)
- Marketplaces (planned)
TSmartConnect
Orchestration layer
- Capture
- Normalize
- Match
- Reconcile
- Sync engine
- Contribution margin
TSmart Warehouse
System of record for physical inventory
QuickBooks Online
System of record for accounting
Systems of record
Ambiguity here is the main reason buyers misread this category. Each system owns one thing, and no other system may assert it.
| System | Owns | What that means |
|---|---|---|
| TSmart Warehouse | Physical inventory | The count of what is on a shelf. No other system may assert it. |
| Shopify | Sellable inventory distribution | What a storefront is allowed to sell, which is a policy result, not a physical count. |
| TSmartConnect | Channels and synchronization | Owns no source data. Orchestrates, matches and reports on records other systems own. |
| QuickBooks Online | Accounting | The ledger. Financial reporting resolves here, not in the orchestration layer. |
The order lifecycle
Told once, in order, with the owner and the status of every step.
- 1
Listing published
Planned Owner: ProviderListings are created and priced in each provider today. Publishing a listing from the orchestration layer is not built.
- 2
Order captured
Live Owner: ProviderOrders are read from every connected provider account. Shopify sends signed webhooks and duplicates are discarded on arrival; Amazon is read on a schedule.
- 3
Order normalized
Live Owner: TSmartConnectProvider orders are mapped into one shape with the source record kept, so a marketplace order and a storefront order sit in the same list without losing what the provider actually sent.
- 4
Stock reserved
Planned Owner: TSmart WarehouseAllocation is not built. Stock is reconciled and reported, but no quantity is reserved against an order and none is published back to a sales channel.
- 5
Released to the warehouse
Planned Owner: TSmart WarehouseThe service-account link between the two systems exists. Releasing an order across it does not.
- 6
Shipped
Planned Owner: TSmart WarehouseAmazon shipment records are read for visibility. Fulfillment driven from this layer is not built.
- 7
Invoiced
Planned Owner: QuickBooks OnlineLedger data is read into this system. Writing back is gated and switched off: the posting path belongs to the warehouse system today, and two systems posting the same invoice is the failure this design exists to prevent.
- 8
Payout reconciled
In development Owner: QuickBooks OnlinePayouts are available as a read-only cash-movement ledger on a transaction-date basis. Matching a payout against orders needs stored reconciliation state and is not built.
- 9
Contribution computed
Live Owner: TSmartConnectGross sales, cost of goods and marketplace fees per sales channel on an order-date basis, reported with the share of sales whose cost is known.
Provider, account, storefront
These are three separate things, and collapsing them is what makes most integrations fail on the second store. A provider is the system you integrate with once, such as Shopify. An account is one seller identity on that provider. A storefront is one selling surface belonging to an account.
One Shopify integration serves as many shop domains as you run. One Amazon integration serves as many marketplaces as you sell in. Records are keyed by the connection that produced them, so a second account is a row, not a redeployment.