This article covers the most common issues you may run into while setting up and running the Amazon integration, and how to resolve each one. Most problems come down to a missing default customer, products that have not yet been mapped to their Amazon ASIN, or simply waiting for the next scheduled sync to run.
After reading this, you will know how to fix a settings page that will not save, get a missing product to sync, make sure your ASIN changes are actually saved, and understand why orders and returns arrive on a schedule rather than instantly.
Work through the section below that matches what you are seeing. Each one describes the exact condition and the step or steps that clear it.
A few rules apply throughout this article, so they are called out here before the individual fixes.
The default customer is mandatory. Until one is set, the Amazon settings will not save and product import cannot begin, because “Finish Setting Up Your store” saves the settings first. Only the default customer is checked when you save; the default location is a setup step, not a save blocker.
On the Product Sync Status tab, nothing is saved until you click Update Mappings. Typing an ASIN into the ASIN box does not store it on its own, and the table only reflects your changes once it reloads.
When an Amazon order is imported, each order line matches a Qoblex product when the Amazon SellerSKU on that line equals the Qoblex variant Sku, or when the line’s ASIN has been mapped to that variant on the Product Sync Status tab. Either match works, so a product whose Qoblex Sku already matches its Amazon SellerSKU does not need an ASIN mapping. This SellerSKU and ASIN rule applies to order import only; returns and refunds are matched differently (see the returns section below).
The Amazon settings page requires a default customer before it will save. If you click Save (or Finish Setting Up Your store) without choosing one, the page does not save and shows the message “The default customer is not set” in the error area at the bottom of the page.
To fix this:
- Open the Amazon integration and stay on the Settings tab.
- In the box under “Which customer to use as default for orders created via the web channel?”, type a contact name and pick the contact from the list. If the customer does not exist yet, use the plus button next to the box to create a new contact first.
- Click Save.
When the save succeeds you will see the confirmation “Amazon integration changes saved”. If you have not yet set a default location under “Which location to use as default for orders created via the web channel?”, set it as part of finishing setup, but note that a missing location does not cause this save error.
If a product on an Amazon order is not being matched to the right Qoblex item, the usual cause is that neither match path lines up: the Amazon SellerSKU does not equal any Qoblex variant Sku, and no ASIN mapping exists for it. Mapping the ASIN on the Product Sync Status tab is the most direct way to link the two.
- Open the Amazon integration and click the Product Sync Status tab.
- Use the Filters link, then turn on “Narrow down the report to products that failed to sync” and click Apply Filters to list only the products that are not yet linked. You can also type in “Filter by name or SKU or barcode” to find a specific item.
- Find the product in the table. The columns are Name, Sku, Barcode, and ASIN.
- Type the Amazon ASIN into the ASIN box on that row.
- Click Update Mappings to save.
The table shows each product with its Name, Sku, Barcode, and an editable ASIN field. Only the ASIN is editable here; the other columns come from the product record itself. If the item’s Sku already matches its Amazon SellerSKU, it can match on that alone, but mapping the ASIN makes the link explicit.
Typing an ASIN into the ASIN box does not save it on its own. The mappings are only stored when you click the Update Mappings button. If you type ASINs and then leave the tab or reload without clicking it, your changes are lost.
- On the Product Sync Status tab, enter or correct the ASIN values in the ASIN boxes.
- Click Update Mappings.
The table reloads after saving, so you can confirm the ASIN values are shown against the correct rows.
Amazon orders are not pulled in the instant they are placed. Qoblex imports recent Amazon orders automatically on a schedule, so there is a short delay before a new order appears.
- The automatic order import runs every 5 minutes. A newly placed order should appear within a few minutes of that schedule running.
- An order line matches a Qoblex product when the Amazon SellerSKU on that line equals the Qoblex variant Sku, or when that line’s ASIN is mapped to the variant on the Product Sync Status tab. If items are missing from an imported order, check that one of these is true: either the product’s Sku equals its Amazon SellerSKU, or map the ASIN for those products and click Update Mappings.
- If an order still does not appear after allowing time for the schedule, confirm the settings are saved (a default customer is set, and a default location for the orders) and that each product on the order matches by SellerSKU or has its ASIN mapped.
Returns and refunds are also imported automatically on their own schedule, which is separate from and slower than the order schedule. Allow time before assuming a return is missing.
- The automatic return import runs every 30 minutes, so a return can take longer to appear than a new order.
- A return or refund is only imported if the original Amazon order it came from already exists in Qoblex. Qoblex looks up that order by its Amazon order reference. If the matching order is not in Qoblex yet, the return is skipped and nothing is created.
- The return’s lines are matched to the existing lines on that original order using the Amazon order item, not by SellerSKU or ASIN. Because of this, mapping an ASIN on the Product Sync Status tab does not affect whether a return imports; that mapping only affects order import.
- A return or refund cannot import until its original order has already been imported into Qoblex. If the order is missing, get the order in first: confirm your default customer and default location are set, and that the order’s products match on SellerSKU or a mapped ASIN so the order can import. Then allow the next return sync to run.
- If the original order is present and the return still does not appear after the 30 minute schedule has had time to run, allow one more cycle, since returns can lag well behind the order that produced them.
When you run a product import, Qoblex confirms it and then takes you to your Activity view so you can see the outcome.
- On the Settings tab, click Finish Setting Up Your store, which saves your settings and opens the Import products window.
- Click Import Products and wait; this can take a few minutes depending on how many products you have.
- When the import finishes, the button changes to Done. Click Done to go to your Activity view and review the results.