Skip to main content

Amazon Seller Central (SP-API)

Publish and maintain listings on Amazon marketplaces using CataZenta syndication.

Prerequisites​

  • Amazon Seller Central account with SP-API access
  • LWA credentials (client id, client secret, refresh token)
  • Target marketplace id (e.g. US, IN, UK — from CataZenta marketplace catalog)
  • Products enriched to your Amazon category / product-type requirements

Setup overview​

1. Create a connection​

Use the Integration API or PIM UI:

  • Connector: Amazon
  • Store LWA credentials securely in the connection
  • Set marketplace_id for the target region

2. Create an export profile​

  • Link the Amazon connection
  • Choose listing schema / product type rules for your categories
  • Enable only when mappings are complete

3. Map categories and attributes​

Amazon requires:

  • Product type per category branch
  • Attribute mapping from PIM fields → Amazon JSON attributes
  • Mandatory fields (brand, bullet points, images, …) for completeness

Use the PIM completeness report before exporting.

4. Run an export job​

  • Select products (or filters)
  • POST create export job → POST start
  • Poll until complete — see Poll an export job

5. Handle results​

Each job item shows success, validation errors from Amazon, or throttling retries. Fix data in PIM and re-export failed SKUs.

Rate limits​

Amazon SP-API enforces per-operation limits. CataZenta's connector throttles and retries 429 responses automatically. Large catalogs should use batch jobs off-peak.

Troubleshooting​

SymptomCheck
Auth errorsRefresh token, LWA app approval, connection status
Missing product typeCategory mapping on export profile
Validation failedJob item error payload; completeness gaps
Partial publishRe-run job for failed items only

APIs​