fullmetrixDocs

Troubleshooting

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

Most problems are solved by reading the exact message the plugin shows. Always start there. To open the plugin, hover over WooCommerce in the WordPress left menu, then click Fullmetrix.

Do not disconnect the plugin 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.

Plugin messages when connecting

These messages appear in a red banner after you click Connect. When the WordPress admin is in another language, the plugin shows the translated 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: ...Your server could not reach Fullmetrix. The rest of the message comes from WordPress. A timeout (cURL error 28) or a certificate error usually means the host blocks outgoing HTTPS connections. Send the Compatibility page to your host.
Registration failed: Plateforme incorrecte pour ce codeThe code was created for another platform, for example PrestaShop. In Fullmetrix, click Change platform, choose WooCommerce 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 WordPress 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 plugin 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.

The plugin does not activate

If WordPress shows "Fullmetrix Connector requires WooCommerce to work.", WooCommerce is not active. Open Plugins, activate WooCommerce, then activate Fullmetrix again.

If WordPress refuses activation for another reason, check the minimum versions in Compatibility. WordPress itself tells you when the PHP or WordPress version is too old. Also check in Plugins, then Installed Plugins, that only one Fullmetrix plugin is present.

The WooCommerce then Fullmetrix menu is missing

  1. In Plugins, then Installed Plugins, check that Fullmetrix Reporting, Analytics & Marketing for WooCommerce is activated.
  2. Check that your account has the Administrator or Shop manager role.
  3. Reload the page. If your site uses an object cache, clear it, then reload again.

The plugin shows Connected but Fullmetrix is still waiting

If the plugin 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 plugin.

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. Also open your site address followed by /wp-json/. A page of technical text should appear. If you see an error or a login page, a security plugin is blocking the REST API.

If you use Cloudflare or a firewall, check that it does not block Fullmetrix calls, see Cloudflare and firewalls.

Check scheduled actions

In WordPress, open WooCommerce, then Status, then the Scheduled Actions tab. Type fullmetrix in the search. Actions that stay Pending for a long time mean WordPress cron is not running. Failed actions show their error in the log column.

If cron is disabled at your host, ask them to replace it with a system task, as explained in Compatibility.

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 WooCommerce

A gap between Fullmetrix and WooCommerce analytics usually comes from excluded order statuses, taxes, shipping costs, refunds 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 WordPress, WooCommerce, PHP and Fullmetrix plugin versions.
  • Whether you use HPOS and WooCommerce Subscriptions.
  • The exact message, typed out or as a screenshot.
  • The approximate time of the problem.
  • Any failed fullmetrix scheduled actions.
  • Whether you use Cloudflare, a firewall, a security plugin or maintenance mode.

What you should never send

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

On this page