用途:审计 Shopify 折扣目录,发现已过期折扣码、零兑换折扣码以及重复代码前缀,解决折扣堆积导致后台难以管理的问题,可选删除被标记的折扣码。该技能在折扣分析基础上增加了写入步骤。
前提条件:已通过 Shopify CLI 认证,命令为 shopify store auth --store <domain> --scopes read_discounts,write_discounts;API 需 read_discounts、write_discounts 权限。
参数:store(必填,店铺域名);flag_expired(默认 true,标记或删除已过结束日期的折扣);flag_zero_usage(默认 true,标记或删除超过 N 天零兑换的折扣);zero_usage_min_age_days(默认 30);dry_run(默认 true,仅预览不执行变更);format(默认 human,可选 json)。
工作流程:先以 discountNodes 查询折扣节点(first: 250,含 codes、usageLimit、asyncUsageCount、endsAt、status 等字段),分页直到 hasNextPage: false;随后标记符合条件者;最后用 discountCodeDelete 变更删除。GraphQL 操作已验证兼容 api_version 2025-01。
输出:生成 CSV 文件 discount_cleanup_<YYYY-MM-DD>.csv,列为 discount_id、title、status、created_at、ends_at、usage_count、usage_limit、flag_reason、action。human 或 json 格式输出结果摘要。
安全限制:discountCodeDelete 会永久删除折扣码且不可恢复,已领取该码的客户将无法使用;建议先以 dry_run: true 审查标记列表;删除前确认过期码未被正在使用的邮件活动引用。THROTTLED 时可等待 2 秒并最多重试 3 次;删除出现 userErrors 时记录并跳过。建议每季度运行,删除零使用码前与邮件营销团队确认,年龄阈值保持 30 天以上。基于代码的自动或百分比折扣不在此技能清理范围内。个别未提到的价格、收费等信息暂未提供。