Odoo eBay 连接器：列表、订单和库存同步

eBay 仍然是全球最大的市场之一，在全球拥有 1.32 亿活跃买家。对于同时使用 eBay 和 Odoo 19 Enterprise 的卖家来说，管理两个独立的订单、库存和客户数据系统效率低下且容易出错。 ECOSIRE Odoo eBay 连接器将您的 eBay 商店与 Odoo 同步，自动执行从列表创建到订单履行和售后会计的整个销售工作流程。

本指南涵盖了从 eBay API 凭证设置到列表管理、订单自动化、库存同步、退货处理和卖家绩效监控的所有内容。

要点

• 连接器使用 eBay REST API 和 OAuth 2.0 进行身份验证
• 支持 eBay Motors、eBay Business & Industrial 以及消费者类别
• 支持固定价格和拍卖列表（仅适用于拍卖的订单导入）
• Odoo 库存变化后 10 分钟内库存同步更新 eBay 数量
• 当数量达到 0 时，eBay 的缺货 (OOS) 设置会自动管理
• 订单导入包括买家详细信息、运输要求和 eBay 结账金额
• 退货和 eBay 退款保证案例同步到 Odoo RMA 工作流程
• 多商店支持：从一个 Odoo 实例管理多个 eBay 卖家帐户

---

eBay API 设置和授权

该连接器使用 eBay 的 REST API 套件，取代了大多数操作的旧版交易 API。

第 1 步：创建 eBay 开发者帐户

1. 在developer.ebay.com处注册
2. 在“我的帐户”→“应用程序密钥集”下创建一个新应用程序 3.记下您的应用程序 ID（客户端 ID）、开发 ID 和 证书 ID（客户端密钥）
3. 为 OAuth 流程生成 RuName（eBay 重定向 URL 名称）

步骤 2：配置 OAuth 范围

您的应用程序需要以下 OAuth 范围：

https://api.ebay.com/oauth/api_scope
https://api.ebay.com/oauth/api_scope/sell.inventory
https://api.ebay.com/oauth/api_scope/sell.inventory.readonly
https://api.ebay.com/oauth/api_scope/sell.fulfillment
https://api.ebay.com/oauth/api_scope/sell.fulfillment.readonly
https://api.ebay.com/oauth/api_scope/sell.account
https://api.ebay.com/oauth/api_scope/sell.account.readonly
https://api.ebay.com/oauth/api_scope/commerce.identity.readonly

第3步：生成用户令牌

卖家操作需要 OAuth 2.0 用户令牌（不是应用程序令牌）：

1. 在连接器配置中，单击 通过 eBay 授权
2. 完成 eBay OAuth 同意流程
3. 连接器自动存储访问令牌和刷新令牌
4. 代币在18个月后过期；连接器使用刷新令牌自动刷新

沙盒与生产

始终首先使用 eBay 的沙箱环境进行测试：

• 沙箱 API：api.sandbox.ebay.com
• 沙箱凭证与生产凭证不同
• 在 developer.ebay.com/sandbox 创建沙箱卖家和买家帐户

---

连接器安装和配置

从 ECOSIRE 市场安装：

1. 从ECOSIRE产品购买eBay连接器模块 2.通过应用程序安装→更新应用程序列表→搜索“eBay Connector”→安装
2. 导航至 库存 → 配置 → eBay 商店 或 销售 → eBay

商店配置：

履行政策：

上市前，在卖家中心配置 eBay 履行政策：

• 运输政策：承运商、预计交货时间、处理时间
• 退货政策：30 天退货，退货费
• 付款政策：自 2021 年起要求由 eBay 管理付款

连接器通过策略 ID 引用这些内容。在商店设置中链接它们。

---

列表管理

该连接器支持直接从 Odoo 产品记录创建和管理固定价格列表。

从 Odoo 产品创建列表：

1. 打开产品表单 → eBay 选项卡
2. 点击 在 eBay 上列出
3. 配置列表字段：

• 标题：最多 80 个字符，根据产品名称自动填充
• 类别：选择 eBay 类别（按关键字或 ID 搜索）
• 状况：全新、二手、零件/不工作等。
• 价格：使用产品价目表或覆盖价格
• 数量：可用库存或定制数量
• 持续时间：建议固定价格使用 GTC（取消前有效）
• 项目细节：eBay 所需的类别属性

4. 单击发布到 eBay

列表模板：

对于拥有许多同一类别产品的卖家，创建列表模板：

• 导航至 eBay → 模板 → 创建模板
• 配置共享字段：类别、运输、退货政策、商品详情
• 同时将模板应用于多个产品

批量列表：

对于包含 100 多种产品的目录：

1. 将产品列表导出为包含 eBay 必填字段的 CSV
2. 使用eBay批量导入→批量刊登→上传CSV 3、批量审核发布

列表同步：

Odoo 中所做的更改同步到 eBay：

• 价格变动 → eBay 价格在 15 分钟内更新
• 产品描述更改 → eBay 列表在下次同步时更新
• 图片更改→ eBay 图片更新（需要重新列出某些更改）

eBay 类别商品详情：

eBay 需要特定类别的属性（例如服装的品牌、尺码、颜色）。连接器将 Odoo 产品属性映射到 eBay 商品细节：

---

订单同步

订单导入流程：

订单自动从 eBay 流向 Odoo：

1.买家在eBay下单并完成结账 2. eBay创建“等待发货”状态的订单 3. 连接器每 15 分钟轮询一次 eBay Orders API（可配置） 4. Odoo 使用来自 eBay 的买家详细信息创建 sale.order 5.自动创建交货单 6. 仓库履行订单并验证交货 7. 连接器将追踪号码发送回 eBay 8. eBay 将订单标记为“已发货”

订单数据映射：

发送跟踪信息：

当您在 Odoo 中验证交货并输入追踪号码时：

1. 连接器检测库存上的跟踪编号。 2.调用eBay的Order Fulfillment API来添加跟踪
2. 买家收到包含跟踪详细信息的 eBay 通知
3. eBay将订单状态更新为“已发货”

支持自动跟踪更新的承运商：USPS、UPS、FedEx、DHL、皇家邮政、德国邮政以及 eBay 承运商代码列表中的 100 多家其他承运商。

---

库存同步

准确的库存可防止 eBay 出现缺货情况的“缺陷”指标。

库存同步机制：

连接器使用 eBay 的 Inventory API 并具有以下逻辑：

eBay Quantity = Odoo On-Hand - Safety Stock Buffer - Odoo Reserved Quantity

库存同步时：

• 每次确认交货订单后（立即）
• 每次验证收据后（立即）
• 计划每 30 分钟一次完全同步
• 随时可以手动同步

缺货处理：

配置数量达到 0 时发生的情况：

• 选项 A：OOS 模式（Odoo 推荐）：使用 eBay 的“缺货”选项以 0 数量保持列表活跃 — 列表保留其历史记录和评论
• 选项 B：结束列表：当库存达到 0 时从 eBay 删除列表，并在重新进货时重新列表
• 选项 C：设置最小值：设置最小数量（例如 1），并仅在触发 OOS 最小值时在 Odoo 中转到 0

结束和重新列出经常会损害 eBay 的搜索排名。推荐OOS模式。

多地点库存：

如果从多个仓库发货：

• 在商店设置中设置 eBay 的主仓库
• 或汇总多个仓库的库存
• 如果某些 SKU 从特定位置发货，则按产品进行配置

---

退货和退款处理

eBay 的退款保证意味着卖家必须接受退货。连接器处理 Odoo 中的返回工作流程。

返回同步工作流程：

1. 买家在 eBay 中提出退货请求
2. 连接器将退货案例作为 RMA（退货授权）导入 Odoo
3. 运营团队在Odoo中审核退货原因
4. 如果接受：生成退货运输标签（如果提供预付费标签）
5. 买家退回物品
6. 在 Odoo 中接收退货 → 验证收据
7. 处理退款：在 Odoo 中创建贷方票据 → 连接器触发 eBay 退款

跟踪的退货案例状态：

---

eBay 卖家绩效监控

eBay 根据直接影响列表可见性的指标来评估卖家。在 Odoo 中监控它们：

关键 eBay 卖家指标：

Odoo 中的性能仪表板：

导航至 eBay → 性能可查看：

• 过去 30 天内按状态列出的订单
• 延迟发货（订单在处理时间后发货）
• 按类别划分的退货率
• 带有订单 ID 的缺陷摘要
• 下次评估的预计卖家级别

---

定价和促销

自动定价规则：

根据 Odoo 成本数据配置动态 eBay 定价：

eBay Price = Product Cost × (1 + Target Margin %) + eBay Fee Buffer

示例：如果成本为 10 美元，目标利润为 40%，eBay 费用通常为 12.5%：

eBay Price = $10 × 1.40 / (1 - 0.125) = $16.00

降价促销：

该连接器支持 eBay Promotions Manager 集成：

• 在 Odoo 中创建销售 → 连接器创建相应的 eBay 促销
• 闪购、订单折扣和运输促销
• 预定促销：在 Odoo 中配置的开始和结束日期

---

常见问题

连接器是否支持 eBay 拍卖列表？

连接器从拍卖列表中导入订单，就像固定价格列表一样。然而，通过连接器创建和管理拍卖列表（设置起始价、底价、持续时间）是有限的 - 拍卖最好直接在 eBay 卖家中心进行管理。连接器的主要列表管理功能适用于固定价格/GTC 列表。

连接器如何处理 eBay Managed Payments（eBay 的付款处理）？

自 2021 年起，eBay 通过 eBay 管理的付款方式处理所有付款。连接器导入订单总计，包括 eBay 的结帐价格（商品价格 + 运费）。 eBay 将净收益（扣除费用后）汇入您的银行账户。该连接器支持导入 eBay 付款报告以进行对账，自动创建日记帐分录，以说明从付款中扣除的 eBay 费用。

我可以将产品从 Odoo 同步到多个 eBay 商店（不同的卖家帐户）吗？

是的。创建多个 eBay 商店配置，每个配置都有自己的 OAuth 凭据。产品可以同时在多个商店上列出，并具有商店特定的定价覆盖。 Odoo 中对库存进行全局跟踪，并根据配置的规则分配到每个商店的列表。

当我更新列表时，我的 eBay 列表历史记录（评论、销售计数）会发生什么变化？

标准列表更新（价格、数量、描述、图像）保留列表历史记录和销售数量。重置历史记录的操作：结束和重新列出、更改某些类别的 eBay 类别。连接器使用 eBay Inventory API 的“更新报价”端点进行例行更改，从而保留历史记录。

连接器如何处理国际 eBay 销售和海关要求？

对于通过 eBay 国际运输或 GSP（全球运输计划）进行的跨境销售，连接器会在销售订单上标记买方所在的国家/地区。您可以在 Odoo 中为国际销售配置适当的财务状况和税务处理。 GSP 订单运送至 eBay 的国内履行中心；海关文件由 eBay 的 GSP 计划处理，而不是由您的运营部门处理。

---

后续步骤

通过 Odoo 管理 eBay 运营可以消除手动数据输入、防止库存错误，并为您提供所有销售渠道的单一事实来源。 ECOSIRE eBay 连接器专为 Odoo 19 Enterprise 构建，完全支持 eBay 最新的 REST API。

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

每次购买都包括模块许可证、设置文档以及我们的实施支持团队的访问权限，以便您的 eBay-Odoo 同步从第一天起顺利运行。