---
sidebar_position: 5
title: "サービスの注文"
---

# サービスの注文

## 概要

このガイドでは、サービスの設定からチェックアウト、注文送信、フルフィルメント、リアルタイムのステータス追跡まで、注文ライフサイクル全体を説明します。これはポータルで最も重要なフローの一つです。注文はポータルで開始され、Salesforceにレコード（Order、Opportunity）を作成し、最終的にWHMCSでサービスをプロビジョニングします。すべての注文はSalesforceのサポートエージェントによる手動承認が必要です。自動プロビジョニングはありません。

## ポータルフロー

### サービスの設定

チェックアウトに進む前に、ユーザーは選択したサービスを設定する必要があります。各サービスタイプには独自のマルチステップ設定ウィザードがあります。

#### インターネットの設定

1. インターネットプランページからプランティア（Standard、Pro、またはPlatinum）をクリックして `/account/services/internet/configure` で設定を開始します。
2. **ステップ1 — サービス設定**：選択したプランの詳細を確認。接続アクセスモード（自前ルーターでIPoE、ホームゲートウェイでIPoE、またはPPPoE）を選択。
3. **ステップ2 — 設置**：設置オプションを選択。契約期間（一括、12ヶ月、24ヶ月）により設置料金の支払い方法が変わります。
4. **ステップ3 — アドオン**：オプションでインターネットサービスのアドオンを選択。一部のアドオンはバンドル（特定プランに自動的に含まれる）されています。
5. **ステップ4 — 注文確認**：プラン、設置オプション、アドオン、月額合計、一括合計のサマリーを確認。価格は10%消費税別。**Proceed to Checkout** をクリック。

#### SIM / eSIMの設定

1. SIMプランページでプランカードの **Select Plan** をクリック。
2. **ステップ1 — SIMタイプ選択**：**eSIM** または **Physical SIM** を選択。eSIMの場合、デバイスのEID（32桁の識別子）を入力する必要があります。
3. **ステップ2 — アクティベーション**：**Immediate**（即時）または **Scheduled**（予定日指定）を選択。
4. **ステップ3 — アドオン**：オプションでアドオンを選択。
5. **ステップ4 — 番号ポーティング（MNP）**：既存の電話番号を移行するかを選択。移行する場合、MNP予約番号、有効期限、キャリアアカウント番号、個人情報を入力。
6. **ステップ5 — 注文確認**：すべてのサマリーを確認。**Proceed to Checkout** をクリック。

#### VPNルーターの設定

1. VPNプランページで希望リージョン（USまたはUK）のプランカードをクリック。
2. プラン選択、アドオン、レビュー、チェックアウトへ進みます。

### チェックアウト

1. 設定ウィザードから「Proceed to Checkout」をクリック後、ポータルが**チェックアウトセッション**を構築します。
2. 未ログインの場合、ログインページにリダイレクトされます。カートデータは保持されます。
3. チェックアウトページには **「Checkout」** というタイトルで「Verify your address, review totals, and submit your order.」という説明が表示されます。

#### チェックアウト要件

送信前に3つの要件をすべて満たす必要があります：

**1. サービス住所の確認**
- 登録済み住所が表示されます。正しいことを確認ボタンで確認する必要があります。

**2. 支払い方法**
- WHMCSに支払い方法が登録されているか確認します。ない場合、WHMCS決済ポータルへのリンクが表示されます。

**3. 本人確認（在留カード）**
- 日本の電気通信規制により本人確認が必要です。在留カード画像のアップロードまたはステータスが表示されます。

#### 注文サマリーと送信

1. **Review & Submit** セクションに推定月額と一括合計が表示されます。
2. **Submit order** ボタンは3つの要件がすべて満たされるまで無効です。
3. **Submit order** をクリック。成功すると注文詳細ページにリダイレクトされます。

### 注文確認と追跡

1. 送信成功後、注文詳細ページに移動します。
2. 緑の **「Order submitted」** バナーが表示されます。

#### 注文詳細ページ

- **統計カード**：注文ステータス、月額コスト、一括コスト、注文日の4つのカード。
- **注文進捗タイムライン**：サービスタイプ別のステップ進行バー：
  - **Internet**：Submitted -> Under Review -> Scheduled -> Active
  - **SIM**：Submitted -> Processing -> Activating -> Active
  - **VPN**：Submitted -> Processing -> Active
- **注文詳細カード**：サービスラベル、注文日、価格、注文アイテムリスト。
- **次のステップ**：現在のステータスに基づく次のアクションの説明。

#### リアルタイム注文更新

- 注文詳細ページはServer-Sent Eventsを使用してサーバーとの**ライブ接続**を確立します。Salesforceで注文ステータスが変更されると、ページが自動更新されます。

#### 注文ステータスの意味

| ポータルステータス | 意味 |
| --- | --- |
| **Under Review** | 注文が送信され、チームが確認中 |
| **Installation Scheduled** | インターネット注文：設置日が設定済み |
| **Setting Up Service** | バックエンドがサービスをプロビジョニング中 |
| **Service Active** | サービスが完全にプロビジョニングされアクティブ |
| **Processing** | 一般的な処理状態 |

### 注文一覧ページ

1. `/account/orders` ですべての注文を確認できます。
2. 上部にサマリー統計、検索、ステータス・タイプフィルターが表示されます。

## Salesforceで起こること

### 注文作成

ユーザーが「Submit order」をクリックすると、BFFがSalesforceで以下のステップを実行します：

1. **注文の検証**：アカウントマッピングの確認、SKUの存在確認、ビジネスルールの検証。
2. **Opportunityとの紐付け**：既存のオープンOpportunityを検索または新規作成。ステージを **「Post Processing」** に設定。
3. **Orderの作成**：新しい**Order**レコードを作成。`Status` = "Draft"、`Type` = 注文タイプ。
4. **Order Itemsの作成**：各SKUに対して**OrderItem**レコードを作成。
5. **サポートチームへの通知**：内部Caseを作成して新規注文を通知。

## WHMCSで起こること

### 注文フルフィルメント（プロビジョニング）

Salesforce Orderの作成後、すべての注文はプロビジョニング前にサポートチームによる手動レビューと承認が必要です。

1. **インターネット注文**：サポートチームが確認後、NTTとの調整を行い、`Activation_Status__c` を更新してプロビジョニングをトリガー。
2. **SIM注文（eSIM）**：レビューと在留カード確認後、WHMCSにProduct/Serviceを作成し、モバイルネットワークでSIMをアクティベート。
3. **SIM注文（Physical SIM）**：物理SIMカードの割り当て後にプロビジョニング。
4. **VPN注文**：レビュー後、WHMCSにProduct/Serviceを作成し、ルーターを発送。

### 作成されるWHMCSレコード

- **Product/Service**：ユーザーのWHMCSクライアントに新しいサービスレコードを作成。
- **Order**：サービスとアドオンをグループ化するWHMCS Orderレコード。
- **Invoice**：WHMCSが請求サイクルと価格に基づいて請求書を自動生成。

## 確認すべき重要事項

### 注文の配置

1. **エンドツーエンドフロー**：各サービスタイプ（Internet、SIM eSIM、SIM Physical、VPN）でフルフローを実行。
2. **チェックアウト要件**：3つの要件がすべて満たされるまでSubmitボタンが無効であることを確認。
3. **住所確認**：完全な住所と不完全な住所でテスト。
4. **支払い方法確認**：支払い方法ありとなしでテスト。

### Salesforce確認

5. **Orderレコード**：送信後、Salesforceで注文を確認。
6. **Order Items**：チェックアウトカートの各SKUがOrderItemとして表示されることを確認。
7. **Opportunity**：Orderに紐付けられ、ステージが「Post Processing」であることを確認。

### 注文追跡

8. **リアルタイム更新**：注文詳細ページを開いた状態でSalesforceでステータスを変更し、ページが自動更新されることを確認。
9. **ステータスラベル**：各ステータスが正しく表示されることを確認。
