Documentation

Sales channels

The store catalog is the source of truth; a marketplace is a sales channel.

The catalog on your storefront is the source. Marketplaces are sales channels. A new marketplace cannot be added without code. New channel = one adapter file + a module row.

Channels

  • online / storefront
  • headless
  • trendyol — Product V2 (V1 closes 15 September 2026)
  • hepsiburada — catalog, then listing
  • amazon — Amazon TR MFN, marketplaceId A33AVAJ2PDY3EV

Wave 2 (same kernel): N11, Pazarama, Çiçeksepeti.

Stock

available = on_hand - reserved - sum(channel_buffers)

Remote marketplace quantity never overwrites local on_hand. Per-shop channel-push concurrency is 1. Debounce 5–15s, barcode coalesce.

Secrets

Channel API keys/secrets and Amazon refresh tokens never appear in JSON responses. Sample placeholder only: sk_live_placeholder. No real keys.

Unless CHANNEL_*_LIVE=1, real hosts are off; fake/fixture only. This marketing site does not call live channel APIs.

Guides