98 lines
4.5 KiB
Markdown
98 lines
4.5 KiB
Markdown
|
---
|
|||
|
|
sidebar_position: 13
|
|||
|
|
title: "住所管理"
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# 住所管理
|
|||
|
|
|
|||
|
|
## 概要
|
|||
|
|
|
|||
|
|
このガイドでは、ポータルで住所を表示・編集する方法を説明します。住所は日本固有のフォーマットを使用し、日本語（Salesforce用）とローマ字英語（WHMCS用）の両方で保存されます。ポータルは日本郵便APIと連携して郵便番号から住所を検索し、正確性を確保します。
|
|||
|
|
|
|||
|
|
## ポータルフロー
|
|||
|
|
|
|||
|
|
### 現在の住所の確認
|
|||
|
|
|
|||
|
|
1. **Account > Settings**（`/account/settings`）に移動します。
|
|||
|
|
2. **Address Information**カードに現在の住所が表示されます。
|
|||
|
|
3. 右上に**Edit**ボタンがあります。
|
|||
|
|
4. 住所が未登録の場合、「No address on file」と**Add Address**ボタンが表示されます。
|
|||
|
|
|
|||
|
|
### 住所の編集
|
|||
|
|
|
|||
|
|
1. **Edit**をクリックするとステップバイステップの住所フォームに切り替わります。
|
|||
|
|
2. フォームは**段階的開示**を使用 — 各ステップは前のステップが完了した後に表示されます。
|
|||
|
|
|
|||
|
|
#### ステップ1：郵便番号の入力
|
|||
|
|
|
|||
|
|
1. 7桁の日本の郵便番号を入力（例：「100-0001」または「1000001」）。
|
|||
|
|
2. 有効な7桁のコードが入力されると、ポータルが日本郵便APIを使用して住所を自動検索。
|
|||
|
|
3. 郵便番号が見つかると**「Verified」バッジ**が表示され、検索結果が表示されます：
|
|||
|
|
- **都道府県**（ローマ字と日本語の両方、例：「Tokyo / 東京都」）
|
|||
|
|
- **市区町村**（両方の言語、例：「Minato-ku / 港区」）
|
|||
|
|
- **町名**（両方の言語、例：「Higashiazabu / 東麻布」）
|
|||
|
|
4. これらのフィールドは読み取り専用で手動編集はできません。
|
|||
|
|
|
|||
|
|
#### ステップ2：番地
|
|||
|
|
|
|||
|
|
1. **Street Address**フィールドが表示されます。
|
|||
|
|
2. 丁目-番地-号のハイフン区切り形式で入力（例：「1-5-3」）。
|
|||
|
|
3. ヘルパーテキスト：「Enter chome-banchi-go (e.g., 1-5-3)」
|
|||
|
|
|
|||
|
|
#### ステップ3：住居タイプ
|
|||
|
|
|
|||
|
|
1. **Residence Type**セレクターが表示されます。
|
|||
|
|
2. 2つのオプション：
|
|||
|
|
- **House**（一戸建てアイコン）
|
|||
|
|
- **Apartment**（建物アイコン）
|
|||
|
|
|
|||
|
|
#### ステップ4：建物の詳細
|
|||
|
|
|
|||
|
|
1. **Building Name**（必須）：建物名または住居名を入力。
|
|||
|
|
2. **Room Number**（アパートの場合のみ必須）：部屋番号を入力。
|
|||
|
|
|
|||
|
|
#### 完了
|
|||
|
|
|
|||
|
|
1. すべてのフィールド入力後、緑の**「Address Complete」**メッセージが表示。
|
|||
|
|
2. **Save Address**をクリックして変更を送信。
|
|||
|
|
|
|||
|
|
## WHMCSで起こること
|
|||
|
|
|
|||
|
|
- WHMCSは顧客の請求先住所の**管理システム**です。
|
|||
|
|
- 住所保存時、ポータルがWHMCSに書き込みキャッシュをクリアします。
|
|||
|
|
- WHMCSフィールドへのマッピング：
|
|||
|
|
|
|||
|
|
| WHMCSフィールド | 内容 | 例 |
|
|||
|
|
| --- | --- | --- |
|
|||
|
|
| address1 | 建物名 + 部屋番号 | "Sunshine Mansion 201" |
|
|||
|
|
| address2 | 町名 + 番地（ローマ字） | "Higashiazabu 1-5-3" |
|
|||
|
|
| city | 市区町村（ローマ字） | "Minato-ku" |
|
|||
|
|
| state | 都道府県（ローマ字） | "Tokyo" |
|
|||
|
|
| postcode | 郵便番号 | "1060044" |
|
|||
|
|
| country | 国コード | "JP" |
|
|||
|
|
|
|||
|
|
## Salesforceで起こること
|
|||
|
|
|
|||
|
|
- SalesforceのContactレコードに**日本語版**の住所が更新されます：
|
|||
|
|
|
|||
|
|
| Salesforceフィールド | 内容 | 例 |
|
|||
|
|
| --- | --- | --- |
|
|||
|
|
| MailingStreet | 町名 + 番地（日本語） | "東麻布1-5-3" |
|
|||
|
|
| MailingCity | 市区町村（日本語） | "港区" |
|
|||
|
|
| MailingState | 都道府県（日本語） | "東京都" |
|
|||
|
|
| MailingPostalCode | 郵便番号 | "1060044" |
|
|||
|
|
| MailingCountry | 国 | "Japan" |
|
|||
|
|
| BuildingName__c | 建物名 | "Sunshine Mansion" |
|
|||
|
|
| RoomNumber__c | 部屋番号 | "201" |
|
|||
|
|
|
|||
|
|
## 確認すべき重要事項
|
|||
|
|
|
|||
|
|
- 有効な郵便番号で都道府県、市区町村、町名が日本語と英語の両方で正しく自動入力されること
|
|||
|
|
- 無効な郵便番号でエラーメッセージが表示されること
|
|||
|
|
- 段階的開示（各ステップが前のステップ完了後にのみ表示）が機能すること
|
|||
|
|
- 「Apartment」選択時に部屋番号フィールドが表示、「House」選択時に非表示であること
|
|||
|
|
- 保存後、WHMCSクライアントプロフィールにローマ字英語で正しく反映されること
|
|||
|
|
- 保存後、Salesforce Contactレコードに日本語で正しく反映されること
|
|||
|
|
- 保存後、ポータルの住所カードが即座に更新されること
|
|||
|
|
- 「Cancel」クリックで変更が破棄され以前の値に戻ること
|