Odoo Amazon Integration: Amazon Connector vs. Custom
What Odoo's Amazon Connector covers (FBA, FBM orders, stock), where it stops, and when an Apps Store module or custom SP-API integration is the better fit.
- Written by
- Md AshikSenior Software Engineer, Artisan Dojo
- Published
- Reading time
- 7 min read
Quick summary30-second read
- Odoo's Amazon Connector is an Enterprise app that imports FBA and FBM orders as sales orders and is not available in Odoo Community.
- For FBM, it confirms shipments with tracking back to Amazon and syncs available stock from Odoo Inventory.
- Refunds, disputes, fee reports, listings and prices are outside its scope and stay in Seller Central or need another integration.
- Products match on Internal Reference against the Amazon SKU; unmatched lines fall back to a generic Amazon Sale product.
- Custom integrations run as an Odoo module on Odoo.sh or self-hosted, or externally through the Odoo 19 JSON-2 API.
For an Odoo Amazon integration, start with Odoo's own Amazon Connector: it is part of Odoo Enterprise, imports FBA and FBM orders as sales orders, sends FBM shipments back to Amazon and pushes FBM stock. It does not manage listings, prices, refunds or Amazon fee reports, and it is not available in Odoo Community. When you need those, or your processes do not fit its rules, you add an Apps Store module or build a custom integration on the Amazon SP-API.
This guide covers what the official connector does in Odoo 18 and 19, where it stops, and how a custom integration maps Amazon data to Odoo. For the Amazon side, see our Amazon SP-API integration guide.
What does the Odoo Amazon Connector support?
According to Odoo's documentation for versions 18 and 19, the Amazon Connector can:
- Import confirmed orders. Both FBA (Fulfilled by Amazon) and FBM (Fulfilled by Merchant), with product, quantity, shipping charges and gift wrapping charges. For FBA it fetches shipped and cancelled orders; for FBM, unshipped and cancelled ones.
- Create customers. Missing contacts and delivery addresses are created in Odoo.
- Confirm FBM shipments. A delivery order is created for each FBM order. When you validate it, Odoo notifies Amazon, which notifies the buyer. Partial shipments work through backorders.
- Sync FBM stock. Available quantities go from Odoo Inventory to Amazon.
- Follow FBA stock. Each FBA order creates stock moves out of a dedicated Amazon location (
WH/Amazonby default). - Handle several accounts. Multiple seller accounts, and multiple marketplaces per account.
You link your account through Amazon's consent page, so you do not register your own SP-API developer application. The docs list nine marketplaces (US, Canada, Mexico, Germany, Spain, France, UK, Italy, Netherlands), and you can add others by entering their Amazon marketplace ID.
Products are matched by Internal Reference: Odoo compares the Amazon SKU with the product's internal reference and saves each pairing as an Amazon Offer. If no match is found, the line falls back to a generic product called Amazon Sale.
Where does Odoo's Amazon connector stop?
The documentation is clear about its scope: the connector is designed to synchronize sales order data. Other limits worth knowing:
- Refunds, disputes and monthly fee reports must be handled in Seller Central. There is no settlement or fee import into Odoo Accounting.
- No listing or price management. Its feature list has no catalog, listing creation or repricing.
- Invoices cannot be emailed to Amazon buyers, because Amazon does not share their email addresses. You upload them in Seller Central manually.
- B2B VAT numbers have to be copied from Seller Central by hand before invoicing.
- FBA and lot/serial tracking do not mix. Amazon does not send the lot or serial number, so the sync fails. Odoo's workaround is a kit product that wraps the tracked product, and it does not record which lot was sold.
- North American FBA orders have arrived without the customer's name since February 19, 2024.
- Taxes come from Odoo, not Amazon (product taxes or fiscal position). Totals can differ from Seller Central by a few cents, which you write off when reconciling payments.
- Enterprise only. Odoo's editions comparison lists the Amazon Connector for Enterprise, not Community.
Official connector vs. Apps Store module vs. custom integration
| Odoo Amazon Connector | Apps Store module | Custom SP-API integration | |
|---|---|---|---|
| Odoo edition | Enterprise only | Depends on the module; often Community too | Any |
| Odoo Online | Yes | No | Only as an external service, on a Custom plan |
| Orders (FBA, FBM) | Yes | Usually | Yes, to your rules |
| FBM stock to Amazon | Yes | Usually | Yes, with your buffer and warehouse logic |
| Listings and prices | No | Varies by module | Yes |
| Settlements and fees in accounting | No | Varies by module | Yes |
| SP-API app | Odoo's | Often your own private app, sometimes the vendor's | Your own private app |
| Maintenance | Odoo | Module vendor | You or your integrator |
Apps Store modules differ widely in scope, pricing and supported Odoo versions, so read each listing for what is excluded. We compare the general trade-offs in custom integration vs. connector.
When do you need a custom Odoo Amazon integration?
Start with the official connector if you run Enterprise and mainly need orders and FBM stock. Consider an Apps Store module or a custom build when:
- You run Odoo Community, where the official connector is not available.
- Listings and prices should come from Odoo, using pricelists per marketplace and Amazon's product type schemas.
- Finance needs Amazon payouts in Odoo: settlement reports split into sales, fees, refunds and reserves, posted automatically.
- Your stock logic is more than one number: several warehouses, kits, safety buffers across Amazon, Kaufland and your own shop. See preventing overselling.
- FBA needs more than order moves: inbound shipments, removals, damaged or lost units reconciled against Amazon's inventory data.
- You need lot or serial traceability on FBA sales.
The routes can be combined, for example the official connector for orders and a custom module for settlements, as long as only one system imports orders.
How does a custom integration talk to Odoo?
The same two options apply as in our Kaufland Odoo integration guide:
- A custom Odoo module on Odoo.sh or self-hosted Odoo. It calls the SP-API from Odoo's scheduled actions and writes records through the ORM. Odoo Online does not allow custom or Apps Store modules.
- An external service using the Odoo API. Odoo 19 introduced the External JSON-2 API (
POST /json/2/<model>/<method>, API key as a bearer token). XML-RPC and JSON-RPC are deprecated and scheduled for removal in Odoo 22 (fall 2028) and Odoo Online 21.1 (winter 2027). API keys last at most three months, and on Odoo Online the external API requires a Custom plan.
One JSON-2 detail matters for orders: every call runs in its own database transaction. Create the sales order with its lines in one create call, then call action_confirm. Do not build an order through several separate calls that can half-fail.
How do Amazon orders and products map to Odoo?
| Amazon | Odoo | Notes |
|---|---|---|
| Order ID | sale.order, in client_order_ref or a dedicated field | Unique key, so retries never create duplicates |
| Order item | sale.order.line | Store the order item ID for shipments and refunds |
| Seller SKU | product.product via default_code or a mapping table | Match on SKU, not ASIN |
| ASIN | Stored on the mapping record | One ASIN can carry several of your SKUs, for example new and used |
| Shipping and gift wrap charges | Service product lines | The official connector does the same |
| Marketplace | Sales team, pricelist, fiscal position, currency | Separate per marketplace if needed |
| FBM stock | free_qty of the shipping warehouse | Minus a buffer if stock is shared with other channels |
| FBA stock | Internal location for Amazon's warehouses | Reconcile against Amazon inventory reports |
| FBM shipment | stock.picking: carrier_id, carrier_tracking_ref | Amazon requires a tracking reference |
| Refund | Credit note (account.move) | |
| Settlement | Journal entries on an Amazon clearing account | Fees and reserves as separate lines |
Read the fulfillment channel on every Amazon order: FBM orders need a delivery order from your warehouse, FBA orders a move out of the Amazon location.
Top tip
Set the Odoo Internal Reference equal to the Amazon SKU before you sync the first order, whichever route you choose. Every order that lands on a generic fallback product is an order whose stock and margin you will fix by hand.
How to set up an Odoo Amazon integration, step by step
- Check edition, version and hosting. Enterprise or Community, Odoo Online or Odoo.sh or self-hosted decides which routes are open.
- Try the official connector first if you are on Enterprise, and note what it does not cover.
- Clean up product data. One Odoo variant per Amazon SKU, internal references set, taxes or fiscal positions configured per marketplace.
- Register an SP-API application if you go custom. A private developer app under your own seller account, with only the roles you need.
- Import orders idempotently. Fetch by last update time, key on the Amazon order ID, and confirm orders quickly so Odoo reserves the stock.
- Send FBM shipments and stock. Confirm shipments with carrier and tracking when the picking is validated. Push stock changes in batches, not one call per SKU, to stay within rate limits (what HTTP 429 means).
- Add FBA and finance. Reconcile the Amazon location against Amazon's inventory data, and post settlement reports to accounting.
- Monitor. Alert when orders stop arriving or shipments fail.
Common mistakes in Odoo Amazon projects
- Internal references that do not match SKUs. Orders fall back to Amazon Sale, and stock never moves.
- Two systems importing orders. The official connector plus a module or script produces duplicate sales orders.
- Sending on-hand stock.
qty_availableignores reservations; use free quantity and a buffer. - Treating the FBA location as self-maintaining. Orders reduce it, but replenishment needs pickings or inventory adjustments, and removals or lost units are not part of the connector's documented features.
- Missing tracking references. Amazon rejects FBM shipments without one, and carrier names with typos are not recognized.
- Upgrading Odoo without checking the module. Apps Store modules are version-specific.
FAQ
Is the Odoo Amazon Connector free?
It is included in Odoo Enterprise, and Odoo's product page calls it free. You need an Enterprise subscription and a paid Amazon seller account. It is not available in Odoo Community.
Does the Odoo Amazon Connector support FBA?
Yes. It imports shipped and cancelled FBA orders and records stock moves out of an Amazon location. Inbound shipments are created by hand, and lot or serial tracked products need a kit workaround.
Can the Odoo Amazon Connector create listings or update prices?
No. Its documented features cover orders, customers, FBM shipments and FBM stock. Listings and prices need an Apps Store module or a custom integration using the Listings Items API.
Can I connect several Amazon seller accounts to Odoo?
Yes. The official connector supports several seller accounts and several marketplaces per account. By default, all accounts of a company share one Amazon stock location.
Need help with your Odoo Amazon integration?
We build and maintain Amazon integrations for Odoo and other ERPs: orders, FBA and FBM stock, listings, prices and settlements. See our Amazon SP-API integration service and marketplace ERP integration service, or book a free 30-minute call below and tell us about your Odoo setup. You will talk to the engineer who would build it.