ControlPort settings

Every setting on the ControlPort order, inventory and shipment Configurations, including the tag maps and the carrier service shipping map.

The ControlPort connector sends orders to ControlPort and imports stock levels and shipments. Its settings live on three Configurations: ControlPort Order, ControlPort Inventory and ControlPort Shipment.

Orders

These settings are on the ControlPort Order Configuration. The three tag maps read the order's tags in order, and the first matching tag decides the value.

Setting	What it does	Values / default	When to change it
Channel account by tag `tagChannelAccountIdMap`	Chooses the ControlPort channel account ID from the order's tags.	Tag map to channel account ID.	Send orders from different sales channels to different channel accounts.
Order type by tag `tagOrderTypeMap`	Chooses the ControlPort order type from the order's tags.	Tag map to order type.	Give, for example, trade and consumer orders different order types.
Allow pre-order by tag `tagAllowPreorderMap`	Decides from the order's tags whether pre-ordering is allowed for the order.	Tag map to the pre-order setting.	Allow pre-orders only for orders carrying a particular tag.
Carrier service shipping map `carrierServiceShippingMap`	Maps carrier service names to a ControlPort shipping configuration. Names are matched case-insensitively. See below.	Map of service name to shipping configuration.	Set an entry for every carrier service your orders use.

Carrier service shipping map

Each entry in carrierServiceShippingMap sets these fields:

Field	What it means
`postageSpeed`	The postage speed: `Urgent`, `Priority`, `Standard` or `Economy`.
`allowSaturday`	Whether Saturday delivery is allowed.
`signedFor`	Whether a signature is required on delivery.
`noSignature`	Whether to suppress the signature requirement.
`tracked`	Whether the shipment is tracked.

Inventory

These settings are on the ControlPort Inventory Configuration.

Setting	What it does	Values / default	When to change it
Warehouses `includeWarehouseIds`	Only stock in these ControlPort warehouses is imported.	List of warehouse IDs. Empty means all warehouses.	Limit the import to the warehouses you use.
Import batches `importBatches`	Includes batch numbers with the stock data, for batch-level tracking.	`true` or `false`. Off or not set means no batch information.	Turn on if you track stock by batch.
Take latest batch on conflict `takeLatestBatchOnConflict`	When several batches exist for the same product and they conflict, uses the most recently created batch.	`true` or `false`. When off, a different resolution is used.	Turn on if the newest batch should win.

Shipments

These settings are on the ControlPort Shipment Configuration.

Setting	What it does	Values / default	When to change it
Setup date `setupDate`	Only shipments created on or after this date are imported, so historical shipments aren't pulled in at go-live.	Date. Set automatically when the Integration is first configured.	Not normally changed afterwards.
Last import date `lastImportDate`	The import watermark. Each run fetches only shipments modified after it.	Date and time. Managed by the system.	Don't edit it by hand.
Import delay `importDelay`	Waits this long before importing a shipment, so other systems can update it first.	Duration, for example `00:05:00` for five minutes.	Add a delay if shipments are updated just after despatch.