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 にあります。上記のナビゲーション階層では不十分な場合は、そのファイルを参照してください。