Category and attribute mapping

Every marketplace listing needs a marketplace category and the parameters that category asks for, such as condition, brand or colour. The Attribute mapping page keeps two kinds of settings that save you from entering them by hand for each listing:

• Category mappings remember which marketplace category a catalog category goes to. You pick them in the listing wizard.
• Attribute mapping rules fill a marketplace parameter from a fixed value or from a field of the product.

Open Marketplace > Attribute mapping. You need the Manage listings permission; without it the menu item is hidden and the page says “You do not have permission to view this page.”

​

Choose what you are working on

The two controls at the top of the page decide what the page lists, and what a new mapping or rule applies to:

• The account list: All accounts (tenant-wide), or one marketplace account.
• The Filter by marketplace category id… box: empty, or one marketplace category ID. It applies when you leave the box. It affects only the rules.

Set them before you click Add mapping or Add rule: a new category mapping is saved for the selected account, or for all accounts; a new rule is saved for the selected account and the category ID typed in the box, or for any account and any category when they are empty. You cannot change this scope later; delete the mapping or rule and add it again.

​

Category mappings

A category mapping links one catalog category to one marketplace category. The list shows each mapping’s display name and its Marketplace category id, but not the catalog category or the account. With All accounts (tenant-wide) selected, it shows every mapping; pick an account to see only that account’s mappings.

​

Save a mapping from the listing wizard

The simplest way to add a mapping is from the listing wizard, where Omnilinker fills in the marketplace category ID for you. The option appears only when one listing in the wizard is unmatched, its product has a catalog category, and that mapping is not saved yet. The mapping is saved for the listing’s account.

​

Add a mapping on this page

Each catalog category can have one mapping for all accounts, and one per account. A second mapping for all accounts is refused: “A tenant-wide category mapping already exists for this catalog category.” A second mapping for the same account and catalog category is refused too, but with a general error that doesn’t say why. To change a mapping that exists, edit it instead. Omnilinker does not show marketplace category IDs. Saving the mapping from the wizard avoids looking them up. To change a mapping, click the pencil, change Marketplace category id or Display name, and click Save. The catalog category cannot be changed. To delete one, click the bin and confirm “Delete this category mapping?”.

​

How category mappings are used

In the wizard’s Category step, a listing without a product match shows Saved mappings: every mapping saved for the listing’s account, by display name, whatever catalog category it was saved for. Omnilinker does not pick the one for the product’s catalog category; you click the one you want, and the listing gets that category. Mappings are not applied anywhere else. New listings and the worksheet do not pick a category from them. Mappings saved for all accounts are not offered in the wizard either, so at the moment nothing uses them. On Allegro, a listing matched to an Allegro product takes the category from the match instead.

​

Attribute mapping rules

A rule fills one marketplace parameter. Rules for the same parameter form a fallback chain: Omnilinker tries them from the top and uses the first rule that gives a value.

​

Add a rule

​

Rule types

Source field takes one of these product fields. Capitals do not matter. Any other field name gives no value. Value translation table (optional) turns product values into marketplace values. Click Add row and fill in From (the product’s value) and To (the marketplace’s value). With a table, a value is used only when it matches a From exactly, capitals included; a value with no row gives nothing, and the next rule in the chain is tried. Without a table, the product’s value is used as it is. Multi-value separator splits the value into several values for a parameter that accepts more than one. The default is |, and it can be up to 8 characters.

​

The list of rules

Rules are grouped into chains, each headed by its parameter ID. A chain holds the rules for one parameter at one scope, so the same parameter ID can head more than one chain, for example one for all accounts and one for an account. Each rule shows its type and its value or source field.

• The arrows move a rule up or down its chain.
• The pencil opens Edit mapping rule. Everything but Target parameter id can be changed.
• The bin deletes the rule after you confirm “Delete this mapping rule?”.

The list shows the rules that apply to what the controls select. With All accounts (tenant-wide) and an empty category box, you see only rules for all accounts and every category. Pick an account to see its rules together with the all-accounts rules; type a category ID to see that category’s rules together with the every-category rules.

​

Which rules apply to a listing

A listing uses every rule whose account is the listing’s account or all accounts, and whose category is the listing’s category or every category. When the listing picks up rules from more than one chain for the same parameter, for example an all-accounts rule and an account rule, Omnilinker does not guarantee which chain it tries first. Keep one chain per parameter where you can.

​

When rules fill in values

Rules fill parameters at two moments:

• New listings: when a listing is matched to an Allegro product, Omnilinker fills its parameters from the rules.
• The wizard’s Parameters step: when a listing has no parameter values yet, the step fills them from the rules.

Rules never overwrite values already saved on a listing. They do not run in the worksheet’s Param panel, at publish, or when prices and stock sync. A rule you add or change later does not reach listings that already have values: open such a listing in the wizard, or enter the value in the worksheet. When no rule gives a value for the condition parameter, the account’s default condition fills it, where the category offers that value. A required parameter left without a value shows “Required — this will block publishing.” The worksheet does not publish the listing until it has one.

​

Troubleshooting

​

Permissions