发票催收

快速开始

提取应收账款账龄报告，根据付款历史对每位客户评分，为每张逾期发票草拟语气匹配的提醒，并呈现给负责人。在负责人同意之前不会发送任何内容。

用户："谁欠我钱"
→ 从 QuickBooks 提取应收账款账龄
→ 交叉核对 PayPal 结算记录（最近14天）
→ 对每位客户评分：好客户 / 偶尔迟付 / 经常迟付
→ 草拟语气匹配的提醒
→ 显示摘要表 + 草稿。等待"发送这些。"

设置（仅首次运行）

在首次运行前询问负责人两个问题：

1. 邮件连接器："您使用 Gmail 还是 Apple Mail 创建草稿？"— 存储答案；用于所有非 PayPal 的草稿排队。
2. Stripe："您是否使用 Stripe 进行开票？我可以在逾期扫描中包含 Stripe 发票。"— 如果是，则与 QuickBooks 一同提取 Stripe 逾期发票。

后续运行时不再询问。

工作流程

1. 提取逾期应收账款。 查询 QuickBooks 应收账款账龄，获取所有逾期超过1天的发票。如果 Stripe 已启用（负责人已在设置中确认），也提取 Stripe 逾期发票。

2. 交叉核对付款历史。 对于每位逾期客户，使用以下参数查询 PayPal 的已结算交易：

   • transaction_status：S（仅已结算——过滤掉待处理和被拒交易，这些会增加结果大小和提高限流风险）
   • 日期窗口：最近7天截止今天（非14或30天——更宽的窗口是 PayPal 429 速率限制错误的主要原因）

   如果 PayPal 返回 429 速率限制错误：

   • 立即重试一次，使用3天窗口代替。
   • 如果重试也返回 429，则完全跳过本次运行的 PayPal 交叉核对。在摘要表中将批次中的所有客户标记为"PayPal 不可用 — 请手动核实"。仅使用 QuickBooks 历史进行评分。不要静默丢弃此说明。

   如果某客户在查询窗口内显示已结算付款，将其标记为"可能已支付 — 请核实"并从草稿队列中排除。

3. 对每位客户评分。 阅读 reference/tone-matching.md 了解评分逻辑。结果：好客户、偶尔迟付 或 经常迟付。

4. 草拟提醒电子邮件。 每位客户一封邮件——将多张逾期发票合并到一封邮件中。语气与评分匹配。参见 reference/examples/gentle-reminder.md 和 reference/examples/firm-reminder.md。

5. 向负责人呈现草稿。 首先显示摘要表：

   客户	欠款金额	逾期天数	语气	发送方式
   Acme Corp	$1,200	18天	温和	PayPal
   Smith LLC	$450	47天	严厉	Gmail 草稿

   然后完整显示每封草稿邮件。等待负责人说"发送这些"或逐项批准。

6. 发送或排队 — 仅批准后执行。

   • PayPal 发票：通过 PayPal 发送提醒。
   • 非 PayPal 发票：在负责人配置的邮件应用中排队作为草稿。
   • 未经明确批准绝不发送。

7. 报告已完成操作。 列出已发送的内容、排队为草稿的内容以及被标记的内容（可能已支付、已排除）。

审批关卡

• 未经负责人明确批准，绝不发送或排队草稿。 先呈现所有草稿；等待批准。
• 绝不包含最近14天内已付款的客户。 将其标记为"可能已支付 — 请核实"。
• 绝不向不在 QuickBooks AR 报告中的客户发送（或 Stripe，如已启用）。不凭记忆发送提醒。
• 一次批准覆盖一个批次。 批准后添加客户或更改草稿将开始新一轮审批。

参考

• reference/tone-matching.md — 评分逻辑、语气指南、主题行公式
• reference/gotchas.md — 已知故障模式
• reference/examples/gentle-reminder.md — 好客户邮件示例
• reference/examples/firm-reminder.md — 经常迟付客户邮件示例