Troubleshooting
What goes wrong with Shopify Connector Pro, how to recognise it, and what to do.
Start at Shopify > Operations > Jobs, filter Needs attention. Every blocked or failed job says what happened and, in What to do, how to fix it. The Health tab on the shop counts the rest.
| You see | It means | Do this |
|---|---|---|
| "No encryption key is configured" | tv_shopify_secret_key is missing from the Odoo configuration file | Add it (see setup), restart Odoo |
| Shop Credentials refused | Shopify answered 401/403: token revoked, app uninstalled or secret changed | Reconnect from the shop form |
| Job blocked: "missing a scope" | A feature needs a permission the shop has not granted; the shop itself stays connected | Reconnect the shop and approve the scopes |
| Job Retry scheduled, "API budget exhausted" | Shopify's query budget is spent | Nothing: it resumes by itself when the budget refills |
| Order blocked: "Shopify tax ... is not mapped" | A tax title/rate has no Odoo tax | Add it under Configuration > Tax mapping, retry |
| Conflict: "More than one product has the SKU" | Two Odoo products share the SKU | Choose the right one in the conflict and resolve |
| Order imported NOT confirmed, totals conflict | Odoo's total differs from Shopify's (taxes, rounding, a price-included tax mapped as excluded) | Fix the mapping or the order, then confirm |
| Refund Waiting | Its order or invoice does not exist yet | Nothing: it is settled when they do |
| Payout Needs review | Missing accounts, another currency not active, or a difference | The result says which; fix and press Book now |
| Order export blocked: totals | Shopify calculated a different total (usually tax) | Fix the order or tax setup, or Accept Shopify's total |
| "Waiting for Shopify's search" on an export | An earlier attempt may have created the draft | Nothing: the job looks again in a minute before creating anything |
| Webhooks never arrive | The address is not public https, or subscriptions point elsewhere | Webhooks tab: set the address, Register webhooks |
| Webhook answered 401 | The signature did not match the app's secret | The secret in Odoo must be the app's current client secret |
| Market conflict: "belongs to more than one active market" | Two Shopify markets include the country | Fix the markets in Shopify, List Shopify markets again, retry |
| Order skipped: "channel ... is excluded" | You excluded its sales channel | Untick excluded on the Markets & channels tab if that was not meant |
Retrying
Retry on a job runs it again now. Cancel marks it skipped with your name. A job that failed eight times stops (dead letter) rather than retrying for ever; fix the cause and retry it.
Asking us
Setup tab > Download support bundle and email it to info@technovision.dev with your Odoo version and edition. The bundle holds settings, counts and recent job results with emails, phone numbers and tokens masked, and never any credential.