Shopify生产商

此连接器回填Shopify产品、客户、订单和退款。它 获取产品、购物车、客户、订单和退款事件 POST /webhooks/shopify.

配置

使用商家拥有的Shopify应用程序。应用程序需要 read_products， read_customers, read_orders． 没有 read_all_orders、Shopify退货 只有最近60天的订单和他们的退款。webhook的秘密不是 应用客户端秘密。

设置

创建一个 Dev Dashboard应用 与商店在同一个Shopify组织中。添加上面的示波器，安装 应用程序，并使用其客户端ID和客户端秘密。

请求访问受保护的客户数据，包括姓名、电子邮件、电话和地址。这个 没有它，配置检查将失败。

在Shopify管理中创建这些webhook：

• products/create
• products/update
• products/delete
• carts/create
• carts/update
• customers/create
• customers/disable
• customers/enable
• customers/update
• customers/delete
• customers/purchasing_summary
• customers_email_marketing_consent/update
• customers_marketing_consent/update
• customer.tags_added
• customer.tags_removed
• orders/create
• orders/updated
• orders/delete
• refunds/create

告诉他们 /webhooks/shopify 并使用webhook签名值为 SHOPIFY_WEBHOOK_SECRET。选择webhook API版本 2026-07，就是那个 连接器的用途。

数据

• 客户、订单和退款持有受保护的客户数据，如姓名、 电子邮件、电话、地址和笔记。将这些表视为客户数据。
• 当前订单总额包括退款。
• Order webhook被映射而不需要重新抓取。如果Shopify截断行项目 在非常大的订单中，webhook行可能会漏行。
• 退款行并不意味着付款已完成。检查其交易 的地位。
• 退款使用 processedAt 的版本。以后的和解可能会错过，如果 Shopify保持相同的时间。
• 在回填之后，更新依赖于webhook。错过的webhook交付则不是 恢复。

演示数据

pnpm demo --size 128MiB 在没有Shopify的情况下写入编造的Shopify数据 凭证。有关标志和变量，请参阅Connector Kit README 的需求。

每个顾客都有订单、退款，有时还有一个开放的购物车。订单和购物车 使用固定的10种产品目录，它不会随着规模的增长而增长。

地方发展

cd connectors/producer-shopify
pnpm sandbox

承载运行从 AIRFOIL_CONFIG_PATH。它还需要 Connector Kit README中的Wings和PostgreSQL变量。

cd connectors/producer-shopify
pnpm start