---
sidebar_position: 9
title: "請求と請求書"
---

# 請求と請求書

## 概要

このガイドでは、ポータルで請求情報を表示・管理する方法を説明します。すべての請求データ（請求書、支払い方法、請求サマリー）はWHMCSから取得されます。ポータルはデータを読み取りますがローカルには保存しません。請求書の閲覧、フィルタリング・検索、詳細の表示、PDFダウンロード、未払い請求書の支払いが可能です。

## ポータルフロー

### 請求書一覧の表示

1. **Account > Billing > Invoices**（`/account/billing/invoices`）に移動します。
2. 上部に**サマリー統計バー**が表示されます：合計、支払い済み（緑）、未払い（琥珀色）、延滞（琥珀色）。
3. **検索・フィルターバー**：請求書番号や説明での検索、ステータスフィルター（All、Paid、Unpaid、Cancelled、Overdue、Collections）。
4. 各請求書行に請求書番号、説明、ステータスバッジ、合計金額、支払期日、発行日が表示されます。

### 請求書ステータスバッジ

| ステータス | 色 | 意味 |
| --- | --- | --- |
| Paid | 緑 | 全額支払い済み |
| Unpaid | 琥珀色 | 支払い期限前の未払い |
| Overdue | 赤 | 支払い期限超過 |
| Draft | グレー | 下書き、未発行 |
| Cancelled | グレー | キャンセル済み |
| Refunded | 青 | 返金済み |
| Collections | 赤 | 督促に送付済み |

### 請求書詳細の表示

1. 一覧の請求書行をクリックして詳細ページを開きます。
2. 詳細ページの表示内容：
   - **サマリーバー**：合計金額、通貨コード、ステータスバッジ、支払期日、請求書番号、発行日
   - **Download PDF**ボタン — 安全なWHMCSリンクを生成しPDFをダウンロード
   - **Pay Now**ボタン — UnpaidまたはOverdueの請求書のみ表示。新しいタブでWHMCS決済ページを開く
   - **支払い済み**の場合、緑の「Payment received」バナーが支払日と共に表示
3. **明細項目**セクションに各項目の説明、タイプ、金額が表示されます。
4. **合計セクション**に小計、税金、合計が表示されます。

### 請求書PDFのダウンロード

1. 詳細ページから**Download PDF**をクリック。
2. ポータルがWHMCS請求書ページへの安全なSSO（シングルサインオン）リンクを生成します。
3. ブラウザがPDFのダウンロードを開始します。

### 請求書の支払い

1. 未払いまたは延滞の請求書詳細ページから**Pay Now**をクリック。
2. 新しいブラウザタブでWHMCS決済ページが開きます。
3. 保存された支払い方法を使用して支払いを完了できます。

### 支払い方法の管理

1. 支払い方法はWHMCS（通常Stripe経由）に保存されています。
2. **Manage Payment Methods**ボタンでSSO経由でWHMCSの支払い方法ページを開けます。

## WHMCSで起こること

- **請求書**：すべての請求書はWHMCSのクライアントアカウントに保存されます。
- **請求書ステータス**：WHMCSがステータスライフサイクルを管理（Draft、Unpaid、Paid、Overdue、Cancelled、Refunded、Collections）。
- **取引**：支払い時にWHMCSにTransactionレコードが作成されます。
- **SSOリンク**：ポータルが一時的なSSOリンクを生成し、別途WHMCSログインなしで請求書の表示/ダウンロード/支払いが可能。

## Salesforceで起こること

- Salesforceは請求データの管理システムでは**ありません**。請求書と支払いは完全にWHMCSに存在します。

## 確認すべき重要事項

- 請求書一覧が正しく読み込まれ、サマリー統計がWHMCS管理画面と一致すること
- ステータスフィルターと請求書番号検索が正しく機能すること
- 請求書詳細（合計金額、明細項目、税金）がWHMCS管理画面と一致すること
- PDFダウンロードが正常に機能すること
- Pay Nowが新しいタブでWHMCS決済ページを開くこと
- ステータスバッジの色分けが正確であること（Paid=緑、Unpaid=琥珀色、Overdue=赤）
- ページネーションが10件超の請求書で正常に機能すること
