Mintsoft settings

Every setting on the Mintsoft Order, Shipment, Inventory, Goods Inbound and Goods Inbound Receipt Configurations, what it does and when to change it.

The Mintsoft Integration sends orders and goods inbound advices to Mintsoft and brings back shipments, stock levels and goods in receipts. Its settings live on five Configurations: Mintsoft Order, Mintsoft Shipment, Mintsoft Inventory, Mintsoft Goods Inbound and Mintsoft Goods Inbound Receipt. The Mintsoft Order Configuration covers both orders Supply Lens creates in Mintsoft and orders imported from it.

Orders: client and channel

These settings, and all the order settings below, are on the Mintsoft Order Configuration.

Setting	What it does	Values / default	When to change it
Client ID `clientId`	The Mintsoft client that receives the orders Supply Lens creates.	A Mintsoft client ID.	Set it to your client in Mintsoft.
Tag channel map `tagChannelMap`	Maps order tags to Mintsoft channel names. The first matching tag decides the channel; only that one is applied.	A map of tag to channel name.	Use it when the channel follows something about the order that's expressed as a tag.
Integration key channel map `integrationKeyChannelMap`	Maps the source Integration's key to a Mintsoft channel name, so orders from different systems land in different channels.	A map of Integration key to channel name, with a default fallback.	Use it when the channel follows the system the order came from.

Orders: courier service

Setting	What it does	Values / default	When to change it
Courier service map `courierServiceMap`	Maps courier service names from the source system to Mintsoft courier service codes. Entries are evaluated in order.	A map of service name to Mintsoft code, with a default fallback when nothing matches.	Set it whenever source service names differ from Mintsoft's codes.
Fall back to the document's courier service `fallBackToDocumentCourierService`	When the map gives no value (no matching entry and no default), sends the document's own carrier service to Mintsoft unchanged.	`true` or `false`. When `false` or unset, the courier service is left empty.	Turn on when most source service names already match Mintsoft's, and map only the exceptions.

Orders: lines, batches and bundles

Setting	What it does	Values / default	When to change it
One line per batch number `createOneLinePerBatchNumber`	Creates a separate order line for each batch number on a line, for batch-level tracking.	`true` or `false`. When `false` or unset, batches don't create separate lines.	Turn on when Mintsoft must pick specific batches.
Skip bundle processing `skipBundleProcessing`	Sends bundle products as they are instead of expanding them into their component lines.	`true` or `false`. When `false` or unset, bundles are expanded.	Turn on if Mintsoft holds the bundle as a product it builds itself. Keep it consistent with the shipment setting.

Orders: delivery dates and cancellations

Setting	What it does	Values / default	When to change it
Delivery date adjustment tag map `deliveryDateAdjustmentTagMap`	Maps order tags to a delivery date adjustment, so the delivery date can be shifted by order type. For example, orders tagged `rush` might have the date brought forward by a number of days.	A map of tag to adjustment.	Use it when some kinds of order need a different delivery date.
Automatically cancel orders `automaticallyCancelOrders`	Cancels orders in Mintsoft automatically when they're cancelled in the source system.	On or off. Default on.	Turn off only if cancellations should be handled by hand in Mintsoft.

Orders: importing from Mintsoft

These settings only matter if you import orders from Mintsoft.

Setting	What it does	Values / default	When to change it
Setup date `setupDate`	Only orders created on or after this date are imported, so history isn't pulled in at go-live.	A date. Set automatically when the Integration is first configured.	Not normally changed.
Last import date `lastImportDate`	The import watermark. Each run only fetches orders modified after it.	Date and time. Managed by the system.	Don't edit it by hand.
Import delay `importDelay`	Waits before importing an order, so other systems can finish changing it first.	A duration, for example `00:05:00`.	Add a delay if orders are picked up before they're complete.
Filter by order status `filterByOrderStatusId`	Imports only orders in these Mintsoft order status IDs.	A list of IDs. Empty means all statuses.	Narrow the import to the statuses you need.
Filter by client `filterByClientId`	Imports only orders for these Mintsoft client IDs.	A list of IDs. Empty means all clients.	Set it when the Mintsoft account holds several clients.
Filter by channel `filterByChannelId`	Imports only orders from these Mintsoft channel IDs.	A list of IDs. Empty means all channels.	Narrow the import to particular channels.
Filter by courier service `filterByCourierServiceId`	Imports only orders using these Mintsoft courier service IDs.	A list of IDs. Empty means all services.	Narrow the import to particular services.
Filter by warehouse `filterByWarehouseId`	Imports only orders at these Mintsoft warehouse IDs.	A list of IDs. Empty means all warehouses.	Narrow the import to particular warehouses.
Default customer `defaultCustomerId`	The Party used when no customer can be identified from the order.	A Party ID.	Set it so every imported order has a customer.
Always use the default customer `alwaysSetDefaultCustomerId`	Always applies the default customer, overriding any customer found on the order.	`true` or `false`. When `false` or unset, the default is used only when no customer is found.	Turn on when all imported orders belong to one account.
Completed order statuses `completedOrderStatusIds`	The Mintsoft order status IDs that mean an order is complete. Orders in these statuses are imported as fulfilled.	A list of IDs.	Set it to Mintsoft's completed statuses.
Status to fulfilment status map `statusIdToFulfillmentStatusMap`	Maps Mintsoft order status IDs to Supply Lens fulfilment statuses.	A map of status ID to fulfilment status.	Set it when you need Mintsoft statuses reflected in Supply Lens.
Tag generation `documentLevelTagGeneration`	Rules that create tags from Mintsoft order fields, to categorise orders.	A list of rules.	Use it to tag orders for routing or reporting.
Advanced tag generation `documentLevelAdvancedTagGeneration`	Advanced tag rules with conditional logic and transformations.	A list of rules.	Use it when simple tag rules aren't enough.
Order number reference type `orderNumberReferenceType`	The document reference type that carries the Mintsoft order number, for traceability.	A reference type.	Set it if you need the Mintsoft order number on the Document.
External order reference type `externalOrderReferenceType`	The document reference type that carries the source system's order reference.	A reference type.	Set it to keep the original order ID on the Document.
Disable the expected payable tag `disableExpectedPayableTag`	Stops the expected payable tag being added. That tag is normally used to check that the calculated order total matches the expected amount.	On or off.	Turn on only to skip the total check.

Shipments

These settings are on the Mintsoft 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.	A date. Set automatically when the Integration is first configured.	Not normally changed.
Last import date `lastImportDate`	The import watermark. Each run only fetches shipments modified after it.	Date and time. Managed by the system.	Don't edit it by hand.
Import delay `importDelay`	Waits before importing a shipment, so other systems can finish changing it first.	A duration, for example `00:05:00`.	Add a delay if shipments arrive incomplete.
Filter by order status `filterByOrderStatusId`	Imports only shipments from orders in these Mintsoft status IDs.	A list of IDs.	Narrow the import to particular order statuses.
Filter by client `filterByClientId`	Imports only shipments for these Mintsoft client IDs.	A list of IDs.	Set it when the account holds several clients.
Filter by channel `filterByChannelId`	Imports only shipments from these Mintsoft channel IDs.	A list of IDs.	Narrow the import to particular channels.
Filter by courier service `filterByCourierServiceId`	Imports only shipments using these Mintsoft courier service IDs.	A list of IDs.	Narrow the import to particular services.
Filter by warehouse `filterByWarehouseId`	Imports only shipments at these Mintsoft warehouse IDs.	A list of IDs.	Narrow the import to particular warehouses.
Order number reference type `orderNumberReferenceType`	The document reference type that carries the Mintsoft order number on imported shipments.	A reference type.	Set it to match the order Configuration.
External order reference type `externalOrderReferenceType`	The document reference type that carries the source system's order reference on imported shipments.	A reference type.	Set it to match the order Configuration.
Skip bundle processing `skipBundleProcessing`	Leaves bundle products as they are on shipment lines instead of expanding them.	`true` or `false`. When `false` or unset, bundles are expanded into components.	Keep it the same as the order setting.
Disable the expected payable tag `disableExpectedPayableTag`	Stops the expected payable tag being added to imported shipments.	On or off.	Turn on only to skip the check.

Inventory

These settings are on the Mintsoft Inventory Configuration.

Setting	What it does	Values / default	When to change it
Last import date `lastImportDate`	The import watermark. Each run only fetches stock changes since it.	Date and time. Managed by the system.	Don't edit it by hand.
Included warehouse IDs `includedWarehouseIds`	Imports stock only from these Mintsoft warehouse IDs.	A list of IDs. Empty means all warehouses.	Set it to exclude warehouses that don't hold your stock.
Included warehouse codes `includedWarehouseCodes`	Imports stock only from these Mintsoft warehouse codes. Can be used instead of, or as well as, the IDs; when both are set, stock is included if it matches either.	A list of codes.	Use it when codes are easier to manage than IDs.

Goods inbound

This setting is on the Mintsoft Goods Inbound Configuration.

Setting	What it does	Values / default	When to change it
Goods in type `goodsInType`	The Mintsoft "Goods In" type given to inbound records Supply Lens creates.	A Mintsoft goods in type.	Set it to the type your 3PL uses.

Goods inbound receipts

These settings are on the Mintsoft Goods Inbound Receipt Configuration.

Setting	What it does	Values / default	When to change it
Setup date `setupDate`	Only receipts created on or after this date are imported.	A date. Set automatically when the Integration is first configured.	Not normally changed.
Last import date `lastImportDate`	The import watermark. Each run only fetches receipts modified after it.	Date and time. Managed by the system.	Don't edit it by hand.
Import delay `importDelay`	Waits before importing a receipt, so other systems can finish changing it first.	A duration, for example `00:05:00`.	Add a delay if receipts arrive incomplete.
Filter by ASN status `filterByAsnStatusId`	Imports only receipts linked to ASNs (advance shipping notices) in these status IDs.	A list of IDs.	Choose the statuses that mean the goods have been counted in.
Filter by client `filterByClientId`	Imports only receipts for these Mintsoft client IDs.	A list of IDs.	Set it when the account holds several clients.
Filter by warehouse `filterByWarehouseId`	Imports only receipts at these Mintsoft warehouse IDs.	A list of IDs.	Narrow the import to particular warehouses.