# @useairfoil/producer-shopify 中文文档

规范地址：https://npmcn.com/package/%40useairfoil/producer-shopify/

版本：0\.2\.2
npm 元数据更新时间：2026-11-02T18:47:50.767Z
中文译文更新时间：2026-11-02T19:32:57.541Z
软件包许可：未声明

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40useairfoil/producer-shopify
原文对照：https://npmcn.com/package/%40useairfoil/producer-shopify/?lang=original
项目主页：https://github.com/useairfoil/connector-kit#readme
源码仓库：https://github.com/useairfoil/connector-kit

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：837 kB，45 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：4 个
- 首次发布：2026-08-13T16:58:53.372Z
- 最新版本发布：2026-11-02T18:47:50.334Z
- 已发布版本数：5（近 12 个月 5 个）

## 中文简介

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

## 安装

```sh
npm install @useairfoil/producer-shopify
```

也可以使用：`pnpm add @useairfoil/producer-shopify`、`yarn add @useairfoil/producer-shopify`、`bun add @useairfoil/producer-shopify`

## README

# Shopify生产商

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

## 配置

| 变量 | 要求 | 默认的 |
| --- | --- | --- |
| `SHOPIFY_SHOP_DOMAIN` | 是 | 无 |
| `SHOPIFY_CLIENT_ID` | 是 | 无 |
| `SHOPIFY_CLIENT_SECRET` | 是 | 无 |
| `SHOPIFY_WEBHOOK_SECRET` | 是 | 无 |

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

## 设置

创建一个 [Dev Dashboard应用](https://shopify.dev/docs/apps/build/dev-dashboard/get-api-access-tokens?lang=node) 与商店在同一个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种产品目录，它不会随着规模的增长而增长。

## 地方发展

```bash
cd connectors/producer-shopify
pnpm sandbox
```

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

```bash
cd connectors/producer-shopify
pnpm start
```

## 常见问题

### @useairfoil/producer-shopify 是什么？

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

### 如何安装 @useairfoil/producer-shopify？

在项目目录运行 npm install @useairfoil/producer-shopify，或使用 pnpm add / yarn add / bun add。

### @useairfoil/producer-shopify 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @useairfoil/producer-shopify 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @useairfoil/producer-shopify 可以商用吗？

@useairfoil/producer-shopify 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @useairfoil/producer-shopify 还在维护吗？

最新版本 0\.2\.2 发布于 2026/11/03（今天）；至今共发布 5 个版本，其中过去 12 个月发布了 5 个；首次发布于 2026/08/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。