Quick checks
Common problems
Where are the logs?
Where are the logs?
C:\ProgramData\Omnilinker\ErpSync\logs. Everyone signed in to the computer can read it. To
follow today’s file:setup.log in the same folder.
See Setup finished, but there is no service.The agent does not write its own messages to the Windows event log. Windows records service start failures in
the System log (see the next entry).The service does not start
The service does not start
Get-Service OmnilinkerErpSyncService shows Stopped, or the service stops shortly after it starts. The tray
icon shows a red square, and its tooltip says The ERP Sync service isn’t running.The service is set to restart itself after a failure (after 5, 10 and 30 seconds), so a service that keeps
stopping has a problem that a restart does not fix.- Open Event Viewer > Windows Logs > System and look for errors from the source Service Control
Manager that name Omnilinker ERP Sync (Omnilinker ERP Sync Service on an installation made with
install-service.ps1). For a crash, also check Windows Logs > Application for .NET Runtime or Application Error entries. - Open the newest service log file (see Where are the logs?). If the service started far enough to log, the
last lines say why it stopped. A fatal start-up error ends with
Omnilinker ERP Sync Service terminated unexpectedly.
- Logon failure. Someone changed the service to run under another account, and its password changed. The System log says the service did not start due to a logon failure. Open Services, open Omnilinker ERP Sync > Log On, select Local System account and click OK. The agent is designed to run as Local System.
-
The data folder cannot be written. The log says ERP Sync cannot write its data folder. The service must be
able to write
%ProgramData%\Omnilinker\ErpSync; check that nobody changed the folder’s permissions, or run Repair from the tray app’s Troubleshoot…. -
Broken
appsettings.json. If you edited it, check that it is still valid JSON. From the install folder:An error means the file is not valid. Fix it or restore it from the original package.
Setup finished, but there is no service
Setup finished, but there is no service
Get-Service OmnilinkerErpSyncService finds no service, or the tray app does not start at
sign-in. Setup never fails because of one step; it writes what it could not do to
%ProgramData%\Omnilinker\ErpSync\logs\setup.log:setup.log at all, setup could not even create the folder. Run it again as an administrator.The tray app cannot reach the service
The tray app cannot reach the service
-
Open Troubleshoot… in the tray app. When the service does not answer, it looks at the Windows service
itself and offers the fix that fits, with an administrator’s approval:
- Restart service, when the service is stopped, or running but not answering.
- Repair, when the Windows service is missing or runs another copy of the agent. It sets the service up again for this installation and keeps the connection and its settings.
- If the tray app shows “Something other than the ERP Sync service answered. Restart the PC; if it happens again, contact support.”, another program answered on the agent’s pipe. The tray app talks only to the Windows service. Restart the computer.
- If it says “This app and the ERP Sync service don’t match (one of them was updated).”, right-click the icon, choose Exit ERP Sync (Hide the tray icon on an agent not yet updated), then start ERP Sync again from the Start menu.
The tray app says Only an operator of this PC can do this
The tray app says Only an operator of this PC can do this
The PC and connector tab says Offline
The PC and connector tab says Offline
- Is the service running? See The service does not start.
- Can the agent reach Omnilinker? See The agent cannot reach omnilinker.pl.
- Is the connection switched on? On ERP Integration > Connected systems, the connection’s status must not be Switched off. Omnilinker accepts nothing from the agent of a switched-off connection. To switch it on, click Switch on in the row’s menu.
- Does Omnilinker still accept the agent’s key? See Omnilinker doesn’t accept this PC.
Omnilinker doesn't accept this PC
Omnilinker doesn't accept this PC
Status: Unauthorized.The agent’s key no longer works. Most often another computer was connected to the connection with a code, or this
computer was connected again elsewhere: connecting a computer replaces the connection’s agent key straight away. The
connection may also have been deleted.Connect this computer again:- In Omnilinker, open the connection and get a connection code with Connect a PC. See Get a connection code.
- On the agent computer, click Connect again in the tray app’s panel (or Settings… > Connect to another company…) and complete setup with the code.
Omnilinker requires a newer agent
Omnilinker requires a newer agent
- In Omnilinker, the connection’s PC and connector tab shows the PC online, and a banner says ERP Sync on the PC needs an update, with your version and the one Omnilinker requires. On Home, the ERP card counts the connection under ERP writes held: the agent needs an update and names it.
- In the tray app, the panel says Nothing is written to the ERP until ERP Sync updates., and Windows shows a notification that says the same.
- The ERP’s lists (price levels, warehouses, products) and prices are not read. A Refresh lists you start in Omnilinker waits for the update, but Omnilinker offers it to the agent for one hour only. If the update comes later than that, click Refresh lists again afterwards.
- In the agent’s log, a warning:
Omnilinker requires ERP Sync <minimum> or newer; nothing is written to the ERP and no list is read until it updates.
AutoUpdateEnabled) and that
the agent computer can reach releases.omnilinker.com, or run the new installer by hand. Once the agent runs a
supported version, its next heartbeat ends the hold.While the agent waits for an update, prices you send from Omnilinker wait (Pending in the product’s ERP prices,
Waiting under ERP Integration > Commands) and expire after 24 hours, the ERP unchanged, and whoever sent
them is told; send them again once the agent has updated. See
Prices to your ERP.The agent cannot reach omnilinker.pl
The agent cannot reach omnilinker.pl
-
Test the connection from the agent computer:
TcpTestSucceeded : Falsemeans a firewall or the network blocks it. The agent needs outbound HTTPS toomnilinker.plon port 443. See Requirements. -
If your network requires a proxy, set it for the machine with the
HTTPS_PROXYenvironment variable, then restart the service. The service runs as Local System, so it does not use the proxy settings of the person signed in: -
Check which server the agent uses: Troubleshoot… names it in the reachable check. It should be
omnilinker.pl. To change it, run setup again and click Change next to Server.
The agent cannot connect to the ERP database
The agent cannot connect to the ERP database
-
Check Server. For a named instance use
server\instance, for exampleerp-server\WAPRO. -
Check that the agent computer can reach the SQL Server port:
Use your instance’s port if it is not 1433. A named instance with a dynamic port also needs the SQL Server Browser service and UDP port 1434.
- SQL Server login: check the user and password, and that SQL Server allows SQL Server authentication (mixed mode).
- Windows account of the service: the agent logs in as the service’s account, Local System, not as you. That is
the agent computer’s domain account (
DOMAIN\COMPUTER$) on a remote SQL Server, orNT AUTHORITY\SYSTEMon SQL Server on the same computer. Give that account a login and the rights in Requirements, or use SQL Server authentication.
The connector's check fails: Wapro price procedure installed or Company chosen
The connector's check fails: Wapro price procedure installed or Company chosen
- Wapro price procedure installed: the database has no
dbo.Api_ProductPriceModify, or the SQL login may not execute it (SQL Server hides a procedure from a login without the right, so both look the same). Grant the loginEXECUTEon it. See Requirements. - Company chosen: the company number is missing, or names a company that has no warehouse in this database. Enter the right Company number in Settings… > Change…. See Wapro.
The ERP's lists do not arrive
The ERP's lists do not arrive
- Is the agent online? See The PC and connector tab says Offline.
- Does the agent need an update? See Omnilinker requires a newer agent: an agent waiting for an update reads no lists.
- Is the connector ready? On the PC and connector tab, the connector’s state should be Ready, and its operations should include Read price levels, Read warehouses, Read products and Read stock, and, once orders are sent, Read orders sent from Omnilinker (the agent reads those only while the connection has sent an order in the last 90 days). An operation marked switched off means a check failed; its hint says which.
- Is the company number set? Without it the Wapro connector reads no list. See Wapro.
- Is the agent paused? A paused agent reads no lists. Resume it from the tray app’s panel or menu.
No ERP stock is shown
No ERP stock is shown
- Is the agent from this release? An older agent sends no stock at all; the Lists from ‹ERP› card shows no Receives stock line. See Omnilinker requires a newer agent.
- Is a warehouse mapped? Wapro stock is read every 5 minutes only while a warehouse of the connection is mapped; otherwise it is read once a day. Map the warehouse on the Warehouses and products tab.
- Is the warehouse ignored, or mapped more than once? An ignored ERP warehouse shows no stock, and so does an Omnilinker warehouse that more than one ERP warehouse of the connection is mapped to.
- Is the product linked? Stock appears only for products linked to an ERP product on the connection. See Link products.
- Is the pair in the ERP’s last list? A product the ERP no longer lists in a warehouse reads 0, marked “not in the ERP’s last list” (a stock line deleted in Wapro reads an unmarked 0 until the agent’s daily complete list).
- Is the agent paused, offline or updating? A paused agent reads no stock. See The PC and connector tab says Offline.
The Prices line says reading prices is off, or to update the agent
The Prices line says reading prices is off, or to update the agent
- reading prices is off for this account: Read prices from the ERP is off for your organization, so Omnilinker has not asked the agent for prices. It is off until Omnilinker switches it on; ask Omnilinker. See Prices and Modules and feature availability.
- Update the ERP Sync agent to read prices: the connection’s agent is older than the release that reads prices, and its connector does not report Read prices among its operations on the PC and connector tab. Update it; see Omnilinker requires a newer agent.
A price level says Not compared yet, or the ERP's prices never refresh
A price level says Not compared yet, or the ERP's prices never refresh
- Is a price level mapped? Prices are read only while a price level of the connection is mapped to a catalog price level. See Price levels.
- Is reading prices on for your organization? If the Prices line says reading prices is off for this account, it is not. See the previous entry.
- Is the agent from this release, online and not paused? A paused or offline agent reads nothing. See The PC and connector tab says Offline.
- Did Omnilinker support set the lists the agent reads by comparison? If the list in
Configuration reference does not include
Prices, the prices are read only with the daily complete read. AddPricesto it, one environment variable for each entry (ErpSync__Feeds__DiffStreams__2, and so on), as the page shows. - Is Read prices switched off on the PC and connector tab? If the connector’s operation is marked switched off, the hint says why (the same checks as for the lists).
The check Same prices in every warehouse is shown
The check Same prices in every warehouse is shown
SynchroArt) to “Wspólne dane i ceny podstawowe” in Wapro and turn synchronisation on for every price level. If the
SQL login lacks the optional SELECT on ARTYKUL_CENA_IE, POZYCJAKONFIG and INTERFIRMAPOZYCJA, the check cannot
tell, and it still shows with its hint: in the tray app its detail starts with “Not checked” and names the three
tables, and the agent’s summary says the prices of the warehouses were not checked rather than that they may differ.
Grant the SELECT and the next check tells; see Requirements. See
How prices are read.A price you sent did not arrive in Wapro
A price you sent did not arrive in Wapro
The connector was not found, or isn't included in this ERP Sync
The connector was not found, or isn't included in this ERP Sync
connectors\wapro subfolder of its install folder. Install the
agent again with the MSI: it brings the connector with it. If the message says the connector’s description could not
be read, install the update again or contact support.A product is not linked, or a warehouse is not on the list
A product is not linked, or a warehouse is not on the list
- “This product is not linked to a product in the ERP. Refresh lists on the connection’s Overview tab, or link it on its Warehouses and products tab.”: the catalog product has no link on this connection. Click Refresh lists so Omnilinker links what it can, by the connection’s link key, or link it by hand. See Link products.
- “Someone is changing which products the ERP manages. Try again in a moment.”: while you link, ignore or create products, or change who manages SKUs, another person is doing one of those, or Omnilinker is updating products from the ERP in the background (linking, creating, or applying a new product list). Try again.
- An ERP product does not link by itself: Omnilinker remembers an unlink or an ignore, so the row shows Won’t link automatically or sits under Ignored. Click Link to link it by hand, or Stop ignoring. Otherwise look for a suggestion on the row and its reason, for example GTIN shared by 3 products; Link suggested links the suggested product. Which key links on its own (code, code then EAN, or EAN only) is set with Edit product settings on the Warehouses and products tab. See Products from your ERP.
- “The ERP warehouse … is ignored on this connection. Stop ignoring it before you map it.”: click Stop ignoring on its row on the Warehouses and products tab. See Lists and mappings.
- “This warehouse is not on the ERP’s warehouse list. Refresh lists and pick one.”: the source warehouse you entered is not one the agent sent. Click Refresh lists, then pick a warehouse from the list. See The source warehouse.
The connection can't be deleted
The connection can't be deleted
- “This connection owns ‹what›. Make Omnilinker the owner of those first, then delete the connection.”: the connection manages something in Omnilinker, and the message lists it: Product identity (it manages SKUs), Product fields: ‹names› (it is the source of those fields), or a warehouse or price level. Make Omnilinker the owner first. For SKUs, click Change owner under Who manages SKUs in How products arrive from ‹connection› on the Warehouses and products tab and choose Omnilinker · Catalog. If the connection is switched off or its product settings cannot be used yet, Change owner is not offered there: open Catalog > Products, click Change owner next to Who manages SKUs there, or switch the connection on first. For fields, set each one to Off or Fill when empty with Edit product settings; the dialog shows the field table for them even when the settings cannot be used otherwise. See Products from your ERP.
- “Omnilinker couldn’t check what this connection owns, so it wasn’t changed. Try again.”: Omnilinker could not read what the connection manages, so it deleted nothing. This is deliberate: it will not delete a connection it cannot check. Try again in a moment.
Orders: Order and customer procedures present fails
Orders: Order and customer procedures present fails
The Orders tab says No ERP user for writes
The Orders tab says No ERP user for writes
The Orders tab says ERP Sync needs an update
The Orders tab says ERP Sync needs an update
An order says More than one Wapro customer could be this buyer, or those found are blocked or inactive
An order says More than one Wapro customer could be this buyer, or those found are blocked or inactive
An order says No EUR rate in Wapro for …
An order says No EUR rate in Wapro for …
EXECUTE on Api_CurrencyImport. See
Currencies and Wapro.An order says Cross-border VAT is not set up in Wapro
An order says Cross-border VAT is not set up in Wapro
An order says Not cancelled in … cancel it there by hand
An order says Not cancelled in … cancel it there by hand
An order says No confirmation from Wapro
An order says No confirmation from Wapro
A change to an order is refused
A change to an order is refused
An order says Lines from more than one warehouse
An order says Lines from more than one warehouse
An order says Managed by another system, or nothing is sent from a source
An order says Managed by another system, or nothing is sent from a source
An order says Not read back from Wapro yet
An order says Not read back from Wapro yet
- Is the agent from this release? An older agent does not read orders back, and the Lists from ‹ERP› card shows no Receives orders sent from Omnilinker line. See Omnilinker requires a newer agent.
- Was the order sent less than about 15 minutes ago? The agent reads orders back about every 15 minutes. Wait for the next read, or click Refresh lists on the connection’s Overview tab.
- Is the read switched off? The PC and connector tab should list Read orders sent from Omnilinker among the connector’s operations. If it is marked switched off, grant the SQL login the read rights in Requirements. The agent’s log names what is missing. If it is not listed at all, the agent is older than this release: see step 1.
- Is the agent paused or offline? A paused or offline agent reads nothing. See The PC and connector tab says Offline.
- Did Omnilinker support set the lists the agent reads by comparison? If the list in
Configuration reference does not include
SalesOrders, the orders are read only with the daily complete read. AddSalesOrdersto it, one environment variable for each entry (ErpSync__Feeds__DiffStreams__0,ErpSync__Feeds__DiffStreams__1, and so on), as the page shows.
The ERP option is greyed out in a warehouse's owner dialog
The ERP option is greyed out in a warehouse's owner dialog
- “Comes once ‹connection› has sent a complete stock list.”: the agent has not finished a complete read of stock yet. Check that it is online and from a release that sends stock; see No ERP stock is shown.
- “This isn’t mapped on ‹connection›.” or “This has 2 mappings on ‹connection›.”: map the warehouse to exactly one ERP warehouse on the connection’s Warehouses and products tab.
- “The connection ‹connection› is switched off. Switch it on first.”: switch the connection on.
Change owner says Orders from … aren't sent to this ERP
Change owner says Orders from … aren't sent to this ERP
Change owner says the connection must reserve the ordered stock
Change owner says the connection must reserve the ordered stock
An order says Removed in Wapro
An order says Removed in Wapro
The ERP option for a price level is locked
The ERP option for a price level is locked
Change owner says the price level has no currency
Change owner says the price level has no currency
Change owner says a price was still being written
Change owner says a price was still being written
A queued send says Withdrawn
A queued send says Withdrawn
Prices from the ERP do not land
Prices from the ERP do not land
A product's price says Waiting for the ERP's prices
A product's price says Waiting for the ERP's prices
Product images from the ERP don't arrive
Product images from the ERP don't arrive
Some of a product's ERP images never arrive
Some of a product's ERP images never arrive
A script that called http://localhost:5555 gets no answer
A script that called http://localhost:5555 gets no answer
http://localhost:5555. The agent no longer opens any network
port, so that API is gone. Use the connection’s PC and connector tab in Omnilinker, the tray app, or the agent’s log files
instead.Get help
If none of this solves the problem, contact Omnilinker support. Include:- The connection name, and what you see on its PC and connector tab.
- The agent’s version, from the PC and connector tab or the tray app’s Settings > Updates.
- The report from the tray app’s Troubleshoot… > Copy report.
- The service log files from the time the problem started.