Amazon

The Amazon integration lets you create and manage Amazon listings directly from YuCommerce using Amazon’s Selling Partner API. You can push new listings, import existing ones, and track submission status.

Connecting Your Account

1. Go to Settings → Amazon
2. Enter your Amazon seller credentials
3. YuCommerce validates the credentials against Amazon’s API
4. On success, your account is marked as Connected

If credentials become invalid (revoked or expired), an error banner appears prompting you to re-enter them.

Setting Up a Product

1. Navigate to a product’s edit page
2. Click the Amazon marketplace card
3. On the setup page, search and select an Amazon product type (e.g., “Shoes”, “Electronics”)
4. If your product has variations, select a variation theme (e.g., Size, Color, Size/Color)
5. Click Initialize

This creates draft listings for each active SKU (and a parent listing if variations exist). Each child listing’s title is automatically set to the product title followed by its variation values — for example, “Cotton T-Shirt - Red, Large”.

Listing Statuses

Status	Meaning
Draft	Not yet submitted to Amazon — edit attributes freely
Pending	Submitted, waiting for Amazon to process
Pending Parent	Child listing waiting for its parent to be approved first
Live	Amazon has processed the listing successfully
Rejected	Amazon rejected the submission — check errors and resubmit

A listing can be Live but still have issues. Status and errors are independent — always check for error indicators.

Editing Listings

Variation products show a parent summary at the top, followed by a child listings matrix. The matrix has inline editable fields for List Price, Your Price, and Quantity. Use the bulk toolbar to apply the same value to multiple selected listings at once, then click Save Listings to persist all changes. Click a seller SKU to open the full detail page for that child listing.

Standalone products (no variations) show a single dynamic form generated from Amazon’s schema for your product type.

Fill in attributes and click Submit to push to Amazon.

Validate Before Submitting

Use the Validate button to dry-run your listing against Amazon’s rules without affecting your actual listing. This catches errors before you submit.

Importing Existing Listings

If you already have listings on Amazon, you can import them:

1. Navigate to the Amazon listings page for a product
2. Click Import from Amazon
3. YuCommerce pulls your existing Amazon data and matches listings to SKUs by seller SKU or UPC
4. Imported attributes are populated into the form fields

Unmatched listings are logged for manual review.

How It Works

• Standalone products (no variations): One listing with seller_sku = your Item ID
• Variation products: One parent listing + one child per active SKU. The parent groups children on Amazon’s product page.
• Variation theme: Declares how children differ (e.g., SIZE_NAME, COLOR_NAME). Must be selected during setup.

Limitations

• Submissions are processed asynchronously by Amazon — status updates may take minutes
• Product type cannot be changed after setup (delete and re-initialize if wrong)
• Variation theme must match your product’s actual variation types
• Amazon’s schema requirements can change — form fields update automatically on next visit