billing-automation

计费自动化

掌握自动化计费系统，包括周期性计费、发票生成、催款管理、按比例计费以及税额计算。

何时使用本技能

• 实现 SaaS 订阅计费
• 自动化发票生成与发送
• 管理支付失败后的恢复（催款）
• 计算套餐变更时的按比例费用
• 处理销售税、增值税（VAT）和商品及服务税（GST）
• 处理基于用量的计费
• 管理计费周期与续订

核心概念

1. 计费周期

常见间隔：

• 每月（SaaS 最常见）
• 每年（长期有折扣）
• 每季度
• 每周
• 自定义（基于用量、按席位）

2. 订阅状态

trial → active → past_due → canceled
              → paused → resumed

3. 催款管理

通过以下方式自动恢复支付失败的流程：

• 重试计划
• 客户通知
• 宽限期
• 账户限制

4. 按比例计费

在以下情况下调整费用：

• 周期中途升级/降级
• 增加/移除席位
• 更改计费频率

快速开始

from billing import BillingEngine, Subscription

# Initialize billing engine
billing = BillingEngine()

# Create subscription
subscription = billing.create_subscription(
    customer_id="cus_123",
    plan_id="plan_pro_monthly",
    billing_cycle_anchor=datetime.now(),
    trial_days=14
)

# Process billing cycle
billing.process_billing_cycle(subscription.id)

详细模式与完整示例

详细的模式文档位于 references/details.md。当上述导航层级不够用时，请阅读该文件。