---
title: "从用户的 Shopify 和 WooCommerce 店铺自动生成电商报表"
description: "自动生成电商报表：拉取每个商家的 Shopify 或 WooCommerce 订单和 Klaviyo 营销活动，写入 Notion。基于 AIsa Connect，每份报表的费用不到一美分。"
canonical: "https://aisa.one/zh/solutions/ecommerce-reporting"
---

# 每周自动给每个商家发一份店铺报表

> 自动生成电商报表：拉取每个商家的 Shopify 或 WooCommerce 订单和 Klaviyo 营销活动，写入 Notion。基于 AIsa Connect，每份报表的费用不到一美分。

商家连接一次店铺、Klaviyo 和 Notion，你的 Agent 拉取一周的订单和营销活动，把总结写进 Notion 页面，一份报表的费用不到一美分。

- 网页版：https://aisa.one/zh/solutions/ecommerce-reporting
- 适合谁：Agent 开发者和营销代理商
- 数据领域：AIsa Connect
- 基于 AIsa Connect 运行：[AIsa Connect](https://aisa.one/zh/products/connect)

## 从已连接的应用到 Notion 报表的四个请求

同一组请求按你的计划为每个商家运行，各自使用这个商家的 externalUserId 和 Connection。

### 1. 商家连接 Klaviyo

Klaviyo 用商家在你的产品里填写的私有 API Key 连接。店铺用凭证连接，Notion 走 AIsa 托管的授权页。

```
curl -X POST "https://api.aisa.one/apis/v1/connector/connect/klaviyo/credentials" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "externalUserId": "store_8812",
    "apiKey": "pk_..."
  }'
```

### 2. 拉取一周的订单

shopify.list_orders 接受 created_at 时间范围，每页最多返回 250 个订单；woocommerce.list_orders 接受 after 和 before 日期。逐页读取，直到覆盖整周。

Shopify：

```
curl -X POST "https://api.aisa.one/apis/v1/connector/actions/run" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "actionKey": "shopify.list_orders",
    "externalUserId": "store_8812",
    "input": {
      "first": 250,
      "query": "created_at:>=2026-11-10 created_at:<2026-11-17"
    }
  }'
```

WooCommerce：

```
curl -X POST "https://api.aisa.one/apis/v1/connector/actions/run" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "actionKey": "woocommerce.list_orders",
    "externalUserId": "store_8812",
    "input": {
      "after": "2026-11-10T00:00:00Z",
      "before": "2026-11-17T00:00:00Z",
      "perPage": 100
    }
  }'
```

### 3. 加入一周的邮件营销活动

klaviyo.list_campaigns 按时间倒序列出商家的邮件营销活动，报表可以把销售和发出的邮件放在一起看。

```
curl -X POST "https://api.aisa.one/apis/v1/connector/actions/run" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "actionKey": "klaviyo.list_campaigns",
    "externalUserId": "store_8812",
    "input": {
      "channel": "email",
      "sort": "-scheduled_at",
      "pageSize": 10
    }
  }'
```

### 4. 把报表写进 Notion

notion.create_page 在商家选定的父页面下新建一页，内容是 Markdown 格式的总结。这是写入操作，只运行一次；重新运行前先查看页面。

```
curl -X POST "https://api.aisa.one/apis/v1/connector/actions/run" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "actionKey": "notion.create_page",
    "externalUserId": "store_8812",
    "input": {
      "parentId": "1f2e3d4c5b6a49788796a5b4c3d2e1f0",
      "title": "Store report, 10 to 16 November",
      "markdown": "## Sales\n...\n## Email campaigns\n..."
    }
  }'
```

## 让你的编程 Agent 来搭建

把这段提示词粘贴到你产品代码仓库里的 Claude Code、Codex 或 Cursor，AIsa Key 放在服务器的环境变量里。

```text
用 AIsa Connect（https://aisa.one/docs/resources/aisa-connect）给这个应用加一份每周店铺报表。

先阅读指南。只在服务器端调用 AIsa，从环境变量读取 AISA_API_KEY。

1. 用商家 ID 作为 externalUserId，让每个商家用凭证连接 Shopify 或 WooCommerce 以及 Klaviyo，通过托管连接页连接 Notion。
2. 每周一为每个商家逐页读取上周的订单，用 shopify.list_orders（created_at 查询）或 woocommerce.list_orders（after 和 before）。
3. 从 klaviyo.list_campaigns 加入上周的邮件营销活动。
4. 销售额、订单数和客单价用代码计算，不要交给模型算。
5. 每周一次，用 notion.create_page 在商家选定的页面下写入总结。

写调用前先读取每个操作的 inputSchema，先把方案给我看。
```

你的编程 Agent 会先给出方案再写代码。把第一份报表和店铺自带的数据分析对一遍，再发给商家。

## 关于电商报表自动生成的常见问题

### 什么是电商报表自动生成？

电商报表自动生成是按计划从店铺的各个应用拉取销售、订单和营销数据，自动写出总结，不用再手动导出表格。基于 AIsa Connect，你的产品用每个商家自己连接的账号为他们完成这件事。

### 报表可以读取哪些应用？

订单用 Shopify、WooCommerce 和 Square，邮件用 Klaviyo 和 Mailchimp，支付用 Stripe，都已在生产环境验证。连接器页列出了其他应用及其操作。

### 怎样每周自动生成报表？

用你自己的调度工具，比如 cron 任务或队列，为每个商家发送同一组请求。每次运行就是一次对 AIsa Connect 的请求。

### 报表可以写进 Google Sheets 而不是 Notion 吗？

暂时不行。Google 系应用目前以只读权限连接，报表可以读取表格，但不能写入。Notion 和 Airtable 支持写入。

### 数字会和 Shopify 自带的报表一致吗？

数字来自 API 返回的订单，退款、税费和时区取决于你的代码怎么计算。把第一份报表和店铺自带的数据分析对一遍，再做调整。

### 一份周报要花多少钱？

一份报表分两页读取订单、列出营销活动、写入一个页面，共四次运行，按每次成功运行 $0.0003 计算约 $0.0012。连接账号免费。

## 相关任务

- [搭建 Shopify AI Agent](https://aisa.one/zh/solutions/shopify-ai-agent.md)：商家连接一次店铺，你的 Agent 就能通过 AIsa Connect 读取订单和库存，并给订单加标签。适合：Agent 开发者和跨境卖家
- [搭建 AI 客服 Agent](https://aisa.one/zh/solutions/ai-customer-support-agent.md)：从商家的 Gmail 读取订单咨询，到店铺里查订单，起草回复交给人工发送。适合：Agent 开发者和企业团队
