Skip to content

Initial Setup

From installation to the first calculated price — the complete path in six stations.


Step 1: Install the apps

  1. Install the merchantCENTRAL hub (AD merchantCENTRAL) first and complete its Assisted Setup
  2. Then install AD merchantCENTRAL Price Engine

Hub first

If you open the Price Engine setup before the hub is configured, the card automatically redirects you to the hub setup — the order is enforced.

Step 2: Activate the license

The Price Engine is the module PRICEENGINE — the license is separate (EUR 99 per 4 weeks per tenant, after a 30-day demo); a supplier connector does not include it. You see the state in the License FactBox on the Price Engine Setup page; a demo can be started there as well. A sandbox needs a licence or a running demo too - it is simply never billed.

Step 3: The setup wizard

Open Assisted Setup → Set up the merchantCENTRAL Price Engine. The wizard walks through the five things the engine needs:

Step What you do
License Check the state; via Open license start a demo or activate the module in the hub
What the engine does Switch on Calculate Prices (the master switch); set Write Purchase Price Lists as needed (default: on); use Suspend Price List Activation only for a migration
Sales channels Via Set up channels, create at least one sales channel in the Price Calculation Setup (see step 4)
Scheduled runs Via Create entries, set up the job queue entries (see step 6)
First calculation Via Queue all items, put every item with a supplier offer into the queue — on a catalogue that is already imported nothing changes otherwise until an offer price changes. Nothing is calculated on the spot; the entries are processed by the scheduled run or by Process Recalculation Queue on the setup card

If the engine is already set up, every step only shows what is in place; clicking through changes nothing. Set the rest on the setup card, e.g. Stale Offer Days — aligned with the longest import interval of your supplier. All fields in detail: Price Engine Setup (reference)

Two switches

Calculate Prices is the engine's own switch. Enabled on the hub's extension card activates the module and checks its license. Both must be on.

Step 4: Create the price list rules

One line per sales channel in the Price Calculation Setup — the minimum:

Field Example
Price List Code SHOP (the BC price list is created automatically with the first price)
Cost Source Best Supplier Offer — or Item Unit Cost / Purchase Price List for running without a supplier connector
Margin % e.g. 30
Rounding Method e.g. Round to x.99
Safety limits minimum price, max change %, minimum markup %

The column Example Price (Cost 100.00) shows live which sales price 100 of cost would produce. For contract price lists with fixed prices per period, set the Pricing Mode to Periodic. All fields: Price Calculation Setup (reference)

Step 5: Simulate instead of guessing

Open the Price Simulation and start a dry run: the engine calculates the whole item universe but writes nothing — per item you see the current and the simulated price, the change in percent, and whether a safety limit would kick in. Details: Simulation & Approvals

Step 6: Automate

Run Create Job Queue Entries on the setup card (or Create entries in the wizard). This sets up three scheduled entries, all on all seven weekdays:

Entry Interval Purpose
Queue (QUEUE) hourly safety net behind the import trigger; also puts scheduled prices of periodic price lists into force when the period starts, and prepares the next period
Reconcile (RECONCILE) daily closes purchase lines of offers that disappeared entirely
Coverage count (COVERAGE) nightly (start 1:00–5:00 a.m.) counts the dashboard's coverage figures and enqueues items whose price fix has expired — calculates no prices

A fourth mode FULL recalculates all enabled lists from scratch; it is not created automatically (details).

In normal operation the engine calculates automatically after every supplier import; with the standalone cost sources, changed unit costs and purchase price lines enqueue the items themselves, and with every cost source so do changed units — a new content of the sales or purchase unit, or a switch of these units on the item card.


Checklist

  • [ ] Hub installed and configured
  • [ ] Price Engine installed, license or demo active
  • [ ] Calculate Prices switched on, purchase list switch checked
  • [ ] One rule line per channel in the Price Calculation Setup
  • [ ] Safety limits set
  • [ ] Simulation run and reviewed
  • [ ] Job queue entries created
  • [ ] First calculation triggered (Queue all items or Queue All Offered Items)
  • [ ] After the first run: open the Price Cockpit and check the Rejected focus