接 Shopify：拉订单进来，推履约出去
最后更新 2026-11-01
在 Shopify 后台建自定义应用，把 Admin API token 填进 Integration，测试、配 Mapping、激活——订单流进来，履约流回去。
Shopify 连接器把您 Shopify 店铺的订单拉进 OMS，再把库存和履约推回 Shopify。一个店铺一个连接：每个店铺有自己的 token。
前置条件#
- 一个任意套餐的 Shopify 店铺，且有后台管理员权限。
- 在该店铺有创建自定义应用的权限。
- 第一次连接先用测试店 / 开发店验证——不要在正式店铺上试 Mapping。
拿凭证——新版模型（推荐）#
- 去 Shopify Dev Dashboard（dev.shopify.com）→ 您的应用 → API 凭证。
- 复制 Client ID 和 Client Secret。Secret 只显示一次，妥善保存。
- 确认应用有连接器需要的 API 权限：read_orders、read_products、read_inventory、write_inventory、read_fulfillments、write_fulfillments。
拿凭证——老版模型（自定义应用 token）#
- 在 Shopify 后台：Settings → Apps → Develop apps → Create an app。
- 在 Admin API integration 里勾选连接器需要的权限：read_orders、read_products、read_inventory、write_inventory、read_fulfillments、write_fulfillments。
- 安装应用，然后复制 Admin API access token（以 shpat_ 开头）。
Admin API token 只显示一次。丢了就卸载重装应用拿新的——旧 token 会失效。
新版 token 模型（Dev Dashboard 应用）：Shopify 不再发永久 shpat_ token。改为填 Client ID + Client Secret（Dev Dashboard → 您的应用 → API 凭证）——系统自动换取 24 小时访问令牌并在后台保持有效。已存 shpat_ token 的老连接继续可用。
填进 Integration#
- 打开 Integration → 连接器市场 → Shopify → 新建连接。
- 店铺域名：您的店铺域名，如 your-store.myshopify.com。
- 凭证——两种模型二选一。新版（推荐）：Dev Dashboard → 您的应用 → API 凭证里的 Client ID + Client Secret；系统自动换取 24 小时 token 并后台续期。老版：自定义应用的 Admin API access token（shpat_ 开头）。两种都加密存储，永不回显。
测试连接#
测试分两级：连通性（token 能用）+ 单据级预览（真实拉一个订单，展示"平台字段 → 标准订单"对照）。店铺里还没有订单时，先在 Shopify 里建一个测试订单——预览需要一条真实单据。
配 Mapping / 选模板#
选 Shopify 标准模板。它映射订单号、行 SKU、数量、收货地址、履约状态。如果卖组合包或用自定义行属性，激活前先在映射预览里核对这些字段。
激活#
激活后，Integration 按您设的频率拉新订单，把库存变化推回 Shopify，并回传带追踪号的履约。先在 运行监控 / 日志里盯几单，确认无误再放手跑。
常见问题#
测试报 401
token 错了、过期了、或缺权限。
重装应用重新复制 token，再核对拿凭证一步里的权限。
拉不到订单
连接没问题，只是店铺没有新订单。
在店铺里建一个测试订单，再手动拉一次。
SKU 显示未映射
渠道 SKU 还没有配到 OMS 的产品。
去产品映射的待处理页，把每个渠道 SKU 配到 OMS 产品。