Athenian eBay Connector
product details.
Athenian eBay Connector connects WooCommerce to eBay with product publishing, marketplace order import, tracking synchronization, and structured listing workflows inside WordPress. It helps teams manage marketplace listings, order flow, fulfillment updates, and channel visibility from the same commerce backend while keeping data, permissions, and automation aligned with the broader Athenian Platform Ecosystem.
Athenian eBay WooCommerce Connector is a WooCommerce-native marketplace integration that connects store catalog data, eBay listing workflows, imported marketplace orders, and fulfillment tracking synchronization into one WordPress admin workflow.
The plugin allows WooCommerce to remain the operational source of truth while eBay becomes a connected sales channel. Product teams can configure eBay categories, item specifics, condition values, SKU overrides, price rules, quantity behavior, seller policies, package data, merchant location keys, and listing readiness directly from WooCommerce product and variation screens.
Beyond product publishing, the connector can poll eBay fulfillment orders, create or update WooCommerce orders, preserve raw eBay order payloads, display eBay-linked order visibility in legacy and HPOS order screens, and push shipment tracking numbers back to eBay when fulfillment data is available.
Within the Athenian Platform, eBay WooCommerce Connector fits as a marketplace channel connector alongside Amazon, Shipment Manager, Pricing & Inventory Control, Product Intelligence, Dropship/Vendor Routing, Order Fulfillment, Secure API Key Manager, and cross-channel reporting tools.
Marketplace Channel Setup
Connect WooCommerce to eBay With OAuth, Seller Policies, and Sync Controls
Athenian eBay WooCommerce Connector provides a WooCommerce admin workspace
for configuring eBay OAuth credentials, production or sandbox mode, seller
marketplace settings, business policy IDs, sync behavior, tracking push-back,
notifications, logging, and developer diagnostics.
| Connection Layer | Operational Value |
|---|---|
| OAuth Authentication | Supports eBay authorization URL generation, authorization-code exchange, refresh-token renewal, token persistence, and environment-aware API routing. |
| Seller Configuration | Stores marketplace ID, merchant location, payment policy, return policy, fulfillment policy, and default listing behavior. |
| Sync Settings | Controls product sync, order sync, auto-publish behavior, tracking push-back, sync intervals, and run limits. |
| Diagnostics & Logs | Adds database-backed logging, retention cleanup, recent log review, and developer REST endpoints for controlled testing. |
- Stores connector configuration in
ath_ebay_wc_options. - Supports option groups such as
environment,oauth,seller,sync,webhooks,debug, andnotifications. - Adds WooCommerce submenu pages for eBay Connector, eBay Orders, and eBay Logs.
- Production deployments should consider moving eBay credentials and OAuth tokens into Athenian Secure API Key Manager or another hardened secret-storage layer.
Product Channel Publishing
Prepare WooCommerce Products and Variations for eBay Listing Workflows
The connector adds eBay product and variation controls for marketplace
readiness, including category mapping, item specifics, condition, SKU,
pricing, quantity, seller policies, package data, merchant location, offer
IDs, listing IDs, and sync diagnostics.
Search eBay categories and retrieve item-specific requirements
Check SKU, category, policies, weight, location, and aspect requirements
Queue eligible variations and sync each variation as an inventory/offer unit
| Publishing Layer | How It Helps |
|---|---|
| eBay Product Tab | Adds product-level mapping fields, sync controls, category data, item specifics, offer/listing display, and last sync diagnostics. |
| Taxonomy APIs | Uses eBay category tree, category suggestion, and item aspect endpoints to help operators map listing requirements before publishing. |
| Inventory & Offer Sync | Builds eBay inventory and offer payloads from WooCommerce data, then upserts inventory items, creates or updates offers, and optionally publishes offers. |
| Preflight Diagnostics | Records missing requirements, blocked publish stages, API errors, and last-result metadata so operators can understand failed syncs. |
- Uses product and variation metadata such as
_ath_ebay_sync,_ath_ebay_category_id,_ath_ebay_aspects_json,_ath_ebay_condition_id,_ath_ebay_offer_id, and_ath_ebay_listing_id. - Supports pricing metadata such as
_ath_ebay_price_mode,_ath_ebay_price_fixed,_ath_ebay_price_override, and_ath_ebay_price_markup_pct. - Supports quantity, package, and location metadata such as
_ath_ebay_qty_mode,_ath_ebay_qty_fixed,_ath_ebay_pkg_type,_ath_ebay_pkg_weight_value, and_ath_ebay_merchant_location_key. - Provides admin AJAX actions such as
ath_ebay_wc_sync_now,ath_ebay_wc_category_suggest, andath_ebay_wc_item_aspects.
Marketplace Fulfillment Operations
Import eBay Orders Into WooCommerce and Push Tracking Back After Fulfillment
Athenian eBay WooCommerce Connector can poll eBay fulfillment orders,
create or update WooCommerce orders, preserve eBay payloads for traceability,
display marketplace order visibility in the admin, and send shipment tracking
back to eBay when fulfillment data is available.
| Fulfillment Layer | Operational Purpose |
|---|---|
| Order Import | Polls recent eBay fulfillment orders, matches line items by SKU when possible, creates fallback fee lines when needed, and stores raw eBay order JSON. |
| Order Admin Visibility | Adds eBay order columns, filters, metaboxes, order ID display, last sync metadata, and an eBay Orders admin page. |
| Tracking Push-Back | Reads common WooCommerce shipment tracking meta keys and submits shipping fulfillment details back to eBay. |
| Scheduled Operations | Registers product sync, order sync, and log cleanup cron hooks with configurable run intervals and limits. |
WooCommerce as the channel hub:
the connector keeps eBay listings, marketplace orders, shipment tracking,
and diagnostics tied to the store’s existing catalog, order, and fulfillment
workflows instead of creating another disconnected marketplace process.
- Links imported orders with metadata such as
_ath_ebay_order_id,_ath_ebay_order, and_ath_ebay_last_sync. - Reads tracking sources such as
_tracking_number,_tracking_provider, and_wc_shipment_tracking_items. - Registers cron hooks such as
ath_ebay_wc_cron_products,ath_ebay_wc_cron_orders, andath_ebay_wc_log_cleanup. - Creates custom tables such as
ath_ebay_wc_mapandath_ebay_wc_log. - Current package notes indicate that admin-referenced routes such as
/mad,/platform-notify, and standard/sync/ordersare anticipated by the settings UI but not registered in the inspected REST class yet. - Builds toward stronger webhook support, Secure API Key Manager credential storage, bulk readiness reports, manual tracking push, Action Scheduler queues, full order financial mapping, multi-marketplace support, and deeper Shipment Manager / Order Fulfillment / Data Intelligence integrations.