---
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」クリックで変更が破棄され以前の値に戻ること
