Skip to content

Price Engine Setup (Reference)

The master switches of the engine. The regular way leads through the merchantCENTRAL Setup: under Extensions, select the line Price Engine and choose Set Up — the hub's extension card shows the settings embedded. Alternatively, search for Price Engine Setup; the same fields sit there in the Price Engine Settings area, together with the License FactBox and the action Activate in Hub. For the first start there is the step-by-step guide and the wizard in the Assisted Setup.

If the engine cannot calculate right now, the line Why no prices are calculated at the top names the first gate it fails at, and what to change first.


Fields

Field Meaning
Calculate Prices Master switch of the engine. Off = the engine neither calculates nor writes; price changes are still collected and processed by the first run after switching it on. Not to be confused with Enabled on the hub's extension card: that activates the module and checks its license. Both must be on
Rejection Alert Threshold From how many rejections per run a notification with a jump into the log appears (0 = off). Default: 50
Max. Offer Price Spread The factor by which the supplier offers of an item may differ at most. If the dearest offer costs more than this multiple of the cheapest, the price is rejected and the previous one stays — the offers then almost always mix prices per piece and per package unit. Default: 4; 0 = off, values below 2 are not allowed
Write Purchase Price Lists Whether supplier offers are mirrored into purchase price lists (MC-<VendorNo>). Switch off if you maintain purchase prices manually
Suspend Price List Activation Migration mode: the engine keeps calculating and writing, but every price list that has never gone live stays inactive — Business Central sells at the previous prices. Default: off → Migration mode
Stale Offer Days After how many days without refresh an offer counts as withdrawn and its purchase line is closed — choose a value above the supplier's longest import interval. Default: 3
Cockpit Row Limit How many rows the Price Cockpit loads per sales channel. Default: 1,000; 0 = no limit
Show Price Origin on Documents Whether the assist button on the Unit Price of sales quote, order and invoice lines shows where the price of an item line comes from — with the calculation behind it. Default: off, because everyone who opens the document then sees the calculation; while it is off, the button only says so → Price origin in sales documents
Last Queue Run / Last Queue Items Area Last Recalculation: when the queue last ran and how many items it processed
Items Waiting Current fill level of the recalculation queue — click opens the list

The License FactBox shows the state of the module PRICEENGINE and can start the demo.


Actions

Action Effect
Price Engine Dashboard Opens the dashboard: what is still ahead, what was calculated today, whether the engine runs
Process Recalculation Queue Calculates all waiting items now: write purchase lines, close withdrawn offers, calculate sales prices per enabled list
Reconcile Purchase Prices Full pass: checks every active MC-* purchase line and closes lines without a live offer
Queue All Offered Items Puts every item with a supplier offer into the queue — after changed conditions, margins or rounding rules, which queue no item on their own
Create Job Queue Entries Sets up the scheduled processing: queue hourly (QUEUE), purchase reconcile daily (RECONCILE) and the nightly coverage count (COVERAGE, start 1:00–5:00 a.m.) for the coverage figures — all three on all seven weekdays
Price Calculation Setup · Supplier Cost Setup · Category Margins · Marketplace Fees The rule tables in direct access
Price Cockpit · Calculation Log · Recalculation Queue · Price Fixes Jumps into the daily work

No manual work in normal operation

The engine processes the queue 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. The actions exist for the first start and for "right now" situations — in daily work you start them from the dashboard, which shows next to them how many purchase and sales prices are still ahead.


Migration mode

With Suspend Price List Activation the engine calculates and writes without its prices selling yet. Lines and header of every price list that has never gone live stay inactive; in the Price Cockpit these items show Price Inactive. That way you compare the new prices with the old ones at leisure.

You go live in the Price Calculation Setup: Activate Price List list by list, Activate All Price Lists in one step — including the MC-* purchase price lists; this switches the setting off. While it is on, the Price Calculation Setup list shows the column Price List Live. A list that has gone live once stays live, even if you switch the setting on again later. The dashboard points out the migration mode, so it is not left on by accident. Details, including periodic and derived lists, are in the manual.


How the queue works

  1. Every price change (import, unit cost, purchase line) and every changed unit only notes the item — that costs practically nothing
  2. Processing happens once per item, no matter how many offers changed — the decisive efficiency factor with aggregators carrying many offers per item
  3. Per item everything happens at once: purchase lines, reconcile, sales price per enabled price list

The engine's job queue entries in detail:

Parameter What the entry does
QUEUE First puts scheduled prices of periodic price lists into force whose period has started, then processes the queue, and finally prepares the next period once its lead time has begun
RECONCILE Full reconcile of the MC-* purchase lines
COVERAGE Counts the coverage figures and then enqueues items whose price fix has expired
FULL Recalculates all enabled lists from scratch (manually or as an entry of its own) — after large rule changes. Periodic lists keep their prices