> ## Documentation Index
> Fetch the complete documentation index at: https://order-limit.xrtotech.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopify 客户累计规则：首次、复购与历史统计边界

> 理解每个产品的历史已购与当前数量如何合计。了解首次购买需单独设上限、客户登录、250 产品范围、记录更新延迟，以及退款取消不自动恢复的边界。

客户累计购买限制用于管理已购买过某产品的客户再次购买。你需要同时理解当前购物车数量和客户已记录的购买数量，才能正确设置门槛。

## 首次购买与再次购买

当前功能对没有该产品购买记录的客户，不用累计门槛限制首次购买数量。首次最多能买多少，需要另外创建购物车数量规则。

存在购买记录后，按每个产品的“历史已记录数量 + 本次购物车数量”检查，超过累计门槛时拦截。同一产品下的变体一起计数，多个不同产品不是共享一个总额度。

| 门槛 3 时的情况 | 累计规则结果 |
| - | - |
| 没有记录，首次买 5 件 | 累计规则本身不限制；需另设单次上限 |
| 历史已记录 1 件，本次买 2 件 | 通过，总计 3 件 |
| 历史已记录 1 件，本次买 3 件 | 拦截，总计 4 件 |
| 历史已记录 3 件，本次买 1 件 | 拦截 |

## 登录与记录来源

* 购买受累计规则限制的产品时，客户需要登录。
* 系统会记录能关联到客户的新增订单中的非订阅商品数量。
* 不会自动导入安装应用前的历史订单。
* 开启规则前，应用已经记录的新增订单也可能影响后续判断；不要把启用规则当作购买记录归零。
* 购买记录随订单创建后的处理更新，不应假设两个连续或并发结账之间绝对实时。

> [!WARNING]
>
> 记录依据是订单创建，不是收款完成。当前没有随退款或取消自动回退数量的处理，也没有按天、按月重置购买额度的设置。

## 可选商品范围

累计规则最多支持 250 个产品。选择 **所有产品** 时，店铺产品总数也不能超过 250。更大的店铺应使用 **指定产品**，并控制在上限内。

累计规则不支持产品系列。需要扩大或调整商品范围时，重新核对所选产品和已有购买记录。

## 推荐配置

如果目标是同一客户每种样品只能买 1 件，同时创建：

1. 单次数量规则：指定样品，分别计算，最大数量 `1`。
2. 客户累计规则：同样的产品，历史门槛 `1`。

完整测试步骤见[样品重复购买限制](https://order-limit.xrtotech.com/scenarios/repeat-purchase.md)。

> [!NOTE]
>
> 客户身份以店铺识别到的客户账户为基础。这项功能不承诺识别同一个人使用多个账户的情况。

## 测试前先规划测试账户

不要重复使用已经购买过样品的账户来验证“首次购买”。首次、复购与跨产品应分开记录。退款和取消不会自动恢复测试额度，重新开始首次测试时请换用没有该产品记录的测试客户。按[上线测试清单](https://order-limit.xrtotech.com/getting-started/launch-checklist.md)保存结果。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.