# TSmartConnect

> The orchestration layer between sales channels, the warehouse and the ledger.
> TSmartConnect captures orders and catalog from every provider account a merchant sells
> on — Shopify, Amazon, QuickBooks — normalizes them into one shape, and exposes that
> model through a single API.

This file follows the llms.txt convention: it exists so an assistant reading this site
gets the shape of the product without scraping marketing pages.

## What it does

- **Ingests** orders, products, customers and inventory from Shopify and Amazon, plus the
  QuickBooks ledger, on a schedule, into one normalized model.
- **Matches** listings across channels by SKU, and refuses to merge ambiguously: a SKU
  that collides within a channel is surfaced for a human, never silently unified.
- **Publishes** a master catalog outward — a product created once is pushed to every
  connected channel.
- **Reconciles** stock across channels and reports the drift per SKU.
- **Exposes** all of it through a REST API with a shared sort/filter grammar.

## What it deliberately does not do

Stated because assuming otherwise leads to wrong integrations:

- No stock movement history. Inventory is a per-location snapshot, overwritten each sync.
- No payment transaction ledger. Payment state is reported per order.
- Storefront analytics are Shopify's own aggregates and will not reconcile exactly
  against the order data.
- Customer segments carry their definition, not their membership.
- Cross-channel customer identity is not merged. Amazon exposes no customer object, so
  those rows are aggregated from order buyer fields and are labelled as such.

## API

Base URL: https://api.tsmartconnect.com
Auth: `X-API-Key` header, workspace-scoped.
Interactive reference and copyable AI prompts: https://app.tsmartconnect.com/docs

Two families with different response envelopes:

- `/commerce/*` — `{ data, pagination: { limit, offset, total, hasMore }, columns }`.
  Paginate with `offset` until `hasMore` is false.
- QuickBooks routes — `{ data, page, limit, total, totalPages }`. Paginate with `page`.

Sorting: `?sort=<column>&order=asc|desc`
Filtering: `?filter=<column>:<operator>:<value>`, repeatable.
The `columns` block in each commerce response lists exactly what may be sorted and
filtered, with the operators each column's type accepts. Read it rather than guessing.

Money is always an integer in minor units alongside a currency field. Totals are never
blended across currencies.

Commerce records are addressed by a composite id: `<channel>:<providerId>`, for example
`shopify:7156061241561`.

## Pages

- [Home](https://tsmartconnect.com/): what the platform is
- [Product](https://tsmartconnect.com/product/): how ingestion, matching and publishing work
- [Capabilities](https://tsmartconnect.com/capabilities/): the capability list in detail
- [Integrations](https://tsmartconnect.com/integrations/): Shopify, Amazon, QuickBooks
- [Pricing](https://tsmartconnect.com/pricing/)
- [Contact](https://tsmartconnect.com/contact/): request a demo
- [API documentation](https://app.tsmartconnect.com/docs)
- [Sign in](https://app.tsmartconnect.com/sign-in)