Connect OLX

An OLX account in Omnilinker is a link to one OLX account on olx.pl. You add it on Marketplace > Marketplace accounts, then sign in to OLX and allow Omnilinker to read and publish adverts for you. Omnilinker never asks for your OLX password, and it renews the access OLX grants by itself. Once the account is connected and its advert details are set, you can publish catalog products as OLX adverts, bring in the adverts you already have, and keep their prices and availability in sync. OLX works differently from Allegro in a few ways that matter here:

• There is no test environment. Every OLX account is a real one: what you publish appears on olx.pl, and paid features are charged.
• OLX orders stay in OLX. Omnilinker does not import OLX orders, Pay & Ship orders included, and order synchronization cannot be switched on.
• Every advert needs contact and location details. You set them once for the account in its listing defaults; publishing fails without them. See Set the OLX advert details.
• Only Pay & Ship adverts have a stock quantity. With stock sync on, Omnilinker keeps the quantity of an advert sold with OLX Pay & Ship in step with your stock (OLX takes at most 1,000). It sends the quantity when your stock next changes, so an advert whose quantity you set by hand in OLX, or that gets Pay & Ship later, keeps its own quantity until then. Any other advert is either available or not: Omnilinker deactivates it when its product has no stock left and activates it again when stock is back. A Pay & Ship advert at 0 is deactivated too, unless you choose to keep it visible; see Set the OLX advert details. A stock buffer counts the same way: if the buffer is equal to or higher than the available stock, the quantity to send is 0.

​

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 OLX account on olx.pl, and the sign-in for it.

​

Add and connect the account

To confirm that Omnilinker can reach OLX, click Test in the account’s row. Omnilinker says “Connected to OLX as” followed by the name OLX gives for the account, or “this account” when OLX gives none. If the test fails, the message starts with “OLX connection test failed:” and gives the reason, for example an HTTP status.

​

Set the OLX advert details

OLX requires an advertiser type, contact details and a location on every advert, and Omnilinker takes them from the account. Set them before you publish anything.

​

Other listing defaults

The rest of the dialog holds the settings new OLX listings start from. A listing that leaves a field empty uses the account’s default when it is published. The shipping, after-sales, handling-time, condition and additional-marketplace fields that Allegro accounts have do not appear for OLX.

​

The accounts page

An OLX account’s row shows the same columns as any other account: Account, Environment (always Production), Connection, Credentials and Actions. The connection states are explained in Connect Allegro. Besides Test, Listing defaults, Edit and Delete, an OLX row has:

• Sync prices and stock now (the cloud icon), with the Manage listings permission: sends changed prices and availability to OLX straight away instead of waiting for the scheduled sync. The messages it shows are listed in Connect Allegro.
• Prepaid publication packets on this account (the box icon), with the Listings permission: opens the account’s packets; see below.

​

Permissions granted

Under the account’s name, a connected account lists Permissions granted: the permissions OLX gave Omnilinker when you signed in, as OLX words them (for example v2, read and write), one tag each, and the Seller id of the OLX account when Omnilinker knows it. If the row says “Not known yet”, the account was connected before Omnilinker started recording its permissions (or OLX 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 OLX states them. The Seller id does not: it is recorded only when you click Test or sign in to OLX for the account. Click Test once on each account connected earlier. Until the Seller id shows, Omnilinker cannot tell which OLX account this one belongs to, so a Reconnect while signed in to a different OLX account is accepted and ties the account to that one. Once the Seller id is recorded, the account stays tied to that OLX account. If you Reconnect while signed in to a different OLX account, Omnilinker refuses it with “This is a different OLX account than the one connected here. Add it as a new connection.”, and the account keeps its current sign-in. If OLX 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 OLX account, the test fails and says so.

​

Publication packets

A packet is a set of prepaid advert slots bought on OLX. Click the box icon to open Publication packets under the account’s row: “Prepaid advert slots bought on OLX. Read-only — packets are bought in OLX itself.” The panel reads OLX each time you open it. If OLX does not answer, it says “Packets could not be loaded from the marketplace. Please try again.” Using a packet slot for a particular advert is done from the listing; see Create listings.

​

Reconnect an account

Omnilinker renews the OLX sign-in by itself once a day, and each renewal keeps it valid for another 30 days. You only sign in again when OLX refuses the renewal, or when no renewal succeeds for 30 days. When an account needs you, its row shows Reconnect required or Refresh failed with a Reconnect button, and the Marketplaces card on Home lists it under Accounts to sign in to again. When the daily check finds that the account must be reconnected, the person who added it gets the notification “Marketplace account needs to be reconnected”; if that person is not known, users with the admin role get it. While an account shows Reconnect required, Omnilinker cannot reach OLX for it and sends no prices or availability. Click Reconnect, sign in to OLX as the same account, and allow access again. Your listings and defaults stay as they are. Omnilinker refuses a different OLX account; see Permissions granted.

​

Edit or delete an account

Click Edit to rename the account or set its Stock buffer, the pieces held back from every advert of the account (see Stock buffer). Order synchronization stays greyed out for OLX: “Omnilinker does not import orders from OLX — order synchronization is not available for this marketplace.” To delete the account, click Delete (the bin), tick I understand the consequences in the Delete marketplace account? dialog, and click Delete account. “Deleting this account removes its stored credentials and OAuth tokens. It does not affect listings or orders already synced to Ordering.” Your adverts on OLX stay as they are. 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