How to Connect with Online Marketplaces

Decide whether Magento should create and manage listings (full sync) or only import orders from existing marketplace listings.

Evaluate connectors using this checklist:

• Magento 2.x compatibility and MSI (multi-source) inventory support
• Amazon SP-API and eBay API support; sandbox/test options
• Order import with tax/fee handling; FBA/MFN support; eBay business policies support
• Price rules (markup, min margin, MAP), repricing options, multi-store/multi-currency
• Listing creation and linking to existing listings; variation (parent/child) support
• SLA-backed support, documentation quality, and total cost (license + per-order/GMV fees)

Confirm support for your exact Magento version, order import, pricing rules, and target marketplaces. Review documentation and pricing.

Obtain the package name from the vendor's documentation or Magento Marketplace. Install and validate in a non-production environment first.

On-prem/self-hosted (staging) example:

php -d memory_limit=-1 composer require <vendor/package:^version>
php bin/magento module:enable <Module_Name>
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f
php bin/magento cache:clean

For production on-prem (use maintenance mode):

php bin/magento maintenance:enable
php -d memory_limit=-1 composer require <vendor/package:^version>
php bin/magento module:enable <Module_Name>
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy -f
php bin/magento cache:clean
php bin/magento maintenance:disable

Adobe Commerce on cloud:

1. 1. Run composer require <vendor/package:^version> in your local dev environment
2. 2. Commit composer.json and composer.lock, then push to the integration branch
3. 3. Let cloud build/deploy hooks run (they execute setup:upgrade, compile, deploy)
4. 4. Verify on the integration environment, then promote to staging and production via the normal pipeline
5. 5. Do not SSH into the production container to install modules

In Magento Admin, open the connector's configuration area (location varies by vendor; typically under Stores › Configuration › <Connector Vendor> or via a top-level <Vendor> menu). From there, click Add Account to start the OAuth/consent flow.

Save credentials and confirm the account status shows Connected in the connector.

Set time zone, currency, and sync frequency. Map stock source (MSI) to the channel. Define price rules or channel price adjustments. Configure order import settings (status mapping, customer creation, tax handling, shipping mappings, FBA vs. merchant-fulfilled).

Pricing and margin

Implement channel-specific price rules to cover marketplace fees and shipping costs (for example, +12% markup with a minimum margin floor). This helps protect profitability while remaining competitive.

Taxes and currency

• Taxes: In many regions, marketplaces collect/remit tax. Configure the connector to import marketplace-collected tax as order tax and avoid double-charging in Magento. Some connectors map imported orders to a non-taxable customer group—enable if required.
• Currency: If marketplace currency differs from your website currency, enable connector-side conversion or set website/store-view pricing scope accordingly so posted prices match the marketplace.

For each marketplace category you plan to use, map Magento categories and attributes to marketplace-required fields (Brand, Condition, Item Specifics for eBay; Product Type/Category attributes for Amazon). Validate that UPC/EAN/ISBN is present or set up GTIN exemptions.

Variations and brand requirements

Clean SKUs and ensure each product has correct identifiers, images, and descriptions.

Linking and duplicate prevention

• Amazon: Link products to existing ASINs using UPC/EAN/ISBN or ASIN. Only create new ASINs if no match exists and you meet new listing requirements. Avoid duplicate ASIN creation.
• eBay: Link to existing listings by Item ID or create new listings using templates; ensure SKU uniqueness to prevent duplicate listings.

For existing marketplace listings, use the connector's linking tool to associate them with Magento SKUs. For new listings, create listing templates (title, bullets, images, policies).

Select 5–10 SKUs and submit them to the marketplace (or enable linking). Use the connector's preview/validation to catch errors. Confirm the status transitions (Queued › Submitted › Active) and resolve any attribute/category issues before scaling.

Turn on quantity and price synchronization in the connector. Make a small price change in Magento to a test SKU and verify it updates on the marketplace within the documented sync window. Confirm stock decrements after a Magento or marketplace test sale.

Operational guidance

• Ensure Magento cron is running (Admin › Stores › Configuration › Advanced › System › Cron or via CLI) so sync jobs execute reliably
• Expected latency: Price/qty updates typically reflect within 5–30 minutes depending on connector schedule and API throttling
• Set a safe sync frequency to avoid API rate-limits; many connectors provide backoff controls
• Make sure only one system owns listing, inventory, and order sync per channel. Do not run multiple connectors or overlapping ERP/WMS updates against the same marketplace listings

Place a low-value order on the marketplace. Confirm the order imports into Magento with correct items, taxes, and shipping method. Ship the order from Magento (or via FBA if configured) and verify tracking information updates back to the marketplace.

Exceptions and post-order flows

Cancellations and refunds: Decide where refunds will be initiated (marketplace vs Magento). Configure the connector to sync cancellations, returns, and partial refunds. Test a cancellation and a partial refund to ensure statuses and amounts sync back correctly.

Scale listing to additional SKUs in batches by category. Monitor connector logs and marketplace health dashboards for rejections or policy flags. Set alerts for order import failures and low stock. Document your operational runbook.

Monitoring and KPIs