Odoo Amazon Connector: Setup and Multi-Channel Selling

Amazon accounts for nearly 40% of US eCommerce revenue, making it a mandatory channel for product sellers. Managing Amazon orders, inventory, and fulfillment separately from your core ERP creates data silos, reconciliation headaches, and fulfillment errors that cost real money.

The ECOSIRE Odoo Amazon Connector bridges Odoo 19 Enterprise and Amazon Seller Central, synchronizing products, orders, inventory levels, and fulfillment status in both directions. This guide covers the complete setup process, data mapping configuration, sync frequency options, error handling, and operational best practices for running Amazon sales through Odoo.

Key Takeaways

• The connector supports all Amazon marketplaces (US, UK, EU, Japan, UAE, etc.)
• Order sync runs every 15 minutes by default; configurable down to 5 minutes
• Inventory levels push to Amazon automatically on every stock move
• FBA and FBM (Fulfilled by Merchant) orders are handled in separate workflows
• Product mapping uses ASIN, SKU, and EAN/UPC as matching keys
• Failed syncs are logged with error details and can be retried individually
• Pricing rules can override Amazon prices based on Odoo pricelists
• The connector uses Amazon SP-API (Selling Partner API), replacing the deprecated MWS

---

Prerequisites and Amazon SP-API Setup

The connector uses Amazon's Selling Partner API (SP-API). Before installing the connector, you need SP-API credentials from Amazon.

Step 1: Register as a developer in Amazon Seller Central

1. Log into Seller Central → Apps & Services → Develop Apps
2. Click "Add new app client" and complete the developer registration
3. Amazon will review your application (1-3 business days for approval)

Step 2: Create an SP-API application

Once approved:

1. Go to Apps & Services → Develop Apps → Your Applications
2. Click "Add new app client"
3. Select IAM ARN (create an AWS IAM user first) or use OAuth
4. Set redirect URI to your Odoo instance: https://your-odoo.com/amazon/oauth/callback
5. Select required API scopes:
   • Orders API
   • Reports API
   • Listings API
   • Catalog Items API
   • FBA Inventory API
   • Feeds API

Step 3: Authorize your seller account

After app creation, authorize the app against each marketplace:

1. Copy your application's LWA (Login With Amazon) credentials
2. Go to the connector's authorization URL
3. Complete the OAuth flow for each Amazon marketplace account

Credentials you'll need in Odoo:

• LWA Client ID
• LWA Client Secret
• Refresh Token (generated during OAuth flow)
• AWS Region (based on marketplace)

---

Installing and Configuring the Connector

Install the ECOSIRE Amazon Connector module:

The connector is available from the ECOSIRE marketplace. After purchase:

1. Download the module zip file from your ECOSIRE account
2. Upload to your Odoo server: cp amazon_connector.zip /opt/odoo/addons/
3. Extract and install: navigate to Apps → Update Apps List → search "Amazon Connector" → Install

Initial configuration:

Navigate to Inventory → Configuration → Amazon Marketplaces (or Sales → Amazon → Configuration depending on your Odoo layout).

Click Create to add a new marketplace connection:

Test the connection:

After saving, click Test Connection. A successful test returns your merchant name and confirms API access. If it fails, check:

• LWA credentials are correct
• Refresh token hasn't expired
• AWS region matches your marketplace
• SP-API application is in "Published" state (not "Draft")

---

Product Mapping and Catalog Sync

The connector maps Odoo products to Amazon ASINs using three methods:

Method 1: SKU matching (recommended)

If your internal product references (SKU codes) match the seller SKU you use on Amazon, enable SKU Auto-Match in the marketplace settings. The connector will automatically link Odoo products to their Amazon listings.

Method 2: EAN/UPC matching

The connector queries Amazon's catalog API to find listings matching your product's barcode (EAN13 or UPC). This works for branded products listed on Amazon's catalog.

Method 3: Manual ASIN mapping

For custom products or bundles:

1. Go to the product form → Amazon tab
2. Enter the ASIN for each marketplace
3. Map variants to their specific ASINs

Importing the Amazon catalog:

Instead of mapping one-by-one, import your Amazon catalog:

1. Go to Amazon → Catalog → Import Listings
2. Select the marketplace
3. The connector downloads all your active listings and creates/updates Odoo products
4. Review imported products for field mapping accuracy

Product field mapping configuration:

---

Order Synchronization

Orders flow from Amazon to Odoo automatically. Understanding the order lifecycle prevents confusion and fulfillment errors.

Order sync workflow:

Amazon Order Created (status: Pending)
        ↓ [15-minute sync interval]
Odoo receives order → creates sale.order in DRAFT
        ↓
Amazon confirms payment (status: Unshipped)
        ↓ [next sync]
Odoo sale.order auto-confirmed → delivery order created
        ↓
Warehouse picks, packs, ships
        ↓
Odoo records shipment → sends tracking to Amazon via API
        ↓
Amazon status: Shipped → Customer receives
        ↓
Amazon releases payment to seller
        ↓
Odoo invoice created and posted (auto or manual)

Order sync settings:

Handling cancelled orders:

When Amazon cancels an order (customer cancellation or payment failure):

1. The connector detects the cancellation on the next sync
2. If the delivery order hasn't been validated: it's automatically cancelled
3. If the delivery was already validated: the connector creates a return RMA
4. The invoice is cancelled or reversed with a credit note

---

Inventory Synchronization

Real-time inventory accuracy prevents overselling, which leads to Amazon seller account penalties.

Inventory push to Amazon:

Every time an Odoo stock move occurs (delivery, receipt, return, adjustment), the connector pushes the updated quantity to Amazon Inventory API:

• FBM products: Odoo's on-hand quantity minus safety stock buffer
• FBA products: Amazon manages FBA inventory; Odoo receives FBA levels via Amazon Inventory API

Safety stock configuration:

Available for Amazon = On-Hand Quantity - Safety Stock Buffer - Reserved Quantity

Configure safety stock per product or globally:

• Navigate to product → Amazon tab → Safety Stock: 5
• Or globally in marketplace settings → Default Safety Stock: 2

Inventory sync frequency:

Unlike order sync (event-driven + scheduled), inventory sync is batch-based:

• Default: every 30 minutes
• After any stock movement: within 5 minutes (webhook-style)
• Before peak periods: run manual sync

Multi-warehouse inventory:

If fulfilling from multiple warehouses:

1. Create separate Amazon Marketplace configurations for each warehouse
2. The connector aggregates inventory across all linked warehouses
3. Or: use Amazon's multi-location inventory feature with warehouse-specific quantity allocation

---

FBA (Fulfilled by Amazon) Integration

FBA orders are fulfilled by Amazon's warehouse, but Odoo still needs to know about them for financial reconciliation.

FBA order workflow in Odoo:

1. Amazon receives and fulfills the order (Odoo has no fulfillment role)
2. The connector creates a sale.order in Odoo marked as "FBA"
3. The delivery order is auto-validated (no physical picking in Odoo)
4. A virtual "Amazon FBA" location is decremented
5. Invoice is created and posted
6. Amazon remittance is reconciled against the invoice

FBA stock management:

Send inventory to Amazon FBA through Odoo:

1. Create an FBA shipment in Odoo (or in Seller Central and link it)
2. The connector creates a stock transfer from your warehouse to the "Amazon FBA" location
3. Validate the transfer when goods are shipped to Amazon
4. FBA quantities are tracked in Odoo for reporting purposes

FBA fee reconciliation:

Amazon deducts fees (fulfillment, storage, referral) before remitting payment. Configure the connector to:

• Import Amazon settlement reports
• Auto-create journal entries for FBA fees
• Reconcile net settlement amount against outstanding invoices

---

Pricing Management

Automated repricing:

The connector supports automated price updates to Amazon based on Odoo pricelist rules:

Amazon Price = Odoo List Price × Marketplace Multiplier + Fixed Offset

Configuration:

• Navigate to marketplace settings → Pricing
• Set Price Source: Pricelist, Cost + Margin, or Fixed
• Set Multiplier (e.g., 1.0 for same price, 1.15 for 15% markup)
• Enable Auto-Sync Prices: prices push to Amazon when changed in Odoo

Currency handling:

For non-USD marketplaces (EUR, GBP, JPY), the connector:

1. Reads prices from the marketplace-specific pricelist if configured
2. Or converts from your base currency using daily exchange rates from Odoo

---

Error Handling and Monitoring

Sync error log:

Navigate to Amazon → Sync Logs to see all sync operations:

• Green: successful sync
• Yellow: partial sync (some records failed)
• Red: complete sync failure

Each error entry shows:

• Timestamp and sync type (orders, inventory, listings)
• Error code from Amazon API
• Affected record ID
• Error message
• Retry button

Common errors and resolutions:

Automated alerts:

Configure email alerts for sync failures:

• Navigate to marketplace settings → Notifications
• Add email addresses to notify on sync errors
• Set alert threshold: notify after 3 consecutive failures

---

Frequently Asked Questions

Does the connector support Amazon FBA Multi-Channel Fulfillment (MCF)?

Yes. MCF allows you to use Amazon's FBA inventory to fulfill orders from other sales channels (your website, other marketplaces). The connector can create MCF fulfillment requests when a sale order from a non-Amazon channel is received, provided the product is stocked in FBA. MCF orders are tracked in Odoo with FBA location movements.

How does the connector handle Amazon's complex tax rules (VAT OSS, Marketplace Facilitator)?

For marketplaces where Amazon collects and remits tax (Marketplace Facilitator rules, applicable in most US states and EU for non-EU sellers), the connector creates orders with $0 tax, as Amazon handles the tax obligation. For non-Facilitator situations, the connector applies fiscal positions configured in Odoo based on the buyer's delivery address.

Can I manage multiple Amazon accounts (different seller accounts) from one Odoo instance?

Yes. Create multiple marketplace configurations, each with their own SP-API credentials. You can have separate configurations for different seller accounts, different marketplaces under the same account, or different companies in a multi-company Odoo setup. Orders, inventory, and pricing are managed per marketplace configuration.

What happens if Amazon changes an order after it's been imported to Odoo?

The connector checks for order modifications on each sync cycle. If Amazon updates an order (e.g., quantity change before shipping, address correction), the connector updates the corresponding Odoo sale order if it hasn't been confirmed yet. Modifications to confirmed orders create a system alert for manual review.

Does the connector handle Amazon A+ Content or Enhanced Brand Content?

No. A+ Content management is marketing content managed exclusively through Seller Central. The connector focuses on operational data: orders, inventory, pricing, and fulfillment. Product content (descriptions, images) can be pushed to Amazon basic listings but not A+ Content templates.

---

Next Steps

Selling on Amazon through Odoo is significantly more efficient than managing two systems separately — but the connector must be set up correctly from the start. Misconfigured product mappings, wrong inventory sync settings, or incorrect tax configurations create problems that compound over time.

ECOSIRE's Amazon Connector module is purpose-built for Odoo 19 Enterprise, and our team provides setup assistance, training, and ongoing support for marketplace sellers managing Amazon through Odoo.

Get the ECOSIRE Amazon Connector for Odoo 19 →

Purchase includes module license, documentation, and 30 days of implementation support to get your Amazon-Odoo integration running correctly from day one.