PI Electronique Connector (Elyx) ✨ New and recommended

⭐ Recommended method for connecting PI Electronique (Elyx) to haddock

haddock Connector is a small program that is installed on your restaurant computer and automatically sends sales from PI Electronique to haddock. Once configured, it runs by itself and you do not have to do anything else.

What do I need before starting?

• The computer where PI Electronique is installed must be turned on and running PI Electronique.
• You need access to that computer to install the program. If you are not physically at the venue, you can ask someone there to give you remote access with AnyDesk or TeamViewer - these are free programs that let you see and control the computer from another location.
• Have the PI Electronique API Key handy (your PI Electronique reseller provides it) and the haddock authentication code (you will find it in the haddock web app, under Restaurant settings > My integrations > PI Electronique Connector (Elyx)).

💡 Tip: If you do not have all the details or do not feel confident doing the installation, the easiest option is to send everything to your PI Electronique reseller or technician. Share the haddock authentication code with them - they will be able to do the installation and setup remotely without you having to handle anything technical.

Step 1 - Download and install

1. On the computer where PI Electronique is installed, download the haddock Connector installer.
2. Open the downloaded file. If Windows asks for permission (Windows protection screen), click "More info" and then "Run anyway".

   
   

   
   

   
   

   
   
3. Follow the installer steps:
4. • Welcome screen:

• Select the destination folder:

• Make sure the "Create a desktop shortcut" option is checked.

• Review the summary and click "Install".

4. When installation finishes, make sure "Launch haddock Connector" is checked and click "Finish". The program will open automatically.

   
   

   
   

Step 2 - Configuration

When the program opens, you will see a screen with several fields to fill in:

1. POS System:
Select Pi Electronique from the drop-down menu.

2. Pi Electronique Connection:

• API Key: A key provided by PI Electronique to identify you. Ask your PI Electronique reseller for it.
• Load Pi Electronique locals: After entering the API Key, click this button so the connector fetches the list of locations (locals) available in PI Electronique. You will pick from that list when setting up each property below.
• Advanced settings: Expanding this option lets you configure the port (default 8082) and other additional settings.

3. Properties:

Add each venue/property you want to sync, with its own authentication code and PI Electronique locals. If you only have one venue, a single property is enough.

• Property name: A name to identify the venue (for example Restaurant 1).
• Authentication Code: Go to the haddock web app, open Restaurant settings > My integrations > PI Electronique Connector (Elyx), and copy the 10-digit code shown there. Paste it into this field. Each property has its own code.
• Pi Electronique locals: The PI Electronique location IDs that belong to this property. Click Load Pi Electronique locals above and select them from the list, or type the numeric IDs manually.
• + Add property: If you manage several venues from the same computer, click this to add another property block and repeat the steps above.

4. Sync Settings:

• Sync interval: How often sales will be sent to haddock, in minutes. You can leave the default value (30 minutes).

5. Sync Dates:

• Start / End: The period from which you want to import sales history. By default, it retrieves the last year of history.

Step 3 - Connect

Click the blue "Connect" button. The program runs a series of checks and shows them as a list of items that turn green one by one:

1. POS reachable — the connector finds PI Electronique on this computer (or at the IP you entered).
2. POS credentials valid — PI Electronique accepts the API Key.
3. API license active — PI Electronique's REST service responds correctly.
4. haddock cloud — there is a connection to haddock's servers.
5. haddock auth code valid — your authentication code is correct.

When all of them are green, the connection is ready and sales will start syncing. If an item turns red, that is the source of the problem: look up the message the connector shows in the Errors and solutions section below.

How do I know it is working?

Once connected, you will see the status panel with real-time information: when the last sales sync happened, how many syncs have been completed, and a log of recent activity. If you want to sync right away without waiting, press "Sync Now".

Day-to-day use

• The program runs in the background - you do not need to keep it open. When you close the window, it minimizes to the notification area (bottom right of the Windows desktop) and keeps working.
• To open it again, click the icon in the notification area.
• It updates and restarts itself if there is any problem - you do not need to worry about anything.

🔧 Errors and solutions

If a check turns red when connecting, the connector shows a message. Look it up here to see what to do:

🚨 "API not accessible on localhost:8082. Make sure PI Electronique is running on this machine."

(Check 1 — POS reachable)

✅ PI Electronique is not open, is on another computer, the port is wrong, or a firewall/antivirus is blocking the port. Check that:

• PI Electronique is open and running on the correct computer.
• The port under Advanced settings is 8082 (the default). If PI Electronique runs on another machine, enter its server IP in the configuration.
• If opening http://localhost:8082 in the browser on that machine loads nothing, PI Electronique's API is not listening there: contact your PI Electronique reseller.

🚨 "PI Electronique server is reachable but the API Key was rejected."

(Check 2 — Credentials)

✅ The API Key is wrong or inactive. Ask your PI Electronique reseller for the correct key and to confirm it is active.

🚨 "PI Electronique API responded with a server error while checking /api/Locales."

(Check 3 — API license)

✅ PI Electronique's REST service is failing. Ask your PI Electronique reseller to verify that the REST service is running.

🚨 "Cannot reach haddock cloud."

(Check 4 — haddock cloud)

✅ The computer has no internet access, or a firewall/proxy/antivirus is blocking the secure (HTTPS) connection to haddock. Check the computer's internet connection and that the firewall or antivirus allows outbound HTTPS traffic to haddock. If the message says the cloud "is reachable but rejected the request", it is a temporary issue: try again in a few minutes.

🚨 "Authentication code is invalid" / "Invalid authentication code format."

(Check 5 — haddock auth code)

✅ The code was copied incorrectly or has expired. Go to the haddock web app (Restaurant settings > My integrations > PI Electronique Connector (Elyx)), generate a new one, and paste it in full. Codes expire if they are not used.

🚨 I do not have the PI Electronique API Key

✅ Ask your PI Electronique reseller for it. It is a piece of data they manage and they must provide it when they activate the integration.

🚨 Everything shows green and connected, but no sales reach haddock

(All 5 checks pass green, but a property's Pi Electronique locals are wrong)

✅ When the connection shows as connected and syncs run, but no sales appear in haddock, it is almost always caused by the Pi Electronique locals assigned to a property in Step 2 - Configuration.

Each property tells the connector which PI Electronique locations its sales come from. Because the API Key, license, and connection are all valid, the five checks turn green and the connector looks like it is working — but if a property has no locals assigned, or holds a wrong or non-existent local ID (a number that does not match a real location, or leftover text such as local1 or test), PI Electronique returns no invoices for it and nothing reaches haddock.

• Click "Load Pi Electronique locals", then open the Pi Electronique locals field for each property and make sure the selected IDs match the venue's real locations in PI Electronique.
• If you typed the IDs manually, double-check they are the exact numeric IDs (your PI Electronique reseller can confirm them). A wrong number means no sales will come through, even though the connection is green.
• If you manage several venues, check that each property has the correct locals — one wrong property will silently miss that venue's sales.

After fixing it, press "Connect" again and then "Sync Now" to force a sync.

The connector was working and now it fails

• I do not see sales right after connecting: the first sync can take a while if there is a lot of history. Press "Sync Now" in the status panel to force it.
• If you see the "Sync has been failing — please check your configuration" notice with a Reconfigure button, press it and use the list above to see which check is red.
• The connector also shows notifications in the Windows notification area (bottom right) when it has been unable to reach the POS or haddock for a while.
• Check that the POS computer is powered on and that PI Electronique is still running.

Still not working after checking this? See How to fix connection problems with my POS or contact haddock support chat.

My articles look wrong or are missing in haddock

The connector pushes both sales and the article catalog automatically (catalog every ~15 minutes by default). If the catalog still looks broken — wrong names, wrong prices, or missing articles — you can force an immediate refresh from the haddock web app:

1. Go to Restaurant settings > My integrations > PI Electronique Connector (Elyx).
2. Click "Refresh".

This queues both an orders resync and a catalog resync that the connector will pick up on its next heartbeat (typically within a minute). The button is rate-limited to once every 24 h per integration.

ℹ️ Multiple locations: PI Electronique's article list is per location, so the same article code can have a different name or price in each one. When several locations share a code, the connector keeps the first location's name and price — so if an article shows the wrong name or price, check that the same code is not defined differently in another location.

If after the refresh the catalog still looks wrong, contact support — the issue is on the connector / PI Electronique side and needs investigation.

Integrations may include additional costs not covered by haddock.

Updated on: 17/07/2026