Connect Allegro

An Allegro account in Omnilinker is a link to one Allegro seller account. You add it on Marketplace > Marketplace accounts, then sign in to Allegro and allow Omnilinker to act for you. Omnilinker never asks for your Allegro password: Allegro hands Omnilinker an access grant, and Omnilinker renews it by itself. Once the account is connected you can publish catalog products as Allegro offers, bring in the offers you already have, keep their prices and stock in sync, and, if you switch it on, import Allegro orders into Sales > Orders.

​

Before you start

• Permissions. To see the page you need Marketplace accounts, under Marketplaces. To add, edit, connect, test or delete accounts, and to edit their listing defaults, you also need Manage marketplace accounts. Without it you see the accounts read-only: Add account is hidden and the row buttons are greyed out.
• The Marketplaces module. It is on for every organization unless Omnilinker has switched it off. When it is off, the Marketplace menu is gone and the page says “The Marketplaces module is disabled for this tenant.” See Modules and feature availability.
• An Allegro seller account, and the sign-in for it. You sign in on Allegro’s own page during the connection.

​

Add and connect the account

To confirm that Omnilinker can reach Allegro, click Test in the account’s row. Omnilinker asks Allegro who the connected seller is and says “Connected to Allegro as” followed by your Allegro login. If the test fails, the message starts with “Allegro connection test failed:” and gives Allegro’s reason. You can connect more than one Allegro account. Each one is a separate row with its own name, connection and settings.

​

Production and sandbox

A new account starts on Production. You can change the environment later in Edit, but the change does not reset the connection: the stored sign-in still belongs to the old environment, so click Connect with Allegro again after the change. Keeping a separate account for each environment is simpler.

​

The accounts page

Each account is one row: The Connection column shows one of four states:

​

Permissions granted

Under the account’s name, a connected account lists Permissions granted: the permissions Allegro gave Omnilinker when you signed in, one tag each, and the Seller id of the Allegro account when Omnilinker knows it. If the row says “Not known yet”, the account was connected before Omnilinker started recording its permissions (or Allegro did not state them). Nothing is wrong with it and nothing stops working. The permissions may fill in by themselves the next time Omnilinker renews the account’s sign-in (once a day), if Allegro states them. The Seller id does not: it is recorded only when you click Test or sign in to Allegro for the account. Click Test once on each account connected earlier. Until the Seller id shows, Omnilinker cannot tell which seller the account belongs to, so a Reconnect while signed in to a different Allegro account is accepted and ties the account to that seller. Once the Seller id is recorded, the account stays tied to that Allegro seller. If you Reconnect while signed in to a different Allegro account, Omnilinker refuses it with “This is a different Allegro account than the one connected here. Add it as a new connection.”, and the account keeps its current sign-in. If Allegro cannot confirm who signed in (for example because it did not answer), Omnilinker also keeps the current sign-in and shows “The connection could not be completed. Please try again.”; try Reconnect again. Test does the same check as the reconnect once the seller is recorded: if the sign-in now belongs to another seller, the test fails and says so.

​

Import Allegro orders

Omnilinker can take your Allegro orders into Sales > Orders and send their progress back to Allegro. It is off until you switch it on, and you can switch it on only for a saved account. Omnilinker then checks Allegro for new orders every two minutes. The first check starts from that moment: Allegro orders placed before you first switched order synchronization on are not imported. Each order’s lines are linked to catalog products through the account’s listings, including offers you brought in with Import existing offers, or by an exact SKU match; a line that matches neither keeps no product. Working with the imported orders is covered in Orders. While order synchronization is on, the dialog shows two more settings, described below. Both act on future changes only.

​

Status mapping

When an order’s status changes in Omnilinker, Omnilinker sends Allegro the matching fulfillment status. Which one depends on the type of the order’s new status; see Order statuses, sources and extra fields. Status mapping lets you change it per type. Each row offers its default, New, Processing, Sent, Cancelled and Skip — don’t push. A change “takes effect on the NEXT status change — it is not applied retroactively.” Tracking numbers of the order’s shipments are sent back to Allegro as well.

​

Auto-cancel on buyer cancellation

When a buyer cancels an order on Allegro, Omnilinker always sends you a notification: “A marketplace order was cancelled”. With Auto-cancel on buyer cancellation on, Omnilinker also asks for the linked order to be cancelled in Omnilinker. Without it, you cancel the order yourself. Auto-cancel does not cancel an order that is already in a Sent-, Delivered- or Return-type status. You get the notification “A buyer cancelled an already-shipped order” instead, and handle the refund or return yourself. See Change the status.

​

Listing defaults

Listing defaults are the settings new listings on this account start from, so that you set them once instead of on every listing:

• The template, the price Multiplier and Adjustment, the stock rule and the sync flags are copied into each new draft. Changing them later does not change listings that already exist.
• The shipping rate, handling time, condition, after-sales terms and GPSR contacts are also used when a listing that leaves one of them empty is published.
• A listing that does not set its own price level uses the account’s Price level each time it is priced, so a change here reaches those listings.

A listing with no template does not fall back to the Template set here. It uses the template marked Use as default template; see Which template a listing uses. Click Listing defaults (the sliders icon) in the account’s row, change what you need, and click Save. Omnilinker says “Listing defaults saved.” The shipping rate, after-sales and GPSR lists come from Allegro, so they are greyed out until the account is connected: “This account is not connected yet — shipping rate, after-sales and GPSR pickers will be available once it is connected. You can still set the template, price/stock rule, handling time and sync flags now.”

​

Additional marketplaces

An Allegro offer can also be shown on Allegro’s marketplaces in other countries. Under Additional marketplaces each of those marketplaces is listed with its currency. For each one, choose:

• Not managed — Allegro’s own conversion applies where no price has been pushed: Omnilinker leaves the price there alone.
• A price level: the sync sends that level’s price to that marketplace for every listing on the account that does not set its own.

If the level prices in another currency than the marketplace, Omnilinker warns you, and the sync skips that marketplace. For each offer, the sync also skips the marketplace the offer was created on: there, the price is the offer’s own price. If the list cannot be read, the section says “The list of marketplaces could not be read from Allegro, so bindings cannot be edited right now.” The other defaults still save.

​

Send prices and stock now

Omnilinker sends changed prices and stock to Allegro on a schedule, every 10 minutes. To send them for one account straight away, click Sync prices and stock now (the cloud icon) in its row. The button appears only if you have the Manage listings permission. Omnilinker answers with one of these messages:

• “Sync queued — prices and stock will be sent shortly.”
• “The same sync was requested a moment ago. You can request it again in” followed by the seconds to wait.
• “This account is already being synced right now, so nothing new was queued.”
• “Nothing can be synced:” followed by the reason, for example “the account is not connected — reconnect it first.”

​

Reconnect an account

Omnilinker renews the Allegro sign-in by itself, once a day, before it runs out. You only sign in again when Allegro refuses the renewal. Allegro can withdraw access, for example when the app’s access is removed on Allegro, when you change your Allegro password, or when you sign out of all devices. When an account needs you:

• Its row shows Reconnect required or Refresh failed, with a Reconnect button.
• The Marketplaces card on Home lists it under Accounts to sign in to again.
• When the daily renewal finds that it must be reconnected, the person who added the account gets a notification: “Marketplace account needs to be reconnected”. If that person is not known, users with the admin role get it. See Notification inbox.

While an account shows Reconnect required, Omnilinker cannot reach Allegro for it: it sends no prices or stock and imports no orders. An account in Refresh failed recovers by itself once a renewal succeeds. To reconnect, click Reconnect in the account’s row, sign in to Allegro as the same seller account, and allow access again. Your listings, defaults and settings stay as they are. Omnilinker refuses a different seller account; see Permissions granted.

​

Edit or delete an account

Click Edit to rename the account, change its environment, change its order settings or set its Stock buffer, the pieces held back from every listing of the account (see Stock buffer). The marketplace cannot be changed: add a new account instead. To delete an account: Deleting the account does not change your offers on Allegro, and it does not withdraw the access you allowed on Allegro’s side. The account’s listings stay on Marketplace > Marketplace listings under All accounts, with — in the Account column. The deleted account is no longer in the account list, and Omnilinker no longer checks or updates those listings.

​

Troubleshooting

​

Next steps