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 shown | What 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 server | Your 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 code | The 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 serveur | An 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 shown | What 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
- Check that you uploaded the
fullmetrix-prestashop.zipfile itself, not an unzipped folder. - In the Module Manager, clear any active filters, then type
Fullmetrixin the search. - 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
modulesdirectory.
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.
- In Fullmetrix, check the organization name at the top of the sidebar.
- Open Settings, then Integrations. A card that reads "Waiting for plugin installation" is still waiting for its code.
- 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.