billing-automation

用途：构建自动化计费系统，处理周期性付款、发票生成、订阅生命周期与催缴管理，适合实现 SaaS 订阅计费等场景。主要能力包括：计费周期（月、年、季、周及自定义按量或按席位）、订阅状态流转（trial→active→past_due→canceled，含 paused/resumed）、催缴重试与通知、套餐变更与席位数变化的按比例计费，以及销售税、VAT、GST 计算；同时支持发票生成与按量计费。用法上提供 Python 示例：先初始化 BillingEngine，再创建订阅并处理计费周期，例如 from billing import BillingEngine, Subscription；billing = BillingEngine()；subscription = billing.create_subscription(customer_id="cus_123", plan_id="plan_pro_monthly", billing_cycle_anchor=datetime.now(), trial_days=14)；billing.process_billing_cycle(subscription.id)。文档给出 Subscription、BillingEngine、DunningManager、ProrationCalculator、TaxCalculator、Invoice、UsageBillingEngine 等类结构参考。限制：资料未说明具体依赖版本、部署或运行环境要求；税费示例中的税率与税务辖区仅为示例，实际需按合规要求确认；部分方法（如发票 PDF 生成、VAT 号校验）在资料中未完整实现，需自行补充。