Invoice Chaser

💸 自动催收发票,专注核心业务

自动化发票催收系统,通过渐进式邮件提醒(友好→强硬→最终通知)追踪未付款项,生成应收账款账龄报告,在保护客户关系的同时保障现金流。支持定时发送、状态管理和人工干预阈值配置。

收藏
6.4k
安装
2.2k
版本
1.0.0
CLS 安全性认证2026-08-11
点击查看完整报告 >

使用说明

核心用法

Invoice Chaser 是一套完整的应收账款自动化管理方案,专为自由职业者、咨询师和小型企业设计。用户通过 add-invoice.sh 录入发票信息(编号、客户、金额、到期日),系统即启动状态机追踪。

核心操作围绕 chase.sh 脚本展开——该脚本每日运行(建议配置 cron),自动计算每张发票的逾期天数,匹配对应催收阶段,并发送个性化邮件。邮件模板分四级递进:友好提醒(到期前3天)→ 专业逾期通知(到期后7天)→ 强硬催款(30天逾期)→ 最终警告(45天,告知将移交催收)。第60天触发人工介入警报。

配套工具包括:status.sh 用于标记付款、暂停提醒或归档坏账;report.sh 生成 AR 账龄分析报表(当前/30天/60天/90天+),支持 CSV 导出和 Telegram 推送。

显著优点

关系维护与收款效率的平衡:渐进式语调设计避免了"一刀切"的强硬催收,早期阶段保持专业友好,后期自动升级坚决态度,减少人工尴尬对话。

完整的状态机管理:非简单的定时提醒,而是涵盖 DRAFT→SENT→REMINDED→OVERDUE→FIRM→FINAL→ESCALATED 的全流程状态追踪,支持 PAUSE、ARCHIVE 等灵活操作。

高度可配置:邮件模板、时间节点、升级规则、支付链接、报告频率均可自定义,变量支持 {client_name}、{days_overdue} 等动态内容。

安全测试机制:所有脚本支持 --dry-run 模式,可在零风险环境下预览邮件内容和执行逻辑。

潜在缺点与局限性

依赖外部邮件发送能力:必须配套 gog 技能(Gmail 发送)并配置 GOG_DEFAULT_ACCOUNT,单点故障风险;未内置备用 SMTP 通道。

无内置支付网关:仅支持在邮件中嵌入 Stripe/PayPal 链接,实际收款仍需跳转第三方平台,无支付状态自动回调机制。

客户关系敏感风险:自动化"坚定"阶段的邮件若配置不当(如过于强硬或发送给已付款但未及时标记的客户),可能损害商业关系;系统依赖用户准确维护 paid 状态。

数据本地化限制:发票数据库为本地 JSON 文件,无多设备同步、无协作权限管理,不适合有专职会计团队的企业。

法律合规盲区:未内置各国催收法规适配(如美国 FDCPA、欧盟 GDPR 的催收通信规范),最终通知阶段的"移交催收"表述需用户自行法律审核。

适合人群

  • 月发票量 5-50 张的自由职业者/独立咨询师
  • 无专职财务人员但现金流敏感的小型服务型企业
  • 因催收对话感到心理压力、希望自动化尴尬沟通的创始人/业务主
  • 已使用 Gmail 作为主邮箱、愿意配置 API 权限的技术适中用户

不适合:需要多币种复杂账期的大型企业、有严格合规审计要求的上市公司、或完全非技术背景且抗拒命令行操作的用户。

常规风险

配置错误导致误发:timing 规则或日期格式错误可能造成提前/延后催款,建议首次使用 --dry-run 验证全周期模拟。

邮件被标记为垃圾邮件:高频发送或模板含"FINAL NOTICE"等敏感词可能触发 Gmail/企业邮箱过滤,需监控送达率并配置 rate limiting。

数据丢失风险:invoices.json 等本地文件若无定期备份,系统故障将导致完整催收记录丢失,建议纳入常规备份策略。

权限与隐私:GOG_DEFAULT_ACCOUNT 存储于 secrets.env,需确保文件权限安全(600),避免邮箱凭证泄露。

安全解读

核心用法

Invoice Chaser 是一款面向自由职业者和小型企业主的应收账款自动化管理工具。其核心工作流围绕"添加发票→自动追踪→渐进催收→状态更新"四个环节展开:

初始化配置:运行 setup.sh 创建配置文件,设置企业信息、邮件模板(友好→专业→强硬→最终通知四个阶段)、发送时间规则和升级阈值。

发票录入:通过 add-invoice.sh 添加发票信息,包括客户邮箱、金额、开票日期和账期,系统自动计算到期日并启动追踪。

自动催收:chase.sh 按预设时间表执行催收循环——第3天友好提醒、第7天到期通知、第30天逾期警告、第45天强硬通知、第60天最终警告、第75天人工介入提醒。每封邮件根据阶段自动调整语气,支持变量替换客户名、发票号、金额等。

状态管理:通过 status.sh 标记已付款、暂停提醒、添加备注或归档坏账。report.sh 生成AR账龄报告,支持CSV导出。

显著优点

情感劳动外包:将 freelancer 最头疼的"催款尴尬"完全交给 Agent 处理,维护专业关系的同时确保收款进度,避免个人情绪干扰商业决策。

渐进式沟通策略:科学的四阶段语气升级机制(友好→专业→强硬→最终)既给客户合理缓冲期,又建立明确的付款预期,显著降低恶性拖欠概率。

完整的AR管理闭环:不仅是邮件工具,更包含发票状态机(DRAFT/SENT/REMINDED/OVERDUE/FIRM/FINAL/ESCALATED)、交互日志、账龄分析,形成轻量级应收账款管理系统。

高度可配置:邮件模板、时间节点、升级规则、支付方式链接均可自定义,适应不同行业账期习惯(Net 30/Net 60等)。

本地优先架构:所有数据存储于 ~/.config/invoice-chaser/,无云端依赖,隐私可控,支持 dry-run 模式安全测试。

潜在缺点与局限性

依赖外部邮件技能:核心功能依赖 gog Skill 发送邮件,若该组件故障或配置错误,整个催收流程中断,且需单独审查其安全性。

无原生支付集成:仅支持在邮件模板中嵌入 Stripe/PayPal 等第三方支付链接,无法直接处理支付回调确认,需人工标记已付款状态。

单用户本地架构:数据存储于本地 JSON 文件,无多用户协作、无云端同步,不适合有专职财务团队的中大型企业。

有限的发送渠道:仅支持邮件催收,无短信、电话等备选渠道,对邮件打开率低的企业客户效果受限。

缺乏智能升级判断:升级决策完全基于时间规则,无法结合客户历史付款行为、合同金额、战略重要性等动态调整策略。

适合的目标群体

核心用户:自由职业者(设计师、开发者、咨询顾问)、小型服务型企业(10人以下)、独立承包商。这些群体通常缺乏专职财务人员,应收账款管理混乱,现金流脆弱,且对"催款尴尬"高度敏感。

场景匹配:项目制工作(有明确开票节点)、账期客户(非预付款)、月结/季结服务模式。不适合电商零售、订阅制 SaaS 等即时收款场景。

技术门槛:需具备基础命令行操作能力,能编辑 JSON 配置文件,设置 cron 定时任务。

使用风险

配置风险:邮件模板配置错误可能导致向客户发送不当内容(如错误金额、错误语气),建议在正式使用前充分测试 --dry-run 模式。

依赖链风险:gog Skill 的安全性和稳定性直接影响本工具,若其存在漏洞或被弃用,需自行替换邮件发送方案。

数据持久化风险:本地 JSON 文件无自动备份,硬件故障或误操作可能导致发票数据丢失,建议定期手动备份 ~/.config/invoice-chaser/ 目录。

法律合规风险:不同司法管辖区对债务催收有严格法规(如美国 FDCPA、欧盟催收指令),默认模板可能不符合当地法律要求,需法务审核后使用。

客户关系风险:自动化催收可能被客户感知为"没有人情味",重要客户建议在 Stage 3 后转为人工沟通,避免过度机械化损害长期合作。

Invoice Chaser 内容

scripts文件夹
手动下载zip · 9.8 kB
add-invoice.shtext/x-shellscript
请选择文件