Athenian Amazon Connector
product details.
Athenian Amazon Connector links WooCommerce to Amazon SP-API so merchants can publish products, manage channel-specific settings, and monitor listing sync status from WordPress. It helps teams coordinate marketplace listings, catalog readiness, channel settings, and product status without separating Amazon work from store operations while keeping data, permissions, and automation aligned with the broader Athenian Platform…
Athenian Amazon WooCommerce Connector is a WooCommerce-to-Amazon marketplace publishing bridge built around Amazon Selling Partner API. It keeps WooCommerce as the working catalog-management surface while adding Amazon-specific product settings, SP-API connection controls, manual publish/update actions, listing status fetches, and product-list sync indicators directly inside WordPress.
The plugin adds an Amazon product-data tab where operators can enable products for Amazon, configure Amazon seller SKU, product type, condition, fulfillment channel, external identifiers, channel-specific price rules, and Amazon quantity rules without changing the public WooCommerce storefront configuration. From the product editor, teams can publish or update a listing through Amazon Listings Items API and fetch Amazon-side listing status, issues, offers, fulfillment availability, attributes, and ASIN data when available.
This connector is intentionally scoped as a practical Amazon listing-control layer rather than a full Amazon operations suite. It focuses on product publishing, channel-specific settings, SP-API connectivity, LWA token exchange, AWS Signature Version 4 signing, and sync visibility. That makes it a strong foundation for merchants and implementation teams that want WooCommerce to remain the primary product-management interface while building toward broader Amazon marketplace workflows.
Within the Athenian Platform, Amazon WooCommerce Connector fits as the Amazon channel connector for catalog publishing, marketplace metadata, channel pricing, inventory exposure, AI Product Builder enrichment, AI Repricing Agent recommendations, Pricing & Inventory Control, Shipment Manager, and future marketplace operations.
Amazon Channel Controls
Manage Amazon Listing Settings Directly From WooCommerce Products
Athenian Amazon WooCommerce Connector adds an Amazon product-data tab
to WooCommerce so operators can enable marketplace publishing, configure
Amazon-specific product metadata, and control channel pricing, quantity,
fulfillment, condition, SKU, and identifier behavior from the product editor.
| Product Setting | Operational Value |
|---|---|
| Amazon Enablement | Uses a product-level flag to decide which WooCommerce products are eligible for Amazon publish/update actions. |
| Seller SKU Strategy | Supports an Amazon seller SKU override with fallback to the WooCommerce SKU or a generated WC-{product_id} value. |
| Listing Metadata | Stores Amazon product type, condition, fulfillment channel, external product identifier, ASIN, listing status, and last sync timestamp. |
| Channel Price & Quantity Rules | Supports inherited, overridden, or percent-adjusted Amazon prices, plus inherited or overridden Amazon quantity exposure. |
- Adds an Amazon product-data tab for supported WooCommerce product screens.
- Stores product metadata such as
_ath_amz_enabled,_ath_amz_sku,_ath_amz_asin,_ath_amz_product_type,_ath_amz_condition_type, and_ath_amz_fulfillment. - Stores pricing and quantity fields such as
_ath_amz_price_mode,_ath_amz_price_override,_ath_amz_price_percent,_ath_amz_qty_mode, and_ath_amz_qty_override. - Registers product metadata with REST exposure for users who can edit products.
Marketplace Sync Workflow
Publish, Update, Fetch, and Monitor Amazon Listing State From WordPress
The connector provides AJAX-driven publish/update and fetch actions that
call Amazon Listings Items API, then stores local sync state so catalog
teams can review Amazon readiness, last-sync time, ASIN data, and warning
or error status from the WooCommerce product list.
Submit conservative Listings Items API payloads through SP-API
Retrieve summaries, issues, offers, fulfillment availability, and attributes
Show compact Amazon sync status directly on the WooCommerce product list
| Sync Layer | How It Helps |
|---|---|
| Listings Items PUT | Builds a listing-focused payload and sends publish/update requests to Amazon using the configured seller ID, seller SKU, and marketplace ID. |
| Listings Items GET | Fetches current Amazon-side listing data and updates local ASIN, status, and last-sync metadata where available. |
| Status Column | Adds product-list indicators for off, pending, published/fetched, warning, or error states, with tooltips for ASIN and sync details. |
| Health Route | Registers a lightweight public ping route for version and UTC time visibility. |
- Uses AJAX actions such as
ath_amz_wc_publish,ath_amz_wc_fetch, andath_amz_wc_test_connection. - Calls Amazon routes such as
/listings/2021-08-01/items/{sellerId}/{sellerSku}and/sellers/v1/marketplaceParticipations. - Stores local sync metadata such as
_ath_amz_listing_status,_ath_amz_listing_link, and_ath_amz_last_sync_at. - Registers the health route
/wp-json/ath-amazon-wc/v1/ping.
Amazon SP-API Infrastructure
Connect WooCommerce to Amazon With LWA Tokens, AWS Signing, and Admin Diagnostics
Athenian Amazon WooCommerce Connector includes a WooCommerce admin settings
screen for Amazon SP-API endpoint, marketplace, seller, LWA, AWS signing,
region, and debug configuration, plus a connection test that validates
marketplace participation access.
| Connector Layer | Operational Purpose |
|---|---|
| LWA Token Exchange | Requests Amazon access tokens using the stored Login With Amazon client ID, client secret, and refresh token, then caches the token in a transient. |
| AWS Signature V4 | Signs SP-API requests with AWS access key, secret key, signing region, service name, access token, host, date, and authorization headers. |
| Connection Settings | Stores endpoint, marketplace ID, seller ID, LWA credentials, AWS credentials, AWS region, SP-API service name, condition defaults, fulfillment defaults, and debug behavior. |
| Diagnostics & Logging | Provides a Test Connection action and prefixed logging for publish, fetch, and connection-test failures. |
Marketplace connector, not a full Amazon suite:
the current version focuses on product publishing, listing status fetches,
channel-specific metadata, and SP-API connectivity. Bulk sync, order import,
schema remediation, scheduled refresh, and advanced issue dashboards are
natural roadmap extensions.
- Stores global connector settings in
ath_amazon_wc_options. - Uses fields such as
endpoint,marketplace_id,seller_id,lwa_client_id,lwa_client_secret,lwa_refresh_token,aws_access_key,aws_secret_key, andaws_region. - Declares WooCommerce HPOS / custom order table and orders cache compatibility.
- Production deployments should consider moving LWA and AWS credentials into Athenian Secure API Key Manager or another encrypted secret layer.
- Builds toward encrypted credential storage, marketplace presets, saved listing issues, product-list filters, bulk publishing, Action Scheduler background sync, schema-aware product-type templates, issue dashboards, variation listings, AI Product Builder enrichment, AI Repricing Agent recommendations, and Amazon order ingestion.