核心用法
Invoice 技能是一套完整的发票创建与管理系统,采用六阶段结构化流程:
1. Discovery(发现) — 识别客户、服务与金额,从客户端数据库加载或新建客户档案
2. Draft(起草) — 自动生成带自动计税和连续编号的发票草稿
3. Review(审核) — 预览并允许编辑调整
4. Finalize(定稿) — 生成 PDF 并锁定编号,防止篡改
5. Send(发送) — 邮件直发客户(可选)
6. Track(追踪) — 监控付款状态
存储架构
文件系统采用分层设计:~/billing/drafts/ 存放工作草稿,~/billing/sent/ 存储已发送发票(按年份归档),~/billing/clients/ 维护客户数据库,config.json 保存企业信息与模板偏好,series.json 管理各编号系列的连续性。
关键特性
- 自动编号系统:严格连续无跳号(如 F-2026-001, F-002),即使取消发票也保留编号,错误通过贷项通知单修正
- 透明计税:必须分项显示:税基、税率、税额、总计,禁止隐藏税费
- 多类型支持:常规发票、简化发票、贷项通知单
- PDF 模板生成:专业格式,支持自定义模板
显著优点
| 优势 | 说明 |
|------|------|
| **合规性保障** | 内置多国法律要求检查,连续编号机制满足审计追溯需求 |
| **防错机制** | 编号锁定、版本管理(v001, v002...)、强制客户信息完整性校验 |
| **效率提升** | 自动计税、一键生成 PDF、邮件集成,减少重复操作 |
| **数据隔离** | 与 `invoices` 技能(管理**收到**的发票)功能分离,避免账务混淆 |
| **可扩展性** | 模块化文档体系,支持按需深入特定主题 |
潜在缺点与局限性
1. 配置门槛:首次使用需完成企业信息、银行详情、税率、编号规则等配置
2. 地域依赖:法律合规模块 (legal.md) 按国家区分,非覆盖地区需人工校验
3. 存储本地化:依赖文件系统架构,无原生云同步,跨设备需额外配置
4. 邮件可选:发送功能非强制集成,重度用户可能需配合外部邮件工具
适合人群
- 自由职业者 / 独立顾问:需要规范开票但无专职财务
- 中小型企业:追求合规与效率平衡,发票量中等
- 跨境服务者:利用多国法律模块应对不同司法管辖区要求
- 财务规范化转型中的团队:从非正式收款转向正式发票体系
常规风险
| 风险类型 | 具体表现 | 缓解建议 |
|----------|----------|----------|
| **数据丢失** | 本地存储无自动备份 | 定期备份 `~/billing/` 目录 |
| **编号冲突** | 多实例同时操作可能破坏连续性 | 单用户操作或加文件锁机制 |
| **税务误差** | 税率配置错误或未及时更新 | 每年复核 `config.json` 中的默认税率 |
| **法律风险** | 非覆盖国家的发票格式不合规 | 结合当地会计师审核初期发票 |
> 注意:本技能仅创建发出的发票,接收发票的管理请使用独立的 invoices 技能,二者存储与逻辑完全隔离。