Skip to content

Setup Wizard

The Setup Wizard (MC Warehouse Client Setup) guides you through the initial configuration of the Warehouse Client in 7 steps. You reach it via Assisted Setup in Business Central:

Search (Alt+Q) → Assisted Setup → group "AD merchantCENTRAL Setup" → merchantCENTRAL: Set up Warehouse Client.

Alternatively, open it from the setup page with the Setup Wizard action.

Set up the Hub first

When opening, the wizard uses the Platform Guard to check whether the merchantCENTRAL Hub is already set up. If it is not, you are directed to the Hub setup. So set up the Hub first.

Prerequisites

  • [ ] merchantCENTRAL Hub (≥ 2.73.0.0) set up
  • [ ] License or demo for the WAREHOUSE module available (the demo can be started in the wizard)
  • [ ] Entra ID app registration (Client ID) ready for the device sign-in

Step 1 – Welcome

Overview and prerequisites. The wizard lists what should be in place:

  • The merchantCENTRAL platform (Hub) is set up.
  • A license or demo is available for the Warehouse Client module.
  • The Entra ID app registration for the MAUI client.

Click Next to continue.

Step 2 – License

Shows the current License Status of the WAREHOUSE module:

Status Meaning
Active Valid license present – module can be enabled
Demo Demo running – full feature scope for 30 days
other (e.g. Unregistered, Expired) No license/demo – module is not enabled on completion

If neither a license nor a demo is present, the Register Demo action appears. With it you start a free 30-day demo. Details: Start a free demo.

A sandbox costs nothing — but still needs a demo

A BC sandbox is never billed, and a demo does not count as consumed there. The licence/demo check itself applies exactly as it does in production: without a licence or a running demo, the module does not work in a sandbox either. See Licensing & Modules.

Step 3 – General

Controls automatic shipment assignment and the lock logic:

Field Recommendation Meaning
Auto-Assign Enabled On After completing a shipment, the next one is automatically assigned to the terminal
Assignment Priority FIFO Order of assignment: FIFO, Shipping Deadline (urgent first), or Marketplace Priority
Lock Timeout (Seconds) 300 Seconds after which a document lock automatically expires (60–3600)
Terminal Idle Minutes 5 Minutes without activity after which a terminal is considered idle in the dashboard (1–60)

Wizard only

Terminal Idle Minutes is only available here – the setup page does not show the field. Run the wizard again to change it.

Step 4 – Modules

First choose the Warehouse Mode, then enable the globally available modules. The default applies to all terminals and can be overridden per terminal (Terminals).

Field Meaning
Warehouse Mode Determines the picking model: Order Picking (without BC WMS) → Pick List, BC Warehouse Picks (with WMS) → Warehouse Activity. The two modules are mutually exclusive; only the one matching the Warehouse Mode can be enabled.

The wizard shows the 11 core modules: Goods Receipt, Goods Issue, Pick List, Item Lookup, Warehouse Activity, Putaway, Complaint, Return, Label Print, Item Weighing, Photo (Enable Photo Capture).

More settings on the setup page

The bin/WMS modules (Stock Transfer, Inventory Count, Bin Put-away, Bin Replenishment), the Goods Issue Mode, Blind Count, the Login Mode and the Windows Client Display Mode are set afterwards on the setup page. See also Stock Transfer, Inventory & Bins.

Only what is needed

Enable only modules that are actually used in operation – every disabled tile disappears from the app's main menu and keeps the interface tidy.

Step 5 – Scanning & Shipment Integration

Scanning:

Field Meaning
Require Serial No. Scan Serial numbers must be scanned individually during goods issue
Require Weight Entry Shipping only with a weight above 0 – calculated or weighed (see Setup)
Scan Log Enabled All barcode scans are logged for audit/analysis

Shipment integration:

Field Meaning
Default Shipment Provider Default for label creation; only active merchantCENTRAL shipment providers can be selected
Default Shipment Service Default shipping product (e.g. CL, STANDARD) of the selected shipment provider
Auto-Create Shipment Label After posting a shipment, a shipping label is created automatically

Shipment connector required

For label creation, the matching shipment connector must be installed and set up (e.g. DHL). Which carrier actually prints the label is primarily determined by the document – see Setup (Reference).

Step 6 – Warehouse Client (MAUI)

Behavior of the device app and authentication:

Field Meaning
Entra Client ID (MAUI App) Client ID of the Entra ID app registration for the device sign-in. It is included in the QR code – without it, sign-in fails.
Require User Login Release the modules only after the employee has signed in with badge + PIN (recommended).
Settings PIN 4-digit PIN that protects access to the settings in the app. Set or change it via …; only a salted hash is stored. The field only shows PIN is set or No PIN set.
Startup Module Module that opens automatically on app startup. Module Selection Screen = main menu.

Via the Download Client App action you open the download page with the Windows and Android installers. See also Client Installation & Updates.

Store the PIN securely

The Settings PIN prevents warehouse staff from changing the device configuration. Assign a PIN and communicate it only to administrators. It can be removed on the setup page with Remove Settings PIN.

Step 7 – Completion

A summary shows the license status, the number of enabled modules, and the configured default shipment provider. With Finish, the settings are saved. If the module is licensed or a demo is running, the Warehouse Client is enabled automatically.

Not licensed?

If you complete without a license/demo, the settings are saved, but the module remains inactive. Register a demo or license and then activate the extension via Activate in Hub on the setup page.

After the Wizard

  1. Complete the setup page – goods issue mode, WMS modules, login mode, etc. → Setup (Reference)
  2. Create warehouse users – employees with badge barcode and PIN. → Licensing & Modules
  3. Create terminals – one terminal per packing station/scanner with printers and, if applicable, allowed shipping agents. → Terminals & QR Pairing
  4. Pair devices – show the QR code per terminal or print the setup sheet and scan it in the app. → Terminals & QR Pairing
  5. Distribute the app – roll out the Windows/Android installers. → Client Installation & Updates

Next Steps