Create listings

A listing is one catalog product offered on one marketplace account. Every listing starts as a draft in Omnilinker. Nothing reaches the marketplace until you publish it. There are two places to work on drafts:

• The worksheet handles a batch. New listings creates drafts for the products you pick, tries to match them to the marketplace’s own products, and opens the worksheet, where you complete and publish them row by row.
• The wizard edits one listing step by step: product match, category, parameters, content, and terms. Use it when a listing needs more attention than a worksheet row gives.

Once a listing is published, you manage it on the Marketplace listings page; see Manage listings.

​

Before you start

• Connect a marketplace account; see Connect Allegro or Connect OLX. On the account, set its Listing defaults (the template, price and stock rule, and for Allegro the shipping rate, after-sales terms and GPSR parties). Every new draft starts from them. An OLX account also needs its advert defaults (advertiser type, contact and location) before anything can be published.
• Give each product a price at the price level you list from; see Price levels. A listing whose product has no price there is rejected.
• Keep stock in Inventory. The quantity a listing offers comes from the product’s available stock.
• You need the permissions in Permissions. If the Marketplaces module is off for your organization, the Marketplace menu is hidden and the pages say “The Marketplaces module is disabled for this tenant.”

​

Create listings in a batch

A product that already has a listing in progress or live on this account gets no new draft: “N product(s) were skipped (an active listing already exists for them on this account).” A product that already has a draft on the account keeps that draft; Omnilinker does not create a second one.

​

Listing creation modes

Always create a new product proposal is shown as coming soon and cannot be chosen. The search looks for the product’s GTIN first, then its name. When a match is applied, the listing takes Allegro’s category for that product, and Omnilinker fills the listing’s parameters from your attribute mapping rules and the account’s default condition. Automatic matching handles up to 100 listings at a time. With more products selected, the drafts are still created, but the dialog warns “The draft listings were created, but the automatic matching pass failed. You can still match them manually in the worksheet.”

​

What a new draft starts with

Because the price level is not copied, changing the account’s default price level later changes every listing that has no price level of its own.

​

Complete and publish in the worksheet

The worksheet, titled Listing (account name), shows the account’s listings that you can still edit: drafts, and listings that were rejected or failed. One row is one listing. To come back to it later, open Marketplace listings: each account with unfinished work has a Resume worksheet: account (N) link above the list.

​

A worksheet row

A row that is not a draft shows its state, for example Rejected.

​

Match a row to an Allegro product

Click Match (or Change) on the row. Search by name and click Search; click a candidate to match it. The listing takes that product’s category. Clear match removes the match. Without a match, you can tick Create a new product in the Allegro catalog: a new product proposal is submitted with the offer. Then fill in every parameter marked required for product, including the GTIN if it applies, and give the listing a title of at least 12 characters and 3 words.

​

Parameters

Param lists the category’s parameters. A required parameter has a red asterisk. Choose a value from the list, tick several where the parameter allows it, or type the value. “Required — this will block publishing.” marks a required parameter that has no value. For a matched listing, the parameters that describe the product come from the match. They appear under Product parameters (from the match) and cannot be edited: “Wrong variant? Pick a different product in the “Match” panel.”

​

Details

Details holds the same settings as the wizard’s Content and Terms steps (see Edit a listing in the wizard): Description, Template, Price, Stock, Sync and, for Allegro, Shipping rate, Return policy, Warranty, Implied warranty, GPSR responsible producer and GPSR responsible person. A seller term left empty shows “The account default will be used: …”.

​

Change many rows at once

Tick the rows, then click Apply to selected. Fill in only what you want to change: Template, Shipping rate, and, after ticking them, Price (a formula or a fixed price) and Stock. Click Apply. The rows change on screen; save them to keep the change.

​

Save and publish

Changes stay on screen until you save. Click the save icon on a row, or Save all in the toolbar. To publish, tick the rows and click Publish listings at the bottom. Omnilinker saves every unsaved row first, then queues the selected rows that have no errors. “Progress: N/M” follows the publish for up to five minutes, while the rows move to Active, Rejected or Error. Tick Show only rows with errors to see what still needs work. A row is held back from publishing when it has: The marketplace still checks the listing when it receives it. When the marketplace rejects a listing, its row shows “This listing was rejected by the marketplace:” with the marketplace’s reasons. “This listing was rejected before submission:” means Omnilinker stopped it before sending, for example because the product has no price. Fix the row and publish it again. Dismiss hides the banner. If some of the account’s listings are still being published, the worksheet says “N listing(s) from this account are currently being published.”

​

Edit a listing in the wizard

Open the wizard from Marketplace listings with the pencil (Edit) on a draft, rejected or failed listing, or from a worksheet row with ⋮ > Edit in the wizard. The page is titled Edit listing. The steps are listed across the top: Products, Productization, Category, Parameters, Content, Terms and Review. Click a step to jump to it. Next saves the listing and moves on; Back goes back. Cancel returns to the listings without saving the step you are on.

​

1. Products

Shows the account and the product. They cannot be changed in the wizard: “Products are locked once drafts are created for this run. Delete the drafts and start over to change the selection.”

​

2. Productization

For Allegro, Match a catalog product searches Allegro’s catalog for the product by its GTIN and name as soon as the step opens. Each candidate shows its name, status, category and main parameters. Click one to match it (“Matched: …”), or search again by name with Search. Clear match removes the match. Without a match, the listing is published without one, or you tick Create a new product in the Allegro catalog to propose a new product. “The marketplace may still refine or replace the match automatically when you publish.” For OLX, the step says “This marketplace does not use product matching.”

​

3. Category

A matched listing takes its category from the match: Category inherited from the matched product. For a listing without a match, choose the category yourself:

• Under Saved mappings, click one of the category mappings saved for this account. The list shows all of the account’s mappings, whatever catalog category they were saved for.
• Under Browse categories, click through the marketplace’s tree, starting at Categories, and click a final category.

The selected category appears as Selected category. To reuse it for other products of the same catalog category, tick Remember this mapping for this catalog category and click Save mapping. This needs the Manage listings permission; see Category and attribute mapping. Next stays disabled until the listing has a category. Changing the category clears the parameter values entered for the old one.

​

4. Parameters

Category parameters lists the category’s parameters, filled in from your attribute mapping rules and the account’s default condition when the listing has no values yet. Required parameters carry a red asterisk; required for product marks those a new-product proposal needs. Units appear in brackets. Values you enter or change here are kept; the rules do not overwrite them. For a matched listing, Product parameters (from the match) shows the parameters Allegro already knows about the product.

​

5. Content

• Title: empty means the product name. The counter shows the length against the marketplace’s limit: 75 characters on Allegro, 16 to 150 on OLX.
• Description: used only when the template gives no description. On OLX it must then be at least 80 characters.
• Template: the description template. No template clears the listing’s own choice, but a template marked Use as default template for the account, or for all accounts, still applies at publish. See Listing templates.
• Preview: the template rendered for this product.
• Images: “Product images are attached automatically at publish time.”

​

6. Terms

• Price: Formula (multiplier + adjustment) with Multiplier, Adjustment and Price level, or Fixed price. Lines under the field show the price a publish would send. See Price.
• Stock: Max quantity and Never exceed available stock. See Stock.
• Sync: Sync price automatically and Sync stock automatically. See Sync.
• For Allegro: Shipping rate, Return policy, Warranty, Implied warranty, GPSR responsible producer and GPSR responsible person (“Only required when the product is manufactured outside the EU.”). The lists show what is set up on your Allegro account; + next to a list creates a new entry on Allegro without leaving the wizard. Creating an entry needs the Manage listings permission.

​

7. Review

Review and publish sums up the account, product, category, title, price rule, the price and quantity a publish would send, the shipping rate and the GPSR producer. “N required parameter(s) are still unresolved — publishing may be rejected by the marketplace.” warns about missing parameters but does not stop you.

• Save as draft saves the listing and returns to the listings.
• Publish saves the listing and queues it: “Listing(s) queued for publishing.” It is disabled while the title or description is outside the marketplace’s limits: “Fix the title/description length issue(s) on the Content step before queueing.”

​

Price, stock and sync

​

Price

With Formula (multiplier + adjustment), the listing’s price is: gross price at the price level × Multiplier + Adjustment rounded to two decimal places. The price level is the one chosen in Price level. Default (account level: …) means the account’s default price level; Default (RRP) means the recommended retail price level, used when the account has no default. Hints under the field show how many of the products have a price at that level, warn when none has, warn when the level’s currency differs from the listing’s (the amount is sent as it is, without conversion), and name the repricer rule that sets prices at the level, if any. With Fixed price, the listing uses the amount you enter. A fixed price of 0 is allowed. A listing is rejected when its product has no price at the level, or when the formula gives a price of 0 or less. Listings are priced in PLN.

​

Stock

The available quantity is the product’s available stock in Inventory, counted in active warehouses only. Stock in a warehouse you have deactivated is not offered on marketplaces. Orders already reserved from such a warehouse beyond what it holds still lower the quantity offered, so a shortfall there is never ignored. A quantity is never below 0. If Omnilinker cannot read stock levels, it counts the available quantity as 0.

​

Stock buffer

Before the rules above apply, Omnilinker holds back the stock buffer: the listing is offered its available quantity minus the buffer, never below 0. The buffer is the listing’s own, set with Stock buffer in its row on the listings page (see Manage listings), or, when the listing has none, the account’s default, set with Edit on the account (Stock buffer, 0 unless you change it). A change to either reaches the listing at its next sync. A listing that ignores availability is not affected. The stock line in the wizard and the worksheet shows the buffer: the worksheet row says “will send: 7 pcs. (available: 10, buffer: 3)”, and the wizard adds the line “Stock buffer: 3 pcs. held back” under its stock line. On OLX only Pay & Ship adverts have a stock quantity; any other advert is available or not: “Automatic stock sync: a listing that has a stock quantity on this marketplace gets it; any other is activated or deactivated by stock level.” See Connect OLX for what a Pay & Ship advert gets at 0.

​

Sync

With Sync price automatically or Sync stock automatically on, Omnilinker keeps an active listing’s price or quantity in step with the catalog and stock. Every 10 minutes it checks a batch of up to 200 listings per account, the ones checked longest ago first, and sends only what changed. See Manage listings.

​

What happens after you publish

A published listing moves through these states: When it publishes, Omnilinker renders the template, uploads the images to the marketplace, and sends the price and quantity worked out at that moment. A listing that stays in Publishing for more than 10 minutes is checked again automatically.

​

Troubleshooting

​

Permissions

The permissions are in the Marketplaces group. Listings is enough to see the accounts in the account lists; you do not need Marketplace accounts for that.