接 Etsy：拉订单进来，推履约出去
在 Etsy 店铺后台网址里找到数字 Shop ID，在 Etsy Developers 复制 API Key，连同 OAuth 访问令牌一起填进 Integration，测试、配 Mapping、激活——订单流进来，履约流回去。
Etsy 连接器把您 Etsy 店铺的订单拉进 OMS，再把履约推回 Etsy。它还能推产品与库存，让两边的商品、库存与发货保持同步。
前置条件#
- 一个 Etsy 店铺，且能进店铺后台查看店铺后台网址。
- 能进 Etsy Developers → Your apps，那里显示您应用的 API Key（KEYSTRING）。
- 能为该店铺完成 OAuth 授权流程——访问令牌只能在该流程完成后获取。
拿凭证#
- 找 Shop ID：打开 Etsy 店铺后台，看店铺后台网址——Shop ID 是网址中的数字 ID，例如 12345678。只复制数字，不要复制店铺名。
- 复制 API Key：去 Etsy Developers → Your apps → 复制您应用的 API Key（KEYSTRING）。妥善保存——之后要填进 Integration 的 API key 字段。
- 拿 OAuth 访问令牌：为您的店铺完成 OAuth 授权流程，然后复制流程完成后获取的访问令牌。之后要填进 Integration 的 OAuth access token 字段。
填进 Integration#
- 打开 Integration → 连接器市场 → Etsy → 新建连接。
- Shop ID：填 Etsy 店铺后台网址中的数字 ID，例如 12345678。不要填店铺名——这个字段只填数字。
- API key——必填：粘贴从 Etsy Developers → Your apps 复制的 API Key（KEYSTRING）。加密存储，永不回显。
- OAuth access token：粘贴 OAuth 授权流程完成后获取的访问令牌。它必须与上面的 Shop ID 是同一家店铺——别家店铺的令牌对不上。
测试连接#
点测试连接。测试会一起校验 Shop ID、API Key 与 OAuth 访问令牌，再拉一个真实订单做单据级预览，展示“平台字段 → 标准订单”对照。店铺里还没有订单时，先在 Etsy 里下一个测试订单——预览需要一条真实单据。测试失败时先记下报错，对照下方常见问题排查，不要先改其他设置。
配 Mapping / 选模板#
选 Etsy 标准模板。它映射订单号、行 SKU、数量、收货地址、履约状态。激活前先用一个真实订单看映射预览——重点确认每个 Etsy SKU 都配到了 OMS 产品，让订单、产品与库存两边对齐。
激活#
激活后，Integration 按您设的频率拉新订单，把带追踪号的履约推回 Etsy，并把产品与库存变化推到 Etsy。先在 运行监控 / 日志里盯几单，确认无误再放手跑。
常见问题#
测试失败：找不到店铺
Shop ID 填错了。最常见是把店铺名填了进去，而不是数字 ID，系统按这个值找不到任何真实店铺。
打开 Etsy 店铺后台，读店铺后台网址中的数字 ID（例如 12345678），把 Shop ID 字段改成只填这个数字，再重新测试。
测试报 API 凭证错误
API Key 与您的应用对不上。复制时不完整、多了空格，或是 Etsy Developers 里另一个应用的 Key，Etsy 拒绝了调用。
去 Etsy Developers → Your apps，把正确应用的 API Key（KEYSTRING）原样再复制一次，不带多余空格地粘贴到 API key 字段，再重新测试。
授权已过期
OAuth 访问令牌已失效。它背后的授权已经过期，需要该令牌的调用会被拒绝，直到店铺重新授权。
为同一家店铺重新完成 OAuth 授权流程，复制流程完成后获取的新访问令牌，替换 OAuth access token 字段，再重新测试。
连接成功但拉不到订单
连接本身没问题。只是店铺在拉单范围内没有新订单，暂时没有可拉的单据。
在 Etsy 店铺下一个测试订单，确认下单时间落在拉单范围内，再手动拉一次，在预览或 运行监控 / 日志里确认订单出现。