Before you start
- An Amazon Seller Central account, and a person who can sign in to it and approve apps.
- The seller account isn’t connected to another Fluid company. One seller account connects to one company.
- A Fluid API token for the company with company admin access: Company settings permission to connect, choose the marketplace and disconnect, and Products permission to list products. The examples use it as
$FLUID_TOKEN. - A live company. A test store can’t connect a sales channel.
Steps
1
Start the connection
Pick the Seller Central region your account sells in:The response’s
url is the Seller Central consent link. Nothing changes in Fluid until someone approves it in the next step. Open the link yourself, or send it to the person who will approve it. The link works once and expires after 10 minutes; call authorize_url again for a new one.2
Approve Fluid in Seller Central
Sign in to Seller Central and authorize Fluid.Amazon then sends the browser back to Fluid admin. The address ends in The step is done when
connect=ok when the connection saved, or connect=error&reason=... when it didn’t. Whatever the page shows, check the result:connection.status is connected. connection.display_name names the seller account, and connection.marketplace_id is the marketplace Fluid picked: the first one the seller sells in.3
Choose the marketplace
Fluid lists products and imports orders in one marketplace. Skip this step if Fluid checks the marketplace with Amazon. It fails with
marketplace_id is already the one you want. Otherwise set it, for example to ATVPDKIKX0DER for amazon.com:422 if the seller doesn’t sell in it.4
List products
This changes live configuration: it creates offers on Amazon. Start with a few products if you haven’t sold on Amazon through Fluid before.Fluid creates one listing per product and publishes it in the background. Products already live on Amazon are skipped, so sending the same IDs again is safe.
5
Check the listings
draft. pending means Amazon accepted the offers and is processing them. The list is newest first, 25 per page; pass meta.pagination.next_cursor back as page[cursor] for the next page, or filter[product_id] to check one product.6
Fix rejected products
A listing with The step is done when no listing is
status publish_failed wasn’t listed. last_error says why, for example a missing barcode or a product Amazon restricts for your account. Fix it, then retry the listing:publish_failed.What each product needs
- A marketplace chosen on the connection.
- A SKU, a price and a barcode on every variant you list. Fluid uses the barcode to find the matching Amazon product, so the barcode has to match a product already in Amazon’s catalog.
- A SKU that isn’t used by another listing on the connection.
- Permission from Amazon to sell the product. Fluid checks Amazon’s listing restrictions before it creates any offer, and a restricted product fails with the restriction named in
last_error.
Amazon orders
Fluid checks Amazon for new and updated orders on a schedule and imports each one as a Fluid order. To see what Fluid has imported, including orders it couldn’t import:filter[ingestion_state], or filter[commerce_order_id] to find the Amazon order behind a Fluid order. An order whose SKU doesn’t match a listed Fluid variant isn’t imported; its row says why.
What the status means
Troubleshooting
authorize_urlfails with422. Fluid couldn’t start the connection. A test store gets this every time. Otherwise contact Fluid support.- The address after approving ends in
connect=error. Thereasonsays why.invalid_statemeans the link was used twice or expired: start again for a new one. - The reason is
no_marketplaces. The seller account doesn’t sell in any marketplace yet. Finish setting up the account in Seller Central, then start again. - The reason is
seller_already_connected. Another Fluid company already holds this seller account. Disconnect it there first. - Choosing the marketplace fails with
422. The seller doesn’t sell in that marketplace, or Fluid couldn’t reach Amazon to check. Use a marketplace from your Seller Central account. - A call fails with
404. The company has never connected Amazon. Run step 1. - A call fails with
403. Your token lacks the permission that call needs: Company settings for the connection, Products for products.