Odoo Etsy 连接器：手工商务集成

Etsy 拥有超过 900 万活跃卖家，并提供其他市场无法复制的利基市场：手工制作、复古和工艺品供应商品。对于已经超越基本电子表格跟踪的 Etsy 卖家，Odoo 19 Enterprise 提供了规模化工艺品业务所需的库存管理、财务会计和生产计划功能。

ECOSIRE Odoo Etsy 连接器将您的 Etsy 商店与 Odoo 连接起来，同步列表、订单、库存和客户数据。本指南涵盖了从 Etsy API 凭证设置到生产订单管理和 Etsy 卖家报告的完整集成。

要点

• 连接器使用带有 OAuth 2.0 身份验证的 Etsy API v3
• 列表双向同步：在 Odoo 中创建，发布到 Etsy
• 订单导入包括买家详细信息、商品定制说明和礼品包装标志
• Odoo 库存变化后 5 分钟内将库存推送至 Etsy
• 生产订单 (MRP) 集成跟踪按订单生产的手工制品
• Etsy 费用和付款处理费根据 Odoo 发票自动核对
• 支持多个商店：从一个 Odoo 实例管理多个 Etsy 商店
• Etsy 的列表更新（每个列表自动更新 20 美分）在 Odoo 成本中跟踪

---

为什么 Etsy 卖家需要 Odoo 集成

Etsy 的内置商店管理器可以处理基本的订单跟踪，但缺乏不断发展的手工企业所需的深度：

对于月收入超过 10,000 美元或管理 50 多个手工和材料活跃 SKU 的卖家，Odoo 提供可随业务扩展的运营能力。

---

Etsy API 设置

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

1. 转到 developers.etsy.com 并使用您的 Etsy 卖家帐户登录
2. 单击“我的应用程序”下的“创建应用程序”
3. 为您的应用程序命名（例如“Odoo Integration”）并描述其用途
4. 接受 Etsy API 服务条款
5. Etsy 将审核您的申请（通常 1-3 个工作日）

步骤 2：配置 OAuth 范围

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

listings_r      — Read active listings
listings_w      — Create/edit listings
listings_d      — Delete listings
transactions_r  — Read orders and transactions
transactions_w  — Update order status
shops_r         — Read shop data
billing_r       — Read payment and billing data

步骤 3：生成 API 凭证

批准后：

• API密钥（Keystring）：您的应用程序标识符
• 共享秘密：用于 OAuth PKCE 流程
• 重定向 URI：https://your-odoo.com/etsy/oauth/callback

第4步：完成OAuth授权

从 Odoo 中的连接器配置：

1. 点击 连接 Etsy 商店
2. 在 Etsy OAuth 弹出窗口中授权连接器
3. 连接器接收并存储您的访问令牌和刷新令牌

Etsy 的 OAuth 令牌不会在固定时间限制内过期（与 Amazon 的 18 个月刷新令牌不同）。它们一直有效，直到您撤销它们为止。

---

连接器安装和配置

从 ECOSIRE 市场安装：

可在 ECOSIRE 产品 处购买。购买后： 1.通过Apps上传并安装Etsy Connector模块 2. 导航至 库存 → Etsy 或 销售 → Etsy 商店

店铺配置：

Etsy 商店部分映射：

Etsy 将列表组织成商店部分（相当于类别）。将 Etsy 部分映射到 Odoo 产品类别：

---

列表管理

从 Odoo 产品创建 Etsy 列表：

1. 打开产品表单 → Etsy 选项卡 → 创建列表
2. 配置列表特定字段：

• 标题：最多 140 个字符，关键字丰富，适合 Etsy SEO
• 描述：包含材料、尺寸、保养说明的完整描述
• 标签：最多 13 个标签，对于 Etsy 搜索算法至关重要
• 类别：浏览 Etsy 的分类树
• 谁制作的：我制作的，我商店的成员，其他人
• 何时制造：定制，2020–2025、2010–2019 等。
• 类型：实体项目、数字下载
• 价格：标价（可能与 Odoo 的标价不同）
• 数量：可列出的可用库存
• 材料：最多 13 个材料标签
• 照片：最多 10 张照片（第一张图片成为主要列表图片）

3. 单击 发布到 Etsy

变体列表（产品变体）：

Etsy 支持“变体”——Odoo 将这些变体映射到产品属性：

示例：尺寸为 5-10 的金/银戒指会创建一个包含 12 种变体组合的 Etsy 列表，每种组合都有自己的价格和库存跟踪。

个性化和定制订单列表：

Etsy 以个性化商品而闻名。在连接器中配置个性化：

• 在列表中启用个性化必需/可选
• 买家在结账时输入个性化文本（姓名、日期、字母组合）
• 此文本出现在 Odoo 销售订单的客户注释字段中
• 制作团队在制作物品时看到定制

---

订单同步

订单导入详情：

Etsy 订单包括对手工卖家至关重要的字段：

按订单生产的订单路由：

Etsy 卖家通常会在收到订单 (MTO) 后制作商品。配置连接器：

1. 在产品设置→销售选项卡→按需：“按订单生产”
2. 导入 Etsy 订单时，Odoo 会创建：

• 销售订单（已确认）
• 与销售相关的制造订单（草稿）
• 制造订单显示所需材料和劳动时间

3. 生产团队根据制造订单进行工作
4. MO完成后，货物到货→确认发货
5. 货件详细信息发送回 Etsy

定制订单处理：

对于自定义佣金（未在 Etsy 上列出）：

1. 在Etsy中接受定制订单
2. 在 Odoo 中，以约定的价格手动创建“自定义产品”销售订单
3. 订单备注中的 Etsy 对话链接
4. 手动或通过连接器的自定义订单工具在 Etsy 中标记为已发货

---

库存同步

对于实体产品：

默认情况下，库存同步每 5 分钟运行一次。当 Odoo 库存变动时：

1. 重新计算可用数量（现有量减去预留量）
2. 通过 Listing Inventory API 推送到 Etsy 的数量 3.如果数量达到0：列表设置为售完（保持列表活跃）
3. 补货时：自动重新激活列表

对于定制产品：

MTO 产品不跟踪传统意义上的实际库存。将 Etsy 列表数量配置为生产能力指标：

• 设置代表当前订单容量的固定“可用数量”（例如 5）
• 当生产队列填满时手动调整

对于数字下载：

数码产品库存无限。连接器将 Etsy 数量设置为 999 并且从不同步库存更改。数字文件传输由 Etsy 的本机数字下载系统处理 - 连接器不涉及文件传输。

---

财务对账

Etsy 的支付处理和费用结构需要仔细的会计设置。

Etsy Payments 费用结构（仅供参考）：

• 列表费用：每个列表 0.20 美元（列表时收费，每 4 个月自动续订一次）
• 交易费用：商品价格的 6.5% + 运费
• 付款处理费：每笔交易 3% + 0.25 美元（美国）
• 站外广告费：Etsy 为您的商品做广告时收取 12-15%（如果已注册）

在 Odoo 中设置费用对账：

1. 创建专用 Etsy Payments 日记帐（银行类型）
2. 创建账户：

• Etsy Listing Fees（费用）
• Etsy Transaction Fees（费用）
• Etsy Payment Processing Fees（费用）
• Etsy Payments Receivable（当前资产）

3.导入Etsy付款报表：

• 导航至 Etsy → 付款 → 月结单 → 下载 CSV
• 导入到连接器的协调工具中
• 连接器为每种交易类型创建日记帐分录

月末对账流程：

1. 下载 Etsy 每月付款 CSV
2. 通过连接器导入：Etsy → 对账 → 导入声明
3. 查看自动匹配的条目
4. 手动匹配任何无法识别的交易
5. 确认对账 → 在 Odoo 中发布日记帐分录
6. 根据 Odoo 余额调节 Etsy Payments 银行账户

---

Etsy SEO 和绩效跟踪

列表性能同步：

连接器将 Etsy 商店统计数据导入 Odoo：

• 每个列表每天的浏览量
• 收藏计数
• 转化率（观看次数转化为销量）
• 上市收入

此数据显示在 Odoo 的 Etsy 分析仪表板中，使您可以识别表现最佳的列表和表现不佳的列表，而无需切换到 Etsy 的统计界面。

标签和关键字跟踪：

通过从 Etsy 的 Shop Stats API 提取统计数据来跟踪哪些搜索词推动了 Etsy 流量。使用此数据可以：

• 识别高转化标签以添加到类似列表中
• 查找浏览量高但转化率低的列表（定价或照片问题）
• 发现您的产品类别中的季节性趋势

---

常见问题

除了 Etsy 市场之外，连接器还可以处理 Etsy 的模式（自定义网站）吗？

不会。该连接器专门与 Etsy 市场集成。 Etsy Pattern（他们的托管网站构建器）共享相同的库存，但使用单独的结帐和付款处理。图案订单需要单独管理。对于功能齐全的网站集成，建议使用 Odoo 的网站模块或 Shopify 集成。

连接器如何处理 Etsy 的交易储备（Etsy 付款保留）？

Etsy 有时会为新卖家付款设置储备金，以进行风险管理。连接器跟踪每个订单的付款状态。预留金额显示在 Etsy Payments 余额中，但不可提取。连接器将这些发票标记为“待付款”，直到释放准备金，然后在资金释放到您的银行时更新为“已付款”。

我可以从一个 Odoo 实例管理多个 Etsy 商店（例如，一家珠宝店，一家家居装饰店）吗？

是的。使用独立的 OAuth 凭据为每个商店创建单独的 Etsy 商店配置。每个商店都有自己的订单导入、库存分配和付款对账设置。产品可以在多个商店中列出，并具有商店特定的定价覆盖。

连接器是否支持 Etsy 的批发/B2B 功能？

Etsy 没有本地批发/B2B 计划。如果您使用 Etsy 进行批发查询，但离线处理实际交易，连接器的处理方式与任何自定义订单相同 - 您可以使用商定的价格手动创建 Odoo 销售订单，并通过标准流程履行。

连接器如何处理国际 Etsy 销售和增值税/GST 要求？

Etsy 代表卖家为欧盟、英国、澳大利亚以及 Etsy 充当市场服务商的其他司法管辖区的买家收取和代缴增值税/商品及服务税。连接器以 0 美元税费导入这些订单（因为 Etsy 收取了税费）。对于您负责收税的市场，请根据买方所在的国家/地区在 Odoo 中配置适当的财务状况。

---

后续步骤

ECOSIRE Etsy 连接器将 Etsy 从独立市场转变为 Odoo 19 Enterprise 内完全集成的销售渠道。对于超出基本商店管理范围的手工制作企业来说，这种集成为可持续增长提供了运营支柱。

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

该连接器包括设置文档、历史订单数据导入工具以及实施支持，使您的 Etsy 商店与 Odoo 快速、正确地集成。