Configuration

Sales Channel Parameters

Sales channel parameters are key-value pairs scoped to a specific sales channel. They are stored within the app itself — not in the ERP. Your app is responsible for persisting and managing them. All configuration data must be scoped by sales channel ID, so that settings from one channel never affect another.

Common Parameters

Key	Description	Example
LAST_ORDER_IMPORT_TIMESTAMP	When orders were last imported	2026-01-15T10:30:00Z
API_KEY	Platform API key	sk_live_abc123
API_SECRET	Platform API secret	encrypted_secret
SHOP_URL	Platform store URL	mystore.myplatform.com
PLATFORM_VERSION	Platform API version	2024-01
AUTO_ORDER_IMPORT	Whether to auto-import orders	true
QUEUE_BATCH_SIZE	Queue processing batch size	10
TRANSFER_TYPES	Enabled sync types (JSON)	{"product":true}

Set sensible defaults when a new sales channel is created (in your sales_channel.create webhook handler).

Caching

Reading parameters from storage on every request can be slow. Consider an in-memory cache with the sales channel ID as part of the cache key. Invalidate cached values when a parameter is updated and add a TTL for periodic refresh.

Credential Storage

Never log credentials. Encrypt them at rest and support rotation without downtime.

Transfer Toggles

Transfer toggles control which sync directions are active per sales channel. Stored as a JSON string in the TRANSFER_TYPES parameter.

Toggle	Direction	Default
UPLOAD_ARTICLE_MASTERDATA	Product data → platform	false
UPLOAD_ARTICLE_PRICE	Prices → platform	false
UPLOAD_ARTICLE_STOCK	Stock levels → platform	false
UPLOAD_ARTICLE_IMAGE	Product images → platform	false
UPLOAD_ORDER_STATUS	Order status → platform	true
DOWNLOAD_ORDERS	Orders ← platform	true

Outbound article sync is disabled by default — the user enables it after configuring the channel. Order-related flows are enabled by default.

Toggles are checked before creating queue entries, so webhook handlers don't need to check them.