Skip to main content
Amazon

What the «Sync Account Health» button does in Amazon Connector for Odoo

The Sync Account Health button asks Amazon for that account's Seller Performance report, waits for it to be ready, imports its metrics into Odoo and leaves a summary of the result. It sits on the account form, anyone with manager permission can press it, and the same sync runs on its own through a daily scheduled task for accounts that have it switched on.

FlexigoTech · Editor in charge: Víctor Gómez · Updated 5 November 2026

Key facts

Module
Amazon
Versions
Odoo 17, 18, 19 and 20
Checked
in the connector's source code, version 20.0 · against the sources linked at the end
Reading time
5 min

Where the button is and who can press it

Where is the Sync Account Health button?

It is on the Amazon account form, which you open from the menu Amazon › Configuration › Accounts. Each menu level asks for a permission, and if you lack it you do not see that level: Amazon asks for Viewer, while Configuration and Accounts ask for Manager. The button does not depend on any state or checkbox: it is always visible. It is on the Accounts screen in Odoo 17, 18, 19 and 20.

Diagram built from code, not an Odoo screen: the menu Amazon › Configuration › Accounts, the Sync Account Health button and, beside it, the permissions message that can stop it
Diagram based on the module's published code, with the original English labels: menu, button and permissions message.

What is the button called in my language?

With Odoo in English it is Sync Account Health. The module's published translations also give it in Spanish, German, French, Italian and Portuguese, as the diagram shows.

Diagram built from code, not an Odoo screen: the text Sync Account Health as the user sees it depending on the language of their Odoo
Diagram based on the published translations: in Spanish Sincronizar salud de la cuenta, in German Kontozustand synchronisieren, in French Synchroniser l'état du compte, in Italian Sincronizza stato dell'account and in Portuguese Sincronizar estado da conta.

Who can press it, and what happens if I lack permission?

The first thing the button does is check permissions. It lets through whoever acts as superuser (the code allows for scheduled-task call chains) and anyone in the Amazon connector's manager group or the Settings group. It also checks that you have write permission on the account. If you belong to neither of those two groups, the action stops with this message: You need Amazon Seller Connector Manager (or Settings) access for this action. Ask a manager to grant Manager access. The fix is to ask a manager to give you Manager access. Because this check comes before anything else, if you stop here nothing has been requested from Amazon.

Your Odoo doesn't talk to Amazon, Temu or Shopify?
Video: Your Odoo doesn't talk to Amazon, Temu or Shopify?

What it does when you press it

What does the button do, step by step?

It works on one account at a time. According to the Odoo 20 code (the button exists in all four versions), the order is:

  1. It checks permissions, as above.
  2. It asks Amazon to generate the account's Seller Performance report.
  3. It checks the report's status, pausing between checks, until Amazon marks it as finished (DONE), cancelled (CANCELLED) or failed (FATAL), or until the attempts run out. Unless another value is configured, that means twelve checks ten seconds apart.
  4. If the report is ready, it downloads the report document and imports the metric lines.
  5. It stores the date of the last run and the result text on the account, and posts that result as a message in the account's chatter.

What will the result summary show?

The summary starts with Amazon Seller Performance sync finished., followed by Account: …, Source: …, Report ID: … and Report status: …. Source reads Manual when you launch it with the button and CRON when the scheduled task does.

If the report is downloaded and imported, the summary adds the counters Metrics: …, Processed: …, Created: …, Updated: …, Skipped: … and With error: …. The result text is stored trimmed to five thousand characters.

What happens if Amazon does not finish the report?

These are some of the cases where the button stops before importing anything. In them it still stores the date and the result and posts the message in the chatter:

  • The final status is CANCELLED or FATAL: the summary adds Amazon did not generate a usable Seller Performance report.
  • The attempts run out before the report finishes: the summary adds Report polling timed out. Try again in a few minutes. Wait a few minutes and press again; each press asks Amazon for a new report.
  • The report reaches DONE but without a document: the summary adds DONE report without reportDocumentId.

The automatic task, repeating it and the cost

Do I have to press it every day?

It depends on whether the account has the Seller Performance sync switched on. If it does, you do not need to: the scheduled task Amazon SP-API - Sync Seller Performance / Account Health (opt-in) runs once a day, is active when the module is installed, and launches for each account the same sync the button runs. The task only goes through active accounts that have that sync switched on; if an account does not, the task does not process it and the button is the way to launch it.

There are differences from a manual press. Source shows CRON. The task does not post the message in the chatter. And if an account produces an error that reaches the task, the task writes it to the server log and carries on with the other accounts. The button is for launching it by hand whenever you want, for example after Report polling timed out. Try again in a few minutes.

What do I need to use it, and what does it cost?

The module is a one-off payment per version and needs a FlexigoTech Cloud subscription, Connector plan: €49 a month or €490 a year, excluding VAT (up to 3 accounts of the platform). The connection goes through FlexigoTech Cloud, which stores the credentials encrypted, monitors the sync and emails you if it fails. The module is published on Odoo Apps for 17.0, 18.0, 19.0 and 20.0; see the listing and the module page.

If you are implementing Odoo and want help setting up the connector or a bespoke integration, FlexigoTech implements Odoo 17, 18, 19 and 20 and builds connectors and custom integrations. For another button in the same module, read what «Preview on Amazon» does.

Keep reading

What the «Preview on Amazon» button in Amazon Connector for Odoo doesWhat the Preview on Amazon button in Amazon Connector for Odoo does: when it shows, what it checks, what it saves and which errors it can raise.
Checked in the connector's source code (version 20.0) and the linked sources

Sources