Shopify
商品 · 市场 · 订单 · 客户
CATALOG
商品与发布
Product→Variant / Media→Catalog
渠道与市场可见性由 Catalog / Publication 控制，不是创建商品后自动全渠道展示。按 Shopify 对象建模
不是同步四张表，而是处理四组对象
Shopify 把商品、库存、履约和客户数据拆成不同对象与权限。先确认谁能写、写到哪个对象、发生冲突时谁优先，才不会覆盖数据或重复履约。
带着系统清单沟通 ↗INVENTORY
库存与地点
InventoryItem×Location→InventoryLevel
外部系统可调整 available 等数量；订单占用的 committed 状态由 Shopify 管理。FULFILLMENT
订单与履约
Order→FulfillmentOrder→Fulfillment / Return
一个订单可能拆成多个配送组或履约单，不能只按订单号假设一次发货。PRIVACY
客户与隐私
Customer→Consent→CRM / Marketing
读取客户或订单数据需要相应 scope；公开应用还必须处理查询与删除类合规 Webhook。连接路径
平台不同，连接策略也不同
不为了“全都能接”而堆工具。能用官方渠道就优先官方渠道，需要跨平台集中管理再使用连接器，业务规则无法表达时才进入定制接口。
销售渠道与 Markets
先区分“引流到官网”和“渠道内下单”
Google、Meta 等引流型渠道要求落地页商品与价格保持一致；TikTok Shop 等下单型渠道可按 Channel Market 配置独立目录、可售范围、价格与币种。
Google · YouTube · Meta · TikTok Shop
Sales Channels + Markets↗
Marketplace
Marketplace Connect 解决发布，不替代平台规则
Shopify 官方 Marketplace Connect 可向 Amazon、Walmart 等平台发布商品并集中处理订单；账号资格、Listing 字段、币种、配送和退货仍需逐平台核对。
Amazon · eBay · Walmart
Marketplace Connect / App↗
运营与业务系统
ERP、WMS、CRM 接入前，先指定每类数据的主系统
库存按 InventoryItem × Location 对应 InventoryLevel；订单按 FulfillmentOrder 回传履约；客户数据按授权范围、同意状态和隐私删除请求处理。
ERP · PIM · WMS · 3PL · CRM · BI
GraphQL Admin API + Webhooks↗
ProductVariantMediaMarket
OrderFulfillmentRefund
ConsentEventAttribution
以 Shopify 官方约束为设计输入
对象、权限和事件机制，决定集成能否稳定运行
连接器的 Logo 只能说明“可能支持”。真正需要核对的是 Shopify 对象模型、应用访问范围、GraphQL 查询成本，以及 Webhook 的重复、乱序和漏失处理。
- 对象边界Product / Variant / Catalog、InventoryLevel / Location、Order / FulfillmentOrder 分别映射
- 权限与容量采用最小 access scopes；GraphQL 按查询成本限流，单次查询成本上限为 1,000 点，数组输入最多 250 项
- 事件与恢复校验 HMAC、用 Webhook ID 去重；按时间戳处理乱序，并定期通过 API 对账补漏
Webhook 不是数据库镜像：Shopify 不保证事件顺序，也建议用定期 reconciliation 对账。接口设计必须包含幂等、重试、补数和人工兜底。
实施路径
三步把“能连接”变成“能长期运行”
01
列出对象与主系统
逐项确认商品、库存地点、订单履约和客户数据由谁创建、谁能修改。
02
验证权限、容量与异常
测试 access scopes、查询成本、批量边界、状态映射、重复事件和失败回退。
03
建立对账与版本机制
监控 Webhook、定时补数、保留人工重放入口，并按稳定 API 版本持续升级。