クレジットAPI

クレジット（請求書）の生成、承認、エクスポートを行うAPIエンドポイントです。

POST /api/v1/credits/generate

指定した発注伝票からクレジット（請求書）を自動生成します。

// リクエスト
{
  "order_ids": ["ord_001", "ord_002"],
  "billing_period": "2026-03"
}

// レスポンス (201 Created)
{
  "id": "crd_abc123",
  "total_amount": 135000,
  "status": "pending_approval",
  "line_items": [
    {
      "order_id": "ord_001",
      "description": "原画 C-001〜C-010",
      "amount": 45000
    }
  ]
}

PATCH /api/v1/credits/[id]/approve

クレジットを承認します。OWNER / ADMIN権限が必要です。

GET /api/v1/credits/export

クレジット一覧をCSV形式でエクスポートします。経理ソフトへのインポートに使用できます。