sidebar_position, title
| sidebar_position |
title |
| 13 |
住所管理 |
住所管理
概要
このガイドでは、ポータルで住所を表示・編集する方法を説明します。住所は日本固有のフォーマットを使用し、日本語（Salesforce用）とローマ字英語（WHMCS用）の両方で保存されます。ポータルは日本郵便APIと連携して郵便番号から住所を検索し、正確性を確保します。
ポータルフロー
現在の住所の確認
- Account > Settings（
/account/settings）に移動します。
- Address Informationカードに現在の住所が表示されます。
- 右上にEditボタンがあります。
- 住所が未登録の場合、「No address on file」とAdd Addressボタンが表示されます。
住所の編集
- Editをクリックするとステップバイステップの住所フォームに切り替わります。
- フォームは段階的開示を使用 — 各ステップは前のステップが完了した後に表示されます。
ステップ1：郵便番号の入力
- 7桁の日本の郵便番号を入力（例：「100-0001」または「1000001」）。
- 有効な7桁のコードが入力されると、ポータルが日本郵便APIを使用して住所を自動検索。
- 郵便番号が見つかると**「Verified」バッジ**が表示され、検索結果が表示されます：
- 都道府県（ローマ字と日本語の両方、例：「Tokyo / 東京都」）
- 市区町村（両方の言語、例：「Minato-ku / 港区」）
- 町名（両方の言語、例：「Higashiazabu / 東麻布」）
- これらのフィールドは読み取り専用で手動編集はできません。
ステップ2：番地
- Street Addressフィールドが表示されます。
- 丁目-番地-号のハイフン区切り形式で入力（例：「1-5-3」）。
- ヘルパーテキスト：「Enter chome-banchi-go (e.g., 1-5-3)」
ステップ3：住居タイプ
- Residence Typeセレクターが表示されます。
- 2つのオプション：
- House（一戸建てアイコン）
- Apartment（建物アイコン）
ステップ4：建物の詳細
- Building Name（必須）：建物名または住居名を入力。
- Room Number（アパートの場合のみ必須）：部屋番号を入力。
完了
- すべてのフィールド入力後、緑の**「Address Complete」**メッセージが表示。
- 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」クリックで変更が破棄され以前の値に戻ること
ramirez
d7efc99fdc