Elbuz re-runs the price list by the current rules — to check a changed rule without a new import. Manual pairs come back if the “Search for manually matched products” type is enabled.
When you need this:
- You changed a rule — a restart removes the links and rebuilds them by the price list's types.
- Automatic pairs are good, rules will change — one button saves them as manual.
- Rules changed for all suppliers — restart all active price lists.
- The run broke off — a new start rebuilds links from scratch; manual pairs are safe.
Where to start: check the price list's types include “Search for manually matched products”.
What a restart does
A regular price list import matches products on its own. You need a restart when the matching types or your own rule have changed and you don't want to wait for the next import.
- Rebuilds the links of one price list — removes all of them and sets them again by the enabled types, in their order.
- Keeps a good match — automatic pairs become manual and survive later restarts.
- Works across all price lists — from the matching types directory, with the option to stop between price lists.
- Survives a break — what was found before the break stays; starting again rebuilds the rest.
What the “Start product matching” button does
The “Start product matching” button in the settings window header goes through the price list again and sets links by the rules. You do need it — otherwise there's no way to check changed rules.
There are two steps. First, links are removed from all price list rows — every one of them, both automatic and manually confirmed. Then the program rebuilds them by the matching types enabled for this particular price list, in the order they appear in the list.
Both steps are named in the red “Start product matching” confirmation window:
“All links of this price list will be dropped first, then rebuilt. Manual links come back only if the price list has the “Search for manually matched products” matching rule enabled. Continue?”
Manually confirmed pairs come back from the list, but not on their own. The restore lives inside the “Search for manually matched products” type. If this type isn't in the price list's list or is disabled, nothing is restored, and you'll have to match the price list all over again.
Before you click “Start product matching”, look at this price list's list of types. It must include “Search for manually matched products”. If it doesn't, first add it with the “Add matching type” button, and only then start.
- Action or result
- Decision: the path depends on the answer
You can follow the run in the work log, just like during a regular import: a “Matching type: …” line for each applied type and the number found after it. You can't stop a run for one price list — the button works to the end, with no progress and no “Stop”.
A restart doesn't change prices in the catalog: it only sets links, while prices and stock are carried over by base catalog update.
Before matching, the button also re-determines the condition of rows by the price list's current rules, without re-importing the file. Changed “Product condition” in the source settings? Click “Start product matching”, and the new rules affect pairs right away: a row is linked only to a card in the same condition.
How to keep good automatic pairs
Next to the restart button is its opposite — “Save automatically found products as manually matched”. It doesn't go through anything: it takes the links the price list already has and adds them to the list of manual pairs.
It has exactly one purpose — to keep a good match before the next restart wipes it. Pairs already in the list aren't added again. The button has its own, calmer confirmation:
“All automatically found links of this price list will be stored in the directory as manual ones. Continue?”
From the “Matching types” window, it works across all price lists at once, and the confirmation text warns you about that. A wrong automatic pair saved with this button also becomes permanent — review the pairs before you click.
How to restart matching for all price lists
The same button is in the “Matching types” window, in the additional operations menu. From there it runs across all price lists of all active contacts: first it removes the links, then rebuilds them — in each price list. The confirmation says so directly:
“The window is open without a selected price list: links will be rebuilt for EVERY active price list of every active supplier. All existing links are dropped first. The operation is long and cannot be undone. Continue?”
You can interrupt such a run:
- the “Stop import” item in the “Menu” of the “List of price lists” left panel, “Import sources” submenu, stops the run at the boundary between price lists;
- a price list that has already started is finished to the end;
- clicking “Stop import” in advance is pointless: each new start resets earlier stops.
What happens if a restart breaks off
Links are removed in one step at the very start — from all price list rows at once. Then the types run one by one, each pairing only rows that still have no pair. There is no rollback: what was found before the break stays, and rows the queue didn't reach stay unpaired.
The “To match” counter and the price list's product grid data are recalculated only after the last type has run. If the run didn't finish, the counter shows the same number as before you clicked the button, even though there are actually fewer links already.
Starting again does the same thing from scratch. A restart doesn't change the list of manual pairs, either during the run or on a break. So manual pairs come back on the next start if the price list's list includes the “Search for manually matched products” type; if it doesn't, add it and start again.
If you stopped a run across all price lists, the price lists the queue didn't reach keep their links: a price list's links are removed only when the queue gets to it. Price lists that went through matching already show the new links in the product grid.
Until the links are rebuilt, don't run “Updating base catalog” for all price lists. The update treats a product with no pair in any price list as gone from offers and gives it an out-of-stock status, if stock update is enabled in its settings.
How long a restart takes and whether you can close the window
A restart doesn't go to the background task queue. It runs as one request while you wait: the button is disabled, and “Processing data, please wait” shows at the bottom. When the run ends, “Operation completed successfully” appears, and the price list's product grid, if open, refreshes itself. On an error — “Operation failed!” with the error text.
There's no limit on the number of price list rows in a restart, and the program sets no separate time limit. If you close the “Product matching settings” window, the run isn't canceled: the program doesn't interrupt the request when the window closes.
Scenarios
Change the rules and check them without losing good pairs
What to do. In the “Product matching settings” window, click “Save automatically found products as manually matched”. Make sure the list of types includes “Search for manually matched products”. Then change the rule and click “Start product matching”.
What you get. All links of the price list are removed, the types run one by one, and “Search for manually matched products” brings back both manually confirmed pairs and the automatic ones you just saved. The work log gets a line for each type, and the price list counters are recalculated.
What won't happen. Rows that got their pair back from “Search for manually matched products” are no longer taken by later types. If this type is above the changed rule in the list, the rule is checked only on rows without a saved pair. Wrong pairs saved with the button will come back on every restart.
Manual pairs disappeared after a restart
What to do. Open the price list's list of types, add “Search for manually matched products” with the “Add matching type” button or enable it, drag it to the top of the list, and start matching again.
What you get. Manual pairs come back from the list: the restart didn't delete them, it only removed the links from the price list rows.
What won't happen. Pairs that never got into the list — found by rules and not saved — come back only if a rule finds them again.
You changed the default types for all suppliers
What to do. Open “Directories” → “Processing price lists” → “Matching types”, choose “Start product matching” in the additional operations menu, and confirm the warning about all price lists.
What you get. Links are rebuilt in each active price list of active suppliers, one by one. You can stop the run between price lists with the “Stop import” item.
What won't happen. A price list the run has already started on is finished to the end. Prices in the catalog won't change until the catalog update runs.
FAQ
Will manual matches come back after a restart?
Only if the price list's list of types includes an enabled “Search for manually matched products”. If it doesn't, the pairs stay in the list: add the type and start matching again (starting again).
Can I stop a restart of one price list?
No, a run for one price list works to the end, with no progress and no “Stop”. You can only stop a run across all price lists — between price lists (all price lists).
The “To match” counter didn't change after a restart. Why?
The counter is recalculated only when the last type has run. If the run broke off, the number stays old, even though there are fewer links already (restart breaking off).
Does a restart change the matched products list?
No: entries in the list are neither added nor deleted, either during the run or on a break. Only the “Save automatically found products as manually matched” button adds to the list.
A wrong pair comes back after every restart. Why?
Most likely it was saved to the list, and now “Search for manually matched products” brings it back. Break the pair in the matched products list; if it's automatic, narrow the rule that finds it.
Where to find it and who has access
- One price list
- “List of price lists” → source → “More” → “Processing rules” → “Product matching settings”
- All price lists
- Directories → Processing price lists → Matching types → additional operations menu
- Other entry points
- the magic wand button in the matched products list
- Access right
- the “Product matching types” window; for all price lists — “Matching types”
- Prepare
- the “Search for manually matched products” type enabled in the price list's list of types
Related topics
- If you need the overall picture of which types work and in what order — How to set up automatic product matching during price list import.
- If you first need to build or change a rule — How to build a custom product matching rule.
- If you need to remove a single pair after a restart — Matched products list.
- If the links are rebuilt but catalog prices are still old — Base catalog update.
