ramirez
d7efc99fdc
Translated all UAT test guides and how-it-works documentation to Japanese. Files are organized under docs/ja/uat/ and docs/ja/how-it-works/.
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」クリックで変更が破棄され以前の値に戻ること
|