Odoo Amazon Connector：设置和多渠道销售

亚马逊占美国电子商务收入的近 40%，使其成为产品卖家的必备渠道。与核心 ERP 分开管理亚马逊订单、库存和配送会产生数据孤岛、对账难题和配送错误，从而造成高昂的成本。

ECOSIRE Odoo Amazon Connector 连接 Odoo 19 Enterprise 和 Amazon Seller Central，双向同步产品、订单、库存水平和履行状态。本指南涵盖了通过 Odoo 运行亚马逊销售的完整设置过程、数据映射配置、同步频率选项、错误处理和操作最佳实践。

要点

• 该连接器支持所有亚马逊市场（美国、英国、欧盟、日本、阿联酋等）
• 默认情况下，订单同步每 15 分钟运行一次；可配置低至 5 分钟
• 每次库存变动时，库存水平都会自动推送至亚马逊
• FBA 和 FBM（由商家配送）订单在单独的工作流程中处理
• 产品映射使用 ASIN、SKU 和 EAN/UPC 作为匹配键
• 失败的同步会记录错误详细信息，并且可以单独重试
• 定价规则可以覆盖基于 Odoo 价目表的亚马逊价格
• 连接器使用 Amazon SP-API（销售合作伙伴 API），替换已弃用的 MWS

---

先决条件和 Amazon SP-API 设置

该连接器使用亚马逊的销售合作伙伴 API (SP-API)。在安装连接器之前，您需要来自 Amazon 的 SP-API 凭证。

第 1 步：在亚马逊卖家中心注册成为开发者

1.登录卖家中心→应用程序和服务→开发应用程序 2.点击“添加新应用客户端”并完成开发者注册 3.亚马逊将审核您的申请（1-3个工作日批准）

步骤 2：创建 SP-API 应用程序

一旦获得批准：

1. 转到应用程序和服务 → 开发应用程序 → 您的应用程序
2. 点击“添加新的应用程序客户端” 3.选择IAM ARN（先创建AWS IAM用户）或使用OAuth
3. 将重定向 URI 设置为您的 Odoo 实例：https://your-odoo.com/amazon/oauth/callback
4. 选择所需的 API 范围：

• 订单API
• 报告API
• 列表API
• 目录项 API
• 亚马逊物流库存API
• 饲料API

第3步：授权您的卖家帐户

创建应用程序后，针对每个市场授权应用程序：

1. 复制应用程序的 LWA（通过 Amazon 登录）凭据
2. 转到连接器的授权 URL
3. 完成每个亚马逊商城账户的 OAuth 流程

您在 Odoo 中需要的凭据：

• LWA 客户端 ID
• LWA 客户端秘密
• 刷新令牌（在 OAuth 流程期间生成）
• AWS 区域（基于市场）

---

安装和配置连接器

安装 ECOSIRE Amazon 连接器模块：

该连接器可从 ECOSIRE 市场 获取。购买后：

1. 从您的 ECOSIRE 帐户下载模块 zip 文件
2. 上传到您的 Odoo 服务器：cp amazon_connector.zip /opt/odoo/addons/ 3.解压并安装：导航至应用程序→更新应用程序列表→搜索“Amazon Connector”→安装

初始配置：

导航至 库存 → 配置 → 亚马逊商城（或 销售 → 亚马逊 → 配置，具体取决于您的 Odoo 布局）。

单击 创建 以添加新的市场连接：

测试连接：

保存后，单击“测试连接”。成功的测试将返回您的商家名称并确认 API 访问。如果失败，请检查：

• LWA 凭证正确
• 刷新令牌尚未过期
• AWS 区域与您的市场相匹配
• SP-API 应用程序处于“已发布”状态（不是“草稿”）

---

产品映射和目录同步

连接器使用三种方法将 Odoo 产品映射到亚马逊 ASIN：

方法一：SKU匹配（推荐）

如果您的内部产品参考（SKU 代码）与您在亚马逊上使用的卖家 SKU 匹配，请在商城设置中启用 SKU 自动匹配。连接器会自动将 Odoo 产品链接到其亚马逊列表。

方法2：EAN/UPC匹配

连接器查询亚马逊的目录 API 以查找与您的商品条形码（EAN13 或 UPC）匹配的商品。这适用于亚马逊目录中列出的品牌产品。

方法 3：手动 ASIN 映射

对于定制产品或捆绑产品：

1. 转到产品表单 → 亚马逊 选项卡
2. 输入每个商城的 ASIN
3. 将变体映射到其特定的 ASIN

导入亚马逊目录：

不要一一映射，而是导入您的 Amazon 目录：

1. 转到 亚马逊 → 目录 → 导入列表
2. 选择市场
3. 连接器下载所有活动列表并创建/更新 Odoo 产品
4. 审查进口产品的现场测绘准确性

产品字段映射配置：

---

订单同步

订单自动从 Amazon 流向 Odoo。了解订单生命周期可以防止混乱和履行错误。

订单同步工作流程：

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)

订单同步设置：

处理取消订单：

当亚马逊取消订单时（客户取消或付款失败）：

1. 连接器在下次同步时检测到取消
2. 如果交货单未经过验证：则自动取消
3. 如果交货已验证：连接器创建退货 RMA
4. 发票被取消或冲销并附有贷项通知单

---

库存同步

实时库存准确性可防止超售，从而导致亚马逊卖家帐户受到处罚。

库存推送至亚马逊：

每次发生 Odoo 库存变动（交货、收货、退货、调整）时，连接器都会将更新的数量推送到 Amazon Inventory API：

• FBM 产品：Odoo 的现有数量减去安全库存缓冲
• FBA产品：亚马逊管理FBA库存； Odoo 通过 Amazon Inventory API 接收 FBA 级别

安全库存配置：

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

配置每个产品或全局的安全库存：

• 导航至产品 → 亚马逊选项卡 → 安全库存：5
• 或在全球市场设置中 → 默认安全库存：2

库存同步频率：

与订单同步（事件驱动+计划）不同，库存同步是基于批次的：

• 默认：每 30 分钟一次
• 任何股票变动后：5 分钟内（webhook 式）
• 高峰期之前：运行手动同步

多仓库库存：

如果从多个仓库发货： 1.为每个仓库创建单独的Amazon Marketplace配置 2. 连接器聚合所有链接仓库的库存 3. 或者：使用亚马逊的多地点库存功能以及仓库特定的数量分配

---

FBA（由亚马逊配送）集成

FBA 订单由亚马逊仓库履行，但 Odoo 仍需要了解它们以进行财务对账。

Odoo 中的 FBA 订单工作流程：

1.亚马逊接收并履行订单（Odoo没有履行角色） 2. 连接器在 Odoo 中创建一个标记为“FBA”的 sale.order 3. 交货单自动验证（Odoo 中无实际拣货） 4、虚拟“亚马逊FBA”仓位减少 5. 创建并过帐发票 6. 亚马逊汇款与发票对账

FBA库存管理：

通过 Odoo 将库存发送至亚马逊 FBA：

1. 在 Odoo 中创建 FBA 货件（或在卖家中心并链接）
2. 连接器创建从您的仓库到“Amazon FBA”位置的库存转移
3. 货物运送到亚马逊时验证转移
4. 在 Odoo 中跟踪 FBA 数量以用于报告目的

FBA费用调节：

亚马逊在汇款前扣除费用（配送、存储、推荐）。将连接器配置为：

• 导入亚马逊结算报告
• 自动创建亚马逊物流费用的日记账分录
• 根据未清发票核对净结算金额

---

定价管理

自动重新定价：

该连接器支持根据 Odoo 价目表规则自动更新 Amazon 价格：

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

配置：

• 导航至市场设置 → 定价
• 设置价格来源：价目表、成本+利润或固定
• 设置乘数（例如，相同价格为 1.0，15% 的加价为 1.15）
• 启用自动同步价格：在 Odoo 中更改价格时推送到亚马逊

货币处理：

对于非美元市场（欧元、英镑、日元），连接器：

1. 从市场特定的价目表中读取价格（如果已配置）
2. 或者使用 Odoo 的每日汇率从您的基础货币进行转换

---

错误处理和监控

同步错误日志：

导航到 Amazon → 同步日志 以查看所有同步操作：

• 绿色：同步成功
• 黄色：部分同步（部分记录失败）
• 红色：完全同步失败

每个错误条目显示：

• 时间戳和同步类型（订单、库存、列表）
• 来自亚马逊API的错误代码
• 受影响的记录ID
• 错误信息
• 重试按钮

常见错误和解决方案：

自动警报：

配置同步失败的电子邮件警报：

• 导航至市场设置 → 通知
• 添加电子邮件地址以通知同步错误
• 设置警报阈值：连续3次失败后通知

---

常见问题

连接器是否支持 Amazon FBA 多渠道配送 (MCF)？

是的。 MCF 允许您使用亚马逊的 FBA 库存来履行来自其他销售渠道（您的网站、其他市场）的订单。当收到来自非 Amazon 渠道的销售订单时，只要产品库存在 FBA 中，连接器就可以创建 MCF 履行请求。 MCF 订单在 Odoo 中通过 FBA 位置变动进行跟踪。

连接器如何处理亚马逊复杂的税务规则（VAT OSS、Marketplace Facilitator）？

对于亚马逊征税和代缴税款的商城（商城服务商规则，适用于美国大多数州和欧盟的非欧盟卖家），连接器会创建 0 美元税费的订单，因为亚马逊会处理纳税义务。对于非协调员的情况，连接器根据买家的送货地址应用 Odoo 中配置的财务状况。

我可以从一个 Odoo 实例管理多个亚马逊账户（不同的卖家账户）吗？

是的。创建多个市场配置，每个配置都有自己的 SP-API 凭据。您可以为不同的卖家账户、同一账户下的不同市场或多公司 Odoo 设置中的不同公司进行单独的配置。订单、库存和定价是根据市场配置进行管理的。

如果亚马逊在订单导入 Odoo 后更改订单，会发生什么情况？

连接器在每个同步周期检查订单修改。如果亚马逊更新订单（例如，发货前数量更改、地址更正），连接器会更新相应的 Odoo 销售订单（如果尚未确认）。对已确认订单的修改会创建系统警报以供人工审核。

连接器是否处理 Amazon A+ 内容或增强品牌内容？

不会。A+ 内容管理是专门通过卖家中心管理的营销内容。该连接器重点关注运营数据：订单、库存、定价和履行。产品内容（描述、图像）可以推送到亚马逊基本列表，但不能推送到 A+ 内容模板。

---

后续步骤

通过 Odoo 在亚马逊上销售比单独管理两个系统要高效得多 - 但连接器必须从一开始就正确设置。配置错误的产品映射、错误的库存同步设置或不正确的税务配置会造成随着时间的推移而加剧的问题。

ECOSIRE 的亚马逊连接器模块专为 Odoo 19 Enterprise 构建，我们的团队为通过 Odoo 管理亚马逊的市场卖家提供设置帮助、培训和持续支持。

获取适用于 Odoo 19 的 ECOSIRE Amazon 连接器 →

购买包括模块许可证、文档和 30 天的实施支持，让您的 Amazon-Odoo 集成从第一天起就正确运行。