fullmetrixDocs

Troubleshooting

Find the message shown by the Fullmetrix module or by Fullmetrix and apply the matching fix.

Most problems are solved by reading the exact message the module shows. Always start there.

To open the module, go to Modules, then Module Manager (or Modules and Services on PrestaShop 1.6), type Fullmetrix in the search and click Configure.

Do not disconnect the module to try again

Clicking Disconnect then pasting the same code again fixes nothing, and the code will then be refused. First note the exact message and the time, then follow the fix below.

Module messages when connecting

These messages appear in a red banner after you click Connect. When the back office is in French, the module shows the French version of the same message.

Message shownWhat it means and what to do
Please enter a connection code.The field was empty. Paste the code copied from Fullmetrix and click Connect again.
Invalid code format. The code must be in FMTX-XXXX-XXXX-XXXX format.The code is incomplete or contains a space, a line break or an extra character. Copy it again by clicking it in Fullmetrix, then paste it without adding anything.
Connection code not found. Check your code in Fullmetrix.This code does not exist on our side. It was often mistyped, or it belonged to a store that has since been deleted. Open your Fullmetrix organization and copy the code currently shown.
This code is already associated with another site.See the dedicated section below, this message has three possible causes.
Connection error to Fullmetrix serverYour server could not reach Fullmetrix within five seconds. The server often blocks outgoing HTTPS connections, or the PHP cURL extension is disabled. Send the Compatibility page to your host.
Registration failed: Plateforme incorrecte pour ce codeThe code was created for another platform, for example WooCommerce. In Fullmetrix, click Change platform, choose PrestaShop and use the new code.
Registration failed: Trop de tentatives, réessayez dans quelques minutes.Too many connection attempts were made in a short time. Wait a few minutes before clicking Connect again.
Registration failed: Erreur serveurAn incident on our side. Try again in a few minutes, then contact us if the message comes back.

The end of the last three messages comes from Fullmetrix and is always in French, whatever your back office language.

The "This code is already associated with another site" message

Fullmetrix refuses the code in three situations.

  • The code has already been used. Each code links a single store, once. This also applies if you disconnected the module and then tried to paste the same code again. To reconnect that store, follow Reconnect the store.
  • The store is already connected to another Fullmetrix organization. Use the organization switcher at the top of the sidebar to check whether another organization already holds this store.
  • The store has already had a Fullmetrix free trial. A subscription is then required to reconnect it, see Billing.

Other module messages

Message shownWhat it means and what to do
Fullmetrix requires PHP 7.1 or later.PrestaShop refused the installation because the server runs a PHP version that is too old. Ask your host to move to PHP 7.1 or later, then install the ZIP file again.
The Fullmetrix module files are incomplete. Upload the whole module again.The uploaded file was damaged or incomplete, often because it was unzipped and zipped again. Download fullmetrix-prestashop.zip again from Fullmetrix and upload it without opening it.
Fullmetrix 2.0 requires PHP 7.1 or later. This server runs an older PHP version ...The server's PHP version was lowered after installation. Sync is stopped until PHP is upgraded again. Ask your host to move back to PHP 7.1 or later.
Only one Fullmetrix 2.0 connection is supported per PrestaShop installation ...Several stores of the same PrestaShop installation are connected. This message is informational and the other stores keep syncing.
The Fullmetrix journal table is in use and was kept ...This message can appear after uninstalling. The leftover table is no longer used and does not affect the store. Your developer can remove it later.

The module does not appear after uploading the file

  1. Check that you uploaded the fullmetrix-prestashop.zip file itself, not an unzipped folder.
  2. In the Module Manager, clear any active filters, then type Fullmetrix in the search.
  3. If PrestaShop showed an error during the upload, your hosting may limit the size of uploaded files. Ask your host to raise that limit, or to copy the module folder into the store's modules directory.

The module shows Connected but Fullmetrix is still waiting

If the module shows the Connected badge but Fullmetrix still reads Waiting for plugin connection, the code you pasted probably belongs to another organization.

  1. In Fullmetrix, check the organization name at the top of the sidebar.
  2. Open Settings, then Integrations. A card that reads "Waiting for plugin installation" is still waiting for its code.
  3. Compare that card's code with the one shown in the module.

If the codes differ, the store is connected to another organization. Switch organization in the switcher to find it.

The store is connected but data is not updating

Read the status in Fullmetrix

Open Settings, then Integrations, and look at the store card. It shows the Last sync date and, when something is wrong, a red or orange message. The message "Auto-sync disabled after N consecutive errors. Click Sync to retry." means we stopped retrying after several failures. In this state, the card shows Resume and Reset in place of Sync.

The states and buttons on this card are described in Sync status.

Check that the store is reachable

Open your store in a private browsing window. It must not be in maintenance mode or ask for a password. If you use Cloudflare or a firewall, check that it does not block Fullmetrix calls, see Cloudflare and firewalls.

Check that the module is enabled

In the Module Manager, the Fullmetrix module must be enabled. A disabled module no longer answers Fullmetrix, and sync resumes as soon as you enable it again.

Restart the sync

After an error, the Sync button gives way to Resume and Reset. Once the cause is fixed, click Resume to continue from where the import stopped. If Resume isn't offered, click Reset, which sets the progress back to zero and restarts the sync without deleting orders already imported. The card's other states are described in Sync status.

Numbers do not match PrestaShop

A gap between Fullmetrix and PrestaShop statistics usually comes from excluded order statuses, taxes, shipping costs or the time zone. Read Data accuracy before concluding there is a sync problem.

What to send us if the problem persists

Write to us from Contact support with this information.

  • The store address and the name of your Fullmetrix organization.
  • Your PrestaShop, PHP and module versions (shown in the Module Manager).
  • The exact message, typed out or as a screenshot.
  • The approximate time of the problem.
  • Whether you use Cloudflare, a firewall, a security module or maintenance mode.

What you should never send

Never send your connection code, your back office credentials or your customers' data.

On this page